fastkit-cli 0.1.0__py3-none-any.whl

fastkit_cli/commands/__init__.py

@@ -0,0 +1,13 @@
+import fastkit_cli.commands.seed
+import fastkit_cli.commands.new
+import fastkit_cli.commands.make
+import fastkit_cli.commands.migrate
+import fastkit_cli.commands.server
+
+__all__ = [
+    'seed',
+    'new',
+    'make',
+    'migrate',
+    'server'
+]

fastkit_cli/commands/make.py

@@ -0,0 +1,367 @@
+import re
+from pathlib import Path
+
+import typer
+from jinja2 import Environment, FileSystemLoader
+
+app = typer.Typer(help="Code generation commands.")
+
+TEMPLATES_DIR = Path(__file__).parent.parent / "templates" / "module"
+
+
+# ─────────────────────────────────────────────────────────────────────────────
+# Naming Helpers
+# ─────────────────────────────────────────────────────────────────────────────
+
+def _to_snake_case(name: str) -> str:
+    name = re.sub(r'([A-Z]+)([A-Z][a-z])', r'\1_\2', name)
+    name = re.sub(r'([a-z\d])([A-Z])', r'\1_\2', name)
+    return name.lower()
+
+
+def _to_pascal_case(name: str) -> str:
+    return ''.join(word.capitalize() for word in re.split(r'[_\s-]', name))
+
+
+def _to_plural(name: str) -> str:
+    if name.endswith('y') and not name.endswith(('ay', 'ey', 'iy', 'oy', 'uy')):
+        return name[:-1] + 'ies'
+    if name.endswith(('s', 'sh', 'ch', 'x', 'z')):
+        return name + 'es'
+    return name + 's'
+
+
+# ─────────────────────────────────────────────────────────────────────────────
+# Shared Helpers
+# ─────────────────────────────────────────────────────────────────────────────
+
+def _build_context(name: str) -> dict:
+    model_name = _to_pascal_case(name)
+    snake_name = _to_snake_case(model_name)
+    table_name = _to_plural(snake_name)
+    return {
+        "model_name": model_name,
+        "snake_name": snake_name,
+        "table_name": table_name,
+        "module_folder": table_name,
+    }
+
+
+def _render_template(template_name: str, context: dict) -> str:
+    env = Environment(
+        loader=FileSystemLoader(str(TEMPLATES_DIR)),
+        keep_trailing_newline=True,
+    )
+    return env.get_template(template_name).render(**context)
+
+
+def _render_and_write(
+    template_name: str,
+    output_path: Path,
+    context: dict,
+    force: bool = False,
+    skipped: list | None = None,
+) -> None:
+    if output_path.exists() and not force:
+        if skipped is not None:
+            skipped.append(output_path.name)
+        return
+    try:
+        content = _render_template(template_name, context)
+        output_path.write_text(content)
+        typer.secho(f"  ✓  {output_path.name}", fg=typer.colors.GREEN)
+    except Exception as e:
+        typer.secho(f"  ✗  {output_path.name} — {e}", fg=typer.colors.RED)
+
+
+def _register_in_alembic(model_name: str, module_folder: str) -> None:
+    env_py = None
+    for candidate in ["alembic/env.py", "migrations/env.py"]:
+        path = Path(candidate)
+        if path.exists():
+            env_py = path
+            break
+
+    if env_py is None:
+        typer.secho(
+            "  ⚠  Could not find alembic/env.py or migrations/env.py. "
+            "Please register the model manually.",
+            fg=typer.colors.YELLOW,
+        )
+        return
+
+    content = env_py.read_text()
+    import_line = f"from modules.{module_folder}.models import {model_name}  # noqa"
+
+    if import_line in content:
+        typer.secho(f"  ✓  Model already registered in {env_py}", fg=typer.colors.YELLOW)
+        return
+
+    insert_marker = "target_metadata"
+    if insert_marker in content:
+        content = content.replace(insert_marker, f"{import_line}\n{insert_marker}", 1)
+        env_py.write_text(content)
+        typer.secho(f"  ✓  Registered model in {env_py}", fg=typer.colors.GREEN)
+    else:
+        typer.secho(
+            f"  ⚠  Could not auto-register model in {env_py}. "
+            f"Please add manually:\n     {import_line}",
+            fg=typer.colors.YELLOW,
+        )
+
+
+def _print_skipped(skipped: list) -> None:
+    if skipped:
+        typer.echo("")
+        typer.secho(
+            f"  Skipped {len(skipped)} existing file(s). Use --force to overwrite.",
+            fg=typer.colors.YELLOW,
+        )
+
+
+# ─────────────────────────────────────────────────────────────────────────────
+# Commands
+# ─────────────────────────────────────────────────────────────────────────────
+
+@app.command()
+def module(
+    name: str = typer.Argument(..., help="Module name in PascalCase (e.g. Invoice, InvoiceItem)"),
+    modules_dir: str = typer.Option("modules", "--dir", "-d", help="Modules root directory"),
+    force: bool = typer.Option(False, "--force", "-f", help="Overwrite existing files"),
+    async_mode: bool = typer.Option(False, "--async", "-a", help="Use async repository and service"),
+):
+    """
+    Generate a new module with model, schemas, repository, and service.
+
+    \b
+    Example:
+        fastkit make module Invoice
+        fastkit make module Invoice --async
+        fastkit make module InvoiceItem --dir src/modules
+    """
+    context = _build_context(name)
+    module_path = Path(modules_dir) / context["table_name"]
+
+    typer.echo("")
+    typer.secho(f"Generating module: {context['model_name']}", fg=typer.colors.BRIGHT_CYAN, bold=True)
+    typer.echo(f"  Location : {module_path}/")
+    typer.echo(f"  Model    : {context['model_name']}")
+    typer.echo(f"  Table    : {context['table_name']}")
+    typer.echo(f"  Mode     : {'async' if async_mode else 'sync'}")
+    typer.echo("")
+
+    module_path.mkdir(parents=True, exist_ok=True)
+
+    init_file = module_path / "__init__.py"
+    if not init_file.exists() or force:
+        init_file.write_text("")
+        typer.secho("  ✓  __init__.py", fg=typer.colors.GREEN)
+
+    templates = [
+        ("model.py.jinja", "models.py"),
+        ("schemas.py.jinja", "schemas.py"),
+        ("async_repository.py.jinja" if async_mode else "repository.py.jinja", "repository.py"),
+        ("async_service.py.jinja" if async_mode else "service.py.jinja", "service.py"),
+        ("async_router.py.jinja" if async_mode else "router.py.jinja", "router.py"),
+    ]
+
+    skipped: list = []
+    for template_name, output_filename in templates:
+        _render_and_write(
+            template_name=template_name,
+            output_path=module_path / output_filename,
+            context=context,
+            force=force,
+            skipped=skipped,
+        )
+
+    _print_skipped(skipped)
+
+    typer.echo("")
+    _register_in_alembic(context["model_name"], context["table_name"])
+
+    typer.echo("")
+    typer.secho("Done! Next steps:", fg=typer.colors.BRIGHT_WHITE, bold=True)
+    typer.echo(f"  1. Define your fields in  {module_path}/models.py")
+    typer.echo(f"  2. Add schemas in          {module_path}/schemas.py")
+    typer.echo(f"  3. Run: fastkit migrate make -m 'create_{context['table_name']}'")
+    typer.echo("")
+
+
+@app.command()
+def model(
+    name: str = typer.Argument(..., help="Model name in PascalCase (e.g. Invoice, InvoiceItem)"),
+    path: str = typer.Option(".", "--path", "-p", help="Path to target directory"),
+    force: bool = typer.Option(False, "--force", "-f", help="Overwrite existing file"),
+):
+    """
+    Generate only a model file.
+
+    \b
+    Example:
+        fastkit make model Invoice
+        fastkit make model Invoice --path modules/invoices
+    """
+    context = _build_context(name)
+    module_path = Path(path)
+
+    typer.echo("")
+    typer.secho(f"Generating model: {context['model_name']}", fg=typer.colors.BRIGHT_CYAN, bold=True)
+    typer.echo("")
+
+    _render_and_write(
+        template_name="model.py.jinja",
+        output_path=module_path / "models.py",
+        context=context,
+        force=force,
+    )
+
+    typer.echo("")
+    _register_in_alembic(context["model_name"], context["table_name"])
+
+    typer.echo("")
+    typer.secho("Done!", fg=typer.colors.BRIGHT_WHITE, bold=True)
+    typer.echo(f"  Define your fields in  {module_path}/models.py")
+    typer.echo("")
+
+@app.command()
+def schema(
+    name: str = typer.Argument(..., help="Schema name in PascalCase (e.g. Invoice)"),
+    path: str = typer.Option(".", "--path", "-p", help="Path to target directory"),
+    force: bool = typer.Option(False, "--force", "-f", help="Overwrite existing file"),
+):
+    """
+    Generate only a schemas file.
+
+    \b
+    Example:
+        fastkit make schema Invoice
+        fastkit make schema Invoice --path modules/invoices
+    """
+    context = _build_context(name)
+    module_path = Path(path)
+
+    typer.echo("")
+    typer.secho(f"Generating schemas: {context['model_name']}", fg=typer.colors.BRIGHT_CYAN, bold=True)
+    typer.echo("")
+
+    _render_and_write(
+        template_name="schemas.py.jinja",
+        output_path=module_path / "schemas.py",
+        context=context,
+        force=force,
+    )
+
+    typer.echo("")
+    typer.secho("Done!", fg=typer.colors.BRIGHT_WHITE, bold=True)
+    typer.echo(f"  Define your schemas in  {module_path}/schemas.py")
+    typer.echo("")
+
+
+@app.command()
+def repository(
+    name: str = typer.Argument(..., help="Repository name in PascalCase (e.g. Invoice)"),
+    path: str = typer.Option(".", "--path", "-p", help="Path to target directory"),
+    force: bool = typer.Option(False, "--force", "-f", help="Overwrite existing file"),
+    async_mode: bool = typer.Option(False, "--async", "-a", help="Use async repository"),
+):
+    """
+    Generate only a repository file.
+
+    \b
+    Example:
+        fastkit make repository Invoice
+        fastkit make repository Invoice --async
+        fastkit make repository Invoice --path modules/invoices
+    """
+    context = _build_context(name)
+    module_path = Path(path)
+    template = "async_repository.py.jinja" if async_mode else "repository.py.jinja"
+
+    typer.echo("")
+    typer.secho(f"Generating repository: {context['model_name']}", fg=typer.colors.BRIGHT_CYAN, bold=True)
+    typer.echo(f"  Mode: {'async' if async_mode else 'sync'}")
+    typer.echo("")
+
+    _render_and_write(
+        template_name=template,
+        output_path=module_path / "repository.py",
+        context=context,
+        force=force,
+    )
+
+    typer.echo("")
+    typer.secho("Done!", fg=typer.colors.BRIGHT_WHITE, bold=True)
+    typer.echo("")
+
+@app.command()
+def service(
+    name: str = typer.Argument(..., help="Service name in PascalCase (e.g. Invoice)"),
+    path: str = typer.Option(".", "--path", "-p", help="Path to target directory"),
+    force: bool = typer.Option(False, "--force", "-f", help="Overwrite existing file"),
+    async_mode: bool = typer.Option(False, "--async", "-a", help="Use async service"),
+):
+    """
+    Generate only a service file.
+
+    \b
+    Example:
+        fastkit make service Invoice
+        fastkit make service Invoice --async
+        fastkit make service Invoice --path modules/invoices
+    """
+    context = _build_context(name)
+    module_path = Path(path)
+    template = "async_service.py.jinja" if async_mode else "service.py.jinja"
+
+    typer.echo("")
+    typer.secho(f"Generating service: {context['model_name']}", fg=typer.colors.BRIGHT_CYAN, bold=True)
+    typer.echo(f"  Mode: {'async' if async_mode else 'sync'}")
+    typer.echo("")
+
+    _render_and_write(
+        template_name=template,
+        output_path=module_path / "service.py",
+        context=context,
+        force=force,
+    )
+
+    typer.echo("")
+    typer.secho("Done!", fg=typer.colors.BRIGHT_WHITE, bold=True)
+    typer.echo("")
+
+@app.command()
+def router(
+    name: str = typer.Argument(..., help="Router name in PascalCase (e.g. Invoice)"),
+    path: str = typer.Option(".", "--path", "-p", help="Path to target directory"),
+    force: bool = typer.Option(False, "--force", "-f", help="Overwrite existing file"),
+    async_mode: bool = typer.Option(False, "--async", "-a", help="Use async router"),
+):
+    """
+    Generate only a router file.
+
+    \b
+    Example:
+        fastkit make router Invoice
+        fastkit make router Invoice --async
+        fastkit make router Invoice --path modules/invoices
+    """
+    context = _build_context(name)
+    module_path = Path(path)
+    template = "async_router.py.jinja" if async_mode else "router.py.jinja"
+
+    typer.echo("")
+    typer.secho(f"Generating router: {context['model_name']}", fg=typer.colors.BRIGHT_CYAN, bold=True)
+    typer.echo(f"  Mode: {'async' if async_mode else 'sync'}")
+    typer.echo("")
+
+    _render_and_write(
+        template_name=template,
+        output_path=module_path / "router.py",
+        context=context,
+        force=force,
+    )
+
+    typer.echo("")
+    typer.secho("Done!", fg=typer.colors.BRIGHT_WHITE, bold=True)
+    typer.echo("")

