fastapi-fastio 0.1.2__py3-none-any.whl

fastapi_fastio-0.1.2.dist-info/METADATA

@@ -0,0 +1,159 @@
+Metadata-Version: 2.4
+Name: fastapi-fastio
+Version: 0.1.2
+Summary: Opinionated FastAPI project scaffolding CLI for services, monoliths, and monorepos.
+Project-URL: Homepage, https://github.com/goloodev/fastio
+Project-URL: Repository, https://github.com/goloodev/fastio
+Project-URL: Issues, https://github.com/goloodev/fastio/issues
+Author-email: goloodev@gmail.com
+License: MIT
+License-File: LICENSE
+Keywords: cli,fastapi,microservices,monolith,scaffold,template,uv
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.11
+Requires-Dist: click>=8.1.0
+Requires-Dist: jinja2>=3.1.4
+Requires-Dist: pydantic>=2.8.2
+Requires-Dist: rich>=13.7.1
+Requires-Dist: typer>=0.12.5
+Description-Content-Type: text/markdown
+
+# fastio
+
+`fastio` is an opinionated Python CLI that generates FastAPI projects for three shapes:
+
+- single service
+- modular monolith
+- monorepo microservices
+
+It is designed around your standards:
+
+- Python + FastAPI
+- `uv`
+- Alembic
+- SQLAlchemy
+- Swagger at `/docs`
+- SQLAdmin
+- Celery + Redis
+- clean architecture
+- thin routers
+- business logic in `services/`
+- versioned APIs under `/api/v1`
+
+## Install
+
+### Local development
+```bash
+uv sync
+uv run fastio --help
+```
+
+### Editable install
+```bash
+uv pip install -e .
+fastio --help
+```
+
+## Quick start
+
+Create a CRUD service:
+
+```bash
+uv run fastio create my-service --mode service --blueprint crud-service
+```
+
+Create a user service:
+
+```bash
+uv run fastio create user-service --mode service --blueprint user-service
+```
+
+Create a modular monolith:
+
+```bash
+uv run fastio create my-app --mode monolith
+```
+
+Create a monorepo:
+
+```bash
+uv run fastio create platform --mode monorepo
+```
+
+## Publishing to PyPI
+
+The project includes a GitHub Actions publish workflow using PyPI Trusted Publishing.
+PyPI’s docs recommend Trusted Publishing via OIDC because it avoids long-lived API tokens, and a pending publisher can create a new project on first release. Also note that a pending publisher does **not** reserve the name before first publish.
+
+## Commands
+
+### `fastio create`
+
+Generate a new FastAPI project.
+
+```bash
+fastio create NAME [OPTIONS]
+```
+
+**Arguments:**
+- `NAME` - Project directory name (required)
+
+**Options:**
+- `--mode {service,monolith,monorepo}` - Project shape (default: service)
+- `--blueprint {base,crud-service,user-service}` - Project template (default: base for monolith/monorepo, crud-service for service)
+- `--database {sqlite,postgres}` - Database backend (default: sqlite)
+- `--sqlalchemy {sync,async}` - SQLAlchemy mode (default: sync, async for user-service)
+- `--sqladmin/--no-sqladmin` - Include SQLAdmin (default: enabled)
+- `--celery/--no-celery` - Include Celery + Redis (default: enabled)
+- `--docker/--no-docker` - Include Dockerfile (default: enabled)
+- `--tests/--no-tests` - Include test suite (default: enabled)
+- `--ci/--no-ci` - Include GitHub Actions CI workflow (default: enabled)
+- `--output-dir, -o` - Output directory (default: current directory)
+- `--interactive` - Interactive mode with prompts for all options
+
+**Blueprints:**
+- `base` - Minimal FastAPI project with core structure
+- `crud-service` - Full CRUD API with models, schemas, and services
+- `user-service` - User management service with authentication, OAuth, and FastAPI-Users
+
+### `fastio version`
+
+Display the installed version.
+
+```bash
+fastio version
+```
+
+## Usage Examples
+
+### Interactive mode
+```bash
+uv run fastio create my-project --interactive
+```
+
+### CRUD service with PostgreSQL
+```bash
+uv run fastio create my-api --mode service --blueprint crud-service --database postgres
+```
+
+### Async monolith
+```bash
+uv run fastio create my-app --mode monolith --sqlalchemy async
+```
+
+### Minimal service without extras
+```bash
+uv run fastio create my-service --mode service --no-celery --no-sqladmin
+```
+
+### Monorepo with custom output
+```bash
+uv run fastio create platform --mode monorepo --output-dir ./projects
+```

fastapi_fastio-0.1.2.dist-info/RECORD

@@ -0,0 +1,91 @@
+fastio/__init__.py,sha256=ArE6rYaXsyJRb5LF9eUeRKvdvw715SpX6KFe3vWKp-c,48
+fastio/main.py,sha256=D6dseHUsOw4XvTELxm0E8qhQv046BXieM9HyyKMntr4,62
+fastio/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+fastio/cli/app.py,sha256=Ikdc3OIA8CX7RhvFofw6I8_hgq6MEsqmkuXFicschs8,6014
+fastio/generators/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+fastio/generators/base.py,sha256=iuGjydAixukHSG5Ov1rKwTieOIuO_rTDQApfoIe98P0,1138
+fastio/generators/monolith.py,sha256=ExU4qCQD2HrXy2dkt_UXXtsqiN_ZY4sJf4_L-9_TgLw,1723
+fastio/generators/monorepo.py,sha256=y-k20rd673v6mzJO_qEJ8uNTrgb5gyjrIaD1HRbZuak,3340
+fastio/generators/service.py,sha256=X2A9FsWFsYXpRgXi7HNlBtR4vbjtYot2Mk2FpWZlm0s,6142
+fastio/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+fastio/models/options.py,sha256=NRBIEEvuMF5FzkwVa-5sWtu9dQ7tWwtSy3-_CynL4As,1955
+fastio/renderers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+fastio/renderers/jinja.py,sha256=_eAgAJLt3ZLG_VmKlmki_M9DyLhXja-S8RoBiFL0KzA,585
+fastio/renderers/writer.py,sha256=ukEgWXfU_gU3kQlAVw98pyr3tWEdfIf7t9zkmeqDsXU,225
+fastio/templates/common/Dockerfile.j2,sha256=BVAfvdSO15kY3kg4Y618kgjYEgsCgH0HmuPy8G-YYFA,196
+fastio/templates/common/compose.yml.j2,sha256=M272RRXe6eBoFBHtnLWqGKNDDTzZJGWdUD2obp1evUo,1270
+fastio/templates/common/empty.py.j2,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+fastio/templates/common/env.example.j2,sha256=g0JSmBC-127KMP8p3h6F1BBZOdrIujnQIFIb_CQTTPk,558
+fastio/templates/common/gitignore.j2,sha256=ijUWFuFD59FtSMUziT1HmIl5vf4Mzg1Gy2VBICB77sw,141
+fastio/templates/common/publish.yml.j2,sha256=qRgVlknGmAZF-JAugF9tgdsgTg9vu5Ld8DHRO7qcFKk,593
+fastio/templates/common/test_smoke.py.j2,sha256=zs-Q2949bNmLCW3n7tJD-afDyiHZRuudzF8Rgc7OLMc,42
+fastio/templates/monolith/README.md.j2,sha256=M5Jez6X0aJIL4GJwmvOaN50Lx0vpubTYIeFme-IdDV0,159
+fastio/templates/monolith/alembic.ini.j2,sha256=Z8tBmcO-2Us1MC_R32dw87qfEnHFqtZhzUegXTuqhWg,242
+fastio/templates/monolith/pyproject.toml.j2,sha256=w-husuowK20ljrnoT-MJVwjrOKvJ3XaSMqrTZ4UnTrg,943
+fastio/templates/monolith/app/main.py.j2,sha256=ItlWRLHSJjALjYHLE5JewkHrgE6O7opweXfrpEPf_ZE,305
+fastio/templates/monolith/app/core/config.py.j2,sha256=ghlcNaEJef2vzuQtGEm3bN1chimQZq9MmHve74nxmjw,711
+fastio/templates/monolith/app/modules/users/api.py.j2,sha256=oAsnBa9dxaO0ZqpEIMvKLC8lLWvNNDSEpS-NaChg8ww,168
+fastio/templates/monolith/app/modules/users/models.py.j2,sha256=DGisa924ifa3PqFPagrvfVSBgLiGtItSbfTqCMZ4c0Y,21
+fastio/templates/monolith/app/modules/users/schemas.py.j2,sha256=6SuT_NVX0BPO4KX2UdVhoIV7Z5ehz3kCUci6q4wRhhk,87
+fastio/templates/monolith/app/modules/users/service.py.j2,sha256=W005DOa4g5ElkF9JaTaoGy7kBfELY1nq5JB9MojZFrQ,128
+fastio/templates/monolith/app/tasks/celery_app.py.j2,sha256=7wdGrlzgKX4ANCgHXgmkY-wl-11vlEtRjm9Q_EBXb5I,381
+fastio/templates/monorepo/README.md.j2,sha256=glXyq0Kb4ZKBl0Ine4HgjGbcfO4-ZbyXrqQ76-sHNFg,182
+fastio/templates/monorepo/pyproject.toml.j2,sha256=jWnsm27p3uW5YVsWyfKtLLe5a4G5uJf4WVOuv6qmsXs,226
+fastio/templates/monorepo/packages/shared-auth/README.md.j2,sha256=Ja4ugpvVBd1Hht2DUymP2GwnQMPMMbzP49X4pM7qMR0,77
+fastio/templates/monorepo/packages/shared-clients/README.md.j2,sha256=W___0Kos4rtsK9WJD5r7CYZ_zU4IrmZHcewLW-M25QI,81
+fastio/templates/monorepo/packages/shared-events/README.md.j2,sha256=patHnc-XS0rcjaPjx9EoXfgdNHf51ljb5xpX91E3pZk,73
+fastio/templates/monorepo/packages/shared-schemas/README.md.j2,sha256=XgfIqmgiCKLOW7BjVrZ5RB7X-Xeeqe5UKeVqVhxrdV8,79
+fastio/templates/service/README.md.j2,sha256=SPH6D5O6oBiWi1p_4klGGsvY8mrlp8ivUH2rpX2V7A0,856
+fastio/templates/service/alembic.ini.j2,sha256=Z8tBmcO-2Us1MC_R32dw87qfEnHFqtZhzUegXTuqhWg,242
+fastio/templates/service/pyproject.toml.j2,sha256=3A1bxX9aV1WFubyqKa_1_PX9w-RJ6Dwn_PgHUoBPYA8,1022
+fastio/templates/service/app/admin.py.j2,sha256=vyZpVnqxQ4AG79-qEBAsIu7MICo0-16t2T8Q0XrjbAE,5555
+fastio/templates/service/app/main.py.j2,sha256=Zpweture5fvt5Djfwcn1eIfPAQu13vpZhUGOpCPXulI,493
+fastio/templates/service/app/main_telegram.py.j2,sha256=IdmRT2bCKBWo3rjxoPXMKWlmdAFxuXDoCny0geY4idc,891
+fastio/templates/service/app/api/deps.py.j2,sha256=ouhJwaW2FeVtdif3RqMcmbs7C3cATQK85dls4ydYts8,247
+fastio/templates/service/app/api/v1/airdrop.py.j2,sha256=KpLr9NEbwreMH9yT6vmrGD3kt81gSkKSh723Xk8UHs4,1528
+fastio/templates/service/app/api/v1/api.py.j2,sha256=JF4AU6hZhwWDV0VNdpl8VjaX94oFl5qGpxXHxRcPGrw,1956
+fastio/templates/service/app/api/v1/items.py.j2,sha256=2BCH5lfTA-V2pFApGmWJVhpLIPIP5awoDfMqYfMlL7k,603
+fastio/templates/service/app/api/v1/members.py.j2,sha256=gaklirbQ8KW86qVmdkuZXALAbjqHtrjT1R6gVT-1rcY,1622
+fastio/templates/service/app/api/v1/moderation.py.j2,sha256=KLxFGJGN7Hddh7jYTAzmoeAqP_GRe-NBoILPL9RwiI8,1019
+fastio/templates/service/app/api/v1/orders.py.j2,sha256=Rh1aY5jkvXtP7XjviJbH1G-fxEYX2jIssbsQ2AgbBho,1030
+fastio/templates/service/app/api/v1/products.py.j2,sha256=SdTVC53W1nNu7hqIPZ-QAWgx4oe94q1l0VVazSptwn0,1495
+fastio/templates/service/app/api/v1/profile.py.j2,sha256=wUmfTXD6li97rQM1_qOrMt4zbmU-kdglo61dEp9z2wI,172
+fastio/templates/service/app/bot/bot.py.j2,sha256=wwaj3svxc_eUHRIvwgXzgL3p0W8Hq0r_1jrA5iz0dTo,193
+fastio/templates/service/app/bot/handlers.py.j2,sha256=l0FEGYqYCu3Zgo0XEVzzZZOUjN_VMd4W9tIKxu2pXio,712
+fastio/templates/service/app/bot/handlers/airdrop.py.j2,sha256=DbL1TyospE_5DXbntezmIslVcBeczpzElw2zafB3s5o,3376
+fastio/templates/service/app/bot/handlers/ecommerce.py.j2,sha256=cYpI2FMrl5eowMoa8sbkky_Dmp49C0NY507EFNPnmz8,2948
+fastio/templates/service/app/bot/handlers/membership.py.j2,sha256=VHpOMvbgxl0aVxyhzrGFBtvpRnd0eUvbN4JjL7Zz4Hg,2157
+fastio/templates/service/app/bot/handlers/police_group.py.j2,sha256=toFG3TGP3HAWkvwZ9xd5R3OdH6kHinzC3lrmwX58JXI,4381
+fastio/templates/service/app/core/config.py.j2,sha256=Uo02avFTlEecStGzf0zJ0kXZWVKFXqTe73lhlIOU32g,902
+fastio/templates/service/app/core/security.py.j2,sha256=QlXygrwSXI3tQLxZbL9v00lIRyvMRoWzYUYgx7eGVho,59
+fastio/templates/service/app/db/base.py.j2,sha256=hEsUrA1w1ixEUgdwhMuDiMYuDYc33gAdbRJGtYdxS1w,431
+fastio/templates/service/app/db/session.py.j2,sha256=jGps9-xQUH6zfwSCFnIkv_etV-JLPY2SXf84aUHnMFE,272
+fastio/templates/service/app/db/models/item.py.j2,sha256=PItVDW8MArArO0mgQ4ouIxzPjvjvQ_A3GdKpA0aJ10g,403
+fastio/templates/service/app/db/models/member.py.j2,sha256=c6g_avU_dCd34e_EmY1sLzAi4S0_qHeS3jOqRECZ-bM,645
+fastio/templates/service/app/db/models/order.py.j2,sha256=PbN5cCss6O1-tIYKO9pqrpt1ToMjUa8RMEfXfl3HwaI,836
+fastio/templates/service/app/db/models/participant.py.j2,sha256=qJZhSYPR3sPpjhatsI02Hi0u217SS4cJQZV1R63CE0s,900
+fastio/templates/service/app/db/models/product.py.j2,sha256=EjKO0RQHF42iJVzaTznYK_x-iMVNk_V7Vkzg8c4PbfI,601
+fastio/templates/service/app/db/models/report.py.j2,sha256=oQclzRffm2pt4Ckq747YqvzbRpQ-2tgpuE0V00S8OSA,1064
+fastio/templates/service/app/schemas/item.py.j2,sha256=xknAZJuspUOE7MPC5DjDe91Yo5SDi77pEW64YnxNFTc,210
+fastio/templates/service/app/schemas/member.py.j2,sha256=ppFDBfmM8ZjDGpizhQ4syBlfgCOyHHYe_SSaEnSw3UQ,300
+fastio/templates/service/app/schemas/order.py.j2,sha256=YF2B6WWzNA1kcGcvx9gKt7fMpej9kGRoTCR9Ymhg29g,337
+fastio/templates/service/app/schemas/participant.py.j2,sha256=uXBkqt4tCn3rZFmB2Juex3V5FWFdQN5Wg4fBtluiRVg,406
+fastio/templates/service/app/schemas/product.py.j2,sha256=yCyqtNQTdlENdzJPk8a-1kvIYqy-9s01TIGq8r7dNN4,528
+fastio/templates/service/app/schemas/report.py.j2,sha256=JvhIMbhIwk1yy8fKIdbA1y9BpjKKBOUCMsWI6cj1TIw,522
+fastio/templates/service/app/schemas/user.py.j2,sha256=6SuT_NVX0BPO4KX2UdVhoIV7Z5ehz3kCUci6q4wRhhk,87
+fastio/templates/service/app/services/airdrop_service.py.j2,sha256=xgOVh9Wap2MXXoLG1upLcwfuYyOp4bt9F-hhpgahTFg,2772
+fastio/templates/service/app/services/item_service.py.j2,sha256=0J2WgfwJWwFJ_4UiQ0K-37YExKssN-6UTVNyHmpR4NY,685
+fastio/templates/service/app/services/member_service.py.j2,sha256=FO9zvFcrGPvdQxgR80ezehslJcI-KSyGY1a23dVZMig,1430
+fastio/templates/service/app/services/moderation_service.py.j2,sha256=8btMw0ii7ajiuvnsRbicaTR2okbwXdIlC9jhRGbkTsg,2271
+fastio/templates/service/app/services/shop_service.py.j2,sha256=OGjLn1zGlU9nUV7IfDWt97BuLNOnfjlEKTy1XKtvfJc,3363
+fastio/templates/service/app/tasks/celery_app.py.j2,sha256=7wdGrlzgKX4ANCgHXgmkY-wl-11vlEtRjm9Q_EBXb5I,381
+fastio/templates/service/app/tasks/item_tasks.py.j2,sha256=GGUB6p_RQZ4dL3FsGT-CnDL1aqbFtf54QcFBqszmGiI,152
+fastio/templates/service/app/tasks/user_tasks.py.j2,sha256=J58YUcUJswmwcT902z_ugbQZ3ttXLb9xBqqiehimMD4,696
+fastio/templates/service/app/users/auth.py.j2,sha256=GiivRrKBwxqup5UEavvQsnBh9nxUlQ_Qa7-AIE3GV5c,44
+fastio/templates/service/app/users/manager.py.j2,sha256=SP797yowIavXGZDZVDr5haGokT7NWIb3wwXNZTtO37Y,41
+fastio/templates/service/app/users/oauth.py.j2,sha256=masmHlAwd9tpswJf73nzpnld1bW6JHuomeoAW7-vYmQ,85
+fastapi_fastio-0.1.2.dist-info/METADATA,sha256=Q-WQHuDY9Rs1QVu0b1IEF7llMxMndghkJXoN3Xo6vI0,4256
+fastapi_fastio-0.1.2.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+fastapi_fastio-0.1.2.dist-info/entry_points.txt,sha256=jRLnQVTrDIKaiKTpDoKXvZBDMTp44MOSeyqgXPUMLOc,43
+fastapi_fastio-0.1.2.dist-info/licenses/LICENSE,sha256=ESYyLizI0WWtxMeS7rGVcX3ivMezm-HOd5WdeOh-9oU,1056
+fastapi_fastio-0.1.2.dist-info/RECORD,,

