instrumenta

Instrumenta — les outils ; et, en diplomatique, les actes qui font foi.

Dépôt personnel réunissant deux choses complémentaires : l'outillage que j'écris pour mes machines (Bash, Go, Python) et la configuration de ces machines elles-mêmes. Bash pour le collage rapide, Go pour les binaires autonomes et le traitement concurrent, Python pour le traitement de données et le prototypage.

Structure

instrumenta/
├── bash/ # scripts shell : maintenance, déploiement, glue
├── go/ # outils compilés : binaires autonomes, concurrence
├── python/ # traitement de données, automatisation, prototypes
└── apparatus/ # configurations des machines
 ├── unix/ # serveur
 ├── macbook/
 └── windows/ # poste de travail

Chaque sous-projet conséquent porte son propre README et, le cas échéant, ses dépendances (go.mod, requirements.txt, pyproject.toml).

Outillage

• Bash : set -euo pipefail en tête de script, ShellCheck-clean, en-tête de commentaire décrivant l'usage et les prérequis.
• Go : gofmt / go vet, un module par outil, binaires nommés explicitement.
• Python : ≥ 3.11, environnement virtuel ou uv, formatage ruff.

Configurations

apparatus/ accueille progressivement les configs des différentes machines. Les fichiers communs (shell, éditeur, git) vivent à la racine du dossier ; les spécificités restent cantonnées à leur plateforme.

Aucun secret dans le dépôt : clés, tokens et identifiants passent par un gestionnaire dédié ou des fichiers ignorés. Vérifier .gitignore avant tout ajout de config.

Usage

Chaque outil est documenté en tête de fichier ou dans son propre dossier. À titre indicatif :

# Script bash
./bash/nom-du-script.sh --help
# Outil Go
cd go/nom-de-loutil && go build -o bin/ ./...
# Script Python
python python/nom-du-script.py --help

Licence

Usage personnel. À adapter selon les besoins de partage.