djinitx 0.2.0__tar.gz → 0.3.0__tar.gz

djinitx-0.3.0/.github/dependabot.yml

@@ -0,0 +1,16 @@
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    target-branch: "main"
+    rebase-strategy: "auto"
+
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    target-branch: "main"
+    rebase-strategy: "auto"
+    open-pull-requests-limit: 10

djinitx-0.3.0/.github/workflows/ci.yml

@@ -0,0 +1,46 @@
+name: CI
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+
+jobs:
+  lint-and-test:
+    name: Lint and Test
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.13"]
+
+    steps:
+    - uses: actions/checkout@v6
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v6
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install ruff
+        pip install -e .
+
+    - name: Lint with Ruff
+      run: |
+        ruff check djinit/
+
+    - name: Check formatting with Ruff
+      run: |
+        ruff format --check djinit/
+
+    - name: Test CLI import
+      run: |
+        python -c "from djinit.generator import main; print('Import successful')"
+
+    - name: Test console script entry point
+      run: |
+        djinit --help

djinitx-0.3.0/.github/workflows/codeql.yml

@@ -0,0 +1,33 @@
+name: CodeQL Analysis
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main ]
+  schedule:
+    - cron: '0 0 * * 1'  # Weekly on Monday
+
+jobs:
+  analyze:
+    name: CodeQL Security Analysis
+    runs-on: ubuntu-latest
+    permissions:
+      actions: read
+      contents: read
+      security-events: write
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v6
+
+    - name: Initialize CodeQL
+      uses: github/codeql-action/init@v4
+      with:
+        languages: python
+
+    - name: Autobuild
+      uses: github/codeql-action/autobuild@v4
+
+    - name: Perform CodeQL Analysis
+      uses: github/codeql-action/analyze@v4

djinitx-0.3.0/.github/workflows/dependabot-auto-merge.yml

@@ -0,0 +1,35 @@
+name: Dependabot Auto-Approve and Auto-Merge
+on:
+  pull_request_target:
+    types: [opened, reopened, synchronize]
+permissions:
+  contents: write
+  pull-requests: write
+jobs:
+  dependabot:
+    if: github.actor == 'dependabot[bot]'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Dependabot metadata
+        id: metadata
+        uses: dependabot/fetch-metadata@v2
+      - name: Approve PR
+        if: |
+          steps.metadata.outputs.update-type == 'version-update:semver-minor' ||
+          steps.metadata.outputs.update-type == 'version-update:semver-patch'
+        uses: actions/github-script@v8
+        with:
+          script: |
+            await github.rest.pulls.createReview({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              pull_number: context.payload.pull_request.number,
+              event: 'APPROVE'
+            })
+      - name: Enable auto-merge (squash)
+        if: |
+          steps.metadata.outputs.update-type == 'version-update:semver-minor' ||
+          steps.metadata.outputs.update-type == 'version-update:semver-patch'
+        uses: peter-evans/enable-pull-request-automerge@v3
+        with:
+          merge-method: squash

djinitx-0.3.0/.github/workflows/pre-commit.yml

@@ -0,0 +1,29 @@
+
+name: Pre-commit
+
+on:
+  pull_request:
+  push:
+    branches: [ main, develop ]
+
+jobs:
+  pre-commit:
+    name: Run Pre-commit Hooks
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v6
+
+    - name: Set up Python
+      uses: actions/setup-python@v6
+      with:
+        python-version: "3.13"
+
+    - name: Install pre-commit
+      run: |
+        python -m pip install --upgrade pip
+        pip install pre-commit
+
+    - name: Run pre-commit
+      run: |
+        pre-commit run --all-files

djinitx-0.3.0/.github/workflows/publish.yml

