CLI Tools

CLI Tools#

This page explains the CLI Helpers shipped by the Dynamic Django starter.

👉 New to App-Generator? Sign IN with GitHub or Generate Web Apps in no time (free service).

Usage - Import CLI Package#

The CLI helpers are located in the cli package, root of the codebase:

Project Files#
< Dynamic Django >  |  |-- core/  | |-- settings.py # Project Configuration  |  |-- cli/ # CLI Package  |-- __init__.py # The entry point  |-- common.py # Constants  |-- h_code_parser.py # AST-based helpers  |-- h_files.py # Filesystem Helpers  |-- h_git.py # GIT Interface  |-- h_shell.py # Shell Interface  |-- h_django.py # DJANGO specific helpers  |-- h_django_deps.py # Manage Project dependencies  |-- h_django_env.py # Manage ENV  |-- h_django_settings.py # Manage Settings  |-- h_django_urls.py # Manage Routing

The cli package can be used in the Django Shell, but also outside Django in Python shell

Import CLI helpers#
# Usage via Django Shell python manage.py shell >>> from cli import * # Usage via Python Shell python >>> from cli import *

In both ways, the Django machinery is available.

GIT CLI#

The Git Interface defined in cli/h_git.py aims to help beginners to interact with the GitHub platform using simplified commands.

git_changes()

Print current changes and modified files. Here is a sample output:

git_changes() output#
>>> from cli import * >>> git_changes() .env core/settings.py db.sqlite3 django_dyn_api/helpers.py home/models.py git_log()

Print the latest changes made on the codebase

Dynamic Django - Git CLI, the output of git_log() helper

Shell Helpers#

Using the shell interface we can check the Django migration status, migrate the Database, create an ADMIN user or start the project using a custom PORT.

check_migrations()

Check migrations status

exec_migration()

Migrate the database

create_admin()

Create a superuser using the input collected from the terminal

Code Parser#

This helper allows to get Python classes using reflection and also we can inject code in existing classes and models

name_to_class(name: str)

This helper will return the a Python class instance if the input string identifies an imported class.

name_to_class() usage and output#
>>> from cli import * >>> product = name_to_class('home.models.Product') >>> product.objects.all() <QuerySet [<Product: Nike / $99>, <Product: PUMA / $99>, <Product: Jordan 5 / $99>, <Product: Jordan 4 / $199>, <Product: Jordan 1 / $499>]> PythonFileClassManipulator - Interface to the AST code structure

This class is heavily used to update the code via primitives like add_model(), add_model_field() ..etc.

Django Helpers#

The Django Interface defined in cli/h_django.py aims to make easier the interaction with all Django internal structures and entities like applications, configuration.

get_django()

Initiate Django in Python shell outside manage.py shell command. This is important when we need to interact with Django core from a bash shell.

check_db_conn()

Check if the DB credentials are correct and the codebase can work as expected.

get_apps()

List all registered application in settings.INSTALLED_APPS section

get_models(aApp) - returs objects

List all models defined in an application

get_models_name(aApp) - returs strings

List the models names defined in an application

get_model_fields(aModelClass)

Returns all class fields

get_model_fk(aModelClass)

Returns all fields that are Foreign Keys

add_model(aAppName, aModelName)

Adds a new model to axisting application

add_model_field(aAppName, aModelName, aFieldName, aFieldType, **kwargs)

Added a specific field to a model

del_model_field(aAppName, aModelName, aFieldName)

Delete field from an existing model