Metadata-Version: 1.1
Name: bjoern
Version: 3.2.2
Summary: A screamingly fast Python 2 + 3 WSGI server written in C.
Home-page: https://github.com/jonashaag/bjoern
Author: Jonas Haag
Author-email: jonas@lophus.org
License: 2-clause BSD
Description: bjoern: Fast And Ultra-Lightweight HTTP/1.1 WSGI Server
        =======================================================
        
        .. image:: https://badges.gitter.im/Join%20Chat.svg
           :alt: Join the chat at https://gitter.im/jonashaag/bjoern
           :target: https://gitter.im/jonashaag/bjoern?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge
        
        A screamingly fast, ultra-lightweight WSGI_ server for CPython 2 and CPython 3,
        written in C using Marc Lehmann's high performance libev_ event loop and
        Ryan Dahl's http-parser_.
        
        Why It's Cool
        ~~~~~~~~~~~~~
        bjoern is the *fastest*, *smallest* and *most lightweight* WSGI server out there,
        featuring
        
        * ~ 1000 lines of C code
        * Memory footprint ~ 600KB
        * Python 2 and Python 3 support (thanks @yanghao!)
        * Single-threaded and without coroutines or other crap
        * Can bind to TCP `host:port` addresses and Unix sockets (thanks @k3d3!)
        * Full persistent connection ("*keep-alive*") support in both HTTP/1.0 and 1.1,
          including support for HTTP/1.1 chunked responses
        
        Installation
        ~~~~~~~~~~~~
        ``pip install bjoern``. See `wiki <https://github.com/jonashaag/bjoern/wiki/Installation>`_ for details.
        
        Usage
        ~~~~~
        
        Flask example
        -------------
        
        .. code-block:: python
        
           from flask import Flask
        
           app = Flask(__name__)
        
           @app.route("/")
           def hello_world():
               return "Hello, World!"
        
           if __name__ == "__main__":
               import bjoern
        
               bjoern.run(app, "127.0.0.1", 8000)
        
        
        Advanced usage
        --------------
        
        .. code-block:: python
        
           # Bind to TCP host/port pair:
           bjoern.run(wsgi_application, host, port)
        
           # TCP host/port pair, enabling SO_REUSEPORT if available.
           bjoern.run(wsgi_application, host, port, reuse_port=True)
        
           # Bind to Unix socket:
           bjoern.run(wsgi_application, 'unix:/path/to/socket')
        
           # Bind to abstract Unix socket: (Linux only)
           bjoern.run(wsgi_application, 'unix:@socket_name')
        
           # Enable statsd metrics. See instrumentation.md for details.
           bjoern.run(wsgi_application, host, port, statsd=...)
        
        Alternatively, the mainloop can be run separately:
        
        .. code-block:: python
        
           bjoern.listen(wsgi_application, host, port)
           bjoern.run()
        
           # With metrics. See instrumentation.md for details.
           bjoern.listen(wsgi_application, host, port)
           bjoern.run(statsd=...)
        
        You can also simply pass a Python socket(-like) object. Note that you are responsible
        for initializing and cleaning up the socket in that case.
        
        .. code-block:: python
        
           bjoern.server_run(socket_object, wsgi_application)
           bjoern.server_run(filedescriptor_as_integer, wsgi_application)
        
           # This needs manual compilation with `WANT_STATSD=yes`
           bjoern.server_run(socket_object, wsgi_application, enable_statsd=True)
        
        .. _WSGI:         http://www.python.org/dev/peps/pep-0333/
        .. _libev:        http://software.schmorp.de/pkg/libev.html
        .. _http-parser:  https://github.com/joyent/http-parser
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: C
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Server
