About Me

• Mike Brown

• Your Favorite Organizer

• Python Backend + DevOps

• Python Lead @ Excella Consulting

Background

 In January 2017...

 {
    "text": "mike made the coolest API", 
    "search": "sarcastic wonka"
 }

Original Flask

 @app.route('/', methods = ['GET', 'POST'])
 def giffer():
    if request.method == 'POST':
       data = request.data
       gif_file = gif_factory.create(**data)
       return send_file(gif_file)
    else:
       return get_guide_text()

The Output

The Original Contestants

• Sanic - Asynchronous/Fast

• Hug - Simplified/Self Documenting

Sanic

• Python 3 required

• Async/Await syntax

• "Faster than Node"

 @app.route('/', methods = ['POST'])
 async def giffer(request):

    data = request.json
    gif_file = await gif_factory.create(**data)
    return file(gif_file, mime_type='image/gif')

Hug

• Python 3 required

• Type Annotations

• Autogenerated documentation

• "make developing an API as simple as possible"

 @hug.post('/', output=hug.output_format.gif_image)
 def giffer_post(search: input_search, text: input_text,
                 text_width: int=60):
    return gif_factory.create(search=search, text=text,
                              text_width=text_width)

Type Annotations!

API Star

By Tom Christie

Who's Tom Christie?

Tom is the creator of

Django Rest Framework

- 8,111 stars

- 2,750 forks

API Star:

• Python 3 required

• Type Annotations

• Autogenerated documentation

• "Faster than nodejs"

• Coming soon: Await/Async

How So Fast?

def show_request(request: http.Request):
    return {
        'method': request.method,
        'url': request.url,
        'headers': dict(request.headers)
    }

def show_query_params(query_params: http.QueryParams):
    return {
        'params': dict(query_params)
    }

def show_user_agent(user_agent: http.Header):
    return {
        'user-agent': user_agent
    }

API Star:

Other "kitchen sink" features

• template/static files
• Django ORM/SQLAlchemy
• autogenerated Swagger schema
• autogenerated JavaScript and Python client libraries

Demo Time

Questions?