Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/anshumanpattnaik/python-graphql-microservices
Python GraphQL Microservices
https://github.com/anshumanpattnaik/python-graphql-microservices
flask-restful graphene graphene-python graphql graphql-schema microservices mongodb python python3
Last synced: about 1 month ago
JSON representation
Python GraphQL Microservices
- Host: GitHub
- URL: https://github.com/anshumanpattnaik/python-graphql-microservices
- Owner: anshumanpattnaik
- License: mit
- Created: 2020-12-03T20:11:13.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2020-12-03T21:11:53.000Z (almost 4 years ago)
- Last Synced: 2024-09-27T21:40:57.801Z (about 2 months ago)
- Topics: flask-restful, graphene, graphene-python, graphql, graphql-schema, microservices, mongodb, python, python3
- Language: Python
- Homepage:
- Size: 474 KB
- Stars: 7
- Watchers: 2
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## Python GraphQL Microservices
The idea behind this project is to demonstrate using [GraphQL](https://graphql.org/) how we can query large sets of datasets by combining different sets of API endpoints? and GraphQL is a very popular data query and manipulation language developed by [Facebook](https://developers.facebook.com/docs/graph-api/) and using GraphQL we can populate large sets of data using a single query in a very faster and efficient way. To demonstrate the proof of concept I have taken the datasets from [COVID-19](https://github.com/anshumanpattnaik/covid19-full-stack-application) project and those datasets used for analysis in this project.
## Technical Overview
The proof of concept written using python and to implement the GraphQL it uses [graphene](https://pypi.org/project/graphene/) python module and the microservices designed and implemented using [flask](https://flask.palletsprojects.com/en/1.1.x/) framework and to store the data it uses mongodb database for the storage.
There are three different types of microservices designed in this project
1. Statistics
2. Total Cases
3. Subscriptions
## Installation
`````````````````````````````````````````````````````````````````````````
git clone https://github.com/anshumanpattnaik/python-graphql-microservices
cd python-graphql-microservices
pip install -r requirements.txt
source venv/bin/activate
python3 run.py
`````````````````````````````````````````````````````````````````````````
## COVID-19 Datasets
Under `covid19_dummy_data/` folder you will find the statistics [data.json](https://github.com/anshumanpattnaik/python-graphql-microservices/blob/main/covid19_dummy_data/data.json) file, which you can use while adding data using `http://127.0.0.1:5000/api/v1/add_statistics` endpoint.
## GraphQL (All Queries/Mutation)
After the installation and importing the data into mongodb database, you can open `http://127.0.0.1:5000/api/v1/graphql` to view in the browser.
To refer the queries you can follow `graphql_queries/` folder for [all_queries.graphql](https://github.com/anshumanpattnaik/python-graphql-microservices/blob/main/graphql_queries/all_queries.graphql) and [mutation_query.graphql](https://github.com/anshumanpattnaik/python-graphql-microservices/blob/main/graphql_queries/mutation_query.graphql) which you can use to analyze the data.
### All Queries
Using all queries it will populate three different sets of data.
1. Statistics of all counties - (allStatistics)
2. Total Cases around the world - (allTotalCases)
3. List of COVID-19 email subscribers - (allSubscriber)
``````````````````````````````````````````````````````````````````````````````
{
allStatistics {
edges {
node {
code
country
flag
coordinates
confirmed
deaths
recovered
states {
edges {
node {
name
address
latitude
longitude
confirmed
deaths
recovered
}
}
}
}
}
},
allTotalCases {
edges {
node {
totalConfirmed
totalDeaths
totalRecovered
}
}
},
allSubscriber {
edges {
node {
email
}
}
}
}
``````````````````````````````````````````````````````````````````````````````
### Mutation Query
Using mutation query you can populate the statistics of the individual country by passing the country name.
````````````````````````````````````````````````````````````````````
mutation {
fetchByCountryName(country: "India") {
statistics {
code
country
flag
coordinates
confirmed
deaths
recovered
states {
edges {
node {
name
address
latitude
longitude
confirmed
deaths
recovered
}
}
}
}
}
}
````````````````````````````````````````````````````````````````````
### Note
To understand more in-depth I'll highly recommend following the official documentation of [GraphQL](https://graphql.org/code/#python) and [Graphene](https://docs.graphene-python.org/en/latest/quickstart/)
### License
This project is licensed under the [MIT License](LICENSE)