django-boss Django management commands, revisited
Download

django-boss Ranking & Summary

django-boss Tags

management Django Commands Django plugin Django management management commands

django-boss Description

Django management commands, revisited django-boss is an implementation of the ideas outlined in my blog post on Django management commands. With it, you can specify commands in individual apps and then run them using the djboss command-line interface.Installing django-bossAt the moment, installation is done via easy_install django-boss or pip install django-boss. The only prerequisites are argparse, whose installation is handled by setuptools, and Django, which you should have installed by now anyway.Writing CommandsCommands are defined as instances of djboss.commands.Command, present in a commands submodule inside an installed app. For example, take the following app layout:echoapp/|-- __init__.py|-- commands.py`-- models.pyThe commands.py file is a submodule that can be imported as echoapp.commands.With DecoratorsThe following is a complete example of a valid commands.py file:from djboss.commands import *@commanddef hello(args): """Print a cliche to the console.""" print "Hello, World!"This example uses the @command decorator to declare that the function is a django-boss command. You can add arguments to commands too; just use the @argument decorator (make sure they come after the @command):@command@argument('-n', '--no-newline', action='store_true', help="Don't append a trailing newline.")def hello(args): """Print a cliche to the console.""" if args.no_newline: import sys sys.stdout.write("Hello, World!") else: print "Hello, World!"The @argument decorator accepts whatever argparse.ArgumentParser.add_argument() does; consult the argparse docs for more information.You can also annotate commands by giving keyword arguments to @command:@command(name="something", description="Does something.")def do_something(args): """Do something.""" print "something has been done."In this case, the command will be called "something" instead of the auto-generated "do-something", and its description will differ from its docstring. For more information on what can be passed in here, consult the argparse.ArgumentParser docs.Without DecoratorsThe API is very similar without decorators. The Command class is used to wrap functions, and you can give keyword arguments when invoking it as with @command:def echo(args): ...echo = Command(echo, name='...', description='...')Adding arguments uses the Command.add_argument() method, which is just a reference to the generated sub-parser’s add_argument() method:def echo(args): ...echo = Command(echo, name='...', description='...')echo.add_argument('-n', '--no-newline', ...)echo.add_argument('words', nargs='*')Running CommandsCommands are executed via the djboss command-line interface. For this to run correctly, you need one of two things:* A DJANGO_SETTINGS_MODULE environment variable which refers to a valid, importable Python module.* A valid, importable settings module in the current working directory.Once one of those is covered, you can run it:djboss --helpusage: djboss COMMAND ...Run django-boss management commands.optional arguments: -h, --help show this help message and exit -v, --version show program's version number and exit -l LEVEL, --log-level LEVEL Choose a log level from DEBUG, INFO, WARN (default) or ERROR.commands: COMMAND echo Echo the arguments back to the console. hello Print a cliche to the console.To discover sub-commands, djboss first finds and imports your Django settings.The DJANGO_SETTINGS_MODULE environment variable takes precedence, but if unspecified, djboss will look for a `settings` module in the current directory. Commands should be defined in a `commands` submodule of each app. djboss will search each of your INSTALLED_APPS for management commands.Each subcommand gets a --help option too:djboss echo --helpusage: djboss echo ]Echo the arguments back to the console.positional arguments: wordsoptional arguments: -h, --help show this help message and exit -n, --no-newline Don't print a newline afterwards.And then you can run it:djboss echo some words heresome words hereMore of the same:djboss hello --helpusage: djboss hello Print a cliche to the console.optional arguments: -h, --help show this help message and exitAnd finally:djboss helloHello, World! Requirements: · Django · Python

django-boss Related Software