djboost 0.1.0__py3-none-any.whl

djboost/__init__.py

@@ -0,0 +1 @@
+# init

djboost/cli.py

@@ -0,0 +1,37 @@
+import typer
+from djboost.commands.create_project import create_project_command
+from djboost.commands.create_app import create_app_command
+from djboost.commands.add_cicd import add_cicd_command
+from djboost.commands.remove_cicd import remove_cicd_command
+
+app = typer.Typer(help="djboost — Django project generator CLI")
+create = typer.Typer(help="Create a new project or app")
+add = typer.Typer(help="Add integrations to your project")
+remove = typer.Typer(help="Remove integrations from your project")
+
+app.add_typer(create, name="create")
+app.add_typer(add, name="add")
+app.add_typer(remove, name="remove")
+
+create.command("project")(create_project_command)
+create.command("app")(create_app_command)
+add.command("cicd")(add_cicd_command)
+remove.command("cicd")(remove_cicd_command)
+
+
+def version_callback(value: bool):
+    if value:
+        typer.echo("djboost version 0.1.0")
+        raise typer.Exit()
+
+
+@app.callback()
+def main(
+    version: bool = typer.Option(
+        None, "--version", "-v",
+        callback=version_callback,
+        is_eager=True,
+        help="Show the version and exit."
+    )
+):
+    pass

djboost/commands/__init__.py

@@ -0,0 +1 @@
+# init

djboost/commands/add_cicd.py

@@ -0,0 +1,16 @@
+import typer
+from rich import print
+from djboost.generator import generate_github_actions, generate_gitlab_ci, check_virtual_environment
+
+def add_cicd_command(provider: str = typer.Argument(..., help="The CI/CD provider to add (github or gitlab)")):
+    check_virtual_environment()
+    provider = provider.lower()
+    if provider == "github":
+        generate_github_actions()
+        print("[green]GitHub Actions workflow created successfully![/green]")
+    elif provider == "gitlab":
+        generate_gitlab_ci()
+        print("[green]GitLab CI pipeline created successfully![/green]")
+    else:
+        print(f"[red]Error: Unsupported provider '{provider}'. Supported providers are: github, gitlab.[/red]")
+        raise typer.Exit(code=1)

djboost/commands/create_app.py

@@ -0,0 +1,130 @@
+import re
+import sys
+import subprocess
+from pathlib import Path
+import typer
+from rich import print
+from djboost.generator import check_virtual_environment, validate_name
+
+
+def get_project_name():
+    if not Path("manage.py").exists():
+        print("[red]Error: manage.py not found. Are you in the project root?[/red]")
+        raise typer.Exit(1)
+
+    content = Path("manage.py").read_text(encoding="utf-8")
+    match = re.search(r"['\"]DJANGO_SETTINGS_MODULE['\"],\s*['\"]([^.]+)\.settings['\"]", content)
+    if match:
+        return match.group(1)
+
+    print("[red]Error: Could not determine project name from manage.py[/red]")
+    raise typer.Exit(1)
+
+
+def update_settings(project_name: str, app_name: str):
+    settings_path = Path(project_name) / "settings.py"
+    if not settings_path.exists():
+        print(f"[yellow]Warning: Could not find settings.py at {settings_path}. Skipping.[/yellow]")
+        return
+
+    content = settings_path.read_text(encoding="utf-8")
+    app_string = f"'apps.{app_name}',"
+
+    if app_string in content or f'"apps.{app_name}",' in content:
+        print(f"[yellow]App '{app_name}' is already in INSTALLED_APPS[/yellow]")
+        return
+
+    if "INSTALLED_APPS = [" in content:
+        content = re.sub(
+            r"(INSTALLED_APPS\s*=\s*\[.*?)(\n?\])",
+            rf"\1\n    {app_string}\2",
+            content,
+            flags=re.DOTALL
+        )
+        settings_path.write_text(content, encoding="utf-8")
+        print(f"[green]✔ Added '{app_string}' to INSTALLED_APPS[/green]")
+    else:
+        print("[yellow]Warning: Could not find INSTALLED_APPS in settings.py[/yellow]")
+
+
+def update_urls(project_name: str, app_name: str):
+    urls_path = Path(project_name) / "urls.py"
+    if not urls_path.exists():
+        print(f"[yellow]Warning: Could not find urls.py at {urls_path}. Skipping.[/yellow]")
+        return
+
+    content = urls_path.read_text(encoding="utf-8")
+
+    if f"apps.{app_name}.urls" in content:
+        print(f"[yellow]App '{app_name}' is already mapped in urls.py[/yellow]")
+        return
+
+    if "include" not in content:
+        content = re.sub(r"(from django\.urls import.*?path)", r"\1, include", content)
+
+    if "urlpatterns = [" in content:
+        content = content.replace(
+            "urlpatterns = [",
+            f"urlpatterns = [\n    path('api/{app_name}/', include('apps.{app_name}.urls')),"
+        )
+        urls_path.write_text(content, encoding="utf-8")
+        print(f"[green]✔ Mapped /api/{app_name}/ in {project_name}/urls.py[/green]")
+    else:
+        print("[yellow]Warning: Could not find urlpatterns in urls.py[/yellow]")
+
+
+def create_app_urls(app_name: str):
+    urls_path = Path("apps") / app_name / "urls.py"
+    content = f"""from django.urls import path
+from . import views
+
+app_name = '{app_name}'
+
+urlpatterns = [
+    # path('', views.MyView.as_view(), name='my-view'),
+]
+"""
+    urls_path.write_text(content, encoding="utf-8")
+
+
+def create_app_command(name: str = typer.Argument(..., help="The name of the Django app to create")):
+    check_virtual_environment()
+    validate_name(name, "app name")
+
+    if not Path("manage.py").exists():
+        print("[red]Error: manage.py not found. Run this command from your Django project root.[/red]")
+        raise typer.Exit(1)
+
+    app_path = Path("apps") / name
+    if app_path.exists():
+        print(f"[red]Error: App '{name}' already exists at apps/{name}.[/red]")
+        raise typer.Exit(1)
+
+    Path("apps").mkdir(exist_ok=True)
+
+    print(f"[cyan]Creating app '{name}'...[/cyan]")
+    result = subprocess.run(
+        [sys.executable, "manage.py", "startapp", name, f"apps/{name}"],
+        capture_output=True, text=True
+    )
+    if result.returncode != 0:
+        print(f"[red]Error creating app:\n{result.stderr}[/red]")
+        raise typer.Exit(1)
+
+    (Path(f"apps/{name}") / "__init__.py").touch()
+
+    # Fix apps.py name
+    apps_py_path = Path(f"apps/{name}/apps.py")
+    if apps_py_path.exists():
+        apps_content = apps_py_path.read_text(encoding="utf-8")
+        apps_content = re.sub(rf"name\s*=\s*['\"]{name}['\"]", f"name = 'apps.{name}'", apps_content)
+        apps_py_path.write_text(apps_content, encoding="utf-8")
+
+    try:
+        project_name = get_project_name()
+        update_settings(project_name, name)
+        update_urls(project_name, name)
+        create_app_urls(name)
+        print(f"[bold green]✅ App '{name}' created and configured successfully![/bold green]")
+    except Exception as e:
+        print(f"[red]Error during auto-configuration: {str(e)}[/red]")

