craft-easy-api 0.1.0

Craft your API the easy way — Production-ready REST API framework built on FastAPI + MongoDB

Craft Easy API

Craft your API the easy way.

A production-ready base system for REST APIs built on FastAPI + MongoDB. Get authentication, authorization, CRUD, cascade operations, and audit logging out of the box — then focus on your business logic.

Status: Pre-alpha. API is unstable and will change.

What you get

• Zero-boilerplate CRUD — Define a model, get a complete REST endpoint with validation, pagination, filtering, and sorting
• Authentication — JWT (ES512) with toggleable on/off, OAuth2 providers (Google, Microsoft, GitHub)
• Feature-based authorization — Access groups with resource/attribute/data-level permissions
• Cascade operations — Declarative delete (deny/null/delete) and update (subscriber pattern)
• ETag concurrency control — Optimistic locking on all mutations
• Audit trail — Every mutation logged automatically
• Schema-driven admin — /admin/schema endpoint powers the Craft Easy Admin app

Quick start

pip install craft-easy-api

from craft_easy import create_app
from craft_easy.crud import Resource
from craft_easy.models.user import User
from craft_easy.models.organization import Organization

app = create_app()

app.include_router(Resource(User, "users").build())
app.include_router(Resource(Organization, "organizations").build())

uvicorn app:app --reload
# API:     http://localhost:8000
# Docs:    http://localhost:8000/docs

Development

git clone https://github.com/easy-software-system/craft-easy-api.git
cd craft-easy-api
python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
docker compose up -d    # Start MongoDB
pytest                  # Run tests

Documentation

Full documentation: craft-easy.dev (coming soon)

License

MIT — see LICENSE.