🚀 FastAPI Blog API

A clean, modular, and database-driven Blog Backend built with FastAPI.

This project demonstrates real-world backend concepts like relational data modeling, API design, and database integration using SQLAlchemy.

---

⚡ Features

• 👤 Create Users
• ✍️ Create Blog Posts
• 🔗 One-to-Many Relationship (User → Posts)
• 📖 Fetch All Posts
• 🔍 Fetch Posts by User
• 🧠 Nested API Response (User with all posts)
• 🛡️ Input Validation using Pydantic
• ⚠️ Proper Error Handling (404, 400)

---

🧱 Tech Stack

• ⚡ FastAPI
• 🐍 Python
• 🗄️ SQLite
• 🧠 SQLAlchemy ORM
• 📦 Pydantic

---

📂 Project Structure

src/
├── users/
│   ├── models.py
│   ├── schemas.py
│   ├── controller.py
│   └── router.py
│
├── posts/
│   ├── models.py
│   ├── schemas.py
│   ├── controller.py
│   └── router.py
│
├── utils/
│   ├── db.py
│   ├── settings.py
│
└── main.py

---

🔥 API Endpoints

Method	Endpoint	Description
POST	/users/create_user	Create a new user
GET	/users/{user_id}	Get user with posts
POST	/posts/create_post	Create a new post
GET	/posts/all_posts	Get all posts
GET	/posts/user/{user_id}	Get posts by user

---

🧪 Example Response

{
  "id": 1,
  "username": "mehfooz",
  "posts": [
    {
      "id": 1,
      "title": "My First Blog",
      "content": "Learning FastAPI..."
    }
  ]
}

---

⚙️ Setup & Run

git clone https://github.com/your-username/fastapi-blog-api.git
cd fastapi-blog-api

python -m venv venv
source venv/bin/activate

pip install -r requirements.txt

uvicorn src.main:app --reload

---

📖 API Docs

Swagger UI available at:

👉 http://127.0.0.1:8000/docs

---

🧠 What I Learned

• Designing REST-like APIs
• Using SQLAlchemy ORM for database operations
• Implementing One-to-Many relationships
• Structuring scalable backend applications
• Handling real-world data flow

---

🚀 Future Improvements

• JWT Authentication 🔐
• PostgreSQL integration 🐘
• Pagination & filtering 📊
• Deployment 🌍

---

👨‍💻 Author

Built with consistency, curiosity, and discipline 💪
More powerful systems coming soon 🚀