FastAPI Items Management & Browser

A FastAPI application with two main features:

• Item Management API: Create, update, delete items
• Item Browser API: Browse and search items

Project Structure

fastapi-items/
├── app/
│   ├── __init__.py
│   ├── main.py                 # Main FastAPI app
│   ├── data.py                 # Dummy data
│   ├── schemas.py              # Pydantic models
│   ├── management/
│   │   ├── __init__.py
│   │   └── routes.py           # Item management endpoints
│   └── browser/
│       ├── __init__.py
│       └── routes.py           # Item browsing/search endpoints
├── requirements.txt
└── README.md

Setup

# Create virtual environment
python3 -m venv venv
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt --only-binary greenlet

# Run server
python -m uvicorn app.main:app --reload --port 8000

Note: The --only-binary greenlet flag is used to install pre-built greenlet binaries, which avoids compilation issues on macOS with missing Xcode developer tools.

API Endpoints

Management API (/api/management)

• GET /items - List all items
• POST /items - Create new item
• GET /items/{id} - Get item details
• PUT /items/{id} - Update item
• DELETE /items/{id} - Delete item

Browser API (/api/browser)

• GET /items - Browse all items
• GET /items/search?q=keyword - Search items
• GET /items/category?category=name - Filter by category

Access

• API Docs: http://localhost:8000/docs
• ReDoc: http://localhost:8000/redoc

Passwords and hashing

• This app uses passlib's argon2 for password hashing (strong, modern, and no 72-byte limit).
• You can safely use long passphrases; no manual truncation is required.