Aller au contenu

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

bogolang
EN

← Documentation

Vérifier une installation sur un PC vierge

Une liste à suivre sur un PC qui n'a jamais eu Bogolang : quoi faire et ce que vous devez voir.

Toutes les pages de documentation

Cette page est une liste à suivre sur un PC qui n'a jamais eu Bogolang, et de préférence un PC qui n'a aucun Python. Elle dit quoi faire et ce que vous devez voir. Elle prend environ quinze minutes. Rien ici ne contacte un équipement : chaque exécution utilise des réponses enregistrées. Tapez les options avant le nom du fichier, comme écrit ici : ce qui suit le fichier est donné au programme.

Cochez chaque ligne. Là où ce que vous voyez diffère, notez la ligne et le texte exact.

Avant

# Faire Voir
1 Ouvrez un terminal et tapez python --version Windows dit que la commande est introuvable, ou ouvre le Store. Les deux conviennent : cela montre que le PC n'a pas de Python. Si une version est affichée, notez-la ; Bogolang ne doit pas l'utiliser
2 Comparez la somme SHA-256 de l'installateur avec celle publiée. Windows : certutil -hashfile FILE SHA256. Linux : sha256sum FILE La même somme que dans le fichier SHA256SUMS de la version

Installation

# Faire Voir
3 Windows : lancez bogolang-0.1.0-windows-x64.exe Un avertissement « éditeur inconnu », car le fichier n'est pas signé. Puis les pages de l'installateur, avec un seul choix : une icône sur le bureau, décochée par défaut. Aucune question d'administrateur
3 Linux : sh bogolang-0.1.0-linux-x64.run, avec votre propre utilisateur Des lignes qui disent où Bogolang a été placé. Peut-être une question sur le réglage du ping (install.md l'explique)
4 Ouvrez un NOUVEAU terminal et tapez bogo version Bogolang 0.1.0, engine Python 3.15
5 Windows : ouvrez le menu Démarrer Un groupe « Bogolang » avec « Bogolang Shell » et « Bogolang Terminal »

Le premier programme

# Faire Voir
6 Créez un dossier, et dedans un fichier hello.bogo avec le programme de first-program.md
7 bogo hello.bogo La première exécution prend quelques secondes de plus. Puis la sortie du programme
8 Changez un type dans le fichier pour un type faux, par exemple donnez à un Rate la valeur 5s, et relancez Une erreur avant que le programme démarre, avec le fichier, la ligne, la colonne et ce qu'il faut écrire

Les exemples, sans équipement

L'installation apporte les exemples. Sous Windows ils sont dans %LOCALAPPDATA%\Bogolang\examples, sous Linux dans ~/.local/share/bogolang/examples. Copiez d'abord le dossier examples dans votre propre dossier.

# Faire Voir
9 Dans examples/reach_hosts : bogo run --replay saved reach_hosts.bogo Un tableau d'hôtes, certains joignables et certains non, lu dans les réponses enregistrées
10 Dans examples/device_table : bogo run --replay saved device_table.bogo Un tableau fait à partir de sorties show enregistrées
11 Dans examples/change_vlan : bogo run --replay saved --dry change_vlan.bogo Les lignes qui seraient envoyées, chacune marquée comme essai à blanc, et « would be added »
12 Dans examples/reach_hosts : bogo test reach_hosts.bogo Les tests réussissent ; rien n'est contacté
13 bogo doc ping_all La signature et le texte de ping_all

Son propre ping

# Faire Voir
14 bogo shell, puis tapez ping(127.0.0.1) Un résultat avec 0 % de perte. Sous Linux, si le réglage du ping est resté fermé, une phrase qui dit comment l'ouvrir
15 Tapez exit() Le shell se termine

Un seul fichier à partager

# Faire Voir
16 Dans votre dossier hello : bogo pack hello.bogo Après une minute ou deux, un seul fichier hello.exe (Windows) ou hello (Linux)
17 Lancez ce fichier La même sortie qu'à l'étape 7

L'éditeur, si VS Code est sur le PC

# Faire Voir
18 bogo vscode « The Bogolang extension is in VS Code. »
19 Ouvrez hello.bogo dans VS Code Des couleurs : les adresses et les unités ressortent. Faites l'erreur de l'étape 8 : un trait rouge dessous deux à trois secondes plus tard, et le texte d'aide sous la souris
20 « Format Document » La mise en page est rangée, ou reste telle quelle si elle l'était déjà

Il n'utilise rien du PC

# Faire Voir
21 Si le PC a un Python (étape 1) : de nouveau python --version, et pip list La même chose qu'avant l'installation : Bogolang n'y a rien ajouté

Suppression

# Faire Voir
22 Windows : « Applications » dans les paramètres, supprimez Bogolang. Linux : bogo uninstall D'abord une question sous Linux. Puis le dossier de Bogolang a disparu
23 Ouvrez un nouveau terminal et tapez bogo version La commande est introuvable
24 Regardez votre dossier hello Toujours là. Les projets, les identifiants enregistrés et le dossier .bogolang de votre dossier personnel sont gardés ; install.md dit ce que la suppression garde