Skip to main content

Write Django management command using the click CLI library

Project description

Django Click

Project information:

https://img.shields.io/pypi/v/django-click.svg https://img.shields.io/pypi/dm/django-click.svg https://img.shields.io/badge/docs-TODO-lightgrey.svg https://img.shields.io/pypi/l/django-click.svg

Automated code metrics:

https://img.shields.io/travis/GaretJax/django-click.svg https://img.shields.io/coveralls/GaretJax/django-click/master.svg https://img.shields.io/codeclimate/github/GaretJax/django-click.svg https://img.shields.io/requires/github/GaretJax/django-click.svg

django-click is a library to easily write Django management commands using the click command line library.

  • Free software: MIT license

  • Documentation for the Click command line library: http://click.pocoo.org/6/

  • Compatible with Django 1.8, 1.10, and 1.11, running on Python 2.7, 3.4, 3.5, 3.6 and PyPy.

Installation

pip install django-click

Example

Create a command module as you would usually do, but instead of creating a class, just put a djclick command into <yourapp>/management/commands/helloworld.py:

import djclick as click

@click.command()
@click.argument('name')
def command(name):
    click.secho('Hello, {}'.format(name), fg='red')

And then call the command with:

$ ./manage.py helloworld django-click
Hello, django-click

Check out the test commands for additional example commands and advanced usage.

History

2.0.0 - 2017-06-30

  • Drop support for unsupported Django versions (1.4, 1.5, 1.6, and 1.7).

  • Add official support for Django 1.10 and 1.11.

  • Add official support for python 3.5 (all Django versions) and 3.6 (Django 1.11 only).

  • Correctly handle click errors by outputting the formatted messages instead of a stack trace (#4).

1.2.0 - 2016-05-19

  • Allow custom lookups on ModelInstance parameter types.

1.1.0 - 2016-02-04

  • Add a ModelInstance parameter type to automatically retrieve model instances by their primary key

1.0.0 – 2015-09-14

  • Support for command groups

  • Added a pass_verbosity decorator

  • Improved test suite

0.1.1 – 2015-09-11

  • Django 1.4, 1.5, 1.6, 1.7 and 1.8 compatibility

  • Python 2.7 and 3.4 compatibility

  • 100% coverage test suite

0.1.0 – 2015-09-10

  • Initial release

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-click-2.0.0.tar.gz (8.4 kB view hashes)

Uploaded Source

Built Distribution

django_click-2.0.0-py2.py3-none-any.whl (8.5 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page