@@ -0,0 +1,27 @@
+name: Publish to PyPI
+on:
+  release:
+    types: [published]
+permissions:
+  contents: read
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    environment: release
+    permissions:
+      id-token: write # IMPORTANT: this permission is mandatory for trusted publishing
+    steps:
+    - uses: actions/checkout@v4
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.12'
+        cache: 'pip'
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install build twine
+    - name: Build package
+      run: python -m build
+    - name: Publish package to PyPI
+      run: python -m twine upload dist/* --verbose

djinitx-0.3.0/.pre-commit-config.yaml

@@ -0,0 +1,20 @@
+# Pre-commit hooks for djinit
+
+default_language_version:
+  python: python3.13
+
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.1.4
+    hooks:
+      - id: ruff
+        args: [--fix, --exit-non-zero-on-fix]
+      - id: ruff-format
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.5.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files

djinitx-0.3.0/.python-version

@@ -0,0 +1 @@
+3.13

djinitx-0.3.0/PKG-INFO

@@ -0,0 +1,291 @@
+Metadata-Version: 2.4
+Name: djinitx
+Version: 0.3.0
+Summary: A CLI tool to setup Django project
+Project-URL: Homepage, https://github.com/S4NKALP/djinit
+Author-email: Sankalp Tharu <sankalptharu50028@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: cli,dj,django,django project,django starter,django-init,djinit,djinitx,project
+Classifier: Environment :: Web Environment
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 4.2
+Classifier: Framework :: Django :: 5.1
+Classifier: Framework :: Django :: 5.2
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.13
+Requires-Dist: click>=8.3.0
+Requires-Dist: jinja2>=3.1.0
+Requires-Dist: pre-commit>=4.5.0
+Requires-Dist: rich>=14.2.0
+Requires-Dist: ruff>=0.14.2
+Description-Content-Type: text/markdown
+
+# djinit
+
+<div align="center">
+
+> PyPI didn't allow the original name, so you'll find it as **djinitx** on PyPI
+
+<img src="https://img.shields.io/pypi/v/djinitx?color=blue&label=PyPI&logo=pypi&logoColor=white" alt="PyPI">
+<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>
+
+</div>
+
+**djinit** helps you set up a production-ready Django project in minutes. No more copy-pasting settings or manually wiring up apps, just answer a few questions and get a modern Django project with REST API, authentication, documentation, and deployment configs ready to go.
+
+## Why djinit?
+
+Starting a Django project usually means spending hours setting up the same things: splitting settings for dev/prod, configuring DRF, adding JWT auth, setting up CORS, preparing for deployment. djinit does all of this for you with sensible defaults and lets you choose the project structure that fits your needs.
+
+## Installation
+
+**Recommended** (using pipx):
+
+```bash
+pipx install djinitx
+```
+
+Or with pip:
+
+```bash
+pip install djinitx
+```
+
+Or with uv:
+
+```bash
+uv tool install djinitx
+```
+
+**Requirements**: Python 3.13+
+
+## Getting Started
+
+Just run:
+
+```bash
+djinit setup
+```
+
+You can also use the shorter alias:
+
+```bash
+dj setup
+```
+
+The tool will ask you a few questions:
+
+1. **What structure do you want?**
+   - **Standard**: Classic Django layout with split settings
+   - **Predefined**: Organized with `apps/` and `api/` folders (great for larger projects)
+   - **Unified**: Everything under `core/` and `apps/` (clean and minimal)
+   - **Single Folder**: All apps in one configurable folder (simple and flat)
+
+2. **Project Setup**:
+   - Where to create it (use `.` for current directory)
+   - Project name (or directory name for Single Folder)
+
+3. **Database Configuration**:
+   - Use `DATABASE_URL` (cleaner, recommended)
+   - Or separate DB variables
+   - Choose between PostgreSQL or MySQL
+
+4. **Django Apps** (Standard Structure only):
+   - Whether to use an `apps/` folder
+   - Which apps to create
+
+5. **CI/CD Pipeline**:
+   - GitHub Actions, GitLab CI, both, or skip it
+
+That's it! Your project will be ready with everything configured.
+
+## What You Get
+
+Every project includes:
+
+- **Split settings** for development and production
+- **Django REST Framework** with JWT authentication
+- **API documentation** (Swagger UI at `/docs/`)
+- **CORS** configured for local development
+- **WhiteNoise** for serving static files
+- **PostgreSQL** support (SQLite for dev)
+- **Modern admin** interface (django-jazzmin)
+- **Deployment ready** with Procfile and runtime.txt
+- **Development tools** (Justfile with common commands)
+- **Environment template** (.env.sample)
+- **Git ready** (.gitignore included)
+
+## Commands
+
+### Create a Project
+
+```bash
+djinit setup
+```
+
+### Add Apps to Existing Project
+
+```bash
+djinit app users products orders
+```
+
+This automatically creates the apps, adds them to `INSTALLED_APPS`, and wires up URLs.
+
+### Generate Secret Keys
+
+```bash
+djinit secret
+```
+
+Need more? Use `--count 5` or change length with `--length 64`.
+
+## Project Structures
+
+### Standard Structure
+
+The classic Django layout with split settings:
+
+```
+myproject/
+├── manage.py
+├── myproject/          # Config module
+│   ├── settings/       # Split settings
+│   ├── urls.py
+│   └── wsgi.py
+└── apps/               # Your apps (optional)
+    └── users/
+```
+
+### Single Folder Layout
+
+Simple structure with all apps in one folder:
+
+```
+myproject/
+├── manage.py
+├── project/            # Configurable folder name
+│   ├── settings/
+│   ├── urls.py
+│   ├── models/         # All models here
+│   ├── api/            # API views and serializers
+│   │   └── your_model_name/
+│   │       ├── views.py
+│   │       ├── serializers.py
+│   │       └── urls.py
+│   └── wsgi.py
+```
+
+### Predefined Structure
+
+Organized for larger projects:
+
+```
+myproject/
+├── manage.py
+├── config/             # Django config
+│   ├── settings/
+│   └── urls.py
+├── apps/               # Business logic
+│   ├── users/
+│   └── core/
+└── api/                # API routes
+    └── v1/
+```
+
+### Unified Structure
+
+Clean and minimal:
+
+```
+myproject/
+├── manage.py
+├── core/               # Django config
+│   ├── settings/
+│   └── urls.py
+└── apps/               # Main application package
+    ├── admin/
+    ├── models/
+    ├── serializers/
+    ├── views/
+    ├── urls/
+    └── api/            # API routes
+```
+
+## Development Workflow
+
+Your project comes with a `Justfile` for common tasks:
+
+```bash
+just dev              # Start dev server
+just migrate          # Run migrations
+just makemigrations   # Create migrations
+just shell            # Django shell
+just test             # Run tests
+just format           # Format code
+just lint             # Lint code
+```
+
+Don't have `just` installed? No problem—these are just shortcuts for standard Django commands.
+
+## What's Included
+
+### Packages
+
+- Django (web framework)
+- Django REST Framework (API)
+- djangorestframework-simplejwt (JWT auth)
+- drf-spectacular (API docs)
+- django-cors-headers (CORS)
+- django-jazzmin (modern admin)
+- whitenoise (static files)
+- psycopg2-binary (PostgreSQL)
+- gunicorn (production server)
+- python-dotenv (environment variables)
+
+### API Endpoints
+
+- `/admin/` - Django admin
+- `/token/` - Get JWT token
+- `/token/refresh/` - Refresh token
+- `/docs/` - Swagger UI (dev only)
+- `/schema/` - OpenAPI schema (dev only)
+
+### Settings
+
+**Development**: SQLite, debug mode, console emails, permissive CORS
+**Production**: PostgreSQL, security hardened, SMTP emails, strict CORS
+
+## Environment Setup
+
+Copy `.env.sample` to `.env` and fill in your values:
+
+```bash
+SECRET_KEY=your-secret-key-here  # Use: djinit secret
+DATABASE_URL=postgres://user:pass@host:5432/db
+ALLOWED_HOSTS=yourdomain.com,www.yourdomain.com
+```
+
+For development, SQLite works out of the box—no database setup needed!
+
+## Contributing
+
+Found a bug or have an idea? Open an issue or submit a pull request. Contributions are always welcome!
+
+## License
+
+MIT © Sankalp Tharu