Event driven concurrent framework for Python
|Stack overflow:||questions tagged python-pulsar|
|Mailing list:||google user group|
|Design by:||Quantmind and Luca Sbardella|
|Platforms:||Linux, OSX, Windows. Python 3.5 and above|
|Keywords:||client, server, asynchronous, concurrency, actor, thread, process, socket, wsgi, websocket, redis, json-rpc|
An example of a web server written with pulsar which responds with “Hello World!” for every request:
from pulsar.apps import wsgi def hello(environ, start_response): data = b'Hello World!\n' response_headers = [ ('Content-type','text/plain'), ('Content-Length', str(len(data))) ] start_response('200 OK', response_headers) return [data] if __name__ == '__main__': wsgi.WSGIServer(callable=hello).start()
Pulsar’s goal is to provide an easy way to build scalable network programs. In the Hello world! web server example above, many client connections can be handled concurrently. Pulsar tells the operating system (through epoll or select) that it should be notified when a new connection is made, and then it goes to sleep.
Pulsar uses the asyncio module from the standard python library and it can be configured to run in multi-processing mode.
Another example of pulsar framework is the asynchronous HttpClient:
from pulsar.apps import http async with http.HttpClient() as session: response1 = await session.get('https://github.com/timeline.json') response2 = await session.get('https://api.github.com/emojis.json')
The http client maintains connections alive (by default 15 seconds) and therefore any requests that you make within a session will automatically reuse the appropriate connection. All connections are released once the session exits the asynchronous with block.
Pulsar has no hard dependencies, install via pip:
pip install pulsar
or download the tarball from pypi.
Pulsar design allows for a host of different asynchronous applications to be implemented in an elegant and efficient way. Out of the box it is shipped with the the following:
Check out the examples directory for various working applications. It includes:
Pulsar internals are based on actors primitive. Actors are the atoms of pulsar’s concurrent computation, they do not share state between them, communication is achieved via asynchronous inter-process message passing, implemented using the standard python socket library.
Two special classes of actors are the Arbiter, used as a singleton, and the Monitor, a manager of several actors performing similar functions. The Arbiter runs the main eventloop and it controls the life of all actors. Monitors manage group of actors performing similar functions, You can think of them as a pool of actors.
More information about design and philosophy in the documentation.
Pulsar checks if some additional libraries are available at runtime, and uses them to add additional functionalities or improve performance:
Pulsar test suite uses the pulsar test application. To run tests:
python setup.py test
For options and help type:
python setup.py test --help
flake8 check (requires flake8 package):
Development of pulsar happens at Github. We very much welcome your contribution of course. To do so, simply follow these guidelines:
A good pull request should:
This software is licensed under the BSD 3-clause License. See the LICENSE file in the top distribution directory for the full license text.
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|File Name & Checksum SHA256 Checksum Help||Version||File Type||Upload Date|
|pulsar-1.6.4-cp35-cp35m-macosx_10_11_x86_64.whl (349.0 kB) Copy SHA256 Checksum SHA256||3.5||Wheel||Feb 9, 2017|
|pulsar-1.6.4.tar.gz (1.4 MB) Copy SHA256 Checksum SHA256||–||Source||Feb 9, 2017|