Welcome to JEC API

What is JEC?

JEC is a lightweight framework built on top of FastAPI that brings class-based routing to your Python APIs. Instead of scattering route definitions across decorator functions, JEC lets you organize your endpoints into clean, logical controller classes.

About the Name

JEC can stand for many things, depending on your mood:

• Just Encapsulated Controllers — The official meaning — class-based API organization
• Jolly Enough Curses — For when debugging at 3am feels magical
• Jupiter Eats Comets — Because your APIs should be astronomical

Quick Example

Here's what a JEC route looks like. Notice how each HTTP method is simply a method on the class:

from jec import Route
from jec.decorators import log, speed, version

class UsersRoute(Route):
    """Handles all /users endpoints."""
    
    @log
    @speed
    async def get(self):
        """GET /users - List all users"""
        return {"users": await self.db.get_users()}
    
    @log
    @version(">=1.0.0")
    async def post(self, user: UserCreate):
        """POST /users - Create a new user"""
        return await self.db.create_user(user)
    
    async def get_by_id(self, user_id: int):
        """GET /users/{user_id} - Get user by ID"""
        return await self.db.get_user(user_id)

Key Features