chore: update README and pyproject.toml with project description and dependencies
This commit is contained in:
2 files changed
+150
-10
No files matched your search
@@ -0,0 +1,140 @@
|
||||
# djinit
|
||||
|
||||
<p align="center">
|
||||
<img src="https://img.shields.io/badge/Django-4.2%20%7C%205.1%20%7C%205.2-0C4B33?logo=django&logoColor=white" alt="Django">
|
||||
<img src="https://img.shields.io/badge/Python-3.13%2B-3776AB?logo=python&logoColor=white" alt="Python">
|
||||
<a href="https://github.com/S4NKALP/djinit/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License"></a>
|
||||
</p>
|
||||
|
||||
A fast, interactive CLI to bootstrap a modern, production‑ready Django project in minutes — featuring split settings, DRF and JWT integration, OpenAPI docs, CORS, static file handling via WhiteNoise, Postgres‑friendly configuration, CI/CD templates, deployment helpers, and battle‑tested defaults that deliver a polished developer experience out of the box.
|
||||
|
||||
- ✨ Split settings: `settings/base.py`, `settings/development.py`, `settings/production.py`
|
||||
- 🧱 Optional nested apps layout (e.g., `apps/`)
|
||||
- 🧩 App scaffolding: URLs, serializers, routes
|
||||
- 🔗 Project URLs wired automatically
|
||||
- 🧰 Utility files: `.gitignore`, `README.md`, `.env.sample`, `requirements.txt`, `pyproject.toml`
|
||||
- 🚀 Deploy helpers: `Justfile`, `Procfile`, `runtime.txt`
|
||||
- 🛠️ CI/CD: GitHub Actions and/or GitLab CI
|
||||
- 🎨 Polished UX with `rich`
|
||||
|
||||
---
|
||||
|
||||
## Demo
|
||||
|
||||
|
||||
|
||||
Tip: If the GIF doesn't load, open `docs/demo.gif` or view it on the repository page.
|
||||
|
||||
## Installation
|
||||
|
||||
Using pipx (recommended):
|
||||
|
||||
```bash
|
||||
pipx install git+https://github.com/S4NKALP/djinit
|
||||
```
|
||||
|
||||
Using pip (user space):
|
||||
|
||||
```bash
|
||||
pip install --user git+https://github.com/S4NKALP/djinit
|
||||
```
|
||||
|
||||
From source:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/S4NKALP/djinit
|
||||
cd djinit
|
||||
pip install -e .
|
||||
```
|
||||
|
||||
Requirements: Python 3.13+
|
||||
|
||||
## Quick start
|
||||
|
||||
Run the interactive setup:
|
||||
|
||||
```bash
|
||||
djinit setup
|
||||
```
|
||||
|
||||
Prompts include:
|
||||
|
||||
- Project directory
|
||||
- Django project name (used by `django-admin startproject`)
|
||||
- Apps layout (flat vs nested package like `apps/`)
|
||||
- App names (comma‑separated)
|
||||
- CI/CD choice (GitHub, GitLab, both, none)
|
||||
- Database config preference (`DATABASE_URL` vs individual params)
|
||||
|
||||
## Commands
|
||||
|
||||
- `djinit setup` — Launch the interactive project generator
|
||||
- `djinit app <names>` — Create one or more Django apps in an existing project
|
||||
- Examples:
|
||||
- `djinit app users`
|
||||
- `djinit app users,products,orders`
|
||||
- `djinit app users products orders`
|
||||
- `djinit secret [--count N] [--length L]` — Print random Django `SECRET_KEY` values
|
||||
- Example: `djinit secret --count 5 --length 50`
|
||||
|
||||
## What gets generated
|
||||
|
||||
- Django project and apps, then structure validation
|
||||
- Settings package and split settings
|
||||
- Base/development/production settings
|
||||
- Utility files
|
||||
- App files: `urls.py`, `serializers.py`, `routes.py`
|
||||
- Project `urls.py` (auto‑includes your apps)
|
||||
- Updated `wsgi.py`, `asgi.py`, `manage.py`
|
||||
- `Justfile`, `Procfile`, `runtime.txt`
|
||||
- CI/CD workflows (per your selection)
|
||||
|
||||
### Output highlights
|
||||
|
||||
- `config/settings/` → `__init__.py`, `base.py`, `development.py`, `production.py`
|
||||
- `apps/<app>/` → `urls.py`, `serializers.py`, `routes.py`
|
||||
- Project root → `.gitignore`, `README.md`, `.env.sample`, `requirements.txt`, `pyproject.toml`, `Justfile`, `Procfile`, `runtime.txt`
|
||||
- CI/CD → `.github/workflows/` and/or `.gitlab-ci.yml`
|
||||
|
||||
Note: If you choose a nested apps package (e.g., `apps`), imports and `INSTALLED_APPS` entries are configured accordingly.
|
||||
|
||||
## Included packages (by default)
|
||||
|
||||
Generated `requirements.txt` includes:
|
||||
|
||||
- Django
|
||||
- python-dotenv
|
||||
- django-jazzmin
|
||||
- djangorestframework
|
||||
- djangorestframework-simplejwt
|
||||
- drf-spectacular
|
||||
- django-cors-headers
|
||||
- whitenoise
|
||||
- psycopg2-binary
|
||||
- gunicorn
|
||||
- dj-database-url (when you opt into `DATABASE_URL`)
|
||||
|
||||
These give you a ready‑to‑use stack with DRF, JWT auth, OpenAPI schema generation, CORS, static files in production, and Postgres support.
|
||||
|
||||
## Environment and database
|
||||
|
||||
- A `.env.sample` is generated to get you started.
|
||||
- If you opt into `DATABASE_URL`, `production.py` expects an environment variable like:
|
||||
`postgres://user:password@host:port/database`
|
||||
|
||||
## Contributing
|
||||
|
||||
Contributions are welcome!
|
||||
Please open an issue for bugs/ideas. PRs with clear descriptions are appreciated.
|
||||
|
||||
## Acknowledgments
|
||||
|
||||
- Django and the Django community
|
||||
- Jinja2
|
||||
- rich
|
||||
- click
|
||||
- ruff
|
||||
|
||||
## License
|
||||
|
||||
MIT © Sankalp Tharu
|
||||
@@ -6,16 +6,16 @@ readme = "README.md"
|
||||
requires-python = ">=3.13"
|
||||
license = { text = "MIT" }
|
||||
dependencies = [
|
||||
"django>=5.2.7",
|
||||
"python-dotenv>=1.1.1",
|
||||
"django-jazzmin>=3.0.1",
|
||||
"djangorestframework>=3.16.1",
|
||||
"djangorestframework-simplejwt>=5.5.1",
|
||||
"drf-spectacular>=0.28.0",
|
||||
"django-cors-headers>=4.9.0",
|
||||
"whitenoise>=6.8.2",
|
||||
"psycopg2-binary>=2.9.9",
|
||||
"gunicorn>=21.2.0",
|
||||
"django",
|
||||
"python-dotenv",
|
||||
"django-jazzmin",
|
||||
"djangorestframework",
|
||||
"djangorestframework-simplejwt",
|
||||
"drf-spectacular",
|
||||
"django-cors-headers",
|
||||
"whitenoise",
|
||||
"psycopg2-binary",
|
||||
"gunicorn",
|
||||
]
|
||||
|
||||
[tool.ruff]
|
||||
|
||||
Reference in new issue
Block a user