django-boss

Django-baas is 'n uitvoering van die idees wat in my blog post op Django bestuur opdragte. Met dit, kan jy opdragte in individuele programme spesifiseer en dan loop hulle met behulp van die djboss command-line interface.
Die installering Django-baas
Op die oomblik is, is die installasie gedoen via easy_install Django-baas of PIP installeer Django-baas. Die enigste voorvereistes is argparse, wie se installasie is hanteer deur setuptools en Django wat jy moet geïnstalleer het nou in elk geval.
die skryf van instruksies
Opdragte word gedefinieer as gevalle van djboss.commands.Command, teenwoordig in 'n instruksies submodule binne 'n geïnstalleerde app. Neem byvoorbeeld die volgende inligting uitleg:
echoapp /
| - __init__.py
| - Commands.py
`- Models.py
Die commands.py lêer is 'n submodule dat echoapp.commands ingevoer kan word.
Met ontwerpers
Die volgende is 'n volledige voorbeeld van 'n geldige commands.py lêer:
van djboss.commands invoer *
command
def hallo (argumente):
& Nbsp; "" "Druk 'n cliche na die konsole." ""
& Nbsp; druk "Hallo, World!"
Hierdie voorbeeld gebruik diecommand versierder om te verklaar dat die funksie is 'n Django-baas opdrag. Jy kan voeg argumente om bevele te; net gebruik dieargument versierder (maak seker dat hulle kom na diecommand):
command
argument ('- n "," --no-newline, action =' store_true,
& Nbsp; hulp = "Moenie voeg 'n sleep newline.")
def hallo (argumente):
& Nbsp; "" "Druk 'n cliche na die konsole." ""
& Nbsp; as args.no_newline:
& Nbsp; invoer sys
& Nbsp; sys.stdout.write ("Hello World")
& Nbsp; anders:
& Nbsp; druk "Hallo, World!"
Dieargument versierder aanvaar ongeag argparse.ArgumentParser.add_argument () doen; raadpleeg die argparse docs vir meer inligting.
Jy kan ook opdragte annoteer deur navraag argumentecommand:
command (name = "iets", beskrywing = "Is iets.")
def do_something (argumente):
& Nbsp; "" ". Doen iets" ""
& Nbsp; druk "iets gedoen is."
In hierdie geval, sal die opdrag "iets" in plaas van die motor-gegenereerde "doen-iets" genoem word, en sy beskrywing sal verskil van sy docstring. Vir meer inligting oor wat oorgedra kan word in hier, raadpleeg die argparse.ArgumentParser docs.
Sonder ontwerpers
Die API is baie soortgelyk sonder ontwerpers. Die Command klas word gebruik om funksies te draai, en jy kan navraag argumente gee wanneer dit as beroep metcommand:
def eggo (argumente):
& Nbsp; ...
eggo = Command (ECHO name = '...', beskrywing = '...')
Toevoeging van argumente gebruik die Command.add_argument (metode), wat net 'n verwysing na die gegenereerde sub-parser & rsquo; s add_argument (metode):
def eggo (argumente):
& Nbsp; ...
eggo = Command (ECHO name = '...', beskrywing = '...')
echo.add_argument ('- n "," --no-newline, ...)
echo.add_argument (se woorde, nargs = '*')
Running Commands
Opdragte uitgevoer via die djboss opdrag-lyn koppelvlak. Vir hierdie om korrek te voer, een van twee dinge wat jy nodig het:
* 'N DJANGO_SETTINGS_MODULE omgewing veranderlike wat verwys na 'n geldige, invoerbare Python module.
* 'N geldige, invoerbare instellings module in die huidige werk gids.
Sodra een van daardie bedek is, kan jy dit uit te voer:
djboss help uit te voer
gebruik: djboss [h] [v] [l VLAK] COMMAND ...
Begin Django-baas bestuur opdragte.
opsionele argumente:
& Nbsp; h, help uit te voer hierdie hulp boodskap en uitgang wys
& Nbsp; v, version Wys program se weergawe nommer en uitgang
& Nbsp; -l VLAK, --log-Vlak
& Nbsp; Kies 'n log vlak van ontfout, INFO waarsku (verstek)
& Nbsp; of foute.
beveel:
& Nbsp; COMMAND
& Nbsp; eggo Echo die argumente terug na die konsole.
& Nbsp; hallo Druk 'n cliche na die konsole.
Om sub-opdragte, djboss eerste ontdekkings en invoer jou Django instellings te ontdek.
Die DJANGO_SETTINGS_MODULE omgewing veranderlike voorrang, maar as ongespesifiseerde, sal djboss kyk vir 'n `settings` module in die huidige gids. Opdragte moet gedefinieer word in 'n `commands` submodule van elke app. djboss sal elkeen van jou INSTALLED_APPS soek bestuur opdragte.
Elke subcommand kry 'n opsie te help uit te voer:
djboss eggo help uit te voer
gebruik: djboss eggo [h] [-n] [woorde [woorde ...]]
Eggo die argumente terug na die konsole.
posisionele argumente:
& Nbsp; woorde
opsionele argumente:
& Nbsp; h, help uit te voer hierdie hulp boodskap en uitgang wys
& Nbsp; -n, --no-newline Moenie 'n newline daarna druk.
En dan kan jy dit loop:
djboss hier eggo paar woorde
paar woorde hier
Meer van dieselfde:
djboss hallo help uit te voer
gebruik: djboss hallo [h]
Druk 'n cliche na die konsole.
opsionele argumente:
& Nbsp; h, help uit te voer hierdie hulp boodskap en uitgang wys
En uiteindelik:
djboss hallo
Hello World

Vereistes :

• Django
• Python