Metadata-Version: 2.0
Name: albatross3
Version: 0.5.0
Summary: A modern async python3 web framework
Home-page: https://github.com/kespindler/albatross
Author: Kurt Spindler
Author-email: kespindler@gmail.com
License: MIT
Keywords: web http server async
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.5
Requires-Dist: httptools
Provides-Extra: ujson
Requires-Dist: ujson; extra == 'ujson'

|Build Status|

Albatross
=========

A modern, fast, simple, natively-async web framework. (Python3.5 only)

.. code:: python

    from albatross import Server
    import asyncio


    class Handler:
        async def on_get(self, req, res):
            await asyncio.sleep(0.1)
            res.write('Hello, %s' % req.args['name'])


    app = Server()
    app.add_route('/{name})', Handler())
    app.serve()

Notes for Usage
~~~~~~~~~~~~~~~

For now (pre 1.0.0), I'm not guaranteeing the API stays the same. The
current HTTP implementation has some deviations with the HTTP standard
(see Issues), but this web framework is a joy to work with for some
current toy projects. Fixing the HTTP standards issue will be done in
the next few weeks. Reach out if you want to use this, as I'm happy to
incorporate your feedback!

Install
-------

::

    pip3 install albatross3

Features
--------

-  You can read the entire codebase in about 30 minutes.

-  It's natively async

-  This works with the ``uvloop`` project, to make your server fast!

Benchmarks
----------

-  My benchmarks indicate that albatross is as fast as aiohttp, both of
   which are twice as fast as tornado. You can run the benchmarks by
   poking around in the ``bench/`` folder.

.. |Build Status| image:: https://travis-ci.org/kespindler/albatross.svg?branch=master
   :target: https://travis-ci.org/kespindler/albatross


