devit-cli 0.1.0__py3-none-any.whl

devkit_cli/main.py

@@ -0,0 +1,89 @@
+# -*- coding: utf-8 -*-
+"""Main CLI entry point for devkit-cli."""
+
+import difflib
+import sys
+
+import click
+from rich.console import Console
+from rich import print as rprint
+from devkit_cli import __version__
+
+from devkit_cli.commands.init import init
+from devkit_cli.commands.clean import clean
+from devkit_cli.commands.info import info
+from devkit_cli.commands.find import find
+from devkit_cli.commands.archive import zip_cmd, unzip_cmd
+from devkit_cli.commands.env import env
+from devkit_cli.commands.run import run, build, dev, test
+
+console = Console()
+
+
+class _DevkitGroup(click.Group):
+    """Click Group subclass that suggests corrections for mistyped commands."""
+
+    def resolve_command(self, ctx: click.Context, args: list):
+        try:
+            return super().resolve_command(ctx, args)
+        except click.UsageError:
+            cmd_name = args[0] if args else ""
+            all_cmds = self.list_commands(ctx)
+            suggestions = difflib.get_close_matches(cmd_name, all_cmds, n=1, cutoff=0.6)
+            if suggestions:
+                console.print(
+                    f"[red]Error:[/red] No such command [bold]'{cmd_name}'[/bold].\n"
+                    f"       Did you mean [bold green]{suggestions[0]}[/bold green]?\n\n"
+                    f"Run [bold]devkit --help[/bold] to see all available commands."
+                )
+            else:
+                console.print(
+                    f"[red]Error:[/red] No such command [bold]'{cmd_name}'[/bold].\n\n"
+                    f"Run [bold]devkit --help[/bold] to see all available commands."
+                )
+            sys.exit(2)
+
+LOGO = """
+[bold cyan]
+  ██████╗ ███████╗██╗   ██╗██╗  ██╗██╗████████╗
+  ██╔══██╗██╔════╝██║   ██║██║ ██╔╝██║╚══██╔══╝
+  ██║  ██║█████╗  ██║   ██║█████╔╝ ██║   ██║   
+  ██║  ██║██╔══╝  ╚██╗ ██╔╝██╔═██╗ ██║   ██║   
+  ██████╔╝███████╗ ╚████╔╝ ██║  ██╗██║   ██║   
+  ╚═════╝ ╚══════╝  ╚═══╝  ╚═╝  ╚═╝╚═╝   ╚═╝  
+[/bold cyan]
+[dim]  Professional Developer CLI Toolkit  v{version}[/dim]
+"""
+
+
+@click.group(cls=_DevkitGroup, invoke_without_command=True, context_settings={"help_option_names": ["-h", "--help"]})
+@click.version_option(__version__, "-v", "--version", message="devkit-cli %(version)s")
+@click.pass_context
+def cli(ctx: click.Context) -> None:
+    """
+    \b
+    devkit-cli — A full-featured CLI framework for professional developers.
+
+    Run `devkit COMMAND --help` for details on any command.
+    """
+    if ctx.invoked_subcommand is None:
+        console.print(LOGO.format(version=__version__))
+        click.echo(ctx.get_help())
+
+
+# Register all commands
+cli.add_command(init)
+cli.add_command(clean)
+cli.add_command(info)
+cli.add_command(find)
+cli.add_command(zip_cmd, name="zip")
+cli.add_command(unzip_cmd, name="unzip")
+cli.add_command(env)
+cli.add_command(run)
+cli.add_command(build)
+cli.add_command(dev)
+cli.add_command(test)
+
+
+if __name__ == "__main__":
+    cli()

devkit_cli/templates/aws/.gitignore

@@ -0,0 +1,43 @@
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+.Python
+*.egg-info/
+dist/
+build/
+.eggs/
+.venv/
+venv/
+env/
+
+# Testing
+.pytest_cache/
+.coverage
+coverage.xml
+htmlcov/
+
+# Linting
+.ruff_cache/
+.mypy_cache/
+
+# OS
+.DS_Store
+Thumbs.db
+*.swp
+*.swo
+
+# IDEs
+.vscode/
+.idea/
+*.iml
+
+# Env
+.env
+.env.*
+!.env.example
+
+# AWS
+.aws-sam/
+cdk.out/

