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

Installation

Installateurs Windows et Linux, un PC sans internet, les autres moteurs, la désinstallation.

Toutes les pages de documentation

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

  1. Téléchargez bogolang-0.1.0-windows-x64.exe.
  2. 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.
  3. Le seul choix proposé est une icône « Bogolang Shell » sur le bureau. La case est décochée par défaut.
  4. 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

  1. Téléchargez bogolang-0.1.0-linux-x64.run.
  2. 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 FOLDER et bogo sync --from FOLDER installent des paquets à partir de fichiers de paquets apportés dans un dossier.
  • bogo engine install VERSION --from FILE ajoute un moteur à partir d'un fichier apporté à la main.
  • bogo pack n'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 VERSION lit 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 FILE ne contacte rien. Apportez le fichier cpython-VERSION...-install_only_stripped.tar.gz pour 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 dans bogo.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 bogo démarre le moteur par son chemin complet. Elle ne cherche jamais python dans le PATH, et n'utilise jamais le lanceur py de 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, PYTHONSTARTUP et les paquets installés pour un Python de l'utilisateur.
  • Il met un seul nom dans le PATH : bogo. Pas de python, pas de pip. Il n'écrit aucune entrée Python dans le registre de Windows et ne prend aucun type de fichier : les fichiers .py s'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).