This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

A really simple app that allows you to write out your RESTful APIs spec in a logical form and automatically generate stub functions for each endpoint.


Install from Source

To install from source, you will need to first clone the repository from GitHub:

git clone

Then run the file:

python3 install

With Pip

Or you can install directly from the Python Packaging Index:

pip install flask_api_builder


In order to generate your base API, you first need to write up a spec for it. The spec contains the definitions for each of your API’s end points, as well as some variables to customize the Blueprint each API endpoint is attached to.

Writing The Spec File

The spec file is designed to be quite intuitive to use. It is set out in a table-like format, with each column being aligned with spaces. Any line starting with a “#” is interpreted as a comment and ignored by the parser.

Defining Variables

Defining variables is really easy, just add a line with variable-name: value. The variable names currently supported are:

The name for your blueprint (defaults to “api”)
The path that all endpoints attached to your API Blueprint are prepended with (nothing by default)
Add pre-made 404 and 500 error handlers. They will be included unless something other than true, yes, 1, or y is entered (not case sensitive)

All variable names are not case sensitive.

Defining Endpoints

API Endpoints are defined one per line, in a table-like format. Each line consists of 3 or 4 fields delimited by two or more whitespace characters. This means that you need to separate your columns by at least two spaces so the parser will read them correctly.

The fields correspond to an endpoint’s METHOD, URL, DESCRIPTION and (optionally) the NAME of the function generated. If no name is provided then one will be generated for you given the method and URL parameters (no guarantees that the generated name will be intelligible though).

Here is an example of a simple spec for a to-do list app:

blueprint-name: api
#Method    URL                       Description
GET       /tasks                     Retrieve list of tasks
GET       /tasks/<int:task_id>       Retrieve task number <task_id>
POST      /tasks                     Create a new task



New Features

  • Added error handlers to the generated code

Version 0.1.1 (2016-44-23)

New Features

  • Added a commandline option to view an example spec
  • Turned the module into a package and gave it a commandline entry point

Documentation Changes

  • Wrote up a basic README
  • Added an example spec file

Administration and Chores

  • Added a makefile to automate the boring stuff
  • Turned the module into a package with a file
  • Added the ability to create sdist’s and wheels properly

Version 0.1.0 (2016-05-22)

New Features

  • Copied the main file from a jupyter notebook and set up the project
Release History

Release History


This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
flask_api_builder-0.2.0-py2.py3-none-any.whl (10.1 kB) Copy SHA256 Checksum SHA256 py2.py3 Wheel Jul 22, 2016
flask_api_builder-0.2.0.tar.gz (7.6 kB) Copy SHA256 Checksum SHA256 Source Jul 22, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting