Dave Forgac tylerdave

Open API Specification (fka Swagger Specification) tutorial

All these Gist files are explained on my Open API Specification (fka Swagger Specification) tutorial on API Handyman blog.

The tutorial

This tutorial is composed of several posts, here are the posts links and files used for each one:

Part 1: Introduction
- A JSON specification
- A YAML specification
Part 2: The basics

Building a test pex

setup.py

yakuza:src kw$ cat testapp/setup.py
#!/usr/bin/env python

from distutils.core import setup

OPEN DATA AND GOVERNMENT TRANSPARENCY

WHEREAS, the City of Philadelphia is committed to creating a high level of openness and transparency in government; and

WHEREAS, the three principles of transparency, participation, and collaboration form the cornerstone of an open government; and

WHEREAS, the City’s participation as a founding and vital partner in the open data consortium has provided a model for transparency on which the City should continue to build; and

WHEREAS, more City data sets should be published and made available via an Open Data Portal which will provide access to information and a mechanism for public feedback and participation; and

	import React from 'react';
	import merge from 'lodash.merge';
	import { RedocStandalone } from 'redoc';
	import useThemeContext from '@theme/hooks/useThemeContext';
	import './styles.css';

	/**
	* NOTE: Colors taken from `node_modules/infima/styles/common/dark-mode.css`
	* and related files
	*/

	>>> import mock
	>>> m = mock.Mock()
	>>> m.assert_called_once() # Old version of Mock? This may not be what you expect.
	<Mock name='mock.assert_called_once()' id='4558624144'>

	>>> assert_called_once = mock.Mock.assert_called_once # Doesn't exist. Now you know!
	Traceback (most recent call last):
	File "<stdin>", line 1, in <module>
	AttributeError: type object 'Mock' has no attribute 'assert_called_once'

	#cribbed from http://vimeo.com/52569901 (Twilio carrier call origination moderation)
	# The idea is that many fan-in queues can enqueue at any rate, but
	# dequeue needs to happen in a rate-controlled manner without allowing
	# any individual input queue to starve other queues.
	# http://en.wikipedia.org/wiki/Leaky_bucket (second sense, "This version is referred to here as the leaky bucket as a queue.")
	#
	# requires:
	# redis 2.6+
	# redis-py>=2.7.0
	# anyjson

	# a messy hack written by Edd Dumbill. http://twitter.com/edd

	# You may need to rerun this script if you hit a Twitter Error because you
	# use up API rate limiting. That's why we pickle the results, so we can resume
	# where we left off.

	# get the twitter module using 'easy_install twitter'

	from twitter.api import Twitter, TwitterError
	from twitter.oauth import OAuth