fastapi_fastio-0.1.2.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

fastapi_fastio-0.1.2.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+fastio = fastio.main:run

fastapi_fastio-0.1.2.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+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.

fastio/__init__.py

@@ -0,0 +1,2 @@
+__all__ = ["__version__"]
+__version__ = "0.1.2"

fastio/cli/app.py

@@ -0,0 +1,151 @@
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Annotated, Optional
+
+import click
+import typer
+from rich.console import Console
+from rich.panel import Panel
+
+from fastio import __version__
+from fastio.generators.monolith import MonolithGenerator
+from fastio.generators.monorepo import MonorepoGenerator
+from fastio.generators.service import ServiceGenerator
+from fastio.models.options import AlchemyMode, Blueprint, Database, Mode, ProjectOptions, TelegramTemplate
+
+app = typer.Typer(
+    no_args_is_help=True,
+    help="Opinionated FastAPI scaffolding CLI for services, monoliths, and monorepos.",
+)
+console = Console()
+
+
+def _build_options(
+    name: str,
+    output_dir: Path,
+    mode: Optional[Mode],
+    blueprint: Optional[Blueprint],
+    database: Optional[Database],
+    sqlalchemy_mode: Optional[AlchemyMode],
+    sqladmin: Optional[bool],
+    celery: Optional[bool],
+    docker: Optional[bool],
+    tests: Optional[bool],
+    ci: Optional[bool],
+    interactive: bool,
+    telegram_template: Optional[TelegramTemplate] = None,
+) -> ProjectOptions:
+    if interactive or mode is None:
+        mode = typer.prompt("Mode", type=click.Choice(["service", "monolith", "monorepo"], case_sensitive=False), default="service")
+    if interactive or blueprint is None:
+        default_blueprint = "base" if mode != "service" else "crud-service"
+        blueprint = typer.prompt("Blueprint", type=click.Choice(["base", "crud-service", "user-service", "telegram-bot"], case_sensitive=False), default=default_blueprint)
+    if interactive or database is None:
+        database = typer.prompt("Database", type=click.Choice(["sqlite", "postgres"], case_sensitive=False), default="sqlite")
+    if interactive or sqlalchemy_mode is None:
+        default_sqlalchemy = "async" if blueprint == "user-service" else "sync"
+        sqlalchemy_mode = typer.prompt("SQLAlchemy mode", type=click.Choice(["sync", "async"], case_sensitive=False), default=default_sqlalchemy)
+    if interactive or sqladmin is None:
+        sqladmin = typer.confirm("Include SQLAdmin?", default=True)
+    if interactive or celery is None:
+        celery = typer.confirm("Include Celery?", default=True)
+    if interactive or docker is None:
+        docker = typer.confirm("Include Dockerfile?", default=True)
+    if interactive or tests is None:
+        tests = typer.confirm("Include tests?", default=True)
+    if interactive or ci is None:
+        ci = typer.confirm("Include CI workflow?", default=True)
+    if blueprint == "telegram-bot" and (interactive or telegram_template is None):
+        telegram_template = typer.prompt(
+            "Telegram Template",
+            type=click.Choice(["membership", "police-group", "airdrop", "ecommerce"], case_sensitive=False),
+            default="membership",
+        )
+
+    return ProjectOptions(
+        name=name,
+        output_dir=output_dir,
+        mode=mode,
+        blueprint=blueprint,
+        database=database,
+        sqlalchemy_mode=sqlalchemy_mode,
+        use_sqladmin=bool(sqladmin),
+        use_celery=bool(celery),
+        use_docker=bool(docker),
+        use_tests=bool(tests),
+        use_ci=bool(ci),
+        telegram_template=telegram_template,
+    )
+
+
+@app.command()
+def version() -> None:
+    console.print(f"fastio {__version__}")
+
+
+@app.command()
+def create(
+    name: str = typer.Argument(..., help="Project directory name."),
+    output_dir: Annotated[Path, typer.Option("--output-dir", "-o", dir_okay=True, file_okay=False)] = Path.cwd(),
+    mode: Annotated[Optional[Mode], typer.Option("--mode")] = None,
+    blueprint: Annotated[Optional[Blueprint], typer.Option("--blueprint")] = None,
+    database: Annotated[Optional[Database], typer.Option("--database")] = None,
+    sqlalchemy_mode: Annotated[Optional[AlchemyMode], typer.Option("--sqlalchemy")] = None,
+    sqladmin: Annotated[Optional[bool], typer.Option("--sqladmin/--no-sqladmin")] = None,
+    celery: Annotated[Optional[bool], typer.Option("--celery/--no-celery")] = None,
+    docker: Annotated[Optional[bool], typer.Option("--docker/--no-docker")] = None,
+    tests: Annotated[Optional[bool], typer.Option("--tests/--no-tests")] = None,
+    ci: Annotated[Optional[bool], typer.Option("--ci/--no-ci")] = None,
+    interactive: Annotated[bool, typer.Option("--interactive/--no-interactive")] = False,
+    telegram_template: Annotated[Optional[TelegramTemplate], typer.Option("--telegram-template")] = None,
+) -> None:
+    options = _build_options(
+        name=name,
+        output_dir=output_dir,
+        mode=mode,
+        blueprint=blueprint,
+        database=database,
+        sqlalchemy_mode=sqlalchemy_mode,
+        sqladmin=sqladmin,
+        celery=celery,
+        docker=docker,
+        tests=tests,
+        ci=ci,
+        interactive=interactive,
+        telegram_template=telegram_template,
+    ).normalized()
+
+    if options.project_dir.exists():
+        raise typer.BadParameter(f"Destination already exists: {options.project_dir}")
+
+    generator_map = {
+        "service": ServiceGenerator,
+        "monolith": MonolithGenerator,
+        "monorepo": MonorepoGenerator,
+    }
+    generator = generator_map[options.mode](options)
+    generator.generate()
+
+    if options.use_ci:
+        workflow_path = options.project_dir / ".github" / "workflows" / "publish.yml"
+        workflow_path.parent.mkdir(parents=True, exist_ok=True)
+        workflow_path.write_text(generator.render("common/publish.yml.j2"), encoding="utf-8")
+
+    console.print(
+        Panel.fit(
+            "\n".join(
+                [
+                    f"[bold green]Created[/bold green] {options.project_dir}",
+                    f"mode = {options.mode}",
+                    f"blueprint = {options.blueprint}",
+                    "",
+                    "Next steps:",
+                    f"  cd {options.project_dir.name}",
+                    "  uv sync",
+                    "  uv run fastapi dev app.main:app",
+                ]
+            ),
+            title="fastio",
+        )
+    )

