If you want to join my little circle, i drop much things, personal information, life update, some hacks, raise money from opensource

Twitter Circle

![Banner](https://user-images.githubusercontent.com/52716203/140251906-3d4f7ce3-1b96-4c20-a0d4-c4c973cc1863.png)

# TortoiseORM - FastAPI 🦥

A simple Boilerplate for FastAPI using TortoiseORM, for building a Simple CRUD API (Create, Read, Update, Delete).

### What is TortoiseORM?

Tortoise ORM is an easy-to-use asyncio ORM (Object Relational Mapper) inspired by Django.

Tortoise ORM was built with relations in mind and admiration for the excellent and popular Django ORM. It’s engraved in its design that you are working not with just tables, you work with relational data.

### What is FastAPI?

FastAPI is a modern, fast (high-performance), web framework for building APIs with Python 3.6+ based on standard Python-type hints.


TortoiseFastAPI-Boilerplate

# MicroBlog 🗳

Kickstart your project with a FastAPI MongoDB Boilerplate ⏳

## Getting Started 📍

- Based on [FastAPI](https://fastapi.tiangolo.com/) 🚀
- Structured into modules for easy re-use 📦
- Using MongoDB as a database 💾
- Easy to add custom data 📦
- Typing with Pydantic 💡
- Deployment using Uvicorn ⚙
- Token-based authentication using PyJWT 🔑
- A full CRUD API Dockerized 🐳

### Running the Application Locally 🚀

- Drop your MongoDB Configuration & Token at the [`.env.sample`](.env.sample) and Don't Forget to change the Name to `.env`

```shell
DB_HOST # MongoDB Host
DB_PORT # MongoDB Port
MONGO_USER # MongoDB User
MONGO_PASSWORD # MongoDB Password
MONGO_DB # MongoDB Database
SECRET_KEY # JWT Secret Key
ACCESS_TOKEN_EXPIRE_MINUTES # JWT Access Token Expire Minutes
```

- To run the [Main](main.py) we need to use [uvicorn](https://www.uvicorn.org/) a lightning-fast ASGI server implementation, using uvloop and httptools.

```sh
# run the main app using uvicorn
$ uvicorn main:app --reload
```

### Running the Application in Docker 🐳

- We have the Dockerfile created in the above section. Now, we will use the Dockerfile to create the image of the FastAPI app and then start the application container.
- I provide a simplified way by Using a Pre-configured `Makefile` just write in your CLI `make help` and use the commands.
- Don't forget to change the configuration if you want to run the app in a different host or port.


MicroBlog-Boilerplate

# Auth-FastAPI-Boilerplate 🦥

- This is a template for bootstrapping the FastAPI project. If you want to develop a RESTful web service using Python, you can use this template.

## Features 🎉

- Based on `FastAPI` (obviously).
- Dockerized Template.
- Structured into (sub)modules for easy large projects.
- Using `MongoDB` (more in future).
- Easy to add custom data models.
- Typing with `Pydantic`.
- Deployment using `Uvicorn`.
- Token-based authentication using `PyJWT`.
- Testing using `Pytest`.
- Code coverage report using `pytest-cov`.

## Usage 📚

- You should create a virtual environment and activate it:

```sh
python -m venv venv/
source venv/bin/activate
```

- And then install the development dependencies:

```sh
pip install -r requirements.txt
```

- I Create a simple Make file to run the application:

__note__: don't forget to change the `APP_HOST` and `SECRET_KEY` variables.

> ```sh
> cp .env.template .env
> ```

- Then Start the application:

```sh
# start Container
make start
```

- You could also test the project using `make test`.

## License 🍀

This project is licensed under the terms of the MIT license.


Recent products

Twitter Circle

TortoiseFastAPI-Boilerplate

MicroBlog-Boilerplate

auth-fastapi-boilerplate