Skip to content
/ runapi Public

A Next.js-inspired file-based routing framework built on FastAPI for Python backend development. runapi makes building robust APIs as intuitive as creating files and folders.

License

Notifications You must be signed in to change notification settings

Amanbig/runapi

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

35 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Runapi 🚀

PyPI version Python 3.8+ License: MIT

A Next.js-inspired file-based routing framework built on FastAPI for Python backend development. runapi makes building robust APIs as intuitive as creating files and folders.

Why Runapi?

  • 🚀 Developer Experience: Just like Next.js for React, runapi makes backend development intuitive
  • Performance: Built on FastAPI, one of the fastest Python frameworks
  • 🛡️ Production Ready: Security, middleware, and error handling built-in
  • 🎯 Type Safe: Full typing support with automatic validation
  • 📁 Intuitive: File-based routing means your folder structure IS your API

Features

  • 📁 File-based routing - Create API routes by simply adding Python files
  • FastAPI integration - Built on top of FastAPI for high performance
  • 🔐 Authentication system - JWT-based auth with middleware support
  • 🛡️ Middleware stack - Built-in middleware for CORS, rate limiting, security headers
  • ⚙️ Configuration management - Environment-based configuration with .env support
  • 🚨 Error handling - Comprehensive error handling with custom exceptions
  • 🔧 CLI tools - Command-line interface for project management
  • 📝 Auto-documentation - Automatic API documentation via FastAPI
  • 🎯 Type hints - Full typing support with Pydantic integration
  • 📦 Schema layer - Auto-discovered Pydantic models with base classes
  • 🗄️ Repository pattern - Data access abstraction with in-memory and SQLAlchemy support
  • 🧩 Service layer - Business logic separation with CRUD services

Installation

pip install runapi

Requirements

  • Python 3.8+
  • FastAPI
  • Uvicorn (for development server)

Table of Contents

Quick Start

1. Create a new project

runapi init my-api
cd my-api

2. Project Structure

my-api/
├── routes/              # API routes (file-based routing)
│   ├── index.py        # GET /
│   └── api/
│       ├── users.py    # GET, POST /api/users
│       └── users/
│           └── [id].py # GET, PUT, DELETE /api/users/{id}
├── schemas/            # Pydantic models (auto-discovered)
│   └── user.py         # UserCreate, UserResponse, etc.
├── repositories/       # Data access layer
│   └── user.py         # UserRepository
├── services/           # Business logic layer
│   └── user.py         # UserService
├── static/             # Static files
├── uploads/            # File uploads directory
├── main.py            # Application entry point
├── .env               # Configuration file
└── README.md

3. Create routes

Routes are created by adding Python files in the routes/ directory:

routes/index.py (GET /)

from runapi import JSONResponse

async def get():
    return JSONResponse({"message": "Hello runapi!"})

routes/api/users.py (GET,POST /api/users)

from runapi import JSONResponse, Request

async def get():
    return JSONResponse({"users": []})

async def post(request: Request):
    body = await request.json()
    return JSONResponse({"created": body})

routes/api/users/[id].py (GET,PUT,DELETE /api/users/{id})

from runapi import JSONResponse, Request

async def get(request: Request):
    user_id = request.path_params["id"]
    return JSONResponse({"user_id": user_id})

async def put(request: Request):
    user_id = request.path_params["id"]
    body = await request.json()
    return JSONResponse({"user_id": user_id, "updated": body})

async def delete(request: Request):
    user_id = request.path_params["id"]
    return JSONResponse({"user_id": user_id, "deleted": True})

4. Run development server

runapi dev

Visit http://localhost:8000 to see your API!

API Documentation

Once your server is running, you can access:

  • Interactive API Documentation: http://localhost:8000/docs (Swagger UI)
  • Alternative Documentation: http://localhost:8000/redoc (ReDoc)
  • OpenAPI JSON Schema: http://localhost:8000/openapi.json

Project Architecture

runapi follows a clean architecture pattern separating concerns into layers:

┌─────────────────────────────────────────────────────────────┐
│                     Routes (routes/)                        │
│              Thin HTTP handlers - file-based                │
└─────────────────────────┬───────────────────────────────────┘
                          │
┌─────────────────────────▼───────────────────────────────────┐
│                   Services (services/)                       │
│           Business logic, validation, orchestration          │
└─────────────────────────┬───────────────────────────────────┘
                          │
