Package: rtd-bin-server
bin-serverUn outil pour héberger des snippets de code et les partager via une URL.InstallationLe service nécessite une version de Python supérieure ou égale à Python 3.7 et un accès à un serveur Redis. Les archives sont hébergés surPypi, vous pouvez installer la dernière version stable viapip:$ pip install rtd-bin-serverUne fois installé, le modulebindevient accessible et peut être directement lancé via la ligne de commande.$ python -m binPar défaut, le service ne traite qu'un client à la fois, écoute à l'adresselocalhost:8012et se connecte à la base de donnée Redis surlocalhost:6379/0. Changer la configuration par défaut se fait au moyen d'un fichierdotenv. Le fichier sera automatiquement détecté s'il est nommé.envet qu'il se trouve soit au niveau des sources, soit au niveau du répertoire courant (celui depuis lequel est lancé la commande). Une alternative est de renseigner le fichier de configuration à utiliser via l'option--rtdbin-config.$ python -m bin --rtdbin-config /chemin/vers/fichier/.envLa configuration complète par défaut est reprise ci-dessous :RTDBIN_HOST=localhost
RTDBIN_PORT=8012
RTDBIN_MAXSIZE=16kiB
RTDBIN_DEFAULT_LANGUAGE=text
RTDBIN_DEFAULT_MAXUSAGE=0
RTDBIN_DEFAULT_LIFETIME=0
REDIS_HOST=localhost
REDIS_PORT=6379
REDIS_DB=0
REDIS_PASSWORD=
REDIS_USERNAME=Par défaut, le service utilise le serveur webwsgirefdisponible dans la bibliothèque standard de Python pour traiter les requêtes. Ce serveur est propice dans un environnement de développement ou lorsque le volume d'utilisateur est réduit. Pour de meilleures performances,un serveur tiers compatible wsgipeut être utilisé à la place.$ pip install gunicorn
$ gunicorn bin:appDes fichiers de configuration d'exemples pournginx,systemdetgunicornsont disponibles dans lewiki.ContributionLe développement debinse fait principalement via la communauté DiscordRead The Docsdans le canal#bin.Les sources peuvent être récupérées via Git et le service peut être installé dans un environnement virtuel dédié.$ git clone https://github.com/readthedocs-fr/bin.git rtdbin
$ cd rtdbin
$ python -m venv
$ venv/bin/pip install -r requirements.txt
$ venv/bin/pip install -e .Une fois installé, vous pouvez vous assurer que le système est correctement opérationnel en lançant la suite de tests unitaires et en vérifiant que le serveur démarre correctement.$ venv/bin/python -m unittest
$ venv/bin/python -m bin &
$ curl http://localhost:8012/health
$ kill %%Les contributions se font sur des branches dédiées, les branches sont nommées en commençant par quelques mots-clés suivis d'un identifiant de l'utilisateur. Les commits sont le plus petit dénominateur de version, sont correctement documentés au moyen d'un message de commit reprenant au minimum un contexte expliquant la nécessité des modifications.$ git checkout main
$ git pull origin main
$ git checkout -b redo-readme-juc
$ git commit <<EOF
doc: redo readme

The readme is the first document users read when they learn
about the project, the file is by default shown in the project root
page in github.

The document is very important yet the current one is not very
good. The new documents are more straight to the point.
EOF
$ git push fork redo-readme-juc