fastkit_cli/commands/migrate.py

@@ -0,0 +1,27 @@
+import typer
+
+app = typer.Typer(help="Migration commands.")
+
+
+@app.command()
+def run():
+    """Run pending migrations. (alembic upgrade head)"""
+    typer.echo("Running migrations...")
+
+
+@app.command()
+def make(message: str = typer.Option(..., "--message", "-m", help="Migration message")):
+    """Generate a new migration. (alembic revision --autogenerate)"""
+    typer.echo(f"Generating migration: {message}")
+
+
+@app.command()
+def rollback():
+    """Rollback last migration. (alembic downgrade -1)"""
+    typer.echo("Rolling back last migration...")
+
+
+@app.command()
+def status():
+    """Show current migration status. (alembic current)"""
+    typer.echo("Checking migration status...")

fastkit_cli/commands/new.py

@@ -0,0 +1,9 @@
+import typer
+
+app = typer.Typer(help="Create a new FastKit project.")
+
+
+@app.callback(invoke_without_command=True)
+def create(name: str = typer.Argument(..., help="Project name")):
+    """Create a new FastKit project."""
+    typer.echo(f"Creating new FastKit project: {name}")

fastkit_cli/commands/seed.py

@@ -0,0 +1,12 @@
+import typer
+
+app = typer.Typer(help="Database seeding commands.")
+
+
+@app.callback(invoke_without_command=True)
+def seed(seeder: str = typer.Argument(None, help="Specific seeder class to run")):
+    """Run database seeders."""
+    if seeder:
+        typer.echo(f"Running seeder: {seeder}")
+    else:
+        typer.echo("Running all seeders...")