┌─────────────────────────▼───────────────────────────────────┐
│                 Repositories (repositories/)                 │
│              Data access abstraction (CRUD)                  │
└─────────────────────────┬───────────────────────────────────┘
                          │
┌─────────────────────────▼───────────────────────────────────┐
│                   Schemas (schemas/)                         │
│         Pydantic models for validation & serialization       │
└─────────────────────────────────────────────────────────────┘

This separation provides:

  • Testability: Each layer can be tested independently
  • Maintainability: Clear boundaries between concerns
  • Flexibility: Swap implementations without affecting other layers

Schemas

Schemas define your data models using Pydantic. They are auto-discovered from the schemas/ directory.

Generate a Schema

runapi generate schema user

This creates schemas/user.py with boilerplate classes.

Schema Base Classes

from runapi import BaseSchema, IDMixin, TimestampMixin
from pydantic import Field
from typing import Optional

# Base schema with ORM support and validation
class UserBase(BaseSchema):
    email: str = Field(..., description="User email")
    name: str = Field(..., min_length=1, max_length=100)

# Schema for creating (no ID, no timestamps)
class UserCreate(UserBase):
    password: str = Field(..., min_length=8)

# Schema for updating (all fields optional)
class UserUpdate(BaseSchema):
    email: Optional[str] = None
    name: Optional[str] = None

# Schema for responses (includes ID and timestamps)
class UserResponse(UserBase, IDMixin, TimestampMixin):
    pass

Built-in Schema Utilities

from runapi import (
    BaseSchema,          # Base with ORM mode, validation
    IDMixin,             # Adds 'id: int' field
    TimestampMixin,      # Adds 'created_at', 'updated_at'
    MessageResponse,     # Simple {"message": str, "success": bool}
    PaginatedResponse,   # Generic paginated list wrapper
    PaginationParams,    # Query params with offset/limit
)

# Pagination example
from runapi import PaginatedResponse, PaginationParams

async def get_users(params: PaginationParams):
    users = await user_service.get_all(
        skip=params.offset,
        limit=params.limit
    )
    total = await user_service.count()
    return PaginatedResponse.create(
        items=users,
        total=total,
        page=params.page,
        page_size=params.page_size
    )

Using Schemas in Routes

# routes/api/users.py
from runapi import JSONResponse, Request
from schemas.user import UserCreate, UserResponse

async def post(request: Request):
    body = await request.json()
    user_data = UserCreate(**body)  # Validates input
    # ... create user logic
    return JSONResponse(UserResponse(**user).model_dump())

Repositories

Repositories abstract data access, making it easy to swap storage backends.

Generate a Repository

runapi generate repository user

In-Memory Repository (Prototyping)

from runapi import InMemoryRepository

class UserRepository(InMemoryRepository):
    """In-memory storage - great for development/testing."""

    async def find_by_email(self, email: str):
        return await self.get_by(email=email)

    async def find_active_users(self):
        return await self.get_many_by(is_active=True)

# Usage
repo = UserRepository()
user = await repo.create({"name": "John", "email": "john@example.com"})
users = await repo.get_all(skip=0, limit=10)
await repo.update(1, {"name": "Johnny"})
await repo.delete(1)

Typed Repository (with Pydantic models)

from runapi import TypedInMemoryRepository
from schemas.user import UserResponse

class UserRepository(TypedInMemoryRepository[UserResponse]):
    def __init__(self):
        super().__init__(UserResponse)

    async def find_by_email(self, email: str):
        return await self.get_by(email=email)

# Returns UserResponse instances, not dicts
user = await repo.create({"name": "John", "email": "john@example.com"})
assert isinstance(user, UserResponse)

SQLAlchemy Repository (Production)

from runapi import SQLAlchemyRepository, SQLALCHEMY_AVAILABLE
from sqlalchemy.ext.asyncio import AsyncSession

if SQLALCHEMY_AVAILABLE:
    class UserRepository(SQLAlchemyRepository[UserModel, int]):
        def __init__(self, session: AsyncSession):
            super().__init__(session, UserModel)

        async def find_by_email(self, email: str):
            return await self.get_by(email=email)

Repository Methods

All repositories provide these methods:

Method Description
get(id) Get by ID
get_all(skip, limit, **filters) Get all with pagination
get_by(**filters) Get single matching filters
create(data) Create new entity
update(id, data) Update existing entity
delete(id) Delete entity
count(**filters) Count entities
exists(id) Check if exists

Services

Services contain business logic, sitting between routes and repositories.

