/PostIn-Backend

Backend architecture for a personal project on CRUD operations about posts

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

PostIn API Service

A personal project created to learn software engineering with python

Description

PostIn is a RESTful API service developed using FastAPI. It provides endpoints for user and post management. The service is designed to be efficient, easy to use, and scalable.

Features

  • User Management
  • Post Management
  • Authentication and authorization
  • Detailed API documentation with OpenAPI

Installation

  1. Clone the repository:

    git clone https://github.com/mwangi-george/PostIn.git
    cd PostIn
  2. Create a virtual environment and activate it:

    python -m venv venv
    source venv/bin/activate  # On Windows, use `venv\Scripts\activate`
  3. Install the dependencies:

    pip install -r requirements.txt
  4. Make database migrations:

    alembic upgrade head

Running the Application

To start the FastAPI server, run the following command:

uvicorn app.main:app --reload

Live api service and documentation available at the following endpoints:

  1. Swagger Documentation

  2. Redocly Documentation