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 |