https://github.com/ryan-gordon/flask-couch-microservice

Star the repo if its useful, looking for contributors
https://github.com/ryan-gordon/flask-couch-microservice

connexion couchdb docker flask hacktoberfest injector swagger

Last synced: 2 months ago
JSON representation

Star the repo if its useful, looking for contributors

• Host: GitHub
• URL: https://github.com/ryan-gordon/flask-couch-microservice
• Owner: Ryan-Gordon
• Created: 2018-01-29T13:05:04.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2018-01-30T00:23:56.000Z (almost 7 years ago)
• Last Synced: 2024-06-12T02:22:35.104Z (7 months ago)
• Topics: connexion, couchdb, docker, flask, hacktoberfest, injector, swagger
• Language: Python
• Homepage:
• Size: 9.77 KB
• Stars: 22
• Watchers: 3
• Forks: 14
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Final-Year-Project-API

This repository will hold an API which will be used in my final year project. The API is meant to act as a gateway to a microservice which is contacted via HTTP e.g couch db. 

#Running 

This service is built on on Python 3.6.

### Virtual Env

This project uses a virtual env to manage dependancies. In order to use it, navagate to the root of the project and run : 

```

source my_venv_dir/bin/activate

```

If you are doing a fresh run of the project, you will need to install dependancies. To do so run:

```

pip install -r requirements.txt 

```

To run the API locally clone the repo and run 

```

python3 app.py

```

## Docker support

This repo has support for running as a docker container. To do so, navagate to the root of the project and run : 

```

docker-compose build && docker-compose up -d

```

# Packages / Frameworks used

## About Injector 

Injector is a dependency-injection framework for Python, inspired by Guice. Guice has become a popular way to manage Dependancy injection in Enterprise grade applications.

## About Connexion

Connexion is a framework on top of Flask that automagically handles HTTP requests based on OpenAPI 2.0 Specification (formerly known as Swagger Spec) of your API described in YAML format. Connexion allows you to write a Swagger specification and then maps the endpoints to your Python functions.

## About Couchdb 

CouchDb is an open source database which can store json documents and files. It follows a NoSql approach and is similar to MongoDB. The handiest features provided by Couch include a REST API to access the data and it comes with sync and replication functionality out of the box.