devkit_cli/templates/aws/README.md

@@ -0,0 +1,23 @@
+# {{project_name}}
+
+AWS automation scripts — scaffolded with **devkit-cli**
+
+## Setup
+
+```bash
+devkit build       # installs requirements
+aws configure      # configure your AWS credentials
+```
+
+## Run
+
+```bash
+devkit run list-buckets
+devkit run list-instances
+```
+
+## Test
+
+```bash
+devkit test
+```

devkit_cli/templates/aws/requirements.txt

@@ -0,0 +1,2 @@
+boto3>=1.34
+botocore>=1.34

devkit_cli/templates/aws/scripts/ec2.py

@@ -0,0 +1,9 @@
+"""EC2 helper scripts."""
+
+import boto3
+
+
+def list_instances():
+    ec2 = boto3.resource("ec2")
+    for instance in ec2.instances.all():
+        print(f"{instance.id}  {instance.instance_type}  {instance.state['Name']}")

devkit_cli/templates/aws/scripts/main.py

@@ -0,0 +1,25 @@
+"""{{project_name}} — AWS automation scripts entry point."""
+
+import argparse
+from scripts import s3, ec2
+
+
+def main():
+    parser = argparse.ArgumentParser(description="{{project_name}} AWS scripts")
+    sub = parser.add_subparsers(dest="command")
+
+    sub.add_parser("list-buckets", help="List S3 buckets")
+    sub.add_parser("list-instances", help="List EC2 instances")
+
+    args = parser.parse_args()
+
+    if args.command == "list-buckets":
+        s3.list_buckets()
+    elif args.command == "list-instances":
+        ec2.list_instances()
+    else:
+        parser.print_help()
+
+
+if __name__ == "__main__":
+    main()

devkit_cli/templates/aws/scripts/s3.py

@@ -0,0 +1,10 @@
+"""S3 helper scripts."""
+
+import boto3
+
+
+def list_buckets():
+    s3 = boto3.client("s3")
+    response = s3.list_buckets()
+    for bucket in response.get("Buckets", []):
+        print(bucket["Name"])

devkit_cli/templates/aws/tests/test_scripts.py

@@ -0,0 +1,6 @@
+"""Tests for {{project_name}} AWS scripts."""
+
+
+def test_placeholder():
+    # Replace with real tests using moto for AWS mocking
+    assert True

devkit_cli/templates/django/.gitignore

@@ -0,0 +1,43 @@
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+.Python
+*.egg-info/
+dist/
+build/
+.eggs/
+.venv/
+venv/
+env/
+
+# Testing
+.pytest_cache/
+.coverage
+coverage.xml
+htmlcov/
+
+# Linting
+.ruff_cache/
+.mypy_cache/
+
+# OS
+.DS_Store
+Thumbs.db
+*.swp
+*.swo
+
+# IDEs
+.vscode/
+.idea/
+*.iml
+
+# Env
+.env
+.env.*
+!.env.example
+
+# AWS
+.aws-sam/
+cdk.out/

devkit_cli/templates/django/README.md

@@ -0,0 +1,15 @@
+# {{project_name}}
+
+Django project — scaffolded with **devkit-cli**
+
+## Dev server
+
+```bash
+devkit dev
+```
+
+## Run migrations
+
+```bash
+.venv/Scripts/python manage.py migrate
+```

devkit_cli/templates/django/apps/core/apps.py

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+
+class CoreConfig(AppConfig):
+    default_auto_field = "django.db.models.BigAutoField"
+    name = "apps.core"

devkit_cli/templates/django/apps/core/urls.py

@@ -0,0 +1,6 @@
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path("", views.index, name="index"),
+]

devkit_cli/templates/django/apps/core/views.py

@@ -0,0 +1,7 @@
+"""Core Django app — views."""
+
+from django.http import JsonResponse
+
+
+def index(request):
+    return JsonResponse({"message": "Welcome to {{project_name}}"})