fastio/generators/base.py

@@ -0,0 +1,33 @@
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Any
+
+from fastio.models.options import ProjectOptions
+from fastio.renderers.jinja import get_environment
+from fastio.renderers.writer import write_text
+
+
+class BaseGenerator:
+    def __init__(self, options: ProjectOptions) -> None:
+        self.options = options.normalized()
+        self.env = get_environment()
+
+    def render(self, template_name: str, **context: Any) -> str:
+        template = self.env.get_template(template_name)
+        merged = {
+            "project": self.options,
+            "project_name": self.options.name,
+            "package_name": self.options.package_name,
+            **context,
+        }
+        return template.render(**merged)
+
+    def write(self, relative_path: str, template_name: str, **context: Any) -> None:
+        destination = self.options.project_dir / relative_path
+        content = self.render(template_name, **context)
+        write_text(destination, content)
+
+    def ensure_root(self) -> Path:
+        self.options.project_dir.mkdir(parents=True, exist_ok=False)
+        return self.options.project_dir

fastio/generators/monolith.py

@@ -0,0 +1,31 @@
+from __future__ import annotations
+
+from fastio.generators.base import BaseGenerator
+
+
+class MonolithGenerator(BaseGenerator):
+    def generate(self) -> None:
+        self.ensure_root()
+        self.write(".gitignore", "common/gitignore.j2")
+        self.write("README.md", "monolith/README.md.j2")
+        self.write("pyproject.toml", "monolith/pyproject.toml.j2")
+        self.write(".env.example", "common/env.example.j2")
+        if self.options.use_docker:
+            self.write("Dockerfile", "common/Dockerfile.j2")
+            self.write("compose.yml", "common/compose.yml.j2")
+        self.write("app/__init__.py", "common/empty.py.j2")
+        self.write("app/main.py", "monolith/app/main.py.j2")
+        self.write("app/core/__init__.py", "common/empty.py.j2")
+        self.write("app/core/config.py", "monolith/app/core/config.py.j2")
+        self.write("app/modules/__init__.py", "common/empty.py.j2")
+        self.write("app/modules/users/__init__.py", "common/empty.py.j2")
+        self.write("app/modules/users/api.py", "monolith/app/modules/users/api.py.j2")
+        self.write("app/modules/users/models.py", "monolith/app/modules/users/models.py.j2")
+        self.write("app/modules/users/schemas.py", "monolith/app/modules/users/schemas.py.j2")
+        self.write("app/modules/users/service.py", "monolith/app/modules/users/service.py.j2")
+        if self.options.use_celery:
+            self.write("app/tasks/__init__.py", "common/empty.py.j2")
+            self.write("app/tasks/celery_app.py", "monolith/app/tasks/celery_app.py.j2")
+        self.write("alembic.ini", "monolith/alembic.ini.j2")
+        if self.options.use_tests:
+            self.write("tests/test_smoke.py", "common/test_smoke.py.j2")