Generate a Service

runapi generate service user

CRUD Service (Ready-to-use)

from runapi import CRUDService, InMemoryRepository

class UserService(CRUDService):
    """Inherits all CRUD operations with error handling."""

    async def register(self, data: dict):
        # Business logic: check if email exists
        existing = await self.repository.get_by(email=data["email"])
        if existing:
            raise ValidationError("Email already registered")
        return await self.create(data)

    async def deactivate(self, user_id: int):
        return await self.update(user_id, {"is_active": False})

# Usage
user_repo = UserRepository()
user_service = UserService(user_repo, entity_name="User")

# Built-in methods with error handling
user = await user_service.get(1)  # Raises NotFoundError if missing
users = await user_service.get_all(skip=0, limit=10)
new_user = await user_service.create({"name": "John"})
await user_service.update(1, {"name": "Johnny"})
await user_service.delete(1)  # Raises NotFoundError if missing

Validated Service (with Schema Validation)

from runapi import ValidatedService
from schemas.user import UserCreate, UserUpdate

class UserService(ValidatedService):
    create_schema = UserCreate  # Auto-validates on create
    update_schema = UserUpdate  # Auto-validates on update

# Input is validated against schemas automatically
user = await user_service.create({
    "name": "John",
    "email": "john@example.com",
    "password": "secure123"
})

Complete Example: Routes + Service + Repository

# repositories/user.py
from runapi import InMemoryRepository

class UserRepository(InMemoryRepository):
    async def find_by_email(self, email: str):
        return await self.get_by(email=email)

# services/user.py
from runapi import CRUDService, ValidationError

class UserService(CRUDService):
    async def register(self, data: dict):
        if await self.repository.get_by(email=data["email"]):
            raise ValidationError("Email exists")
        return await self.create(data)

# routes/api/users.py
from runapi import JSONResponse, Request
from repositories.user import UserRepository
from services.user import UserService

user_repo = UserRepository()
user_service = UserService(user_repo, "User")

async def get():
    users = await user_service.get_all()
    return JSONResponse(users)

async def post(request: Request):
    body = await request.json()
    user = await user_service.register(body)
    return JSONResponse(user, status_code=201)

Service Decorators

from runapi import validate_input, require_exists, log_operation
from schemas.user import UserCreate

class UserService(CRUDService):

    @validate_input(UserCreate)
    async def create(self, data: dict):
        return await self.repository.create(data)

    @require_exists("User")
    async def update(self, id: int, data: dict):
        return await self.repository.update(id, data)

    @log_operation("delete_user")
    async def delete(self, id: int):
        return await self.repository.delete(id)

Configuration

runapi uses environment variables for configuration. Create a .env file:

# Server Settings
DEBUG=true
HOST=127.0.0.1
PORT=8000

# Security
SECRET_KEY=your-secret-key-here

# CORS
CORS_ORIGINS=http://localhost:3000,http://localhost:8080
CORS_CREDENTIALS=true

# Rate Limiting
RATE_LIMIT_ENABLED=true
RATE_LIMIT_CALLS=100
RATE_LIMIT_PERIOD=60

# Database (example)
DATABASE_URL=sqlite:///./app.db

# Logging
LOG_LEVEL=INFO

# Static Files
STATIC_FILES_ENABLED=true
STATIC_FILES_PATH=static
STATIC_FILES_URL=/static

# JWT Settings
JWT_ALGORITHM=HS256
JWT_EXPIRY=3600
JWT_REFRESH_EXPIRY=86400

Configuration Reference

Variable Type Default Description
DEBUG boolean true Enable debug mode
HOST string 127.0.0.1 Server host
PORT integer 8000 Server port
SECRET_KEY string dev-secret-key... Secret key for JWT
CORS_ORIGINS string * Comma-separated allowed origins
CORS_CREDENTIALS boolean true Allow credentials in CORS
RATE_LIMIT_ENABLED boolean false Enable rate limiting
RATE_LIMIT_CALLS integer 100 Requests per period
RATE_LIMIT_PERIOD integer 60 Rate limit period in seconds
LOG_LEVEL string INFO Logging level
DATABASE_URL string None Database connection URL

Authentication

runapi includes built-in JWT authentication:

Enable Authentication Middleware

main.py

from runapi import create_runapi_app

app = create_runapi_app()

# Protect specific routes
app.add_auth_middleware(
    protected_paths=["/api/protected"],
    excluded_paths=["/api/auth/login", "/docs"]
)

