bf28ab6f8e
- Add proper model relationships for better querying - Implement character model and endpoints for managing anime characters - Add advanced filtering options (year, score range, source, studio, etc.) - Add statistics endpoint for analyzing anime collection - Include pagination metadata for easier navigation - Create Alembic migration for the new character model - Update README with new features and documentation
137 lines
4.2 KiB
Markdown
137 lines
4.2 KiB
Markdown
# Anime Information API
|
|
|
|
This is a FastAPI application that provides anime information via a RESTful API.
|
|
|
|
## Features
|
|
|
|
- **Anime Information**: Comprehensive anime data including titles, synopsis, episodes, scores, etc.
|
|
- **Genre Management**: Create, read, update, and delete anime genres
|
|
- **Character Management**: Create, read, update, and delete anime characters
|
|
- **Advanced Search**: Search anime with multiple filters including year, score range, source, studio, etc.
|
|
- **Smart Pagination**: Built-in pagination with metadata for easy navigation
|
|
- **Statistics Dashboard**: Get statistical insights about the anime collection
|
|
- **Health Endpoint**: Check the health of the application and its database connection
|
|
|
|
## Tech Stack
|
|
|
|
- **Framework**: FastAPI
|
|
- **Database**: SQLite with SQLAlchemy ORM
|
|
- **Migration Tool**: Alembic
|
|
- **Validation**: Pydantic
|
|
- **Code Quality**: Ruff linter
|
|
|
|
## Project Structure
|
|
|
|
```
|
|
anime-information-api/
|
|
├── alembic/ # Database migrations
|
|
├── app/ # Application code
|
|
│ ├── api/ # API endpoints
|
|
│ │ └── endpoints/ # Route definitions
|
|
│ ├── core/ # Core application components
|
|
│ ├── crud/ # CRUD operations
|
|
│ ├── db/ # Database setup
|
|
│ ├── initial_data/ # Data seeding
|
|
│ ├── models/ # SQLAlchemy models
|
|
│ └── schemas/ # Pydantic schemas
|
|
├── storage/ # Storage for SQLite database
|
|
├── alembic.ini # Alembic config
|
|
├── main.py # Application entry point
|
|
├── requirements.txt # Dependencies
|
|
└── seed_data.py # Script to seed initial data
|
|
```
|
|
|
|
## Getting Started
|
|
|
|
### Prerequisites
|
|
|
|
- Python 3.9+
|
|
|
|
### Installation
|
|
|
|
1. Clone the repository
|
|
2. Install dependencies:
|
|
```
|
|
pip install -r requirements.txt
|
|
```
|
|
|
|
### Database Setup
|
|
|
|
Run the Alembic migrations to set up the database schema:
|
|
|
|
```
|
|
alembic upgrade head
|
|
```
|
|
|
|
Seed the database with initial data:
|
|
|
|
```
|
|
python seed_data.py
|
|
```
|
|
|
|
### Running the Application
|
|
|
|
Start the application with:
|
|
|
|
```
|
|
uvicorn main:app --reload
|
|
```
|
|
|
|
The API will be available at http://localhost:8000, and the interactive API documentation at http://localhost:8000/docs.
|
|
|
|
## API Endpoints
|
|
|
|
### Health Check
|
|
- `GET /health`: Check application health
|
|
|
|
### Anime
|
|
- `GET /api/v1/anime/`: Get anime list with advanced filtering and pagination
|
|
- `GET /api/v1/anime/statistics`: Get statistics about the anime collection
|
|
- `POST /api/v1/anime/`: Create new anime
|
|
- `GET /api/v1/anime/{id}`: Get anime by ID
|
|
- `PUT /api/v1/anime/{id}`: Update anime
|
|
- `DELETE /api/v1/anime/{id}`: Delete anime
|
|
|
|
### Genres
|
|
- `GET /api/v1/genres/`: Get genre list
|
|
- `POST /api/v1/genres/`: Create new genre
|
|
- `GET /api/v1/genres/{id}`: Get genre by ID
|
|
- `PUT /api/v1/genres/{id}`: Update genre
|
|
- `DELETE /api/v1/genres/{id}`: Delete genre
|
|
|
|
### Characters
|
|
- `GET /api/v1/characters/`: Get all characters
|
|
- `POST /api/v1/characters/`: Create new character
|
|
- `GET /api/v1/characters/{id}`: Get character by ID
|
|
- `PUT /api/v1/characters/{id}`: Update character
|
|
- `DELETE /api/v1/characters/{id}`: Delete character
|
|
- `GET /api/v1/characters/anime/{anime_id}`: Get all characters for a specific anime
|
|
|
|
## Advanced Search Parameters
|
|
|
|
The anime search endpoint supports the following parameters:
|
|
|
|
- `title`: Filter by title (partial match)
|
|
- `genre_id`: Filter by genre ID
|
|
- `status`: Filter by anime status (airing, finished, upcoming)
|
|
- `year_from`: Filter by starting year (inclusive)
|
|
- `year_to`: Filter by ending year (inclusive)
|
|
- `score_min`: Filter by minimum score (inclusive)
|
|
- `score_max`: Filter by maximum score (inclusive)
|
|
- `source`: Filter by source material (manga, light novel, etc.)
|
|
- `studio`: Filter by studio name (partial match)
|
|
- `sort_by`: Sort by field (id, title, score, popularity, etc.)
|
|
- `sort_order`: Sort order (asc, desc)
|
|
- `skip`: Number of items to skip for pagination
|
|
- `limit`: Maximum number of items to return
|
|
|
|
## Statistics
|
|
|
|
The statistics endpoint provides the following information:
|
|
|
|
- Total anime count
|
|
- Average score and episode count
|
|
- Distribution by status, source, and studio
|
|
- Yearly distribution of releases
|
|
- Score distribution
|
|
- Top genres |