fastio/generators/monorepo.py

@@ -0,0 +1,42 @@
+from __future__ import annotations
+
+from fastio.generators.base import BaseGenerator
+
+
+class MonorepoGenerator(BaseGenerator):
+    def generate(self) -> None:
+        self.ensure_root()
+        self.write("README.md", "monorepo/README.md.j2")
+        self.write("pyproject.toml", "monorepo/pyproject.toml.j2")
+        self.write("packages/shared-schemas/README.md", "monorepo/packages/shared-schemas/README.md.j2")
+        self.write("packages/shared-auth/README.md", "monorepo/packages/shared-auth/README.md.j2")
+        self.write("packages/shared-events/README.md", "monorepo/packages/shared-events/README.md.j2")
+        self.write("packages/shared-clients/README.md", "monorepo/packages/shared-clients/README.md.j2")
+        self.write("services/example-service/README.md", "service/README.md.j2")
+        self.write("services/example-service/pyproject.toml", "service/pyproject.toml.j2")
+        self.write("services/example-service/.env.example", "common/env.example.j2")
+        self.write("services/example-service/Dockerfile", "common/Dockerfile.j2")
+        self.write("services/example-service/compose.yml", "common/compose.yml.j2")
+        self.write("services/example-service/app/__init__.py", "common/empty.py.j2")
+        self.write("services/example-service/app/main.py", "service/app/main.py.j2")
+        self.write("services/example-service/app/admin.py", "service/app/admin.py.j2")
+        self.write("services/example-service/app/core/__init__.py", "common/empty.py.j2")
+        self.write("services/example-service/app/core/config.py", "service/app/core/config.py.j2")
+        self.write("services/example-service/app/api/__init__.py", "common/empty.py.j2")
+        self.write("services/example-service/app/api/deps.py", "service/app/api/deps.py.j2")
+        self.write("services/example-service/app/api/v1/__init__.py", "common/empty.py.j2")
+        self.write("services/example-service/app/api/v1/api.py", "service/app/api/v1/api.py.j2")
+        self.write("services/example-service/app/api/v1/items.py", "service/app/api/v1/items.py.j2")
+        self.write("services/example-service/app/db/__init__.py", "common/empty.py.j2")
+        self.write("services/example-service/app/db/base.py", "service/app/db/base.py.j2")
+        self.write("services/example-service/app/db/session.py", "service/app/db/session.py.j2")
+        self.write("services/example-service/app/db/models/__init__.py", "common/empty.py.j2")
+        self.write("services/example-service/app/db/models/item.py", "service/app/db/models/item.py.j2")
+        self.write("services/example-service/app/schemas/__init__.py", "common/empty.py.j2")
+        self.write("services/example-service/app/schemas/item.py", "service/app/schemas/item.py.j2")
+        self.write("services/example-service/app/services/__init__.py", "common/empty.py.j2")
+        self.write("services/example-service/app/services/item_service.py", "service/app/services/item_service.py.j2")
+        self.write("services/example-service/app/tasks/__init__.py", "common/empty.py.j2")
+        self.write("services/example-service/app/tasks/celery_app.py", "service/app/tasks/celery_app.py.j2")
+        self.write("services/example-service/app/tasks/item_tasks.py", "service/app/tasks/item_tasks.py.j2")
+        self.write("services/example-service/alembic.ini", "service/alembic.ini.j2")