Create Login Route

routes/api/auth/login.py

from runapi import JSONResponse, Request, create_token_response, verify_password

async def post(request: Request):
    body = await request.json()
    username = body.get("username")
    password = body.get("password")
    
    # Verify credentials (implement your logic)
    if verify_credentials(username, password):
        user_data = {"sub": "user_id", "username": username}
        tokens = create_token_response(user_data)
        return JSONResponse(tokens.dict())
    
    return JSONResponse({"error": "Invalid credentials"}, status_code=401)

Protected Routes

routes/api/protected.py

from runapi import JSONResponse, get_current_user, Depends

async def get(current_user: dict = Depends(get_current_user())):
    return JSONResponse({
        "message": "This is protected!",
        "user": current_user
    })

Middleware

runapi includes several built-in middleware:

from runapi import create_runapi_app

app = create_runapi_app()

# Built-in middleware (automatically configured via .env)
# - CORS
# - Rate limiting  
# - Security headers
# - Request logging
# - Compression

# Add custom middleware
from runapi import RunApiMiddleware

class CustomMiddleware(RunApiMiddleware):
    async def dispatch(self, request, call_next):
        # Pre-processing
        response = await call_next(request)
        # Post-processing
        return response

app.add_middleware(CustomMiddleware)

Error Handling

runapi provides comprehensive error handling:

from runapi import ValidationError, NotFoundError, raise_not_found

async def get_user(user_id: str):
    if not user_id:
        raise ValidationError("User ID is required")
    
    user = find_user(user_id)
    if not user:
        raise_not_found("User not found")
    
    return user

CLI Commands

runapi includes a powerful CLI for development:

# Create new project
runapi init my-project

# Run development server
runapi dev

# Run production server (multiple workers)
runapi start --workers 4

# Generate boilerplate code
runapi generate route users           # Create route file
runapi generate schema user           # Create schema with base classes
runapi generate repository user       # Create repository with CRUD
runapi generate service user          # Create service with business logic
runapi generate middleware auth       # Create custom middleware
runapi generate main                  # Create main.py entry point

# List resources
runapi routes                         # List all API routes
runapi schemas                        # List all schemas

# Show project info
runapi info

Generator Examples

# Generate a complete user module
runapi generate schema user
runapi generate repository user
runapi generate service user
runapi generate route users --path api

# Generate nested resources
runapi generate schema product --path api
runapi generate repository product --path api

Advanced Usage

Custom Application Setup

main.py

from runapi import create_runapi_app, get_config

# Load custom configuration
config = get_config()

# Create app with custom settings
app = create_runapi_app(
    title="My API",
    description="Built with runapi",
    version="1.0.0"
)

# Add custom middleware
app.add_auth_middleware()

# Add custom startup/shutdown events
@app.get_app().on_event("startup")
async def startup():
    print("Starting up!")

# Get underlying FastAPI app
fastapi_app = app.get_app()

Database Integration

# Using SQLAlchemy (example)
from sqlalchemy import create_engine
from runapi import get_config

config = get_config()
engine = create_engine(config.database_url)

# Use in routes
async def get_users():
    # Your database logic here
    pass

Background Tasks

from fastapi import BackgroundTasks
from runapi import JSONResponse

async def send_email(email: str):
    # Send email logic
    pass

async def post(request: Request, background_tasks: BackgroundTasks):
    body = await request.json()
    background_tasks.add_task(send_email, body["email"])
    return JSONResponse({"message": "Email queued"})

Dynamic Routes

runapi supports dynamic route parameters:

  • routes/users/[id].py/users/{id}
  • routes/posts/[slug].py/posts/{slug}
  • routes/api/[...path].py/api/{path:path} (catch-all)

File Uploads

from fastapi import UploadFile, File
from runapi import JSONResponse

async def post(file: UploadFile = File(...)):
    contents = await file.read()
    # Process file
    return JSONResponse({"filename": file.filename})

Testing

from fastapi.testclient import TestClient
from main import app

client = TestClient(app.get_app())

def test_read_main():
    response = client.get("/")
    assert response.status_code == 200
    assert response.json()["message"] == "Hello runapi!"

Production Deployment

Using Docker

Dockerfile

FROM python:3.9-slim

WORKDIR /app
COPY requirements.txt .
RUN pip install -r requirements.txt

COPY . .
EXPOSE 8000

CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"]

Using Gunicorn

