django-boss

django-boss ay isang pagpapatupad ng mga ideya na nakabalangkas sa aking blog post sa Django utos ng pangasiwaan. Gamit ito, maaari mong tukuyin ang mga utos sa indibidwal na apps at pagkatapos ay patakbuhin ang mga ito gamit ang djboss command-line interface.
Pag-install ng django-boss
Sa ngayon, ang pag-install ay tapos na sa pamamagitan easy_install django-boss o PIP install django-boss. Ang tanging kinakailangan ay argparse, na ang pag-install ay gagawin sa pamamagitan ng setuptools, at Django, na dapat na-install mo na ngayon sa pamamagitan pa rin.
Pagsusulat utos
Utos ay tinukoy bilang mga pagkakataon ng djboss.commands.Command, naroroon sa isang utos submodule sa loob ng isang naka-install na app. Halimbawa, gawin ang mga sumusunod na layout app:
echoapp /
| - __init__.py
| - Commands.py
`- Models.py
Ang commands.py file ay isang submodule na maaaring import bilang echoapp.commands.
Sa Decorators
Ang mga sumusunod ay isang kumpletong halimbawa ng isang wastong commands.py file:
mula djboss.commands import *
command
def hello (args):
& Nbsp; "" "I-print ang isang klisey sa console." ""
& Nbsp; print "Hello, World!"
Ang halimbawang ito ay gumagamit ng mgacommand dekorador upang ipahayag na ang function ay isang command django-boss. Maaari kang magdagdag ng mga argumento sa mga utos masyadong; lamang gamitin angargument decorator (tiyakin na sila ay darating pagkataposcommand):
command
argument ('- n', '--no-newline', action = 'store_true',
& Nbsp; ng tulong = "Huwag idagdag ang isang trailing newline.")
def hello (args):
& Nbsp; "" "I-print ang isang klisey sa console." ""
& Nbsp; kung args.no_newline:
& Nbsp; import sys
& Nbsp; sys.stdout.write ("Hello, World")
& Nbsp; pa:
& Nbsp; print "Hello, World!"
Tumatanggap ngargument decorator kahit anong argparse.ArgumentParser.add_argument () ay; konsultahin ang argparse docs para sa karagdagang impormasyon.
Maaari mo ring annotate utos sa pamamagitan ng pagbibigay ng argumento ng keyword upangcommand:
command (name = "something", description = "ba ng isang bagay.")
def do_something (args):
& Nbsp; "" ". Mayroon isang bagay na" ""
& Nbsp; print "ang isang bagay ay tapos na."
Sa kasong ito, ang mga utos ay tinatawag na "something" sa halip ng ang auto-generated na "isang bagay na gawin-", at nag-iiba ng paglalarawan nito mula docstring nito. Para sa karagdagang impormasyon sa kung ano ang maaaring maipasa sa dito, sumangguni sa argparse.ArgumentParser docs.
Walang Decorators
Ang API ay halos katulad nang decorators. Ang Command klase ay ginagamit upang ibalot function, at maaari kang magbigay ng mga argumento keyword kapag invoking ito bilang maycommand:
def echo (args):
& Nbsp; ...
echo = Command (echo, name = '...', description = '...')
Pagdaragdag ng mga argumento ay gumagamit ng Command.add_argument () method, na tumutukoy lamang sa nakabuo sub-parser & rsquo; s add_argument () method:
def echo (args):
& Nbsp; ...
echo = Command (echo, name = '...', description = '...')
echo.add_argument ('- n', '--no-newline', ...)
echo.add_argument ('salita', = '*' nargs)
Pagpapatakbo ng utos
Utos ay naisakatuparan sa pamamagitan ng djboss command-line interface. Para sa mga ito upang tumakbo nang tama, kailangan mo ang isa sa dalawang bagay:
* Isang DJANGO_SETTINGS_MODULE environment variable na tumutukoy sa isang may-bisang, angkatin Python module.
* Ang isang may-bisang, angkatin setting ng module sa kasalukuyang nagtatrabaho direktoryo.
Kapag isa sa mga iyon ay sakop, maaari mong patakbuhin ang mga ito:
djboss help
paggamit: djboss [h] [v] [l LEVEL] COMMAND ...
Patakbuhin django-boss utos ng pangasiwaan.
opsyonal na mga argumento:
& Nbsp; h, help ipakita ang tulong na mensahe at exit
& Nbsp;, numero at exit v --version show program version
& Nbsp; l LEVEL, --log-level LEVEL
& Nbsp; Pumili ng isang level log mula DEBUG, INFO, balaan (default)
& Nbsp; o ERROR.
command:
& Nbsp; COMMAND
& Nbsp; echo Echo ang argumento pabalik sa console.
& Nbsp; hoy print ang isang klisey sa console.
Upang matuklasan ang sub-utos, djboss unang nahahanap at ang iyong mga setting Django import.
Ang DJANGO_SETTINGS_MODULE environment variable tumatagal mauuna, ngunit kung hindi natukoy, djboss magiging hitsura para sa isang `settings` module sa kasalukuyang directory. Mga utos ay dapat na tinukoy sa isang `commands` submodule ng bawat app. djboss ay sa paghahanap sa bawat isa sa iyong mga INSTALLED_APPS para sa mga utos ng pangasiwaan.
Bawat subcommand makakakuha ng isang help option masyadong:
djboss echo help
paggamit: djboss echo [h] [n] [salita [salita ...]]
Echo ang argumento pabalik sa console.
posisyonal argumento:
& Nbsp; salita
opsyonal na mga argumento:
& Nbsp; h, help ipakita ang tulong na mensahe at exit
& Nbsp; n, --no-newline Huwag i-print ang isang newline pagkatapos.
At pagkatapos ay maaari mong patakbuhin ang mga ito:
djboss echo ilang mga salita dito
ilang mga salita dito
Higit pa sa mga parehong:
djboss hoy help
paggamit: djboss hoy [h]
I-print ang isang klisey sa console.
opsyonal na mga argumento:
& Nbsp; h, help ipakita ang tulong na mensahe at exit
At sa wakas:
djboss hoy
Hello, World

Kinakailangan :

• Django
• sawa