devkit_cli/templates/django/manage.py

@@ -0,0 +1,20 @@
+#!/usr/bin/env python
+"""Django's command-line utility for administrative tasks."""
+import os
+import sys
+
+
+def main():
+    os.environ.setdefault("DJANGO_SETTINGS_MODULE", "{{module_name}}.settings")
+    try:
+        from django.core.management import execute_from_command_line
+    except ImportError as exc:
+        raise ImportError(
+            "Couldn't import Django. Are you sure it's installed and "
+            "available on your PYTHONPATH?"
+        ) from exc
+    execute_from_command_line(sys.argv)
+
+
+if __name__ == "__main__":
+    main()

devkit_cli/templates/django/requirements.txt

@@ -0,0 +1 @@
+django>=4.2

devkit_cli/templates/django/{{module_name}}/settings.py

@@ -0,0 +1,61 @@
+"""Django settings for {{project_name}}."""
+
+from pathlib import Path
+
+BASE_DIR = Path(__file__).resolve().parent.parent
+
+SECRET_KEY = "django-insecure-change-me-in-production"
+
+DEBUG = True
+
+ALLOWED_HOSTS = ["*"]
+
+INSTALLED_APPS = [
+    "django.contrib.admin",
+    "django.contrib.auth",
+    "django.contrib.contenttypes",
+    "django.contrib.sessions",
+    "django.contrib.messages",
+    "django.contrib.staticfiles",
+    "apps.core",
+]
+
+MIDDLEWARE = [
+    "django.middleware.security.SecurityMiddleware",
+    "django.contrib.sessions.middleware.SessionMiddleware",
+    "django.middleware.common.CommonMiddleware",
+    "django.middleware.csrf.CsrfViewMiddleware",
+    "django.contrib.auth.middleware.AuthenticationMiddleware",
+    "django.contrib.messages.middleware.MessageMiddleware",
+    "django.middleware.clickjacking.XFrameOptionsMiddleware",
+]
+
+ROOT_URLCONF = "{{module_name}}.urls"
+
+TEMPLATES = [
+    {
+        "BACKEND": "django.template.backends.django.DjangoTemplates",
+        "DIRS": [BASE_DIR / "templates"],
+        "APP_DIRS": True,
+        "OPTIONS": {
+            "context_processors": [
+                "django.template.context_processors.debug",
+                "django.template.context_processors.request",
+                "django.contrib.auth.context_processors.auth",
+                "django.contrib.messages.context_processors.messages",
+            ],
+        },
+    },
+]
+
+WSGI_APPLICATION = "{{module_name}}.wsgi.application"
+
+DATABASES = {
+    "default": {
+        "ENGINE": "django.db.backends.sqlite3",
+        "NAME": BASE_DIR / "db.sqlite3",
+    }
+}
+
+STATIC_URL = "static/"
+DEFAULT_AUTO_FIELD = "django.db.models.BigAutoField"

devkit_cli/templates/django/{{module_name}}/urls.py

@@ -0,0 +1,9 @@
+"""URL config for {{project_name}}."""
+
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path("admin/", admin.site.urls),
+    path("", include("apps.core.urls")),
+]

devkit_cli/templates/django/{{module_name}}/wsgi.py

@@ -0,0 +1,7 @@
+"""WSGI config for {{project_name}}."""
+
+import os
+from django.core.wsgi import get_wsgi_application
+
+os.environ.setdefault("DJANGO_SETTINGS_MODULE", "{{module_name}}.settings")
+application = get_wsgi_application()

devkit_cli/templates/fastapi/.gitignore

@@ -0,0 +1,43 @@
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+.Python
+*.egg-info/
+dist/
+build/
+.eggs/
+.venv/
+venv/
+env/
+
+# Testing
+.pytest_cache/
+.coverage
+coverage.xml
+htmlcov/
+
+# Linting
+.ruff_cache/
+.mypy_cache/
+
+# OS
+.DS_Store
+Thumbs.db
+*.swp
+*.swo
+
+# IDEs
+.vscode/
+.idea/
+*.iml
+
+# Env
+.env
+.env.*
+!.env.example
+
+# AWS
+.aws-sam/
+cdk.out/

