Python (FastAPI)

# Create a new Python service
apso server new my-api --template python
 
# Navigate to project
cd my-api
 
# Create virtual environment
python -m venv venv
source venv/bin/activate  # or venv\Scripts\activate on Windows
 
# Install dependencies
pip install -r requirements.txt
 
# Start development server
uvicorn main:app --reload

my-api/
├── app/
│   ├── entities/           # SQLAlchemy models
│   │   ├── project.py
│   │   └── task.py
│   ├── routers/            # API routes
│   │   ├── projects.py
│   │   └── tasks.py
│   ├── schemas/            # Pydantic schemas
│   │   ├── project.py
│   │   └── task.py
│   ├── services/           # Business logic
│   ├── extensions/         # Your custom code
│   ├── core/               # Config, security
│   └── main.py             # Entry point
├── migrations/             # Alembic migrations
├── tests/                  # Test files
├── .apsorc                 # APSO schema
└── requirements.txt

from sqlalchemy import Column, String, ForeignKey
from sqlalchemy.orm import relationship
from app.core.database import Base
 
class Project(Base):
    __tablename__ = "projects"
 
    id = Column(String, primary_key=True)
    name = Column(String, nullable=False)
    organization_id = Column(String, nullable=False)
 
    tasks = relationship("Task", back_populates="project")

from pydantic import BaseModel, Field
 
class ProjectCreate(BaseModel):
    name: str = Field(..., max_length=200)
    description: str | None = None
 
class ProjectResponse(BaseModel):
    id: str
    name: str
    description: str | None
    organization_id: str
    created_at: datetime
 
    class Config:
        from_attributes = True

# app/routers/projects.py
from fastapi import APIRouter, Depends, HTTPException
from sqlalchemy.ext.asyncio import AsyncSession
from app.core.deps import get_db, get_current_user
from app.schemas.project import ProjectCreate, ProjectResponse
from app.services import projects as project_service
 
router = APIRouter(prefix="/projects", tags=["projects"])
 
@router.get("/", response_model=list[ProjectResponse])
async def list_projects(
    skip: int = 0,
    limit: int = 20,
    db: AsyncSession = Depends(get_db),
    user = Depends(get_current_user),
):
    return await project_service.get_all(
        db, user.organization_id, skip=skip, limit=limit
    )
 
@router.post("/", response_model=ProjectResponse, status_code=201)
async def create_project(
    project: ProjectCreate,
    db: AsyncSession = Depends(get_db),
    user = Depends(get_current_user),
):
    return await project_service.create(db, project, user.organization_id)

# .env
DATABASE_URL=postgresql+asyncpg://user:pass@localhost:5432/db
JWT_SECRET=your-secret-key
DEBUG=true

# app/core/config.py
from pydantic_settings import BaseSettings
 
class Settings(BaseSettings):
    database_url: str
    jwt_secret: str
    debug: bool = False
 
    class Config:
        env_file = ".env"
 
settings = Settings()