Cette page explique comment installer Bogolang sous Windows et sous Linux, sur un PC avec ou sans internet, comment ajouter un autre moteur Python, et comment supprimer Bogolang. Elle dit aussi ce que l'installation apporte et ce qu'elle prend au PC.
Les installateurs sont publiés sur la page des versions du projet, avec un fichier de leurs sommes SHA-256. Comparez la somme du fichier que vous avez téléchargé avec celle publiée avant de le lancer.
| Windows | Linux | |
|---|---|---|
| Le fichier | bogolang-VERSION-windows-x64.exe |
bogolang-VERSION-linux-x64.run |
| La machine | x86 64 bits | x86 64 bits, un Linux construit sur la bibliothèque C de GNU (Ubuntu, Debian, Red Hat et semblables) |
| Droit d'administrateur | Pas nécessaire | Pas nécessaire, sauf pour un réglage facultatif (ci-dessous) |
| Internet | Pas nécessaire | Pas nécessaire |
| Installé dans | %LOCALAPPDATA%\Bogolang |
~/.local/share/bogolang |
La commande bogo |
Son dossier est ajouté au PATH de l'utilisateur | Un lien dans ~/.local/bin |
| Supprimé avec | « Applications » dans les paramètres de Windows | bogo uninstall |
Bogolang s'installe pour l'utilisateur courant seulement. La version 0.1.0 est une première version, à l'essai.
Windows
- Téléchargez
bogolang-0.1.0-windows-x64.exe. - Lancez-le. Le fichier n'est pas signé, donc Windows affiche un avertissement « éditeur inconnu ». Vérifiez d'abord la somme SHA-256 si vous ne l'avez pas fait.
- Le seul choix proposé est une icône « Bogolang Shell » sur le bureau. La case est décochée par défaut.
- Ouvrez un nouveau terminal, pour qu'il lise le nouveau PATH, et tapez :
bogo version
Bogolang 0.1.0, engine Python 3.15
L'installateur ajoute deux entrées au menu Démarrer, sous « Bogolang » :
| Entrée | Ce qu'elle ouvre |
|---|---|
| Bogolang Shell | Une fenêtre de terminal qui lance bogo shell, dans votre dossier Documents |
| Bogolang Terminal | Une fenêtre de terminal dans votre dossier Documents, avec bogo prêt |
Le fichier de l'installateur fait environ 51 Mo. Le dossier installé fait environ 264 Mo. Pour
une installation sans aucune fenêtre, l'installateur accepte l'option habituelle d'Inno Setup
/VERYSILENT.
bogo upgrade récupère la version la plus récente, vérifie sa somme et lance son installateur :
tools.md dit comment. Avec Python et pip déjà sur un PC, pip install bogolang
donne une commande bogolang-install qui fait de même pour une première installation.
Installer une nouvelle version par-dessus une plus ancienne la remplace. Les fichiers de l'ancienne sont d'abord supprimés ; rien hors du dossier de Bogolang n'est touché.
Linux
- Téléchargez
bogolang-0.1.0-linux-x64.run. - Lancez-le avec votre propre utilisateur, pas en root :
sh bogolang-0.1.0-linux-x64.run
L'installateur a besoin de deux outils du système pour se décompresser : tar et xz. Un
Linux habituel a les deux. Un système nu, comme une image de conteneur ou une installation
minimale de la famille Red Hat, peut ne pas les avoir. L'installateur s'arrête alors avec
xz: command not found ou tar: command not found et n'installe rien. Ajoutez-les d'abord,
en tant qu'administrateur :
| Système | Commande |
|---|---|
| Red Hat, Rocky, Alma, Fedora | dnf install tar xz |
| Debian, Ubuntu | apt install tar xz-utils |
Ces deux outils sont les seuls outils du système que l'installateur utilise. Une fois installé, Bogolang n'en utilise aucun.
L'installateur vérifie d'abord que son moteur démarre sur cette machine. Sinon, il le dit et s'arrête :
Bogolang cannot run on this machine: its engine does not start here.
It needs a 64-bit x86 Linux built on the GNU C library, such as Ubuntu, Debian or Red Hat.
Il place ensuite Bogolang dans ~/.local/share/bogolang, lie la commande dans ~/.local/bin,
et ajoute « Bogolang Shell » au menu des applications (sur une machine sans bureau, cela ne
change rien). Un Bogolang plus ancien au même endroit est remplacé. Il n'écrit rien hors de
votre dossier personnel, sauf pour le réglage du ping ci-dessous. Il se termine par
Type: bogo --help et To remove Bogolang later: bogo uninstall.
Si ~/.local/bin n'est pas dans votre PATH, il le dit et donne la ligne à ajouter à
~/.profile. Il ne change lui-même aucun réglage du shell :
export PATH="$HOME/.local/bin:$PATH"
Le fichier de l'installateur fait environ 69 Mo. Le dossier installé fait environ 444 Mo.
La seule question : le réglage du ping
Bogolang envoie ses propres paquets ping, sans outil du système. Sous Linux, il utilise le
socket ICMP que le système offre aux utilisateurs ordinaires. Un réglage du système,
net.ipv4.ping_group_range, peut garder ce socket fermé. La plupart des systèmes actuels
l'ouvrent ; certains non.
L'installateur essaie le socket. S'il s'ouvre, rien n'est demandé. Sinon, et si une personne est au clavier, il demande :
Bogolang's own ping needs one setting of this system, which is closed here.
Opening it needs the administrator password, once. Without it, ping() uses the ping command of the system.
Open it now? [y/N]
Sur oui, il demande le mot de passe administrateur par sudo, une fois. Il écrit alors un
fichier, /etc/sysctl.d/60-bogolang-ping.conf, avec la ligne
net.ipv4.ping_group_range = 0 2147483647, et l'applique aussitôt. Là où le système refuse
cette valeur, comme certains conteneurs, il écrit 0 65535 à la place. Il essaie de nouveau
le socket et dit le résultat. Le réglage tient ensuite après chaque redémarrage.
Ce que cela change : les utilisateurs ordinaires de cette machine peuvent ouvrir le socket ICMP, le moyen propre au système d'autoriser le ping sans root. Cela ne donne aucun autre droit à Bogolang. Cela ouvre aussi le ping aux autres programmes de cette machine, comme c'est déjà le cas sur la plupart des systèmes. C'est le seul fichier que Bogolang écrit hors de votre dossier personnel.
Sur non, sans clavier, ou si sudo échoue, rien n'est écrit. ping(), ping_all() et
scan() utilisent alors la commande ping du système, et le disent une fois par exécution.
Les entrées size, interval, ttl, source, dont_fragment et dscp n'ont alors aucun
effet. trace() envoie alors des sondes UDP, qui ne demandent aucun réglage ; une cible qui
répond à un ping mais reste muette à une sonde UDP n'est alors pas montrée comme dernier saut.
Pour ouvrir le réglage plus tard, un administrateur lance la ligne que l'installateur affiche :
sudo sh -c "echo 'net.ipv4.ping_group_range = 0 2147483647' > /etc/sysctl.d/60-bogolang-ping.conf && sysctl -p /etc/sysctl.d/60-bogolang-ping.conf"
Un PC sans internet
Les installateurs n'ont pas besoin d'internet. Copiez le fichier sur le PC et lancez-le.
- Un nouveau projet ne télécharge rien. Son environnement voit les paquets que Bogolang apporte, et ne contient que ce que le projet ajoute.
bogo add NAME --from FOLDERetbogo sync --from FOLDERinstallent des paquets à partir de fichiers de paquets apportés dans un dossier.bogo engine install VERSION --from FILEajoute un moteur à partir d'un fichier apporté à la main.bogo packn'a pas besoin d'internet.
Un autre moteur Python : bogo engine install
Bogolang tourne sur son propre moteur Python 3.15, et un nouveau projet l'utilise. Un projet peut choisir un autre moteur.
bogo engine list
bogo engine install 3.14
bogo engine use 3.14
bogo engine install VERSIONlit la liste des moteurs du projet python-build-standalone, la même source que le moteur de l'installateur. Il télécharge le fichier pour ce système et compare sa somme SHA-256 avec celle publiée avant que quoi que ce soit soit décompressé. Sans somme publiée, rien n'est téléchargé.bogo engine install VERSION --from FILEne contacte rien. Apportez le fichiercpython-VERSION...-install_only_stripped.tar.gzpour votre système depuis ce projet. La commande affiche la somme SHA-256 du fichier, pour que vous la compariez avec celle publiée là d'où il vient.- Avant qu'un moteur soit accepté, il est démarré une fois et on lui demande sa version. Un fichier qui contient une autre version que celle demandée est refusé, et rien n'est placé.
- Les moteurs vont dans
~/.bogolang/engines. Seulement x86 64 bits sous Windows et sous un Linux construit sur la bibliothèque C de GNU. bogo engine use VERSION, tapé dans un projet, écrit le moteur dansbogo.toml. L'environnement du projet est refait à sa prochaine exécution.
Un projet sur un autre moteur a besoin de ses propres copies des paquets des commandes
intégrées, car les paquets compilés ne conviennent qu'à un seul moteur. Ils viennent
d'internet, ou de bogo sync --from FOLDER. Sans eux, les commandes d'équipement ne
fonctionnent pas dans ce projet, et un avertissement le dit.
Suppression
Windows. Ouvrez les paramètres de Windows, « Applications », et supprimez « Bogolang
0.1.0 ». Cela supprime le dossier, l'entrée du PATH, les entrées du menu Démarrer et l'icône du
bureau. bogo uninstall sous Windows dit la même chose.
Linux.
bogo uninstall
Il demande d'abord, en nommant le dossier en entier :
Remove Bogolang from /home/USER/.local/share/bogolang?
Projects, stored logins and the folder ~/.bogolang are left alone. [y/N]
Sur oui, il supprime le dossier, le lien dans ~/.local/bin (seulement s'il pointe vers ce
Bogolang), l'entrée de menu et les icônes. bogo uninstall --yes ne demande pas.
Si l'installateur a écrit le fichier du réglage du ping, bogo uninstall dit ensuite où il se
trouve et demande s'il faut le supprimer aussi, de nouveau avec le mot de passe administrateur.
Ce fichier est ce qui fait durer le réglage : une fois qu'il est supprimé, le réglage reste
ouvert jusqu'au prochain redémarrage, et est fermé après. Avec --yes, ou sans clavier, il ne
demande pas et affiche la ligne à taper :
sudo rm /etc/sysctl.d/60-bogolang-ping.conf
Sur les deux systèmes, la suppression laisse intacts vos projets, les identifiants enregistrés
dans le magasin protégé du système, et le dossier .bogolang de votre dossier personnel (le
cache des vérifications et les moteurs ajoutés). Supprimez ce dossier à la main si vous voulez
qu'il disparaisse.
Ce que l'installation apporte
| Dossier | Ce qu'il contient |
|---|---|
bin |
La commande bogo. Sous Windows un petit .exe, sous Linux un court script shell |
engine/3.15 |
Un moteur Python 3.15 privé, de python-build-standalone, inchangé |
| dans le moteur | Bogolang, le vérificateur de types (mypy), le formateur (Black), l'empaqueteur (PyInstaller), et les paquets des commandes intégrées (Netmiko, paramiko, pysnmp, keyring, openpyxl, python-docx, matplotlib et leurs propres dépendances), dans des versions testées ensemble |
tools |
Linux seulement : objdump et objcopy de GNU binutils, pour bogo pack |
examples |
Les treize programmes de ../examples, avec leurs réponses enregistrées |
docs |
Ces pages |
LICENSES |
La licence de chaque partie apportée, et leur liste |
La source des binutils apportés est publiée à côté de l'installateur Linux, comme sa licence le demande.
Bogolang tourne sur ses propres ressources
Beaucoup de PC ont déjà un Python. Bogolang ne l'utilise pas et ne le dérange pas.
- La commande
bogodémarre le moteur par son chemin complet. Elle ne cherche jamaispythondans le PATH, et n'utilise jamais le lanceurpyde Windows. - Le moteur tourne toujours dans le mode isolé de Python, comme chaque processus que Bogolang
démarre (la vérification, les tests, le shell, pip). Il ignore
PYTHONPATH,PYTHONHOME,PYTHONSTARTUPet les paquets installés pour un Python de l'utilisateur. - Il met un seul nom dans le PATH :
bogo. Pas depython, pas depip. Il n'écrit aucune entrée Python dans le registre de Windows et ne prend aucun type de fichier : les fichiers.pys'ouvrent comme avant. - Un environnement de projet est fait à partir du moteur de Bogolang et ne voit que ses paquets.
Ce qu'il prend encore au PC, dit simplement :
| Pris au PC | Pourquoi |
|---|---|
| Le système lui-même : les bibliothèques de Windows, la bibliothèque C de GNU sous Linux | Tout programme le fait |
| Le magasin protégé du système | Les identifiants et les jetons y sont gardés, pas dans des fichiers |
| Les réglages réseau : proxy, DNS, certificats | Pour joindre les équipements et ajouter des paquets |
| Les réglages pip de l'utilisateur, s'il y en a | Pour qu'un index de paquets ou un proxy d'entreprise continue de marcher pour bogo add |
La commande ping du système, sous un Linux où le réglage du ping reste fermé |
Voir plus haut |
Cela a été prouvé lors de chaque construction des installateurs et sur une vraie installation, sur un PC où d'autres Pythons sont installés. Un PC sans aucun Python n'a pas été essayé (not-proven.md).
Sans l'installateur
Bogolang peut aussi tourner depuis sa source, installé avec pip dans un Python 3.15 à vous. Il
fonctionne de la même façon, mais il tourne sur ce Python : l'isolation ci-dessus ne s'applique
pas, et sous Linux bogo pack prend objdump et objcopy du système (paquet binutils).