https://github.com/housleyjk/aiopyramid

Run pyramid using asyncio.
https://github.com/housleyjk/aiopyramid

Last synced: 1 day ago
JSON representation

Run pyramid using asyncio.

• Host: GitHub
• URL: https://github.com/housleyjk/aiopyramid
• Owner: housleyjk
• License: other
• Created: 2014-07-22T20:17:09.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2023-07-20T15:09:15.000Z (over 1 year ago)
• Last Synced: 2024-05-10T05:03:40.410Z (6 months ago)
• Language: Python
• Size: 171 KB
• Stars: 79
• Watchers: 8
• Forks: 13
• Open Issues: 9
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGES.rst
  • License: LICENSE

Awesome Lists containing this project

• awesome-pyramid - aiopyramid - Run pyramid using (Async)

README

        
Introduction

============

A library for leveraging pyramid infrastructure asynchronously using the new ``asyncio``.

``Aiopyramid`` provides tools for making web applications with ``Pyramid`` and ``asyncio``.

It will not necessarily make your application run faster. Instead, it gives you some tools

and patterns to build an application on asynchronous servers.

Bear in mind that you will need to use asynchronous libraries for io where appropriate.

Since this library is built on relatively new technology, it is not intended for production use.

Getting Started

---------------

``Aiopyramid`` includes a scaffold that creates a "hello world" application,

check it out. The scaffold is designed to work with either `gunicorn`_

via a custom worker or `uWSGI`_ via the `uWSGI asyncio plugin`_. We will be

be using gunicorn and installing aiopyramid along with its defined gunicorn

extras for this example:

::

    pip install aiopyramid[gunicorn] gunicorn

    pcreate -s aio_starter 

    cd 

    pip install -e .

    gunicorn --paste development.ini

There is also a ``websocket`` scaffold `aio_websocket` for those who basic tools for setting up

a ``websocket`` server.

Documentation

-------------

Full documentation for ``Aiopyramid`` can be found `here`_.

.. _gunicorn: http://gunicorn.org

.. _uWSGI: https://github.com/unbit/uwsgi

.. _uWSGI asyncio plugin: http://uwsgi-docs.readthedocs.org/en/latest/asyncio.html

.. _here: http://aiopyramid.readthedocs.io/