pip install gunicorn
gunicorn main:app -w 4 -k uvicorn.workers.UvicornWorker

WebSockets

runapi supports WebSocket connections through FastAPI:

# routes/ws/chat.py
from fastapi import WebSocket
from runapi import get_app

app = get_app()

@app.websocket("/ws/chat")
async def websocket_endpoint(websocket: WebSocket):
    await websocket.accept()
    while True:
        data = await websocket.receive_text()
        await websocket.send_text(f"Message: {data}")

API Reference

Core Functions

create_runapi_app(**kwargs)

Creates a runapi application instance.

Parameters:

  • title (str): API title
  • description (str): API description
  • version (str): API version
  • config (runapiConfig): Custom configuration

Returns: runapiApp instance

get_config()

Returns the global configuration instance.

load_config(env_file: str = None)

Loads configuration from environment file.

Authentication Functions

create_access_token(data: dict, expires_delta: timedelta = None)

Creates a JWT access token.

verify_token(token: str)

Verifies and decodes a JWT token.

hash_password(password: str)

Hashes a password using bcrypt.

verify_password(plain_password: str, hashed_password: str)

Verifies a password against its hash.

Error Functions

raise_validation_error(message: str, details: dict = None)

Raises a validation error (400).

raise_not_found(message: str = "Resource not found")

Raises a not found error (404).

raise_auth_error(message: str = "Authentication required")

Raises an authentication error (401).

Schema Classes

BaseSchema

Base Pydantic model with ORM mode, validation, and JSON serialization.

IDMixin

Mixin adding id: int field.

TimestampMixin

Mixin adding created_at and updated_at datetime fields.

PaginatedResponse[T]

Generic paginated response wrapper with items, total, page, page_size, pages.

PaginationParams

Query parameters for pagination with page, page_size, offset, limit properties.

Repository Classes

BaseRepository[T, ID]

Abstract base repository with CRUD operations.

InMemoryRepository

Dictionary-based in-memory storage for prototyping and testing.

TypedInMemoryRepository[T]

Type-safe in-memory repository returning Pydantic model instances.

SQLAlchemyRepository[T, ID]

Async SQLAlchemy repository (requires sqlalchemy[asyncio]).

Service Classes

CRUDService[T, ID]

Ready-to-use CRUD service with error handling for get, get_all, create, update, delete.

ValidatedService[T, ID]

CRUD service with automatic Pydantic schema validation.

Service Decorators

@validate_input(schema)

Validates input data against a Pydantic schema before method execution.

@require_exists(entity_name)

Ensures entity exists before method execution, raises NotFoundError if not.

@log_operation(operation_name)

Logs service operation start, completion, and errors.

Route Conventions

File Naming

  • index.py → Root path /
  • users.py/users
  • [id].py/{id} (dynamic parameter)
  • [...slug].py/{slug:path} (catch-all)

HTTP Methods

Export async functions named after HTTP methods:

async def get():        # GET request
async def post():       # POST request
async def put():        # PUT request
async def delete():     # DELETE request
async def patch():      # PATCH request

Request Handling

from runapi import Request, JSONResponse

async def post(request: Request):
    # Get JSON body
    body = await request.json()
    
    # Get path parameters
    user_id = request.path_params.get("id")
    
    # Get query parameters
    limit = request.query_params.get("limit", 10)
    
    # Get headers
    auth_header = request.headers.get("authorization")
    
    return JSONResponse({"status": "success"})

Troubleshooting

Common Issues

Import Error: No module named 'runapi'

pip install runapi

Routes not loading

  • Ensure routes/ directory exists in your project root
  • Check that route files have proper async function exports
  • Verify file naming conventions

Authentication not working

  • Set a proper SECRET_KEY in production
  • Check that protected paths are correctly configured
  • Verify JWT token format and expiration

CORS Issues

  • Configure CORS_ORIGINS in your .env file
  • Set CORS_CREDENTIALS=true if needed
  • Check that your frontend origin is included

Debug Mode

Enable debug mode for detailed error messages:

DEBUG=true
LOG_LEVEL=DEBUG

Performance Tips

  1. Use async/await: All route functions should be async
  2. Enable compression: Built-in gzip compression for responses
  3. Configure rate limiting: Protect against abuse
  4. Use proper HTTP status codes: For better client handling
  5. Implement caching: For frequently accessed data

Security Best Practices

  1. Change default secret key in production
  2. Use HTTPS in production
  3. Configure CORS properly
  4. Implement rate limiting
  5. Validate all inputs
  6. Use environment variables for sensitive data

