django-boss

django-patron est une mise en œuvre des idées exposées dans mon blog sur les commandes de gestion de Django. Avec elle, vous pouvez spécifier des commandes dans des applications individuelles, puis les exécuter en utilisant l'interface de ligne de commande djboss.
Installation django-patron
À l'heure actuelle, l'installation se fait via easy_install django-patron ou PIP installer django-patron. Les seuls prérequis sont argparse, dont l'installation est gérée par setuptools, et Django, que vous devez avoir installé maintenant de toute façon.
Commandes d'écriture
Les commandes sont définis comme des instances de djboss.commands.Command, présents dans un sous-module de commandes à l'intérieur d'une application installée. Par exemple, prenez l'application mise en page suivante:
echoapp /
| - __init__.py
| - Commands.py
`- Models.py
Le fichier commands.py est un sous-module qui peut être importé comme echoapp.commands.
Avec Décorateurs
Ce qui suit est un exemple complet d'un fichier commands.py valide:
de djboss.commands importer *
command
def bonjour (args):
& Nbsp; "" "Imprimer un cliché à la console." ""
& Nbsp; print "Bonjour tout le monde!"
Cet exemple utilise le décorateurcommand de déclarer que la fonction est une commande django-patron. Vous pouvez ajouter des arguments aux commandes aussi; il suffit d'utiliser le décorateurargument (assurez-vous qu'ils viennent après lacommand):
command
argument («- n», «--no-retour à la ligne", action = 'store_true',
& Nbsp; aide = "Ne pas ajouter une nouvelle ligne de fuite.")
def bonjour (args):
& Nbsp; "" "Imprimer un cliché à la console." ""
& Nbsp; si args.no_newline:
& nbsp; import sys
& Nbsp; sys.stdout.write ("Bonjour, monde»)
& Nbsp; d'autre:
& Nbsp; print "Bonjour tout le monde!"
Le décorateurargument accepte quelque argparse.ArgumentParser.add_argument () fait; consulter les docs argparse pour plus d'informations.
Vous pouvez aussi annoter des commandes en donnant des arguments de mots clés pourCommand:
command (name = "quelque chose", description = "Est-ce quelque chose.")
def do_something (args):
& Nbsp; "" ". Faites quelque chose" ""
& Nbsp; print "quelque chose a été fait."
Dans ce cas, la commande sera appelé "quelque chose" au lieu de "quelque chose de faire-« auto-généré, et sa description sera différent de son docstring. Pour plus d'informations sur ce qui peut être passé ici, consultez la documentation pour argparse.ArgumentParser.
Sans Décorateurs
L'API est très similaire sans décorateurs. La classe de commande est utilisé pour envelopper fonctions, et vous pouvez donner des arguments mot-clé lors de l'appel comme aveccommand:
def écho (args):
& Nbsp; ...
echo = Commande (écho, name = '...', description = '...')
Ajout arguments utilise la méthode Command.add_argument (), qui est juste une référence au sous-parser & rsquo généré; s add_argument méthode ():
def écho (args):
& Nbsp; ...
echo = Commande (écho, name = '...', description = '...')
echo.add_argument («- n», «--no-saut de ligne ', ...)
echo.add_argument («mots», nargs = '*')
Exécution de commandes
Les commandes sont exécutées via l'interface de ligne de commande djboss. Pour ce afin de fonctionner correctement, vous avez besoin de deux choses:
* Une variable d'environnement DJANGO_SETTINGS_MODULE qui se réfère à un module Python importable valide.
* Un valide, module de paramètres importables dans le répertoire de travail courant.
Une fois que l'un de ceux est couvert, vous pouvez l'exécuter:
djboss --help
utilisation: djboss [-h] [-v] [NIVEAU -l] COMMAND ...
Commandes de gestion django-patron Exécuter.
arguments optionnels:
& Nbsp; -h, --help afficher ce message d'aide et de sortie
& Nbsp; -v, le nombre et la sortie de la version de --version programme du spectacle
& Nbsp; -l niveau, NIVEAU --log-level
& Nbsp; Choisissez un niveau de DEBUG, INFO journal, WARN (par défaut)
& Nbsp; ou erreur.
commandes:
& Nbsp; COMMAND
& Nbsp; echo Echo les arguments à la console.
& Nbsp; bonjour Imprimer un cliché à la console.
Pour découvrir les sous-commandes, djboss premières découvertes et les importations de vos paramètres de Django.
La variable d'environnement DJANGO_SETTINGS_MODULE emporte, mais si non spécifié, djboss va chercher un module `Settings` dans le répertoire courant. Commandes doivent être définis dans un sous-module `commands` de chaque application. djboss va chercher chacun de vos INSTALLED_APPS pour les commandes de gestion.
Chaque sous-commande obtient une option --help trop:
djboss écho --help
utilisation: djboss écho [-h] [-n] [mots [mots ...]]
L'écho des arguments à la console.
les arguments de position:
& nbsp; mots
arguments optionnels:
& Nbsp; -h, --help afficher ce message d'aide et de sortie
& Nbsp; -n, --no-saut de ligne Ne pas imprimer un saut de ligne après.
Et puis vous pouvez l'exécuter:
djboss écho quelques mots ici
quelques mots ici
Plus de la même:
djboss bonjour --help
utilisation: djboss bonjour [-h]
Imprimer un cliché à la console.
arguments optionnels:
& Nbsp; -h, --help afficher ce message d'aide et de sortie
Et enfin:
djboss bonjour
! Bonjour tout le monde

Exigences :

• Django
• Python