fastio/generators/service.py

@@ -0,0 +1,92 @@
+from __future__ import annotations
+
+from fastio.generators.base import BaseGenerator
+
+
+class ServiceGenerator(BaseGenerator):
+    def generate(self) -> None:
+        self.ensure_root()
+        self.write(".gitignore", "common/gitignore.j2")
+        self.write("README.md", "service/README.md.j2")
+        self.write("pyproject.toml", "service/pyproject.toml.j2")
+        self.write(".env.example", "common/env.example.j2")
+        if self.options.use_docker:
+            self.write("Dockerfile", "common/Dockerfile.j2")
+            self.write("compose.yml", "common/compose.yml.j2")
+        self.write("app/__init__.py", "common/empty.py.j2")
+        if self.options.blueprint == "telegram-bot":
+            self.write("app/main.py", "service/app/main_telegram.py.j2")
+        else:
+            self.write("app/main.py", "service/app/main.py.j2")
+        if self.options.use_sqladmin:
+            self.write("app/admin.py", "service/app/admin.py.j2")
+        self.write("app/core/__init__.py", "common/empty.py.j2")
+        self.write("app/core/config.py", "service/app/core/config.py.j2")
+        self.write("app/api/__init__.py", "common/empty.py.j2")
+        self.write("app/api/deps.py", "service/app/api/deps.py.j2")
+        self.write("app/api/v1/__init__.py", "common/empty.py.j2")
+        self.write("app/api/v1/api.py", "service/app/api/v1/api.py.j2")
+        self.write("app/db/__init__.py", "common/empty.py.j2")
+        self.write("app/db/base.py", "service/app/db/base.py.j2")
+        self.write("app/db/session.py", "service/app/db/session.py.j2")
+        self.write("app/schemas/__init__.py", "common/empty.py.j2")
+        self.write("app/services/__init__.py", "common/empty.py.j2")
+        if self.options.use_celery:
+            self.write("app/tasks/__init__.py", "common/empty.py.j2")
+            self.write("app/tasks/celery_app.py", "service/app/tasks/celery_app.py.j2")
+        self.write("alembic.ini", "service/alembic.ini.j2")
+        if self.options.use_tests:
+            self.write("tests/test_smoke.py", "common/test_smoke.py.j2")
+
+        if self.options.blueprint == "crud-service":
+            self.write("app/api/v1/items.py", "service/app/api/v1/items.py.j2")
+            self.write("app/db/models/__init__.py", "common/empty.py.j2")
+            self.write("app/db/models/item.py", "service/app/db/models/item.py.j2")
+            self.write("app/schemas/item.py", "service/app/schemas/item.py.j2")
+            self.write("app/services/item_service.py", "service/app/services/item_service.py.j2")
+            if self.options.use_celery:
+                self.write("app/tasks/item_tasks.py", "service/app/tasks/item_tasks.py.j2")
+        elif self.options.blueprint == "telegram-bot":
+            self.write("app/bot/__init__.py", "common/empty.py.j2")
+            self.write("app/bot/bot.py", "service/app/bot/bot.py.j2")
+            self.write("app/db/models/__init__.py", "common/empty.py.j2")
+            tpl = self.options.telegram_template
+            if tpl == "membership":
+                self.write("app/bot/handlers.py", "service/app/bot/handlers/membership.py.j2")
+                self.write("app/db/models/member.py", "service/app/db/models/member.py.j2")
+                self.write("app/schemas/member.py", "service/app/schemas/member.py.j2")
+                self.write("app/services/member_service.py", "service/app/services/member_service.py.j2")
+                self.write("app/api/v1/members.py", "service/app/api/v1/members.py.j2")
+            elif tpl == "police-group":
+                self.write("app/bot/handlers.py", "service/app/bot/handlers/police_group.py.j2")
+                self.write("app/db/models/report.py", "service/app/db/models/report.py.j2")
+                self.write("app/schemas/report.py", "service/app/schemas/report.py.j2")
+                self.write("app/services/moderation_service.py", "service/app/services/moderation_service.py.j2")
+                self.write("app/api/v1/moderation.py", "service/app/api/v1/moderation.py.j2")
+            elif tpl == "airdrop":
+                self.write("app/bot/handlers.py", "service/app/bot/handlers/airdrop.py.j2")
+                self.write("app/db/models/participant.py", "service/app/db/models/participant.py.j2")
+                self.write("app/schemas/participant.py", "service/app/schemas/participant.py.j2")
+                self.write("app/services/airdrop_service.py", "service/app/services/airdrop_service.py.j2")
+                self.write("app/api/v1/airdrop.py", "service/app/api/v1/airdrop.py.j2")
+            elif tpl == "ecommerce":
+                self.write("app/bot/handlers.py", "service/app/bot/handlers/ecommerce.py.j2")
+                self.write("app/db/models/product.py", "service/app/db/models/product.py.j2")
+                self.write("app/db/models/order.py", "service/app/db/models/order.py.j2")
+                self.write("app/schemas/product.py", "service/app/schemas/product.py.j2")
+                self.write("app/schemas/order.py", "service/app/schemas/order.py.j2")
+                self.write("app/services/shop_service.py", "service/app/services/shop_service.py.j2")
+                self.write("app/api/v1/products.py", "service/app/api/v1/products.py.j2")
+                self.write("app/api/v1/orders.py", "service/app/api/v1/orders.py.j2")
+            else:
+                self.write("app/bot/handlers.py", "service/app/bot/handlers.py.j2")
+        elif self.options.blueprint == "user-service":
+            self.write("app/api/v1/profile.py", "service/app/api/v1/profile.py.j2")
+            self.write("app/core/security.py", "service/app/core/security.py.j2")
+            self.write("app/schemas/user.py", "service/app/schemas/user.py.j2")
+            self.write("app/users/__init__.py", "common/empty.py.j2")
+            self.write("app/users/auth.py", "service/app/users/auth.py.j2")
+            self.write("app/users/manager.py", "service/app/users/manager.py.j2")
+            self.write("app/users/oauth.py", "service/app/users/oauth.py.j2")
+            if self.options.use_celery:
+                self.write("app/tasks/user_tasks.py", "service/app/tasks/user_tasks.py.j2")