handlebars.pythonFlaskConnexion.README.mustache Maven / Gradle / Ivy
# Swagger generated server
## Overview
This server was generated by the [swagger-codegen](https://github.com/swagger-api/swagger-codegen) project. By using the
[OpenAPI-Spec](https://github.com/swagger-api/swagger-core/wiki) from a remote server, you can easily generate a server stub. This
is an example of building a swagger-enabled Flask server.
This example uses the [Connexion](https://github.com/zalando/connexion) library on top of Flask.
## Requirements
{{#supportPython2}}
Python 2.7+
{{/supportPython2}}
{{^supportPython2}}
Python 3.5.2+
{{/supportPython2}}
## Usage
To run the server, please execute the following from the root directory:
```
{{#supportPython2}}
pip install -r requirements.txt
python -m {{packageName}}
{{/supportPython2}}
{{^supportPython2}}
pip3 install -r requirements.txt
python3 -m {{packageName}}
{{/supportPython2}}
```
and open your browser to here:
```
http://localhost:{{serverPort}}{{contextPath}}/ui/
```
Your Swagger definition lives here:
```
http://localhost:{{serverPort}}{{contextPath}}/swagger.json
```
To launch the integration tests, use tox:
```
sudo pip install tox
tox
```
## Running with Docker
To run the server on a Docker container, please execute the following from the root directory:
```bash
# building the image
docker build -t {{packageName}} .
# starting up a container
docker run -p {{serverPort}}:{{serverPort}} {{packageName}}
```