djboost/commands/create_project.py

@@ -0,0 +1,6 @@
+import typer
+from djboost.generator import create_project
+
+
+def create_project_command(name: str = typer.Argument("core", help="The name of the Django project")):
+    create_project(name)

djboost/commands/remove_cicd.py

@@ -0,0 +1,34 @@
+import os
+import shutil
+import typer
+from rich import print
+from djboost.generator import check_virtual_environment
+
+def remove_cicd_command(provider: str = typer.Argument(..., help="The CI/CD provider to remove (github or gitlab)")):
+    check_virtual_environment()
+    provider = provider.lower()
+    if provider == "github":
+        github_dir = ".github"
+        if os.path.exists(github_dir):
+            try:
+                shutil.rmtree(github_dir)
+                print("[green]GitHub Actions workflow removed successfully![/green]")
+            except Exception as e:
+                print(f"[red]Failed to remove GitHub Actions workflow: {e}[/red]")
+        else:
+            print("[yellow]GitHub Actions workflow is not present in this project.[/yellow]")
+            
+    elif provider == "gitlab":
+        gitlab_file = ".gitlab-ci.yml"
+        if os.path.exists(gitlab_file):
+            try:
+                os.remove(gitlab_file)
+                print("[green]GitLab CI pipeline removed successfully![/green]")
+            except Exception as e:
+                print(f"[red]Failed to remove GitLab CI pipeline: {e}[/red]")
+        else:
+            print("[yellow]GitLab CI pipeline is not present in this project.[/yellow]")
+            
+    else:
+        print(f"[red]Error: Unsupported provider '{provider}'. Supported providers are: github, gitlab.[/red]")
+        raise typer.Exit(code=1)

djboost/generator.py

