Skip to content

Version 0.1.0 is a first version, for trial. See what is not proven →

bogolang
FR

← Documentation

Check an installation on a clean PC

A list to follow on a PC that never had Bogolang: what to do and what you should see.

All documentation pages

This page is a list to follow on a PC that never had Bogolang, and best one that has no Python at all. It says what to do and what you should see. It takes about fifteen minutes. Nothing in it contacts a device: every run uses saved answers. Type the options before the name of the file, as written here: what follows the file is given to the program.

Tick each line. Where what you see differs, note the line and the exact text.

Before

# Do See
1 Open a terminal and type python --version Windows says the command is not found, or opens the Store. Either is fine: it shows the PC has no Python. If a version is printed, note it; Bogolang must not use it
2 Compare the SHA-256 sum of the installer with the published one. Windows: certutil -hashfile FILE SHA256. Linux: sha256sum FILE The same sum as in the file SHA256SUMS of the release

Install

# Do See
3 Windows: run bogolang-0.1.0-windows-x64.exe An "unknown publisher" warning, since the file is not signed. Then the pages of the installer, with one choice: a desktop icon, off by default. No administrator question
3 Linux: sh bogolang-0.1.0-linux-x64.run, as your own user Lines that say where Bogolang was put. Perhaps one question about the ping setting (install.md explains it)
4 Open a NEW terminal and type bogo version Bogolang 0.1.0, engine Python 3.15
5 Windows: open the Start menu A group "Bogolang" with "Bogolang Shell" and "Bogolang Terminal"

The first program

# Do See
6 Make a folder, and in it a file hello.bogo with the program of first-program.md
7 bogo hello.bogo The first run takes a few seconds longer. Then the output of the program
8 Change a type in the file to a wrong one, for example give a Rate the value 5s, and run again An error before the program starts, with the file, the line, the column and what to write

The examples, with no device

The installation carries the examples. On Windows they are in %LOCALAPPDATA%\Bogolang\examples, on Linux in ~/.local/share/bogolang/examples. Copy the folder examples to your own folder first.

# Do See
9 In examples/reach_hosts: bogo run --replay saved reach_hosts.bogo A table of hosts, some up and some down, read from the saved answers
10 In examples/device_table: bogo run --replay saved device_table.bogo A table made from saved show outputs
11 In examples/change_vlan: bogo run --replay saved --dry change_vlan.bogo The lines that would be sent, each marked as a dry run, and "would be added"
12 In examples/reach_hosts: bogo test reach_hosts.bogo The tests pass; nothing is contacted
13 bogo doc ping_all The signature and the text of ping_all

Its own ping

# Do See
14 bogo shell, then type ping(127.0.0.1) A result with 0% loss. On Linux, if the ping setting was left closed, a sentence that says how to open it
15 Type exit() The shell ends

One file to share

# Do See
16 In your hello folder: bogo pack hello.bogo After a minute or two, one file hello.exe (Windows) or hello (Linux)
17 Run that file The same output as step 7

The editor, if VS Code is on the PC

# Do See
18 bogo vscode "The Bogolang extension is in VS Code."
19 Open hello.bogo in VS Code Colours: addresses and units stand out. Make the mistake of step 8: a red line under it two to three seconds later, and the help text under the mouse
20 "Format Document" The layout is tidied, or stays as it was when already tidy

It uses nothing of the PC

# Do See
21 If the PC has a Python (step 1): python --version again, and pip list The same as before the installation: Bogolang added nothing to it

Removal

# Do See
22 Windows: "Apps" in the settings, remove Bogolang. Linux: bogo uninstall A question first on Linux. Then the folder of Bogolang is gone
23 Open a new terminal and type bogo version The command is not found
24 Look at your hello folder Still there. Projects, stored logins and the folder .bogolang of your home are kept; install.md says what removal keeps