Metadata-Version: 2.1
Name: django-hogwarts
Version: 0.9.0
Summary: Django utilities for codegen and DX improvement
Home-page: https://github.com/adiletto64/django-hogwarts
Keywords: django,django-utils,codegen
Author: adiletto64
Author-email: adiletdj19@gmail.com
Requires-Python: >=3.9,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: Jinja2 (>=3.1.2,<4.0.0)
Requires-Dist: rich (>=13.5.2,<14.0.0)
Project-URL: Documentation, https://django-hogwarts.vercel.app/
Project-URL: Repository, https://github.com/adiletto64/django-hogwarts
Description-Content-Type: text/markdown

<h1 align="center">Django hogwarts 🧙‍♂️</h1>
<h4 align="center">Management commands to generate views, urls and templates</h4>

Use CLI commands to generate:
- basic create, update, list, detail views
- urlpatterns from views with REST like path urls
- form, table, detail templates (Bootstrap and django-crispy-forms by default)

**all commands will respect (will not change) existing code**

---

## Installation
```shell
# pip
pip install django-hogwarts

# poetry
poetry add django-hogwarts
```

add `hogwarts` to your `INSTALLED_APPS`:
``` python
INSTALLED_APPS = [
    ...
    "hogwarts"
]
```

## Usage
> Check [this](./docs/conventions.md) to know what urls will be generated
### Generate urls.py
Generates paths for views from views.py
```
python manage.py genurls <your-app-name>
```

Arguments:
- `--force-app-name`, `fan` override app_name variable in urls.py 
- `--override`, `-o` fully overrides existing code in urls.py (previous code will be deleted)
- `--single-import`, `-s` instead of importing individual view, imports just module`from . import views`

### Generate views.py
Generates create, update, detail, list views for model.
Checkout the [demo](./docs/gen_views_example.md)
```
python manage.py genviews <your-app-name> <model-name>
```
Arguments
- `--smart-mode`, `-s` adds login required, sets user for CreateView and checks if client is owner of object in UpdateView
- `--model-is-namespace`, `-mn` adds success_url with name model as [namespace](https://docs.djangoproject.com/en/4.2/topics/http/urls/#url-namespaces)
- `--file`, `-f` specify view file (example: "views/posts_view.py" or "new_views.py") in your app

### Generate tests.py
It generates tests from urls.py for CRUD generic views only
``` 
python manage.py gentests <your-app-name>
```

### Generate templates
Generates templates from `template_name`s from views from given app

**[django-crispy-forms](https://github.com/django-crispy-forms/django-crispy-forms) and
[crispy-bootstrap5](https://github.com/django-crispy-forms/crispy-bootstrap5) packages are required**

``` 
python manage.py gentemplates <your-app-name>
```

Want to create own scaffolding templates? 
1. create folder, copy and customize from [this templates](https://github.com/adiletto64/django-hogwarts/tree/master/hogwarts/scaffold)
2. add that folder to setting `HOGWARTS_SCAFFOLD_FOLDER = "<your-folder>"`

### Scaffolding

Generates views, urls and templates for given app (every model in app)

``` 
python manage.py scaffold <your-app-name>
```


## Roadmap
- tests generator
- maybe rest-framework support (let me know in issues)



