Options¶
Le comportement de 0bin peut être ajusté à l’aide d’options passées depuis un fichier de configuration ou directement à la ligne de commande. Certains paramètres sont uniquement disponibles dans le fichier de configuration.
Si une option n’est pas passée, 0bin utilise la valeur par défaut présente dans le fichier zerobin/default_settings.py.
Ligne de commande¶
–host et –port¶
L’hôte et le port sur lesquels écouter les requêtes entrantes. En général 127.0.0.1 et 8000 pour écouter localement, ou 0.0.0.0 et 80 pour écouter les requêtes extérieures.
Défaut: 127.0.0.1 et 8000
Equivalent du fichier de configuration : HOST et PORT
–debug¶
Afffiche un listing d’informations utiles pour déboguer quand quelque chose se passe mal à la place d’une page d’erreur 500.
En mode debug, le serveur recharge aussi automatiquement tout fichier Python modifié.
Défaut: False
Equivalent du fichier de configuration : DEBUG
–user et –group¶
L’utilisateur et le group que le serveur essayera d’adopter après le démarrage.
Utile quand on lance la commande avec les droits admin afin de pouvoir écouter sur le port 80, mais qu’on souhaite, pour des raisons de sécurité, que le processus n’est pas accès aux fichiers protégés du système.
–group prend de –user si il n’est pas précisé.
Défaut: Aucun
Equivalent du fichier de configuration : USER et GROUP
–settings-file¶
Chemin vers le fichier de configuration, si vous souhaitez en utiliser un.
Défaut: Aucun
Equivalent du fichier de configuration : Aucun
–compressed-static¶
Sert les versions minifiées fichiers statiques (css et js). A utiliser en production pour un site plus rapide.
Défaut: False
Equivalent du fichier de configuration : COMPRESSED_STATIC_FILES
–version et –help¶
Affiche l’aide ou la version de 0bin
Défaut: Aucun
Equivalent du fichier de configuration : Aucun
Exemples¶
Production:
sudo zerobin --host 0.0.0.0 --port 80 --user foo --compressed-static
Développement:
zerobin --debug --serve-static
Fichier de configuration¶
Le fichier configuration doit être un fichier Python ordinnaire, généralement appelé settings.py. On l’utilise ainsi:
zerobin --settings-file '/chemin/vers/settings.py'
Toutes les autres options passées à la commandes auront priorité sur les options du fichier de configuration. Le fichier zerobin/default_settings.py peut servir d’exemple pour créer son propre fichier de configuration, il est largement commenté.
DEBUG¶
Afffiche un listing d’informations utiles pour déboguer quand quelque chose se passe mal à la place d’une page d’erreur 500.
En mode debug, le serveur recharge aussi automatiquement tout fichier Python modifié.
Défaut: False
Equivalent en ligne de commande : –debug
STATIC_FILES_ROOT¶
Chemin absolu du dossier dans lequel 0bin va chercher les fichiers statiques (css, js et images).
Défaut: dossier “static” dans le dossier “zerobin”
Equivalent en ligne de commande : Aucun
COMPRESSED_STATIC_FILES¶
Sert les versions minifiées fichiers statiques (css et js). A utiliser en production pour un site plus rapide.
Défaut: False
Equivalent en ligne de commande : –compressed-static
PASTE_FILES_ROOT¶
Chemin absolu du dossier dans lequel 0bin va sauvegarder les pastes.
Défaut: dossier “static/content” dans le dossier “zerobin”
Equivalent en ligne de commande : Aucun
TEMPLATE_DIRS¶
Liste des chemins absolus des dossiers qui contiennent les templates que 0bin utilise pour générer les pages du site. Les premiers éléments de la liste ont priorités sur les suivant.
Si vous voulez utiliser vos propres templates, ajoutez le dossier qui les contient au début de la liste:
from zerobin.defauls_settings import TEMPLATE_DIRS
TEMPLATE_DIRS = (
'/chemin/version/votre/dossier/de/templates',
) + TEMPLATE_DIRS
Défaut: dossier “view” dans le dossier “zerobin”
Equivalent en ligne de commande : Aucun
HOST et PORT¶
L’hôte et le port sur lesquels écouter les requêtes entrantes. En général 127.0.0.1 et 8000 pour écouter localement, ou 0.0.0.0 et 80 pour écouter les requêtes extérieures.
Défaut: 127.0.0.1 et 8000
Equivalent du fichier de configuration : –host et –port
USER et GROUP¶
L’utilisateur et le group que le serveur essayera d’adopter après le démarrage.
Utile quand on lance la commande avec les droits admin afin de pouvoir écouter sur le port 80, mais qu’on souhaite, pour des raisons de sécurité, que le processus n’est pas accès au fichiers système.
GROUP prend de USER si il n’est pas précisé.
Défaut: Aucun
Equivalent en ligne de commande : –user et –group
MAX_SIZE¶
Valeur approximative de limite de taille d’un paste.
Défaut = 500000 octets (500 ko)
Equivalent en ligne de commande : Aucun