Examples

Check out the /example directory for a complete example application demonstrating:

  • File-based routing
  • Authentication with JWT
  • Protected routes
  • Error handling
  • Middleware usage
  • Configuration management

Run the example:

cd example
runapi dev

Roadmap

  • Schema layer with auto-discovery
  • Repository pattern (in-memory, SQLAlchemy)
  • Service layer with CRUD operations
  • CLI generators for schemas, repositories, services
  • Built-in caching mechanisms (Redis, in-memory)
  • WebSocket routing support
  • Background task queue integration
  • Plugin system
  • More authentication providers (OAuth, LDAP)
  • Performance monitoring and metrics
  • GraphQL support
  • MongoDB repository support

Contributing

We welcome contributions! Here's how to get started:

Development Setup

  1. Clone the repository:
git clone https://github.com/Amanbig/runapi.git
cd runapi
  1. Create a virtual environment:
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
  1. Install development dependencies:
pip install -e .
pip install pytest httpx
  1. Run tests:
python -m pytest tests/

Guidelines

  • Follow PEP 8 style guidelines
  • Add tests for new features
  • Update documentation
  • Create detailed commit messages
  • Open an issue before major changes

Reporting Issues

Please include:

  • Python version
  • runapi version
  • Minimal code example
  • Full error traceback
  • Expected vs actual behavior

Changelog

v0.1.3 (Latest)

  • New Feature: Schema layer with auto-discovery from schemas/ directory
  • New Feature: BaseSchema, IDMixin, TimestampMixin for consistent model definitions
  • New Feature: PaginatedResponse and PaginationParams for pagination support
  • New Feature: Repository pattern with BaseRepository, InMemoryRepository, TypedInMemoryRepository
  • New Feature: Optional SQLAlchemyRepository for async database support
  • New Feature: Service layer with CRUDService, ValidatedService
  • New Feature: Service decorators: @validate_input, @require_exists, @log_operation
  • New Feature: ServiceFactory and RepositoryFactory for dependency injection
  • CLI: Added runapi generate schema <name> command
  • CLI: Added runapi generate repository <name> command
  • CLI: Added runapi generate service <name> command
  • CLI: Added runapi schemas command to list all schemas
  • CLI: Updated runapi init to create schemas/, repositories/, services/ directories
  • Tests: Added 20 comprehensive tests covering all new features

v0.1.2

  • New Feature: Added runapi start command for production deployments (no-reload, multi-worker support)
  • Performance: Optimized startup time by ignoring irrelevant directories during route discovery
  • Performance: Replaced O(N) rate limiting with O(1) Fixed Window Counter algorithm
  • Performance: Implemented streaming compression using GZipMiddleware for lower TTFB and memory usage
  • Security: Refactored authentication to use standard python-jose library instead of manual implementation
  • CLI: Optimized runapi dev startup speed and runapi routes robustness

v0.1.1

  • Bug Fix: Fixed runapi dev command failing to import main module
  • Enhancement: Improved CLI error handling and validation
  • Enhancement: Better Python path management for uvicorn integration
  • Enhancement: Added pre-validation of main.py before server startup

v0.1.0

  • Initial release
  • File-based routing system
  • JWT authentication
  • Middleware stack
  • CLI tools
  • Configuration management
  • Error handling system

License

This project is licensed under the MIT License - see the LICENSE file for details.

Community

Acknowledgments

  • Built on top of FastAPI by Sebastián Ramirez
  • Inspired by Next.js file-based routing by Vercel
  • Uses Typer for CLI by Sebastián Ramirez
  • Password hashing with Passlib
  • Testing with pytest and httpx

Related Projects

  • FastAPI - Modern, fast web framework for Python
  • Starlette - Lightweight ASGI framework
  • Pydantic - Data validation using Python type hints
  • Next.js - React framework (inspiration)

Support

If runapi has been helpful to your project:

  • ⭐ Star the repo on GitHub
  • 🐛 Report bugs and request features
  • 📝 Contribute to documentation
  • 💰 Sponsor the project

runapi - Making Python backend development as intuitive as frontend development! 🚀

Get Started | Documentation | Examples

About

A Next.js-inspired file-based routing framework built on FastAPI for Python backend development. runapi makes building robust APIs as intuitive as creating files and folders.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

No packages published

Contributors 3

  •  
  •  
  •  

Languages