devkit_cli/templates/fastapi/README.md

@@ -0,0 +1,21 @@
+# {{project_name}}
+
+FastAPI backend — scaffolded with **devkit-cli**
+
+## Run (dev)
+
+```bash
+devkit dev
+```
+
+## Run (production)
+
+```bash
+devkit run
+```
+
+## Test
+
+```bash
+devkit test
+```

devkit_cli/templates/fastapi/app/routers/health.py

@@ -0,0 +1,10 @@
+"""Health-check router."""
+
+from fastapi import APIRouter
+
+router = APIRouter(prefix="/health", tags=["health"])
+
+
+@router.get("")
+async def health():
+    return {"status": "ok"}

devkit_cli/templates/fastapi/main.py

@@ -0,0 +1,13 @@
+"""{{project_name}} — FastAPI application entry point."""
+
+from fastapi import FastAPI
+from app.routers import health
+
+app = FastAPI(title="{{project_name}}", version="0.1.0")
+
+app.include_router(health.router)
+
+
+@app.get("/")
+async def root():
+    return {"message": "Welcome to {{project_name}}"}

devkit_cli/templates/fastapi/requirements.txt

@@ -0,0 +1,6 @@
+fastapi>=0.111
+uvicorn[standard]>=0.29
+pydantic>=2.0
+httpx>=0.27
+pytest>=7.0
+pytest-anyio>=0.0.0

devkit_cli/templates/fastapi/tests/test_api.py

@@ -0,0 +1,17 @@
+"""Tests for {{project_name}} API."""
+
+from fastapi.testclient import TestClient
+from main import app
+
+client = TestClient(app)
+
+
+def test_root():
+    r = client.get("/")
+    assert r.status_code == 200
+
+
+def test_health():
+    r = client.get("/health")
+    assert r.status_code == 200
+    assert r.json()["status"] == "ok"

devkit_cli/templates/package/.gitignore

@@ -0,0 +1,43 @@
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+.Python
+*.egg-info/
+dist/
+build/
+.eggs/
+.venv/
+venv/
+env/
+
+# Testing
+.pytest_cache/
+.coverage
+coverage.xml
+htmlcov/
+
+# Linting
+.ruff_cache/
+.mypy_cache/
+
+# OS
+.DS_Store
+Thumbs.db
+*.swp
+*.swo
+
+# IDEs
+.vscode/
+.idea/
+*.iml
+
+# Env
+.env
+.env.*
+!.env.example
+
+# AWS
+.aws-sam/
+cdk.out/

devkit_cli/templates/package/README.md

@@ -0,0 +1,15 @@
+# {{project_name}}
+
+> Created with **devkit-cli**
+
+## Install
+
+```bash
+pip install -e ".[dev]"
+```
+
+## Test
+
+```bash
+devkit test
+```

devkit_cli/templates/package/pyproject.toml

@@ -0,0 +1,29 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.backends.legacy:build"
+
+[project]
+name = "{{project_name}}"
+version = "0.1.0"
+description = "A short description of {{project_name}}"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+dependencies = []
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "black>=24.0",
+    "ruff>=0.4",
+]
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["{{module_name}}*"]
+
+[tool.black]
+line-length = 100
+
+[tool.ruff]
+line-length = 100
+select = ["E", "F", "I"]

devkit_cli/templates/package/tests/test_core.py

@@ -0,0 +1,8 @@
+"""Tests for {{project_name}}."""
+
+from {{module_name}}.core import hello
+
+
+def test_hello():
+    assert hello() == "Hello, world!"
+    assert hello("devkit") == "Hello, devkit!"

devkit_cli/templates/package/{{module_name}}/__init__.py

@@ -0,0 +1,3 @@
+"""{{project_name}} — Python package."""
+
+__version__ = "0.1.0"

devkit_cli/templates/package/{{module_name}}/core.py

@@ -0,0 +1,5 @@
+"""Core logic for {{project_name}}."""
+
+
+def hello(name: str = "world") -> str:
+    return f"Hello, {name}!"