Aller au contenu

La version 0.1.0 est une première version, à l'essai. Voir ce qui n'est pas prouvé →

bogolang
EN

Version 0.1.0 sur Python 3.15

Un langage de programmation pour les ingénieurs réseaux et télécommunications.

Bogolang est un langage à part entière, construit sur Python 3. Il a ses propres littéraux, instructions, règles et outils. Il est fondé sur les classes, comme Java : tout le code se trouve dans une classe, et un programme commence dans main. Les adresses, les sous-réseaux, les interfaces et les unités sont de vrais types. Joindre des hôtes, lire des équipements, tester une liste d'accès ou préparer un bond radio sont des commandes intégrées. Un changement sur un équipement est refusé s'il n'a pas de retour arrière. Tous les paquets Python continuent de fonctionner.

  • Fondé sur les classes
  • Windows et Linux
  • Sans droit d'administrateur
  • Licence MIT
reach_hosts.bogo Ouvrir l'exemple
edition 2027
"""Is everything up? Ping a list of hosts at once, trace the path to one, scan a small network."""


class ReachHosts:
    """A morning reach check: a table of ping results, one trace and one scan."""

    hosts: list[IP] = [192.0.2.1, 192.0.2.10, 198.51.100.7, 203.0.113.20]
    far: IP = 203.0.113.20
    lan: Net = 192.0.2.0/29
    slow: Duration = 50ms

    @staticmethod
    def verdict(r: PingResult, slow: Duration) -> str:
        """One word for a ping result: DOWN, LOSS, SLOW or ok."""
        if not r.ok:
            return "DOWN"
        if r.received < r.sent:
            return "LOSS"
        if r.avg is not None and r.avg > slow:
            return "SLOW"
        return "ok"

    @staticmethod
    def main(args: list[str]) -> None:
        results: list[PingResult] = ping_all(ReachHosts.hosts, count=3, timeout=1s)
        rows: list[dict[str, object]] = []
        for r in results:
            rows.append(
                {
                    "host": r.host,
                    "received": f"{r.received}/{r.sent}",
                    "loss": r.loss,
                    "avg": r.avg,
                    "jitter": r.jitter,
                    "state": ReachHosts.verdict(r, ReachHosts.slow),
                }
            )
        table(rows)

        print(f"\nPath to {ReachHosts.far}:")
        for hop in trace(ReachHosts.far, max_hops=10, probes=2):
            print(f"  {hop}")

        up: list[IP] = scan(ReachHosts.lan)
        print(
            f"\n{len(up)} addresses answer in {ReachHosts.lan}: {', '.join(str(ip) for ip in up)}"
        )

$ bogo run --replay saved reach_hosts.bogo

host          received  loss     avg       jitter  state
------------  --------  -------  --------  ------  -----
192.0.2.1     3/3       0pct     1.233ms   0.25ms  ok
192.0.2.10    2/3       33.3pct  2.35ms    0.5ms   LOSS
198.51.100.7  0/3       100pct                     DOWN
203.0.113.20  3/3       0pct     61.767ms  4.1ms   SLOW

Path to 203.0.113.20:
  1  192.0.2.1  1ms  0% loss
  2  198.51.100.1  8.65ms  0% loss
  3  *  *  100% loss
  4  198.51.100.65  40.95ms  0% loss
  5  203.0.113.20  61.05ms  0% loss

3 addresses answer in 192.0.2.0/29: 192.0.2.1, 192.0.2.2, 192.0.2.5

La forme d'un programme

Fondé sur les classes, comme Java

Tous les programmes Bogolang ont la même forme. Un ingénieur peut donc ouvrir le fichier d'un collègue et savoir où regarder.

Tout le code se trouve dans une classe
Le haut d'un fichier ne contient que la ligne d'édition, des imports et des classes. Une fonction, une affectation ou une ligne isolée en haut du fichier est refusée avant que le programme ne tourne.
Un programme commence dans main
Le départ est la méthode statique main de la classe qui porte le nom du fichier : link_check.bogo commence dans la classe LinkCheck. Les mots tapés après le nom du fichier arrivent dans args.
Les tests sont aussi des classes
Un test est une méthode dont le nom commence par test_, dans une classe dont le nom commence par Test. Un programme peut porter ses propres tests, et bogo test les lance.
Tout ce que Python offre pour les classes reste
L'héritage, les décorateurs, @dataclass, Enum, Protocol, les propriétés et les méthodes de classe fonctionnent comme en Python.