@@ -0,0 +1,880 @@
+import os
+import sys
+import subprocess
+import re
+from pathlib import Path
+from rich import print
+from rich.console import Console
+
+console = Console()
+
+
+def check_virtual_environment():
+    """Check if user is inside a virtual environment."""
+    in_venv = (
+        hasattr(sys, 'real_prefix') or
+        (hasattr(sys, 'base_prefix') and sys.base_prefix != sys.prefix)
+    )
+    if not in_venv:
+        print("[bold red]⚠ You are not inside a virtual environment![/bold red]")
+        print("[yellow]Please create and activate a virtual environment first:[/yellow]")
+        print()
+        print("  [cyan]python -m venv env[/cyan]")
+        print()
+        print("  [cyan]# Windows:[/cyan]")
+        print("  [cyan]env\\Scripts\\activate[/cyan]")
+        print()
+        print("  [cyan]# Mac/Linux:[/cyan]")
+        print("  [cyan]source env/bin/activate[/cyan]")
+        print()
+        import typer
+        raise typer.Exit(1)
+
+
+def validate_name(name: str, label: str = "name"):
+    """Validate that name is a valid Python identifier."""
+    if not name.isidentifier():
+        print(f"[red]Error: '{name}' is not a valid {label}. Use only letters, numbers, and underscores. Must not start with a number.[/red]")
+        import typer
+        raise typer.Exit(1)
+    if name[0].isdigit():
+        print(f"[red]Error: '{name}' must not start with a digit.[/red]")
+        import typer
+        raise typer.Exit(1)
+
+
+def update_settings_file(settings_path: str, name: str):
+    with open(settings_path, "r", encoding="utf-8") as f:
+        content = f.read()
+
+    # Extract the original SECRET_KEY generated by Django
+    match = re.search(r"SECRET_KEY\s*=\s*(['\"].*?['\"])", content)
+    secret_key = match.group(1) if match else "'your-secret-key-here'"
+
+    # 1. Add imports at the top
+    content = content.replace(
+        "from pathlib import Path",
+        "from pathlib import Path\nfrom datetime import timedelta\nfrom celery.schedules import crontab\nfrom decouple import config"
+    )
+
+    # 2. Update SECRET_KEY, DEBUG, ALLOWED_HOSTS
+    content = re.sub(r"SECRET_KEY = .*", "SECRET_KEY = config('SECRET_KEY')", content)
+    content = re.sub(r"DEBUG = .*", "DEBUG = config('DEBUG', default=False, cast=bool)", content)
+    content = re.sub(
+        r"ALLOWED_HOSTS = .*", 
+        "ALLOWED_HOSTS = config('ALLOWED_HOSTS', default='localhost', cast=lambda v: [s.strip() for s in v.split(',')])", 
+        content
+    )
+
+    # 3. Update INSTALLED_APPS
+    apps_addition = """    'corsheaders',
+    'rest_framework',
+    'rest_framework_simplejwt',
+    'rest_framework_simplejwt.token_blacklist',
+    'channels',
+    'channels_redis',
+    'drf_spectacular',"""
+    content = re.sub(
+        r"['\"]django\.contrib\.staticfiles['\"],",
+        f"'daphne',\n    'django.contrib.staticfiles',\n{apps_addition}",
+        content
+    )
+
+    # 4. Update MIDDLEWARE
+    content = content.replace(
+        "MIDDLEWARE = [",
+        "MIDDLEWARE = [\n    'corsheaders.middleware.CorsMiddleware',\n    'whitenoise.middleware.WhiteNoiseMiddleware',"
+    )
+
+    # 5. Update DATABASES
+    db_config = """DATABASES = {
+    'default': {
+        'ENGINE': config("DB_ENGINE", default="django.db.backends.sqlite3"),
+        'NAME': config('DB_NAME', default=BASE_DIR / 'db.sqlite3'),
+        'USER': config('DB_USER', default=''),
+        'PASSWORD': config('DB_PASSWORD', default=''),
+        'HOST': config('DB_HOST', default='localhost'),
+        'PORT': config('DB_PORT', default=5432, cast=int),
+        'CONN_MAX_AGE': config('CONN_MAX_AGE', default=600, cast=int),
+    }
+}"""
+    content = re.sub(r"DATABASES\s*=\s*\{.*?\}\s*\}", db_config, content, flags=re.DOTALL)
+
+    # 6. Update WSGI / ASGI
+    content = re.sub(
+        rf"WSGI_APPLICATION\s*=\s*['\"]{name}\.wsgi\.application['\"]",
+        f"WSGI_APPLICATION = '{name}.wsgi.application'\nASGI_APPLICATION = '{name}.asgi.application'",
+        content
+    )
+
+    # 6.5 Update Static / Media Files
+    static_media_config = """STATIC_URL = '/static/'
+MEDIA_URL = '/media/'
+
+STATICFILES_DIRS = [BASE_DIR / 'static']
+STATIC_ROOT = BASE_DIR / 'assets'
+MEDIA_ROOT = BASE_DIR / 'media'"""
+    content = re.sub(r"STATIC_URL\s*=\s*['\"]static/['\"]", static_media_config, content)
+
+    # 7. Append custom configurations at the end
+    custom_configs = """
+
+# ── Caching Configuration (Redis) ─────────────────────────────────────────────
+CACHES = {
+    "default": {
+        "BACKEND": "django.core.cache.backends.redis.RedisCache",
+        "LOCATION": config("REDIS_URL", default="redis://127.0.0.1:6379/1"),
+    }
+}
+
+# ── Security & Performance Settings ───────────────────────────────────────────
+SECURE_BROWSER_XSS_FILTER = True
+SECURE_CONTENT_TYPE_NOSNIFF = True
+X_FRAME_OPTIONS = 'DENY'
+STORAGES = {
+    "staticfiles": {
+        "BACKEND": "whitenoise.storage.CompressedManifestStaticFilesStorage",
+    },
+}
+
+# ── Channels Configuration ────────────────────────────────────────────────────
+CHANNEL_LAYERS = {
+    "default": {
+        "BACKEND": "channels_redis.core.RedisChannelLayer",
+        "CONFIG": {
+            "hosts": [(config("REDIS_HOST", default="127.0.0.1"), config("REDIS_PORT", default=6379, cast=int))],
+        },
+    },
+}
+
+# ── REST Framework & JWT Settings ─────────────────────────────────────────────
+REST_FRAMEWORK = {
+    'DEFAULT_AUTHENTICATION_CLASSES': (
+        'rest_framework_simplejwt.authentication.JWTAuthentication',
+    ),
+    'EXCEPTION_HANDLER': 'core.utils.custom_exception_handler',
+    'DEFAULT_PAGINATION_CLASS': 'rest_framework.pagination.PageNumberPagination',
+    'PAGE_SIZE': 10,
+    'DEFAULT_THROTTLE_CLASSES': [
+        'rest_framework.throttling.AnonRateThrottle',
+        'rest_framework.throttling.UserRateThrottle'
+    ],
+    'DEFAULT_THROTTLE_RATES': {
+        'anon': '100/day',
+        'user': '1000/day'
+    },
+    'DEFAULT_SCHEMA_CLASS': 'drf_spectacular.openapi.AutoSchema',
+}
+
+SPECTACULAR_SETTINGS = {
+    'TITLE': 'API Documentation',
+    'DESCRIPTION': 'Project API Documentation',
+    'VERSION': '1.0.0',
+    'SERVE_INCLUDE_SCHEMA': False,
+}
+
+SIMPLE_JWT = {
+    'ACCESS_TOKEN_LIFETIME': timedelta(days=10),
+    'REFRESH_TOKEN_LIFETIME': timedelta(days=30),
+    'ROTATE_REFRESH_TOKENS': True,
+    'BLACKLIST_AFTER_ROTATION': True,
+    'ALGORITHM': 'HS256',
+    'SIGNING_KEY': SECRET_KEY,
+    'AUTH_HEADER_TYPES': ('Bearer',),
+}
+
+# ── CORS & CSRF Settings ──────────────────────────────────────────────────────
+CSRF_TRUSTED_ORIGINS = [i.strip() for i in config("CSRF_TRUSTED_ORIGINS", "").split(",") if i]
+CORS_ALLOWED_ORIGINS = [i.strip() for i in config("CORS_ALLOWED_ORIGINS", "").split(",") if i]
+CORS_ALLOW_CREDENTIALS = True
+CORS_ALLOW_HEADERS = ['accept', 'accept-encoding', 'authorization', 'content-type', 'dnt', 'origin', 'user-agent', 'x-csrftoken', 'x-requested-with']
+CORS_ALLOW_METHODS = ['DELETE', 'GET', 'OPTIONS', 'PATCH', 'POST', 'PUT']
+
+# ── Email Settings ────────────────────────────────────────────────────────────
+EMAIL_USE_SSL = config('EMAIL_USE_SSL', default=True, cast=bool)
+EMAIL_HOST = config('EMAIL_HOST', default='')
+EMAIL_HOST_USER = config('EMAIL_HOST_USER', default='')
+EMAIL_HOST_PASSWORD = config('EMAIL_HOST_PASSWORD', default='')
+EMAIL_PORT = config('EMAIL_PORT', default=465, cast=int)
+EMAIL_BACKEND = config('EMAIL_BACKEND', default='django.core.mail.backends.smtp.EmailBackend')
+
+# ── Logging Configuration ─────────────────────────────────────────────────────
+LOGGING = {
+    "version": 1,
+    "disable_existing_loggers": False,
+    "formatters": {
+        "verbose": {
+            "format": "[{levelname}] {asctime} {name}: {message}",
+            "style": "{",
+        },
+    },
+    "handlers": {
+        "console": {
+            "class": "logging.StreamHandler",
+            "formatter": "verbose",
+        },
+    },
+    "loggers": {
+        "django": {
+            "handlers": ["console"],
+            "level": "INFO",
+        },
+        "celery": {
+            "handlers": ["console"],
+            "level": "INFO",
+        },
+    },
+}
+
+# ── Celery & Background Tasks ─────────────────────────────────────────────────
+CELERY_BROKER_URL = config("CELERY_BROKER_URL", default="redis://127.0.0.1:6379/0")
+CELERY_RESULT_BACKEND = config("CELERY_RESULT_BACKEND", default="redis://127.0.0.1:6379/0")
+CELERY_ACCEPT_CONTENT = ["json"]
+CELERY_TASK_SERIALIZER = "json"
+CELERY_RESULT_SERIALIZER = "json"
+CELERY_TIMEZONE = TIME_ZONE
+CELERY_BROKER_CONNECTION_RETRY_ON_STARTUP = True
+CELERY_TASK_TIME_LIMIT = 5 * 60
+CELERY_TASK_SOFT_TIME_LIMIT = 60
+CELERY_WORKER_PREFETCH_MULTIPLIER = 1
+
+# Celery Beat Schedule
+CELERY_BEAT_SCHEDULE = {
+    "sample_task": {
+        "task": "core.tasks.sample_task",
+        "schedule": crontab(minute="*/15"),
+    },
+}
+"""
+    custom_configs = custom_configs.replace("core.utils.", f"{name}.utils.")
+    custom_configs = custom_configs.replace("core.tasks.", f"{name}.tasks.")
+    content += custom_configs
+
+    with open(settings_path, "w", encoding="utf-8") as f:
+        f.write(content)
+
+    return secret_key
+
+
+def create_directories():
+    os.makedirs("apps", exist_ok=True)
+    os.makedirs("static", exist_ok=True)
+    os.makedirs("media", exist_ok=True)
+
+
+def install_dependencies():
+    packages = [
+        "Django",
+        "djangorestframework",
+        "djangorestframework-simplejwt",
+        "django-cors-headers",
+        "python-decouple",
+        "psycopg2-binary",
+        "Pillow",
+        "celery",
+        "redis",
+        "daphne",
+        "channels",
+        "channels-redis",
+        "whitenoise",
+        "drf-spectacular",
+        "pytest",
+        "pytest-django",
+        "pytest-cov",
+        "pre-commit",
+        "black",
+        "flake8",
+        "isort",
+    ]
+    print("[cyan]📦 Installing dependencies...[/cyan]")
+    result = subprocess.run(
+        [sys.executable, "-m", "pip", "install"] + packages,
+        capture_output=True, text=True
+    )
+    if result.returncode != 0:
+        print(f"[red]Error installing dependencies:\n{result.stderr}[/red]")
+        import typer
+        raise typer.Exit(1)
+    print("[green]✔ Dependencies installed.[/green]")
+
+
+def generate_env_file(secret_key: str, name: str):
+    env_content = f"""# -----------------------------
+# Django Secret Key & Debug
+# -----------------------------
+DEBUG=True
+SECRET_KEY={secret_key}
+
+# ALLOWED HOSTS
+ALLOWED_HOSTS=localhost,127.0.0.1
+
+# CORS SETTINGS------------------------------#
+# CSRF trusted origins
+CSRF_TRUSTED_ORIGINS=http://localhost:5173,http://127.0.0.1:8000
+
+# CORS allowed origins
+CORS_ALLOWED_ORIGINS=http://localhost:5173,http://127.0.0.1:8000
+
+
+# -----------------------------
+# Database: #'django.db.backends.postgresql',  # or 'django.db.backends.mysql', # or 'django.db.backends.sqlite3'
+# -----------------------------
+# DB_ENGINE=django.db.backends.postgresql
+# DB_NAME={name}_db
+# DB_USER={name}_user
+# DB_PASSWORD=your-db-password
+# DB_HOST=localhost
+# DB_PORT=5432
+# CONN_MAX_AGE=600
+
+# -----------------------------
+# Redis Configuration
+# -----------------------------
+REDIS_HOST=localhost
+REDIS_PORT=6379
+REDIS_URL=redis://localhost:6379/1
+CELERY_BROKER_URL=redis://localhost:6379/0
+CELERY_RESULT_BACKEND=redis://localhost:6379/0
+
+# -----------------------------
+# Email / SMTP Settings
+# -----------------------------
+EMAIL_USE_SSL=True
+EMAIL_HOST=smtp.gmail.com
+EMAIL_HOST_USER=your-email@gmail.com
+EMAIL_HOST_PASSWORD=your-app-password
+EMAIL_PORT=465
+EMAIL_BACKEND=django.core.mail.backends.smtp.EmailBackend
+"""
+    with open(".env", "w", encoding="utf-8") as f:
+        f.write(env_content)
+
+
+def generate_docker_files(name: str):
+    dockerfile_content = """FROM python:3.11-slim
+
+ENV PYTHONDONTWRITEBYTECODE 1
+ENV PYTHONUNBUFFERED 1
+
+WORKDIR /app
+
+RUN apt-get update \\
+    && apt-get install -y --no-install-recommends gcc libpq-dev \\
+    && apt-get clean \\
+    && rm -rf /var/lib/apt/lists/*
+
+COPY requirements.txt /app/
+RUN pip install --upgrade pip
+RUN pip install -r requirements.txt
+
+COPY . /app/
+"""
+    with open("Dockerfile", "w", encoding="utf-8") as f:
+        f.write(dockerfile_content)
+
+    docker_compose_content = f"""version: '3.8'
+
+services:
+  db:
+    image: postgres:15
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+    environment:
+      - POSTGRES_DB={name}_db
+      - POSTGRES_USER={name}_user
+      - POSTGRES_PASSWORD={name}@1234!
+    ports:
+      - "5432:5432"
+
+  redis:
+    image: redis:alpine
+    ports:
+      - "6379:6379"
+
+  web:
+    build: .
+    command: daphne -b 0.0.0.0 -p 8000 {name}.asgi:application
+    volumes:
+      - .:/app
+    ports:
+      - "8000:8000"
+    env_file:
+      - .env
+    environment:
+      - DB_HOST=db
+      - REDIS_HOST=redis
+      - REDIS_URL=redis://redis:6379/1
+      - CELERY_BROKER_URL=redis://redis:6379/0
+      - CELERY_RESULT_BACKEND=redis://redis:6379/0
+    depends_on:
+      - db
+      - redis
+
+  celery:
+    build: .
+    command: celery -A {name} worker -l info
+    volumes:
+      - .:/app
+    env_file:
+      - .env
+    environment:
+      - DB_HOST=db
+      - REDIS_HOST=redis
+      - REDIS_URL=redis://redis:6379/1
+      - CELERY_BROKER_URL=redis://redis:6379/0
+      - CELERY_RESULT_BACKEND=redis://redis:6379/0
+    depends_on:
+      - db
+      - redis
+      - web
+
+volumes:
+  postgres_data:
+"""
+    with open("docker-compose.yml", "w", encoding="utf-8") as f:
+        f.write(docker_compose_content)
+
+    dockerignore_content = """.env
+.venv
+venv/
+__pycache__/
+*.pyc
+db.sqlite3
+media/
+static/
+"""
+    with open(".dockerignore", "w", encoding="utf-8") as f:
+        f.write(dockerignore_content)
+
+
+def freeze_requirements():
+    print("[cyan]📄 Freezing requirements...[/cyan]")
+    result = subprocess.run(
+        [sys.executable, "-m", "pip", "freeze", "--local"],
+        capture_output=True, text=True
+    )
+    with open("requirements.txt", "w", encoding="utf-8") as f:
+        f.write(result.stdout)
+    print("[green]✔ requirements.txt created.[/green]")
+
+
+def create_utils_file(name: str):
+    utils_content = """from rest_framework.views import exception_handler
+
+# Custom Message
+def custom_exception_handler(exc, context):
+    \"\"\"
+    Global DRF exception handler.
+    Always return only first error message.
+    \"\"\"
+
+    response = exception_handler(exc, context)
+
+    if response is None:
+        return response
+
+    data = response.data
+
+    # Case 1: {"detail": "..."}
+    if isinstance(data, dict) and "detail" in data:
+        message = data["detail"]
+
+    # Case 2: serializer errors {"field": ["error"]}
+    elif isinstance(data, dict):
+        first_error = list(data.values())[0]
+
+        if isinstance(first_error, list):
+            message = first_error[0]
+        else:
+            message = first_error
+
+    # Case 3: ["error"]
+    elif isinstance(data, list):
+        message = data[0]
+
+    else:
+        message = "Something went wrong."
+
+    # Clean up technical messages
+    message = str(message)
+    if "JSON parse error" in message:
+        message = "Invalid JSON format in request body."
+
+    # Standardize response to include success: false
+    response.data = {
+        "success": False,
+        "message": message
+    }
+
+    return response
+"""
+    with open(f"{name}/utils.py", "w", encoding="utf-8") as f:
+        f.write(utils_content)
+
+
+def create_celery_file(name: str):
+    celery_content = f"""import os
+from celery import Celery
+
+# Set the default Django settings module for the 'celery' program.
+os.environ.setdefault('DJANGO_SETTINGS_MODULE', '{name}.settings')
+
+app = Celery('{name}')
+
+# Using a string here means the worker doesn't have to serialize
+# the configuration object to child processes.
+# - namespace='CELERY' means all celery-related configuration keys
+#   should have a `CELERY_` prefix.
+app.config_from_object('django.conf:settings', namespace='CELERY')
+
+# Load task modules from all registered Django apps.
+app.autodiscover_tasks()
+
+@app.task(bind=True, ignore_result=True)
+def debug_task(self):
+    print(f'Request: {{self.request!r}}')
+"""
+    with open(f"{name}/celery.py", "w", encoding="utf-8") as f:
+        f.write(celery_content)
+
+
+def update_init_file(name: str):
+    init_content = """from .celery import app as celery_app
+
+__all__ = ('celery_app',)
+"""
+    with open(f"{name}/__init__.py", "w", encoding="utf-8") as f:
+        f.write(init_content)
+
+
+def update_urls_file(name: str):
+    urls_content = """from django.contrib import admin
+from django.urls import path, include
+from django.conf.urls.static import static
+from django.conf import settings
+from django.http import JsonResponse
+from drf_spectacular.views import SpectacularAPIView, SpectacularRedocView, SpectacularSwaggerView
+
+
+# ── Root / Health-check endpoint ──────────────────────────────────────────────
+def root_view(request):
+    return JsonResponse({
+        "message": "API Server Running",
+        "status": "ok"
+    })
+
+
+# ── URL Patterns ──────────────────────────────────────────────────────────────
+urlpatterns = [
+    # Root / Health-check
+    path('', root_view, name='home'),
+
+    # Django Admin Panel
+    # Optional: Change 'admin/' to 'em-secure-admin/' in production for security
+    path('admin/', admin.site.urls),
+
+    # API Documentation
+    path('api/schema/', SpectacularAPIView.as_view(), name='schema'),
+    path('api/schema/swagger-ui/', SpectacularSwaggerView.as_view(url_name='schema'), name='swagger-ui'),
+    path('api/schema/redoc/', SpectacularRedocView.as_view(url_name='schema'), name='redoc'),
+
+] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)
+"""
+    with open(f"{name}/urls.py", "w", encoding="utf-8") as f:
+        f.write(urls_content)
+
+
+def generate_gitignore():
+    gitignore_content = """# ===========================
+# Python / Django / Virtual Env
+# ===========================
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+
+env/
+venv/
+ENV/
+.venv/
+pyvenv.cfg
+
+*.log
+*.pot
+*.pyc
+*.pyo
+*.pyd
+
+# ===========================
+# Database (PostgreSQL / MySQL)
+# ===========================
+*.dump
+*.sql
+*.backup
+backups/
+dumps/
+db.sqlite3
+db.sqlite3-journal
+*.sqlite3
+*.db
+
+# ===========================
+# Django migrations (optional)
+# ===========================
+# Ignore migrations if you handle them via CI/CD
+# */migrations/*.py
+# */migrations/*.pyc
+# !*/migrations/__init__.py
+
+# ===========================
+# Static files / Media
+# ===========================
+/static/
+/staticfiles/
+/media/
+/mediafiles/
+/assets/
+
+# ===========================
+# Secrets / Environment variables
+# ===========================
+.env
+.env.*
+secret_key.txt
+.secret_key
+*.key
+*.pem
+*.crt
+*.cer
+credentials.json
+secrets.json
+
+# ===========================
+# Caches / Temp
+# ===========================
+.cache/
+.pytest_cache/
+.mypy_cache/
+django_cache/
+tmp/
+temp/
+
+# ===========================
+# Celery
+# ===========================
+celerybeat-schedule*
+celerybeat-schedule
+celerybeat-schedule-shm
+celerybeat-schedule-wal
+*.pid
+
+# ===========================
+# IDEs / Editors
+# ===========================
+.vscode/
+.idea/
+*.iml
+*.sublime-project
+*.sublime-workspace
+*.swp
+*~
+
+# ===========================
+# OS / System
+# ===========================
+.DS_Store
+Thumbs.db
+*.bak
+*.orig
+*.rej
+
+# ===========================
+# Docker
+# ===========================
+.docker/
+docker-compose.override.yml
+
+# ===========================
+# Node / Frontend
+# ===========================
+node_modules/
+dist/
+build/
+*.map
+
+# ===========================
+# Testing / Coverage
+# ===========================
+.coverage
+htmlcov/
+.tox/
+.nox/
+"""
+    with open(".gitignore", "w", encoding="utf-8") as f:
+        f.write(gitignore_content)
+
+
+def generate_pytest_ini(name: str):
+    content = f"""[pytest]
+DJANGO_SETTINGS_MODULE = {name}.settings
+python_files = tests.py test_*.py *_tests.py
+addopts = --cov=. --cov-report=html
+"""
+    with open("pytest.ini", "w", encoding="utf-8") as f:
+        f.write(content)
+
+
+def generate_pre_commit_config():
+    content = """repos:
+-   repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.4.0
+    hooks:
+    -   id: trailing-whitespace
+    -   id: end-of-file-fixer
+    -   id: check-yaml
+-   repo: https://github.com/psf/black
+    rev: 23.3.0
+    hooks:
+    -   id: black
+-   repo: https://github.com/PyCQA/isort
+    rev: 5.12.0
+    hooks:
+    -   id: isort
+-   repo: https://github.com/PyCQA/flake8
+    rev: 6.0.0
+    hooks:
+    -   id: flake8
+"""
+    with open(".pre-commit-config.yaml", "w", encoding="utf-8") as f:
+        f.write(content)
+
+
+def generate_github_actions():
+    os.makedirs(".github/workflows", exist_ok=True)
+    content = """name: Django CI
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    branches: [ "main" ]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+    - name: Set up Python 3.11
+      uses: actions/setup-python@v3
+      with:
+        python-version: "3.11"
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -r requirements.txt
+    - name: Lint with flake8
+      run: |
+        flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
+    - name: Run Tests
+      run: |
+        pytest
+"""
+    with open(".github/workflows/main.yml", "w", encoding="utf-8") as f:
+        f.write(content)
+
+
+def generate_gitlab_ci():
+    content = """image: python:3.11-slim
+
+stages:
+  - test
+
+variables:
+  PIP_CACHE_DIR: "$CI_PROJECT_DIR/.cache/pip"
+
+cache:
+  paths:
+    - .cache/pip
+
+test_project:
+  stage: test
+  before_script:
+    - python -m pip install --upgrade pip
+    - pip install -r requirements.txt
+  script:
+    - flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
+    - pytest
+"""
+    with open(".gitlab-ci.yml", "w", encoding="utf-8") as f:
+        f.write(content)
+
+
+def create_project(name: str):
+    check_virtual_environment()
+    validate_name(name, "project name")
+
+    # Check if project already exists
+    if Path(name).exists():
+        print(f"[red]Error: A directory named '{name}' already exists. Choose a different name or delete it first.[/red]")
+        import typer
+        raise typer.Exit(1)
+
+    # Check if current directory already has a manage.py (already a Django project)
+    if Path("manage.py").exists():
+        print("[red]Error: manage.py already exists here. Are you already inside a Django project?[/red]")
+        import typer
+        raise typer.Exit(1)
+
+    print(f"[green]🚀 Creating Django project: {name}[/green]")
+
+    # Install Django first so django-admin is available
+    print("[cyan]📦 Installing Django first...[/cyan]")
+    result = subprocess.run(
+        [sys.executable, "-m", "pip", "install", "Django"],
+        capture_output=True, text=True
+    )
+    if result.returncode != 0:
+        print(f"[red]Failed to install Django:\n{result.stderr}[/red]")
+        import typer
+        raise typer.Exit(1)
+
+    result = subprocess.run(
+        [sys.executable, "-m", "django", "startproject", name, "."],
+        capture_output=True, text=True
+    )
+    if result.returncode != 0:
+        print(f"[red]Failed to create Django project:\n{result.stderr}[/red]")
+        import typer
+        raise typer.Exit(1)
+
+    secret_key = update_settings_file(f"{name}/settings.py", name)
+    create_utils_file(name)
+    create_celery_file(name)
+    update_init_file(name)
+    update_urls_file(name)
+    create_directories()
+    install_dependencies()
+    generate_env_file(secret_key, name)
+    freeze_requirements()
+    generate_docker_files(name)
+    generate_gitignore()
+    generate_pytest_ini(name)
+    generate_pre_commit_config()
+
+    # Initialize git and install pre-commit
+    try:
+        subprocess.run(["git", "init"], check=True, capture_output=True)
+        subprocess.run(
+            [sys.executable, "-m", "pre_commit", "install"],
+            check=True, capture_output=True
+        )
+    except Exception:
+        pass
+
+    print()
+    print(f"[bold green]✅ Project '{name}' created successfully![/bold green]")
+    print()
+    print("[cyan]Next steps:[/cyan]")
+    print(f"  1. Update your [bold].env[/bold] file with DB credentials")
+    print(f"  2. Run [bold]python manage.py migrate[/bold]")
+    print(f"  3. Run [bold]python manage.py runserver[/bold]")

