Skip to main content

FastAPI scaffolding CLI

Project description

๐Ÿฆ‡ Yish CLI

Opinionated FastAPI scaffolding CLI for modern Python backend development.

Yish CLI is a lightweight command-line tool that bootstraps FastAPI projects using a predefined project structure and development conventions.

Instead of manually creating folders, Docker files, configuration files, and boilerplate for every project, Yish CLI generates a production-ready project in seconds.


โœจ Features

  • ๐Ÿš€ FastAPI project scaffolding
  • ๐Ÿ“ฆ Docker & Docker Compose
  • ๐Ÿ UV-ready project
  • ๐Ÿ“ Opinionated project structure
  • โš™๏ธ Environment configuration
  • ๐Ÿ“ README generation
  • ๐Ÿ”’ GitIgnore generation
  • ๐Ÿงฉ Easily extendable templates

๐Ÿ“‚ Generated Structure

project/
โ”‚
โ”œโ”€โ”€ app/
โ”‚   โ”œโ”€โ”€ api/
โ”‚   โ”œโ”€โ”€ core/
โ”‚   โ”œโ”€โ”€ db/
โ”‚   โ”œโ”€โ”€ models/
โ”‚   โ”œโ”€โ”€ schemas/
โ”‚   โ”œโ”€โ”€ repositories/
โ”‚   โ”œโ”€โ”€ services/
โ”‚   โ”œโ”€โ”€ providers/
โ”‚   โ”œโ”€โ”€ middlewares/
โ”‚   โ”œโ”€โ”€ dependencies/
โ”‚   โ”œโ”€โ”€ exceptions/
โ”‚   โ”œโ”€โ”€ logging/
โ”‚   โ”œโ”€โ”€ cache/
โ”‚   โ”œโ”€โ”€ utils/
โ”‚   โ”œโ”€โ”€ workers/
โ”‚   โ””โ”€โ”€ main.py
โ”‚
โ”œโ”€โ”€ Dockerfile
โ”œโ”€โ”€ docker-compose.yaml
โ”œโ”€โ”€ pyproject.toml
โ”œโ”€โ”€ .env.example
โ”œโ”€โ”€ README.md
โ””โ”€โ”€ .gitignore

๐Ÿš€ Installation

Local Development

git clone https://github.com/<your-username>/yish-cli.git

cd yish-cli

uv sync

uv pip install -e .

Usage

Create a new project.

yish new my-awesome-api

Result:

my-awesome-api/

ready for development.


Philosophy

Yish CLI follows one simple philosophy.

Stop creating the same project over and over again.

It automates the repetitive setup so developers can immediately start building features instead of project scaffolding.


Roadmap

  • FastAPI project scaffolding
  • Multiple templates
  • Project placeholder replacement
  • Service generator
  • Route generator
  • Repository generator
  • AI project template
  • RAG template
  • Authentication template

Tech Stack

  • Python
  • Typer
  • Rich
  • UV

License

MIT License


Author

Built with โค๏ธ by Justine Juan.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

yish_cli-0.1.1.2.tar.gz (11.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

yish_cli-0.1.1.2-py3-none-any.whl (24.7 kB view details)

Uploaded Python 3

File details

Details for the file yish_cli-0.1.1.2.tar.gz.

File metadata

  • Download URL: yish_cli-0.1.1.2.tar.gz
  • Upload date:
  • Size: 11.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for yish_cli-0.1.1.2.tar.gz
Algorithm Hash digest
SHA256 75be0cb2d3aea89e7c5de3c3c32b6e4ad5b510dbae9a5899478e1219306ca23b
MD5 17a52eb7bb7fc101cf557883c4fa37e2
BLAKE2b-256 cbfe103ccf4c7feb27cf8119a8a02e52c4ce12d6ca1ea77627068598c1ed5569

See more details on using hashes here.

File details

Details for the file yish_cli-0.1.1.2-py3-none-any.whl.

File metadata

  • Download URL: yish_cli-0.1.1.2-py3-none-any.whl
  • Upload date:
  • Size: 24.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for yish_cli-0.1.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 f0b34154762f6eb605cd958ce2a80a414a78eac7fb6e988ede66f94373ae73d5
MD5 e6301cb6bd4830baa643750a2c099eca
BLAKE2b-256 d0f9cb7867a66dfb2c173a20211ca044c7204341a90dbbd919a34c119b536b11

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page