Skip to main content

CLI for creating and managing Django projects

Project description

django-clite

A CLI tool that handles creating and managing Django projects

publish PyPI - Package PyPI - Python PyPI - License PyPI - Downloads

Installation

Install via pip:

pip install django-clite

After installation, the CLI will expose the binary with the name:

django-clite

Extending the CLI

Currently, there are two main ways of extending the functionality of the CLI:

  1. Adding your own commands/plugins
  2. Overriding the provided resource templates

Including your own commands

If you would like to extend the functionality of this CLI, you can include your own plugins/commands by setting an environment variable: DJANGO_CLITE_PLUGINS. Simply set this variable to the path where your plugins are.

Plugin commands are auto-discovered if they are placed under the plugins directory, but please be sure to do the following for this to work:

  1. Name your package and click command the same. That is, a package called get, for example, should define a get command.
  2. Place the command definition within the package's main.py module. For example:
# get/main.py
import click


@click.command()
@click.pass_context
def get(ctx):
    pass
  1. Sub-commands should be added to the top-most command group in the package's main.py module.
# get/main.py
import click


@click.group() # <- group
@click.pass_context
def get(ctx):
  pass


@click.command()
@click.pass_context
def foo(ctx):
  pass


get.add_command(foo)
  1. Access your commands via your top-most command group.
django-clite get foo

NOTE: If you would like to skip a plugin/command from being auto-discovered, simply rename the package by either prepending or appending any number of underscores (_). Any code contained within the package will be ignored.

Overriding the templates

The flag --templates-dir can be used to configure an additional path wherein the CLI can look for resource templates. Alternatively, you can use the environment variable DJANGO_CLITE_TEMPLATES_DIR for the same purpose.

Take a look at the template files directory for a reference of what files can be overriden. The paths of the templates you wish to override need to match the provided template. For example, if you wish to override the model template, which is defined under src/cli/template_files/models/model.tpl, you should define your own model template under your desired directory, i.e /path/to/templates/models/model.tpl.

Development

Install from source:

git clone https://github.com/oleoneto/django-clite.git
cd django-clite
pip install --editable .

Dependencies

Check out pyproject.toml for all installation dependencies.

Interactive Docs

In order to maintain consistency in our documentation of all the different commands and features of the CLI, we've decided to move the README to a series of Jupyter notebooks which you can explore per command under the docs directory.

To Do

Check out our open issues.

Pull requests

Found a bug? See a typo? Have an idea for new command? Feel free to submit a pull request with your contributions. They are much welcome and appreciated.

LICENSE

django-clite is BSD Licensed.

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_clite-0.19.7.tar.gz (47.9 kB view details)

Uploaded Source

Built Distribution

django_clite-0.19.7-py3-none-any.whl (80.8 kB view details)

Uploaded Python 3

File details

Details for the file django_clite-0.19.7.tar.gz.

File metadata

  • Download URL: django_clite-0.19.7.tar.gz
  • Upload date:
  • Size: 47.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.2

File hashes

Hashes for django_clite-0.19.7.tar.gz
Algorithm Hash digest
SHA256 b88d662ca10049432c772652a7552b82bd5c691157c73e73a690828ae3fa23c6
MD5 dfe3e31f4b6edc8f8905ddba7b060793
BLAKE2b-256 b1f2e35c6bcd14b39dfd37d788ca8319e553934a7a6f634d6d6f53ade804563d

See more details on using hashes here.

File details

Details for the file django_clite-0.19.7-py3-none-any.whl.

File metadata

  • Download URL: django_clite-0.19.7-py3-none-any.whl
  • Upload date:
  • Size: 80.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.2

File hashes

Hashes for django_clite-0.19.7-py3-none-any.whl
Algorithm Hash digest
SHA256 df28286537c4571a24b26cd6e11d9a8d5a7d25010492c38ea7260aa04a23f022
MD5 69750116ae38d9789c859995a2fff584
BLAKE2b-256 9624e68367109bffde99fae5183490c84591974b93f578b8f464238830611691

See more details on using hashes here.

Supported by

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