djboost-0.1.0.dist-info/METADATA

@@ -0,0 +1,203 @@
+Metadata-Version: 2.4
+Name: djboost
+Version: 0.1.0
+Summary: Django project generator CLI — production-ready Django projects in one command
+Author: Munjur Alom
+License: MIT
+Project-URL: Homepage, https://github.com/munjurdev/djboost
+Project-URL: Repository, https://github.com/munjurdev/djboost
+Project-URL: Bug Tracker, https://github.com/munjurdev/djboost/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer>=0.9.0
+Requires-Dist: rich>=13.0.0
+Dynamic: license-file
+
+# djboost 🚀
+
+`djboost` is a CLI tool that generates a fully-configured, production-ready Django project in one command. No more repetitive boilerplate setup.
+
+With a single command you get Django REST Framework, JWT Authentication, Celery, Redis, WebSockets (Channels), Docker, Swagger docs, and more — all pre-wired and ready to go.
+
+## ✨ Features
+
+- **API Ready** — Django REST Framework + Simple JWT pre-configured
+- **API Docs** — Auto-generated Swagger UI and ReDoc via `drf-spectacular`
+- **Async Tasks** — Celery + Redis integrated out of the box
+- **WebSockets** — Django Channels with Daphne and Redis channel layers
+- **Environment Variables** — `python-decouple` with a generated `.env` file
+- **Database** — Pre-configured for PostgreSQL (SQLite default for dev)
+- **CORS & Security** — `django-cors-headers` + standard security headers
+- **Docker** — Ready-to-use `Dockerfile` and `docker-compose.yml`
+- **Static Files** — Whitenoise configured for efficient static file serving
+- **Code Quality** — `pre-commit` with `black`, `flake8`, and `isort`
+- **Testing** — `pytest` + `pytest-django` with coverage pre-configured
+- **CI/CD** — Modular GitHub Actions and GitLab CI pipelines
+- **Custom Exception Handling** — Global DRF exception handler included
+
+---
+
+## � Installation
+
+```bash
+pip install djboost
+```
+
+---
+
+## 🚀 Quick Start
+
+### Step 1 — Create a virtual environment and activate it
+
+```bash
+python -m venv env
+
+# Windows
+env\Scripts\activate
+
+# Mac / Linux
+source env/bin/activate
+```
+
+### Step 2 — Install djboost
+
+```bash
+pip install djboost
+```
+
+### Step 3 — Navigate to an empty folder and create your project
+
+```bash
+# Create a project with a custom name
+djboost create project myproject
+
+# Or use the default name 'core'
+djboost create project
+```
+
+This single command will automatically:
+
+1. Install Django and run `startproject`
+2. Update `settings.py` with all advanced configurations
+3. Generate `.env`, `Dockerfile`, `docker-compose.yml`, and `.gitignore`
+4. Generate `pytest.ini` and `.pre-commit-config.yaml`
+5. Create `/apps`, `/static`, and `/media` directories
+6. Install all required dependencies
+7. Initialize a `git` repository and set up `pre-commit` hooks
+8. Freeze dependencies into `requirements.txt`
+
+---
+
+## 🧱 Creating Apps
+
+Apps are created inside the `apps/` directory to keep your project root clean. Settings and URLs are auto-configured.
+
+```bash
+# Navigate to your project root first
+cd myproject
+
+# Create a new app
+djboost create app users
+```
+
+This will:
+- Create `apps/users/` with standard Django app structure
+- Auto-add `'apps.users'` to `INSTALLED_APPS`
+- Auto-map `api/users/` in `urls.py`
+- Create a starter `urls.py` inside the app
+
+---
+
+## � Managing CI/CD Pipelines
+
+CI/CD is modular — add or remove it any time after project creation.
+
+### Add a pipeline
+
+```bash
+djboost add cicd github   # GitHub Actions
+djboost add cicd gitlab   # GitLab CI
+```
+
+### Remove a pipeline
+
+```bash
+djboost remove cicd github
+djboost remove cicd gitlab
+```
+
+---
+
+## 🏃 Running Your Project
+
+### Locally
+
+```bash
+# Apply migrations
+python manage.py migrate
+
+# Start the dev server
+python manage.py runserver
+```
+
+### API Documentation
+
+Once your server is running:
+
+| Interface | URL |
+|---|---|
+| Swagger UI | `http://127.0.0.1:8000/api/schema/swagger-ui/` |
+| ReDoc | `http://127.0.0.1:8000/api/schema/redoc/` |
+| OpenAPI Schema | `http://127.0.0.1:8000/api/schema/` |
+
+### Testing
+
+```bash
+pytest
+```
+
+### With Docker
+
+```bash
+docker-compose up --build
+```
+
+This spins up PostgreSQL, Redis, Celery worker, and a Daphne ASGI server together.
+
+---
+
+## ⚙️ CLI Reference
+
+```
+djboost --help
+djboost --version
+
+djboost create project [NAME]     Create a new Django project
+djboost create app NAME           Create a new app inside apps/
+
+djboost add cicd github|gitlab    Add a CI/CD pipeline
+djboost remove cicd github|gitlab Remove a CI/CD pipeline
+```
+
+---
+
+## 🐍 Requirements
+
+- Python 3.10+
+- Virtual environment (required — djboost will warn you if not activated)
+
+---
+
+## 📄 License
+
+MIT

