django-boss

Django-boss je implementace myšlenek uvedených v mém blogu na příkazů správy Django. S ním, můžete zadat příkazy v jednotlivých aplikací a spustit je pomocí djboss rozhraní příkazového řádku.
Instalace Django-boss
V současné době, instalace se provádí pomocí easy_install Django-šéf nebo PIP nainstalovat Django-šéf. Jedinými předpoklady jsou argparse, jehož instalace je se ovládal setuptools, a Django, který byste měli mít nainstalován už tak jako tak.
psaní Příkazy
Příkazy jsou definovány jako instance djboss.commands.Command, přítomných v commands submodulu uvnitř nainstalované aplikace. Například, vzít toto uspořádání app:
echoapp /
| - __init__.py
| - Commands.py
`- Models.py
Commands.py Soubor je submodul, který lze importovat jako echoapp.commands.
S dekoratérů
Je doplňuje kompletní příklad platného commands.py souboru:
od djboss.commands import *
command
def ahoj (args):
& Nbsp; "" "Tisk klišé na konzoli." ""
& Nbsp; print "Hello, World!"
Tento příklad používácommand dekoratér, aby prohlásil, že funkce je příkaz Django-boss. Můžete přidat argumenty na povely taky; stačí použítargument dekoratér (ujistěte se, že přijdou pocommand):
command
argument ('- n', "--no-nový řádek ', action =' store_true ',
& Nbsp; help = "Do not připojit koncové nový řádek.")
def ahoj (args):
& Nbsp; "" "Tisk klišé na konzoli." ""
& Nbsp; pokud args.no_newline:
& nbsp; import sys
& Nbsp; sys.stdout.write ("Hello, World")
& Nbsp; jinak:
& Nbsp; print "Hello, World!"
argument Dekoratér přijímá cokoliv argparse.ArgumentParser.add_argument () dělá; konzultovat argparse docs pro více informací.
Můžete také anotovat příkazy tím, že klíčové slovo argumentycommand:
command (name = "něco", description = "dělá něco.")
def do_something (args):
& Nbsp; "" ". Udělej něco" ""
& Nbsp; print "něco bylo provedeno."
V tomto případě, bude příkaz být nazýván "něco" namísto "do-něco" auto-generované, a jeho popis se bude lišit od jeho dokumentačního řetězce. Pro více informací o tom, co může být přenesen sem, konzultuje argparse.ArgumentParser docs.
Bez dekoratéři
API je velmi podobná bez dekorace. Třída Příkaz se používá k zabalit funkce, a vy můžete dát klíčových argumentů při vyvolání jako ucommand:
def echo (args):
& Nbsp; ...
echo = Command (echo, name = '...', description = '...')
Přidání argumenty používá metodu Command.add_argument (), což je jen odkaz na generovaného sub-analyzátoru & rsquo; s add_argument metoda ():
def echo (args):
& Nbsp; ...
echo = Command (echo, name = '...', description = '...')
echo.add_argument ('- n', '-no-nový řádek ", ...)
echo.add_argument ("slova", nargs = "*")
Running Příkazy
Příkazy jsou prováděny přes djboss rozhraní příkazového řádku. K tomu, aby správně fungoval, je třeba jednu ze dvou věcí:
* DJANGO_SETTINGS_MODULE proměnná prostředí, která se odkazuje na platný, dovážet Python modulu.
* Platný, importovatelné nastavení modul v aktuálním pracovním adresáři.
Jednou jeden z nich je pokryta, můžete jej spustit:
djboss --help
Využití: djboss [-h] [-v] [-l LEVEL] Příkaz ...
Spouštět příkazy pro správu Django-boss.
volitelné argumenty:
& Nbsp; -h, --help zobrazit tuto nápovědu a skončí
& Nbsp; -v, číslo verze --version přehlídka programu a exit
& Nbsp; -l LEVEL, --log úrovni LEVEL
& Nbsp; Vyberte úroveň protokolu z Debug info, WARN (výchozí)
& Nbsp; nebo ERROR.
příkazy:
& Nbsp; COMMAND
& Nbsp; echo Echo argumenty zpět do konzole.
& Nbsp; ahoj Vytisknout klišé na konzoli.
Chcete-li zjistit sub-příkazy, djboss první nálezy a dovoz vaše nastavení Django.
Proměnná DJANGO_SETTINGS_MODULE prostředí má přednost, ale pokud NS, bude djboss hledat `settings` modulu v aktuálním adresáři. Příkazy by měly být definovány v `commands` submodulu každé aplikaci. djboss bude hledat každou z vašich INSTALLED_APPS pro příkazy správy.
Každý dílčí dostane --help možnost příliš:
djboss echo --help
využití: djboss echo [-h] [-n] [slova [slova ...]]
Echo argumenty zpět do konzole.
poziční argumenty:
& nbsp; slova
volitelné argumenty:
& Nbsp; -h, --help zobrazit tuto nápovědu a skončí
& Nbsp; -n, --no-nový řádek Netiskněte nový řádek poté.
A pak můžete spustit:
djboss echo pár slov zde
Některá slova zde
Více o totéž:
djboss ahoj --help
Využití: djboss ahoj [-h]
Vytisknout klišé na konzoli.
volitelné argumenty:
& Nbsp; -h, --help zobrazit tuto nápovědu a skončí
A nakonec:
djboss ahoj
! Hello, World

Požadavky na :

• Django
• Python