swagger_ui_bundle - swagger-ui files in a pip package
Project description
swagger_ui_bundle
This package contains the static files for swagger-ui as a python package.
Basic configuration options are templated with the Jinja2 templating language.
This package is intended to be webserver-agnostic, so it only includes the static files, and some very basic configuration.
Getting Started
You can import the swagger_ui_path from the swagger_ui_bundle package like so:
from swagger_ui_bundle import swagger_ui_path
# or if you need a specific version
from swagger_ui_bundle import swagger_ui_2_path
from swagger_ui_bundle import swagger_ui_3_path
You can easily serve up this directory as all static files to get the default swagger-ui distribution. Here’s an example in flask:
from swagger_ui_bundle import swagger_ui_path
from flask import Flask, Blueprint, send_from_directory, render_template
swagger_bp = Blueprint(
'swagger_ui',
__name__,
static_url_path='',
static_folder=swagger_ui_path,
template_folder=swagger_ui_path
)
app = Flask(__name__, static_url_path='')
app.register_blueprint(swagger_bp, url_prefix='/ui')
if __name__ == "__main__":
app.run()
You may wish to override some of the configuration variables. Included is a jinaj2 templated file where you can modify these parameters. You can add another route to render this template with your desired configuration like so:
SWAGGER_UI_CONFIG = {
"openapi_spec_url": "https://petstore.swagger.io/v2/swagger.json"
}
@swagger_bp.route('/')
def swagger_ui_index():
return render_template('index.j2', **SWAGGER_UI_CONFIG)
Have a look at example.py for a complete server for the Flask webserver.
License
Since this is just repackaging swagger-ui releases, the license comes from the swagger ui project (https://github.com/swagger-api/swagger-ui).
All vendored code is published by SmartBear Software under the Apache 2.0 License.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Hashes for swagger_ui_bundle-0.0.4-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | cea04fca6a37d26bfe0f0e3d78b51c023c30ba1105f7eaa5a709ed3725e570ea |
|
MD5 | 9a8a8744af3a9b460d0f030bb7cd9426 |
|
BLAKE2b-256 | a4737e2f7e104586277a6838543a600bf837a52d052b1341e1661f1f120eaa25 |
Hashes for swagger_ui_bundle-0.0.4-py2-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | c8b183838bd1e7212c5641af49b5294367d8fda6123261e5c1d00366131ba372 |
|
MD5 | da05941a7b5c4928769cc69b7221cfb0 |
|
BLAKE2b-256 | 08f6bbfa24df1caf26c617a91187047b3bbfb6ca70ed179f2b2f15eb6bc80383 |