djboost-0.1.0.dist-info/RECORD

@@ -0,0 +1,14 @@
+djboost/__init__.py,sha256=dP-7015-lW7jRYSq9V1Gamk6IBR_QApOw1KMCvi7WcE,8
+djboost/cli.py,sha256=iQaCfkNuRKqQQMZ3m4WmUbasNJNrOXmvUFPxHa3AhiU,1159
+djboost/generator.py,sha256=HJucjKldl_qSJjEYEDUT4DLnQ6JXAl6otqmnIus9Iik,26048
+djboost/commands/__init__.py,sha256=dP-7015-lW7jRYSq9V1Gamk6IBR_QApOw1KMCvi7WcE,8
+djboost/commands/add_cicd.py,sha256=I28rZcuZ8ZOb67w7SP7m4wOyYeG8RW181U_POVan768,759
+djboost/commands/create_app.py,sha256=rr4kpm6iNq-uJcHH-6WZ5QozO-ryddQIhGWClqrdX9Q,4693
+djboost/commands/create_project.py,sha256=FcNODKMGlIKYrsce94u58rRhkYkV4xZsclfNp6o2NI0,192
+djboost/commands/remove_cicd.py,sha256=arkMkZUHit4YcDTDMV7BT3YoSCC3WmG7vMVYx7BVLRs,1447
+djboost-0.1.0.dist-info/licenses/LICENSE,sha256=y5cRw4FX_ySuzWEy0aq14MhDvK-cKxrNsCHvkmoQ2CQ,1087
+djboost-0.1.0.dist-info/METADATA,sha256=Q4701Sgx04kSsqU8LoUbENA3UhtHrUzD3eLR-97h5AY,5280
+djboost-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+djboost-0.1.0.dist-info/entry_points.txt,sha256=i_aCUH4pIdn_LZDe5SQZATzpaj4pWAPkmZjA17mVL-I,44
+djboost-0.1.0.dist-info/top_level.txt,sha256=mLgii1ayliYMsRglYvmbFtc-PVL2pcaDKqcmFKVkrxQ,8
+djboost-0.1.0.dist-info/RECORD,,

djboost-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

djboost-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+djboost = djboost.cli:app

djboost-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 munjurdev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

djboost-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+djboost