Description
Netius is a Python network library that can be used for the rapid creation of asynchronous non-blocking
servers and clients. It has no dependencies, it's cross-platform, and brings some sample netius-powered
servers out of the box, namely a production-ready WSGI server.
Simplicity and performance are the main drivers of this project. The codebase adheres to very strict
code standards, and is extensively commented; and as far as performance is concerned, it aims to
be up to par with equivalent native implementations, where PyPy can be used to
provide the extra boost to raise performance up to these standards.
Bear in mind that although netius is non-blocking, it will naturally still block if the operations
performed within the event loop are blocking, like reading or writing a file, which are both blocking
operations in the Python standard library. Running multiple netius instances in parallel, and having
a fast server like nginx act as their reverse proxy, is one way of minimising the
perceptibility of such blockages.
netius alternatives and similar packages
Based on the "WSGI Servers" category.
Alternatively, view netius alternatives based on common mentions on social networks and blogs.
-
gunicorn
gunicorn 'Green Unicorn' is a WSGI HTTP Server for UNIX, fast clients and sleepy applications. -
-
Scout Monitoring - Free Django app performance insights with Scout Monitoring
* Code Quality Rankings and insights are calculated and provided by Lumnify.
They vary from L1 to L5 with "L5" being the highest.
Do you think we are missing an alternative of netius or a related project?
README
[Netius](res/logo.png)
Fast and readable async non-blocking network apps
Netius is a Python network library that can be used for the rapid creation of asynchronous non-blocking servers and clients. It has no dependencies, it's cross-platform, and brings some sample netius-powered servers out of the box, namely a production-ready WSGI server.
Simplicity and performance are the main drivers of this project. The codebase adheres to very strict code standards, and is extensively commented; and as far as performance is concerned, it aims to be up to par with equivalent native implementations, where PyPy can be used to provide the extra boost to raise performance up to these standards.
Bear in mind that although netius is non-blocking, it will naturally still block if the operations performed within the event loop are blocking, like reading or writing a file, which are both blocking operations in the Python standard library. Running multiple netius instances in parallel, and having a fast server like NGINX act as their reverse proxy, is one way of minimising the perceptibility of such blockages.
Installation
pip install netius
Or download the source from GitHub.
Netius has no dependencies, and is therefore cross-platform. It's compatible with PyPy, with which it benefits of performance increases up to 1.5x - 2.5x faster in most environments, when compared with running it with the cPython interpreter.
Usage
WSGI Server
import netius.servers
def app(environ, start_response):
status = "200 OK"
contents = "Hello World"
content_l = len(contents)
headers = (
("Content-Length", content_l),
("Content-Type", "text/plain"),
("Connection", "keep-alive")
)
start_response(status, headers)
yield contents
server = netius.servers.WSGIServer(app = app)
server.serve(port = 8080)
HTTP Client
Synchronous usage
import netius.clients
result = netius.clients.HTTPClient.get_s(
"http://www.flickr.com/",
asynchronous = False
)
print(result["data"])
Asynchronous usage
import netius.clients
def on_partial(client, parser, data):
print(data)
def on_message(client, parser, message):
netius.clients.HTTPClient.cleanup_s()
netius.clients.HTTPClient.get_s(
"http://www.flickr.com/",
callback = on_message,
on_data = on_partial
)
Test servers
The servers that come with netius out-of-the-box, can be tested through the command line:
| Class | Example |
|---|---|
| WSGIServer | python -m netius.servers.wsgi |
| FTPServer | python -m netius.servers.ftp |
| HelloServer | MESSAGE="Hello Netius" python -m netius.extra.hello |
| FileServer | BASE_PATH=/ python -m netius.extra.file |
| SMTPServer | python -m netius.servers.smtp |
| RelaySMTPServer | python -m netius.extra.smtp_r |
Learn more
Basic
- [Configuration](doc/configuration.md) - how to configure your server/client
Advanced topics
More information can be found in the [Advanced Topics](doc/advanced.md) page.
License
Netius is currently licensed under the Apache License, Version 2.0.
Build Automation
*Note that all licence references and agreements mentioned in the netius README section above
are relevant to that project's source code only.