fastkit_cli/commands/server.py

@@ -0,0 +1,13 @@
+import typer
+
+app = typer.Typer(help="Server commands.")
+
+
+@app.callback(invoke_without_command=True)
+def start(
+    host: str = typer.Option("0.0.0.0", "--host", "-h", help="Host to bind"),
+    port: int = typer.Option(8000, "--port", "-p", help="Port to bind"),
+    reload: bool = typer.Option(True, "--reload/--no-reload", help="Enable auto-reload"),
+):
+    """Start the FastAPI development server."""
+    typer.echo(f"Starting server on {host}:{port}...")

fastkit_cli/main.py

@@ -0,0 +1,20 @@
+import typer
+from fastkit_cli.commands import make, migrate, seed, server, new
+
+app = typer.Typer(
+    name="fastkit",
+    help="FastKit CLI - FastAPI with structure and developer experience.",
+    no_args_is_help=True,
+    pretty_exceptions_enable=False,
+)
+
+# Register command groups
+app.add_typer(make.app, name="make")
+app.add_typer(migrate.app, name="migrate")
+app.add_typer(seed.app, name="db")
+app.add_typer(server.app, name="server")
+app.add_typer(new.app, name="new")
+
+
+if __name__ == "__main__":
+    app()

fastkit_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,457 @@
+Metadata-Version: 2.4
+Name: fastkit-cli
+Version: 0.1.0
+Summary: FastKit CLI is a code generation tool for the fastkit core packge.
+Project-URL: Homepage, https://github.com/codevelo-pub/fastkit-cli
+Project-URL: Documentation, https://github.com/codevelo-pub/fastkit-cli#readme
+Project-URL: Repository, https://github.com/codevelo-pub/fastkit-cli
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+Requires-Dist: fastkit-core>=0.3.5
+Requires-Dist: jinja2>=3.1.6
+Requires-Dist: typer>=0.24.1
+
+<div align="center">
+  <h1>FastKit CLI</h1>
+  
+  [![PyPI version](https://badge.fury.io/py/fastkit-cli.svg)](https://pypi.org/project/fastkit-cli/)
+  [![Python 3.11+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
+  [![CI](https://github.com/codevelo-pub/fastkit-core/actions/workflows/tests.yml/badge.svg)](https://github.com/codevelo-pub/fastkit-cli/actions/workflows/tests.yml)
+  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+</div>
+
+
+**FastAPI with structure and developer experience.**
+
+FastKit CLI is a code generation tool for the [FastKit](https://github.com/codevelo-pub/fastkit-core) ecosystem. It generates complete, production-ready modules for FastAPI projects — models, schemas, repositories, services, and routers — in seconds.
+
+> Inspired by Laravel's `php artisan`, built for FastAPI developers who want structure without the overhead.
+
+---
+
+## Requirements
+
+- Python 3.12
+- [fastkit-core](https://pypi.org/project/fastkit-core/)
+
+---
+
+## Installation
+
+```bash
+pip install fastkit-cli
+```
+
+Or with [uv](https://github.com/astral-sh/uv) (recommended):
+
+```bash
+uv add fastkit-cli
+```
+
+Verify the installation:
+
+```bash
+fastkit --help
+```
+
+---
+
+## Quickstart
+
+### Generate a complete module
+
+```bash
+fastkit make module Invoice
+```
+
+This generates the following structure:
+
+```
+modules/
+└── invoices/
+    ├── __init__.py
+    ├── models.py
+    ├── schemas.py
+    ├── repository.py
+    ├── service.py
+    └── router.py
+```
+
+With a confirmation and next steps:
+
+```
+Generating module: Invoice
+  Location : modules/invoices/
+  Model    : Invoice
+  Table    : invoices
+  Mode     : sync
+
+  ✓  __init__.py
+  ✓  models.py
+  ✓  schemas.py
+  ✓  repository.py
+  ✓  service.py
+  ✓  router.py
+
+  ✓  Registered model in alembic/env.py
+
+Done! Next steps:
+  1. Define your fields in  modules/invoices/models.py
+  2. Add schemas in          modules/invoices/schemas.py
+  3. Run: fastkit migrate make -m 'create_invoices'
+```
+
+### Generate an async module
+
+```bash
+fastkit make module Invoice --async
+```
+
+Generates the same structure but with async repository, service, and router using `AsyncSession` and `get_async_db`.
+
+---
+
+## make
+
+### `fastkit make module`
+
+Generates a complete module with all layers.
+
+```bash
+fastkit make module <Name> [OPTIONS]
+```
+
+| Option | Short | Default | Description |
+|--------|-------|---------|-------------|
+| `--dir` | `-d` | `modules` | Root directory for modules |
+| `--async` | `-a` | `False` | Use async repository, service, and router |
+| `--force` | `-f` | `False` | Overwrite existing files |
+
+**Examples:**
+
+```bash
+# Basic usage
+fastkit make module Invoice
+
+# Async mode
+fastkit make module Invoice --async
+
+# Custom directory
+fastkit make module Invoice --dir src/modules
+
+# Compound name (automatically converted)
+fastkit make module InvoiceItem
+
+# Overwrite existing files
+fastkit make module Invoice --force
+```
+
+---
+
+### `fastkit make model`
+
+Generates only the SQLAlchemy model file.
+
+```bash
+fastkit make model <Name> [OPTIONS]
+```
+
+| Option | Short | Default | Description |
+|--------|-------|---------|-------------|
+| `--path` | `-p` | `.` | Target directory |
+| `--force` | `-f` | `False` | Overwrite existing file |
+
+**Examples:**
+
+```bash
+fastkit make model Invoice
+fastkit make model Invoice --path modules/invoices
+```
+
+**Generated `models.py`:**
+
+```python
+from fastkit_core.database import BaseWithTimestamps, IntIdMixin
+# from fastkit_core.database import UUIDMixin, SoftDeleteMixin, SlugMixin
+
+class Invoice(BaseWithTimestamps, IntIdMixin):
+    __tablename__ = "invoices"
+    # Define your fields here
+```
+
+---
+
+### `fastkit make schema`
+
+Generates only the Pydantic schemas file.
+
+```bash
+fastkit make schema <Name> [OPTIONS]
+```
+
+| Option | Short | Default | Description |
+|--------|-------|---------|-------------|
+| `--path` | `-p` | `.` | Target directory |
+| `--force` | `-f` | `False` | Overwrite existing file |
+
+**Examples:**
+
+```bash
+fastkit make schema Invoice
+fastkit make schema Invoice --path modules/invoices
+```
+
+**Generated `schemas.py`:**
+
+```python
+from fastkit_core.validation import BaseSchema
+
+class InvoiceCreate(BaseSchema):
+    pass  # Define your fields here
+
+class InvoiceUpdate(BaseSchema):
+    pass  # All fields optional for partial updates
+
+class InvoiceResponse(BaseSchema):
+    id: int
+    model_config = {"from_attributes": True}
+```
+
+---
+
+### `fastkit make repository`
+
+Generates only the repository file.
+
+```bash
+fastkit make repository <Name> [OPTIONS]
+```
+
+| Option | Short | Default | Description |
+|--------|-------|---------|-------------|
+| `--path` | `-p` | `.` | Target directory |
+| `--async` | `-a` | `False` | Use async repository |
+| `--force` | `-f` | `False` | Overwrite existing file |
+
+**Examples:**
+
+```bash
+fastkit make repository Invoice
+fastkit make repository Invoice --async
+fastkit make repository Invoice --path modules/invoices
+```
+
+---
+
+### `fastkit make service`
+
+Generates only the service file.
+
+```bash
+fastkit make service <Name> [OPTIONS]
+```
+
+| Option | Short | Default | Description |
+|--------|-------|---------|-------------|
+| `--path` | `-p` | `.` | Target directory |
+| `--async` | `-a` | `False` | Use async service |
+| `--force` | `-f` | `False` | Overwrite existing file |
+
+**Examples:**
+
+```bash
+fastkit make service Invoice
+fastkit make service Invoice --async
+```
+
+---
+
+### `fastkit make router`
+
+Generates only the router file with full CRUD endpoints.
+
+```bash
+fastkit make router <Name> [OPTIONS]
+```
+
+| Option | Short | Default | Description |
+|--------|-------|---------|-------------|
+| `--path` | `-p` | `.` | Target directory |
+| `--async` | `-a` | `False` | Use async router |
+| `--force` | `-f` | `False` | Overwrite existing file |
+
+**Examples:**
+
+```bash
+fastkit make router Invoice
+fastkit make router Invoice --async
+```
+
+**Generated endpoints:**
+
+```
+GET    /invoices        → index   (paginated list)
+GET    /invoices/{id}   → show
+POST   /invoices        → store
+PUT    /invoices/{id}   → update
+DELETE /invoices/{id}   → destroy
+```
+
+---
+
+## migrate
+
+Wrapper around [Alembic](https://alembic.sqlalchemy.org/) migrations.
+
+### `fastkit migrate run`
+
+Run all pending migrations.
+
+```bash
+fastkit migrate run
+# Equivalent to: alembic upgrade head
+```
+
+### `fastkit migrate make`
+
+Generate a new migration based on model changes.
+
+```bash
+fastkit migrate make -m "create_invoices"
+# Equivalent to: alembic revision --autogenerate -m "create_invoices"
+```
+
+| Option | Short | Required | Description |
+|--------|-------|----------|-------------|
+| `--message` | `-m` | Yes | Migration description |
+
+### `fastkit migrate rollback`
+
+Rollback the last migration.
+
+```bash
+fastkit migrate rollback
+# Equivalent to: alembic downgrade -1
+```
+
+### `fastkit migrate status`
+
+Show the current migration status.
+
+```bash
+fastkit migrate status
+# Equivalent to: alembic current
+```
+
+---
+
+## db seed
+
+Run database seeders.
+
+```bash
+# Run all seeders
+fastkit db seed
+
+# Run a specific seeder
+fastkit db seed UserSeeder
+```
+
+---
+
+## server
+
+Start the FastAPI development server.
+
+```bash
+fastkit server
+```
+
+| Option | Short | Default | Description |
+|--------|-------|---------|-------------|
+| `--host` | `-h` | `0.0.0.0` | Host to bind |
+| `--port` | `-p` | `8000` | Port to bind |
+| `--reload / --no-reload` | | `True` | Enable auto-reload |
+
+**Examples:**
+
+```bash
+# Default
+fastkit server
+
+# Custom host and port
+fastkit server --host 127.0.0.1 --port 9000
+
+# Without auto-reload
+fastkit server --no-reload
+```
+
+---
+
+## new
+
+Create a new FastKit project from a template.
+
+```bash
+fastkit new my-project
+```
+
+---
+
+## Naming Conventions
+
+FastKit CLI automatically handles naming conversions regardless of how you pass the module name:
+
+| Input | Model | Snake | Table | Folder |
+|-------|-------|-------|-------|--------|
+| `Invoice` | `Invoice` | `invoice` | `invoices` | `invoices` |
+| `invoice` | `Invoice` | `invoice` | `invoices` | `invoices` |
+| `InvoiceItem` | `InvoiceItem` | `invoice_item` | `invoice_items` | `invoice_items` |
+| `invoice_item` | `InvoiceItem` | `invoice_item` | `invoice_items` | `invoice_items` |
+| `Category` | `Category` | `category` | `categories` | `categories` |
+
+---
+
+## Typical Workflow
+
+```bash
+# 1. Generate a new module
+fastkit make module Invoice --async
+
+# 2. Define your model fields
+# Edit modules/invoices/models.py
+
+# 3. Define your schemas
+# Edit modules/invoices/schemas.py
+
+# 4. Generate and run migration
+fastkit migrate make -m "create_invoices"
+fastkit migrate run
+
+# 5. Register the router in your main app
+# In app.py:
+# from modules.invoices.router import router as invoices_router
+# app.include_router(invoices_router, prefix="/api/v1")
+
+# 6. Start the server
+fastkit server
+```
+
+---
+
+## Related Packages
+
+- [fastkit-core](https://pypi.org/project/fastkit-core/) — Base classes, repository pattern, validation, i18n
+- [mailbridge](https://pypi.org/project/mailbridge/) — Email delivery abstraction
+
+---
+
+## License
+
+FastKit Core is open-source software licensed under the [MIT License](https://opensource.org/license/MIT).
+
+---
+
+## Built by CodeVelo
+
+FastKit is developed and maintained by [Codevelo](https://codevelo.io) for the FastAPI community.

fastkit_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,14 @@
+fastkit_cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+fastkit_cli/main.py,sha256=MVCbiuhOWz9I2FfKP6KU4qjHBINznR_ekb4OJYKAdo4,514
+fastkit_cli/commands/__init__.py,sha256=O2DOG56rHVwANWjyy6hsA3sP3BHtA86_cQqoXcAlyXc,246
+fastkit_cli/commands/make.py,sha256=MRxDqAOvHcgLcKCwwBfVYgH5xtoj9MlTkiO8HYlQxF0,13051
+fastkit_cli/commands/migrate.py,sha256=oJHDi4I6PWLvOcSXs9v9vYv6SUxZs2DwydPHMJe96Y0,688
+fastkit_cli/commands/new.py,sha256=wKgbwCijTL202Oi68tSjRm_dOwlPKFjC2YguR8r45js,276
+fastkit_cli/commands/seed.py,sha256=ThRGBxgM-ciU19th0Ccsker6UWYT890Ocnb1XxJkOnc,344
+fastkit_cli/commands/server.py,sha256=QaClYex641TI8Ua5L9CN6lqE2ArPL5t0wMjf1jZMfes,459
+fastkit_cli/templates/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+fastkit_cli-0.1.0.dist-info/METADATA,sha256=OPvkrG2NVXQdrTxgQJLvQJVkw6IxN4MYiEjln16YUb4,9835
+fastkit_cli-0.1.0.dist-info/WHEEL,sha256=YCfwYGOYMi5Jhw2fU4yNgwErybb2IX5PEwBKV4ZbdBo,91
+fastkit_cli-0.1.0.dist-info/entry_points.txt,sha256=9bLU81EMcn8V0JrhwAyGn4CDPp8yDEeRgCjppHbZC2Y,49
+fastkit_cli-0.1.0.dist-info/top_level.txt,sha256=OWFS0N5oLU8nzQkoMXL9W3vTrhGutPKYVppxwH8IOPo,12
+fastkit_cli-0.1.0.dist-info/RECORD,,

fastkit_cli-0.1.0.dist-info/WHEEL

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

fastkit_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+fastkit = fastkit_cli.main:app

fastkit_cli-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+fastkit_cli