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 |