Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/grillazz/fastapi-redis
Showcase of Redis integration with Python FastAPI framework supported by Pydantic as API backend for RDKit: Open-Source Cheminformatics Software
https://github.com/grillazz/fastapi-redis
api asyncio docker fastapi fastapi-redis pydantic python python3 rdkit redis
Last synced: 2 days ago
JSON representation
Showcase of Redis integration with Python FastAPI framework supported by Pydantic as API backend for RDKit: Open-Source Cheminformatics Software
- Host: GitHub
- URL: https://github.com/grillazz/fastapi-redis
- Owner: grillazz
- License: mit
- Created: 2021-01-11T17:45:40.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2024-12-30T03:50:42.000Z (4 days ago)
- Last Synced: 2024-12-30T04:27:27.533Z (4 days ago)
- Topics: api, asyncio, docker, fastapi, fastapi-redis, pydantic, python, python3, rdkit, redis
- Language: Python
- Homepage:
- Size: 691 KB
- Stars: 81
- Watchers: 3
- Forks: 10
- Open Issues: 20
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# fastapi-redis
[](https://github.com/grillazz)
[](https://github.com/grillazz/fastapi-redis/blob/main/LICENSE)
![visitors](https://visitor-badge.laobi.icu/badge?page_id=grillazz.fastapi-redis")
[](https://github.com/grillazz/fastapi-redis/actions/workflows/build-and-test.yml)
### Project Description
Purpose of this showcase is integrate modern NoSQL backend Redis with FastAPI Python ASGI Framework
as API for chemical compounds extended analyze with [RDKit](https://github.com/rdkit/rdkit) Library.
Data set coming from pub chem database, and you can download example from COVID-19 Disease Map here on this link: https://pubchem.ncbi.nlm.nih.gov/#query=covid-19
Pydantic schema was created for PubChem Compounds. You can replace it with your own schema to accept other source of SMILES.
There is many chemical compound sets. Now we are all in days when COVID-19 Pandemic is out there.
We all want to know as much as possible about best cure..., and it is my project background.
Show power and robustness of Redis with speed of FastAPI and functionality of RDKit to deliver api
which allow fast analyze chem molecules.
This showcase can be quickly integrated with other services via REST API and extended to deliver desired chem compound bakery.
Project as whole is build on FastAPI framework, Python 3.11, Redis.
### How to Setup
To build, run and test and more... use magic of make.
```shell
make help
```
and you receive below list:
```text
build Build project with compose
clean Reset project containers with compose
down Stop project containers with compose
format Format project code.
help Show this help
lint Lint project code.
lock Refresh pipfile.lock
requirements Refresh requirements.txt from pipfile.lock
safety Check project and dependencies with safety https://github.com/pyupio/safety
test Run project unit tests with coverage
up Run project with compose
```
### How to Play
1. Download sample JSON from PubChem database i.e. COVID-19 Disease Map here on this link:
https://pubchem.ncbi.nlm.nih.gov/#query=covid-19
2. Add SMILES to Redis Hash with `/smiles/add-to-hash` endpoint
```shell
curl --location --request POST 'http://0.0.0.0:8080/smiles/add-to-hash?redis_hash=covid-19-canonical' \
--header 'Content-Type: application/json' \
--data-binary '@/fastapi-redis/PubChem_compound_text_covid-19_records.json'
```
and get response like below with `201 Created`
```json
{
"number_of_inserted_keys": 2364,
"hash_name": "covid-19-canonical"
}
```
3. Compare SMILES code to list loaded in previous step on Redis Hash with `/api/smiles/compare-to-hash` endpoint
```shell
curl --location --request GET
'http://0.0.0.0:8080/smiles/compare-to-hash?compound=CCC(CC)COC(=O)C(C)NP(=O)(OCC1C(C(C(O1)(C%23N)C2=CC=C3N2N=CN=C3N)O)O)OC4=CC=CC=C4&redis_hash=covid-19-canonical'
```
and get response like below with `200 OK`
```json
{
"number_of_smiles_to_compare": 2364,
"similarity": {
"CCC(CC)COC(=O)[C@H](C)N[P@](=O)(OC[C@@H]1[C@H]([C@H]([C@](O1)(C#N)C2=CC=C3N2N=CN=C3N)O)O)OC4=CC=CC=C4": 1.0,
"CCC(CC)COC(=O)C(C)NP(=O)(OCC1C(C(C(O1)(C#N)C2=CC=C3N2N=CN=C3N)O)O)OC4=CC=CC=C4": 1.0,
"C1=C2C(=NC=NN2C(=C1)C3(C(C(C(O3)COP(=O)(O)O)O)O)C#N)N": 0.8964264082374318,
"C1=C2C(=NC=NN2C(=C1)[C@]3([C@@H]([C@@H]([C@H](O3)COP(=O)(O)O)O)O)C#N)N": 0.8964264082374318,
"C1=C2C(=NC=NN2C(=C1)[C@]3([C@@H]([C@@H]([C@H](O3)CO)O)O)C#N)N": 0.8740109555690809,
"C1=C2C(=NC=NN2C(=C1)C3(C(C(C(O3)CO)O)O)C#N)N": 0.8740109555690809
}
}
```
4. For REST API Documentation please use: `http://0.0.0.0:8080/docs`
5. Finally, you can use postman collection here [Postman Collection](https://github.com/grillazz/fastapi-redis/blob/main/postman/fastapi-redis.postman_collection.json)
### Backbone
Beside of using latest and greatest version of [Redis](https://redis.io/) with it robustness, powerfulness and speed
there is [FastAPI](https://fastapi.tiangolo.com/) (modern, fast (high-performance),
web framework for building APIs with Python 3.11+ based on standard Python type hints.) already reviewed
on [thoughtworks](https://www.thoughtworks.com/radar/languages-and-frameworks?blipid=202104087) and presented in
Python Developers [Survey 2021 Results](https://lp.jetbrains.com/python-developers-survey-2021/#FrameworksLibraries)
as the fifth official annual Python Developers Survey,
conducted as a collaborative effort between the Python Software Foundation and JetBrains.
[redis-py](https://github.com/redis/redis-py) is already implemented as Python interface to the Redis key-value store.
Special thanks going to maintainers of [rdkit-pypi](https://github.com/kuelumbus/rdkit-pypi).
Hope you enjoy it.
### Change Log
- 16 APR 2022 aioredis replaced with redis.asyncio
- 15 JUN 2022 re-implement api with redis-om
- 6 APR 2023 bump all project deps and rdkit = "^2022.9.5"
- 6 APR 2023 move project to python 3.11
- 6 APR 2023 switch project to poetry and remove pipenv
- 14 APR 2023 implement rich for logging