Comment un fichier est organisé

link_check.bogo
edition 2027
"""Says which routers answer."""


class LinkCheck:
    """Pings each router twice."""

    routers: list[IP] = [192.0.2.1, 192.0.2.2]

    @staticmethod
    def main(args: list[str]) -> None:
        for r in LinkCheck.routers:
            print(r, ping(r, count=2))


class TestLinkCheck:
    def test_there_are_two_routers(self) -> None:
        assert len(LinkCheck.routers) == 2
Une ligne hors d'une classe est refusée
top.bogo:3:1: error: code must be inside a class
    x = 1
    ^
    Only imports and classes stand at the top of a file. Put this line in a method of a class.

Intégré

Le travail quotidien d'un ingénieur réseau, en commandes du langage

Pas de bibliothèque à chercher, pas de surcouche à écrire. Chaque carte ouvre la page qui l'explique.

Sûr par règle

Prudent avec le réseau, car une erreur y coûte cher

Lecture seule par défaut
Les sessions sur les équipements sont en lecture seule, sauf si un bloc change dit autre chose.
Pas de changement sans retour arrière
Un bloc change sans retour arrière est refusé avant que le programme ne tourne.
Pas d'identifiants dans un fichier
Les identifiants sont gardés dans le magasin protégé du système, jamais dans un fichier.
Essayez sans équipement
--dry affiche chaque changement et n'envoie rien. --replay répond à partir des sorties enregistrées.

Lire la page sur le bloc change

Tiré de l'exemple change_vlan
change on d:
    apply:
        vlan {vid}
         name {name}
        interface {trunk}
         switchport trunk allowed vlan add {vid}
    rollback:
        interface {trunk}
         switchport trunk allowed vlan remove {vid}
        no vlan {vid}
    verify:
        name in show("vlan brief")
        str(vid) in show(f"interfaces {trunk} trunk")

$ bogo run --dry --replay saved change_vlan.bogo

DRY RUN: change on core-sw1. Nothing is sent.
  apply:
    vlan 30
     name CAMERAS
    interface GigabitEthernet1/0/2
     switchport trunk allowed vlan add 30
  rollback:
    interface GigabitEthernet1/0/2
     switchport trunk allowed vlan remove 30
    no vlan 30
core-sw1: VLAN 30 would be added, nothing was sent
access-sw3: VLAN 30 is already there, nothing to do

Le langage

Python en dessous, plus strict au-dessus

Si vous lisez Python, vous lisez Bogolang. Les règles qu'il ajoute arrêtent les erreurs avant qu'un paquet ne quitte le PC.

La page du langage

  1. 01

    Des valeurs avec un type

    192.0.2.1, 10.40.0.0/16, 50ms et 18GHz sont des valeurs avec un type. Comparer une durée avec un débit est une erreur.

  2. 02

    Vérifié avant de tourner

    Une erreur de type arrête le programme avant son départ, avec la ligne, la colonne et ce qu'il faut écrire.

  3. 03

    Les éditions gardent les anciens programmes en marche

    Une édition fixe le sens du langage. Un Bogolang plus récent fait tourner chaque édition plus ancienne avec le sens qu'elle avait.

  4. 04

    Tous les paquets Python continuent de fonctionner

    Le moteur Python 3.15 reste à l'intérieur. Les paquets Python s'importent tels quels.

sortes de travaux intégrés
10
pages de documentation
20
programmes d'exemple
13
systèmes : Windows et Linux
2

Exemples

Des programmes qui tournent sur n'importe quel PC

Chaque exemple vient avec ses réponses enregistrées. Il tourne donc sans équipement et sans réseau.

Les 13 exemples

D'un dossier vide à un programme qui tourne

Installez Bogolang, puis suivez la page du premier programme. Sa dernière étape tourne sur des réponses enregistrées et ne contacte aucun hôte.