|
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432 |
- Metadata-Version: 2.1
- Name: autobahn
- Version: 23.6.2
- Summary: WebSocket client & server library, WAMP real-time framework
- Home-page: https://github.com/crossbario/autobahn-python
- Author: typedef int GmbH
- License: MIT License
- Project-URL: Source, https://github.com/crossbario/autobahn-python
- Keywords: autobahn crossbar websocket realtime rfc6455 wamp rpc pubsub twisted asyncio xbr data-markets blockchain ethereum
- Platform: Any
- Classifier: License :: OSI Approved :: MIT License
- Classifier: Development Status :: 5 - Production/Stable
- Classifier: Environment :: No Input/Output (Daemon)
- Classifier: Framework :: Twisted
- Classifier: Intended Audience :: Developers
- Classifier: Operating System :: OS Independent
- Classifier: Programming Language :: Python
- Classifier: Programming Language :: Python :: 3
- Classifier: Programming Language :: Python :: 3.9
- Classifier: Programming Language :: Python :: 3.10
- Classifier: Programming Language :: Python :: 3.11
- Classifier: Programming Language :: Python :: Implementation :: CPython
- Classifier: Programming Language :: Python :: Implementation :: PyPy
- Classifier: Topic :: Internet
- Classifier: Topic :: Internet :: WWW/HTTP
- Classifier: Topic :: Communications
- Classifier: Topic :: System :: Distributed Computing
- Classifier: Topic :: Software Development :: Libraries
- Classifier: Topic :: Software Development :: Libraries :: Python Modules
- Classifier: Topic :: Software Development :: Object Brokering
- Requires-Python: >=3.9
- License-File: LICENSE
- Requires-Dist: txaio (>=21.2.1)
- Requires-Dist: cryptography (>=3.4.6)
- Requires-Dist: hyperlink (>=21.0.0)
- Requires-Dist: setuptools
- Provides-Extra: accelerate
- Provides-Extra: all
- Requires-Dist: zope.interface (>=5.2.0) ; extra == 'all'
- Requires-Dist: twisted (>=20.3.0) ; extra == 'all'
- Requires-Dist: attrs (>=20.3.0) ; extra == 'all'
- Requires-Dist: python-snappy (>=0.6.0) ; extra == 'all'
- Requires-Dist: msgpack (>=1.0.2) ; extra == 'all'
- Requires-Dist: ujson (>=4.0.2) ; extra == 'all'
- Requires-Dist: cbor2 (>=5.2.0) ; extra == 'all'
- Requires-Dist: py-ubjson (>=0.16.1) ; extra == 'all'
- Requires-Dist: flatbuffers (>=22.12.6) ; extra == 'all'
- Requires-Dist: pyopenssl (>=20.0.1) ; extra == 'all'
- Requires-Dist: service-identity (>=18.1.0) ; extra == 'all'
- Requires-Dist: pynacl (>=1.4.0) ; extra == 'all'
- Requires-Dist: pytrie (>=0.4.0) ; extra == 'all'
- Requires-Dist: qrcode (>=7.3.1) ; extra == 'all'
- Requires-Dist: cffi (>=1.14.5) ; extra == 'all'
- Requires-Dist: argon2-cffi (>=20.1.0) ; extra == 'all'
- Requires-Dist: passlib (>=1.7.4) ; extra == 'all'
- Requires-Dist: bitarray (>=2.7.5) ; extra == 'all'
- Requires-Dist: xbr (>=21.2.1) ; extra == 'all'
- Requires-Dist: click (>=8.1.2) ; extra == 'all'
- Requires-Dist: zlmdb (>=21.2.1) ; extra == 'all'
- Requires-Dist: web3[ipfs] (>=6.0.0) ; extra == 'all'
- Requires-Dist: rlp (>=2.0.1) ; extra == 'all'
- Requires-Dist: py-eth-sig-utils (>=0.4.0) ; extra == 'all'
- Requires-Dist: py-ecc (>=5.1.0) ; extra == 'all'
- Requires-Dist: eth-abi (>=4.0.0) ; extra == 'all'
- Requires-Dist: mnemonic (>=0.19) ; extra == 'all'
- Requires-Dist: base58 (>=2.1.0) ; extra == 'all'
- Requires-Dist: ecdsa (>=0.16.1) ; extra == 'all'
- Requires-Dist: py-multihash (>=2.0.1) ; extra == 'all'
- Requires-Dist: jinja2 (>=2.11.3) ; extra == 'all'
- Requires-Dist: yapf (==0.29.0) ; extra == 'all'
- Requires-Dist: spake2 (>=0.8) ; extra == 'all'
- Requires-Dist: hkdf (>=0.0.3) ; extra == 'all'
- Requires-Dist: PyGObject (>=3.40.0) ; extra == 'all'
- Provides-Extra: asyncio
- Provides-Extra: compress
- Requires-Dist: python-snappy (>=0.6.0) ; extra == 'compress'
- Provides-Extra: dev
- Requires-Dist: backports.tempfile (>=1.0) ; extra == 'dev'
- Requires-Dist: bumpversion (>=0.5.3) ; extra == 'dev'
- Requires-Dist: codecov (>=2.0.15) ; extra == 'dev'
- Requires-Dist: flake8 (<5) ; extra == 'dev'
- Requires-Dist: humanize (>=0.5.1) ; extra == 'dev'
- Requires-Dist: passlib ; extra == 'dev'
- Requires-Dist: pep8-naming (>=0.3.3) ; extra == 'dev'
- Requires-Dist: pip (>=9.0.1) ; extra == 'dev'
- Requires-Dist: pyenchant (>=1.6.6) ; extra == 'dev'
- Requires-Dist: pyflakes (>=1.0.0) ; extra == 'dev'
- Requires-Dist: pyinstaller (>=4.2) ; extra == 'dev'
- Requires-Dist: pylint (>=1.9.2) ; extra == 'dev'
- Requires-Dist: pytest-aiohttp ; extra == 'dev'
- Requires-Dist: pytest-asyncio (>=0.14.0) ; extra == 'dev'
- Requires-Dist: pytest-runner (>=2.11.1) ; extra == 'dev'
- Requires-Dist: pytest (>=3.4.2) ; extra == 'dev'
- Requires-Dist: pyyaml (>=4.2b4) ; extra == 'dev'
- Requires-Dist: qualname ; extra == 'dev'
- Requires-Dist: sphinx-autoapi (>=1.7.0) ; extra == 'dev'
- Requires-Dist: sphinx (>=1.7.1) ; extra == 'dev'
- Requires-Dist: sphinx-rtd-theme (>=0.1.9) ; extra == 'dev'
- Requires-Dist: sphinxcontrib-images (>=0.9.1) ; extra == 'dev'
- Requires-Dist: tox-gh-actions (>=2.2.0) ; extra == 'dev'
- Requires-Dist: tox (>=4.2.8) ; extra == 'dev'
- Requires-Dist: twine (>=3.3.0) ; extra == 'dev'
- Requires-Dist: twisted (>=22.10.0) ; extra == 'dev'
- Requires-Dist: txaio (>=20.4.1) ; extra == 'dev'
- Requires-Dist: watchdog (>=0.8.3) ; extra == 'dev'
- Requires-Dist: wheel (>=0.36.2) ; extra == 'dev'
- Requires-Dist: yapf (==0.29.0) ; extra == 'dev'
- Requires-Dist: mypy (>=0.610) ; (python_version >= "3.4" and platform_python_implementation != "PyPy") and extra == 'dev'
- Provides-Extra: encryption
- Requires-Dist: pyopenssl (>=20.0.1) ; extra == 'encryption'
- Requires-Dist: service-identity (>=18.1.0) ; extra == 'encryption'
- Requires-Dist: pynacl (>=1.4.0) ; extra == 'encryption'
- Requires-Dist: pytrie (>=0.4.0) ; extra == 'encryption'
- Requires-Dist: qrcode (>=7.3.1) ; extra == 'encryption'
- Provides-Extra: nvx
- Requires-Dist: cffi (>=1.14.5) ; extra == 'nvx'
- Provides-Extra: scram
- Requires-Dist: cffi (>=1.14.5) ; extra == 'scram'
- Requires-Dist: argon2-cffi (>=20.1.0) ; extra == 'scram'
- Requires-Dist: passlib (>=1.7.4) ; extra == 'scram'
- Provides-Extra: serialization
- Requires-Dist: msgpack (>=1.0.2) ; extra == 'serialization'
- Requires-Dist: ujson (>=4.0.2) ; extra == 'serialization'
- Requires-Dist: cbor2 (>=5.2.0) ; extra == 'serialization'
- Requires-Dist: py-ubjson (>=0.16.1) ; extra == 'serialization'
- Requires-Dist: flatbuffers (>=22.12.6) ; extra == 'serialization'
- Provides-Extra: twisted
- Requires-Dist: zope.interface (>=5.2.0) ; extra == 'twisted'
- Requires-Dist: twisted (>=20.3.0) ; extra == 'twisted'
- Requires-Dist: attrs (>=20.3.0) ; extra == 'twisted'
- Provides-Extra: ui
- Requires-Dist: PyGObject (>=3.40.0) ; extra == 'ui'
- Provides-Extra: xbr
- Requires-Dist: bitarray (>=2.7.5) ; extra == 'xbr'
- Requires-Dist: xbr (>=21.2.1) ; extra == 'xbr'
- Requires-Dist: click (>=8.1.2) ; extra == 'xbr'
- Requires-Dist: cbor2 (>=5.2.0) ; extra == 'xbr'
- Requires-Dist: zlmdb (>=21.2.1) ; extra == 'xbr'
- Requires-Dist: twisted (>=20.3.0) ; extra == 'xbr'
- Requires-Dist: web3[ipfs] (>=6.0.0) ; extra == 'xbr'
- Requires-Dist: rlp (>=2.0.1) ; extra == 'xbr'
- Requires-Dist: py-eth-sig-utils (>=0.4.0) ; extra == 'xbr'
- Requires-Dist: py-ecc (>=5.1.0) ; extra == 'xbr'
- Requires-Dist: eth-abi (>=4.0.0) ; extra == 'xbr'
- Requires-Dist: mnemonic (>=0.19) ; extra == 'xbr'
- Requires-Dist: base58 (>=2.1.0) ; extra == 'xbr'
- Requires-Dist: ecdsa (>=0.16.1) ; extra == 'xbr'
- Requires-Dist: py-multihash (>=2.0.1) ; extra == 'xbr'
- Requires-Dist: jinja2 (>=2.11.3) ; extra == 'xbr'
- Requires-Dist: yapf (==0.29.0) ; extra == 'xbr'
- Requires-Dist: spake2 (>=0.8) ; extra == 'xbr'
- Requires-Dist: hkdf (>=0.0.3) ; extra == 'xbr'
-
- Autobahn\|Python
- ================
-
- WebSocket & WAMP for Python on Twisted and asyncio.
-
- | |Version| |CI Test Status| |CI Deploy Status| |CI Docker Status| |CI EXE Status| |Docs| |Docker Images| |EXE Download|
-
- --------------
-
- | **Quick Links**: `Source Code <https://github.com/crossbario/autobahn-python>`__ - `Documentation <https://autobahn.readthedocs.io/en/latest/>`__ - `WebSocket Examples <https://autobahn.readthedocs.io/en/latest/websocket/examples.html>`__ - `WAMP Examples <https://autobahn.readthedocs.io/en/latest/wamp/examples.html>`__
- | **Community**: `Forum <https://crossbar.discourse.group/>`__ - `StackOverflow <https://stackoverflow.com/questions/tagged/autobahn>`__ - `Twitter <https://twitter.com/autobahnws>`__ - `IRC #autobahn/chat.freenode.net <https://webchat.freenode.net/>`__
- | **Companion Projects**: `Autobahn|JS <https://github.com/crossbario/autobahn-js/>`__ - `Autobahn|Cpp <https://github.com/crossbario/autobahn-cpp>`__ - `Autobahn|Testsuite <https://github.com/crossbario/autobahn-testsuite>`__ - `Crossbar.io <https://crossbar.io>`__ - `WAMP <https://wamp-proto.org>`__
-
- Introduction
- ------------
-
- **Autobahn\|Python** is a subproject of `Autobahn <https://crossbar.io/autobahn>`__ and provides open-source
- implementations of
-
- - `The WebSocket Protocol <https://tools.ietf.org/html/rfc6455>`__
- - `The Web Application Messaging Protocol (WAMP) <https://wamp-proto.org/>`__
-
- for Python 3.7+ and running on `Twisted <https://twistedmatrix.com/>`__ and `asyncio <https://docs.python.org/3/library/asyncio.html>`__.
-
- You can use **Autobahn\|Python** to create clients and servers in Python speaking just plain WebSocket or WAMP.
-
- **WebSocket** allows `bidirectional real-time messaging on the Web <https://crossbario.com/blog/post/websocket-why-what-can-i-use-it/>`__ and beyond, while `WAMP <https://wamp-proto.org/>`__ adds real-time application communication on top of WebSocket.
-
- **WAMP** provides asynchronous **Remote Procedure Calls** and **Publish & Subscribe** for applications in *one* protocol running over `WebSocket <https://tools.ietf.org/html/rfc6455>`__. WAMP is a *routed* protocol, so you need a **WAMP Router** to connect your **Autobahn\|Python** based clients. We provide `Crossbar.io <https://crossbar.io>`__, but there are `other options <https://wamp-proto.org/implementations.html#routers>`__ as well.
-
- .. note::
-
- **Autobahn\|Python** up to version v19.11.2 supported Python 2 and 3.4+,
- and up to version v20.7.1 supported Python 3.5+,
- and up to version v21.2.1 supported Python 3.6+.
-
- Features
- --------
-
- - framework for `WebSocket <https://tools.ietf.org/html/rfc6455>`__ and `WAMP <https://wamp-proto.org/>`__ clients and servers
- - runs on `CPython <https://python.org/>`__ and `PyPy <https://pypy.org/>`
- - runs under `Twisted <https://twistedmatrix.com/>`__ and `asyncio <https://docs.python.org/3/library/asyncio.html>`__ - implements WebSocket
- `RFC6455 <https://tools.ietf.org/html/rfc6455>`__ and Draft Hybi-10+
- - implements `WebSocket compression <https://tools.ietf.org/html/draft-ietf-hybi-permessage-compression>`__
- - implements `WAMP <https://wamp-proto.org/>`__, the Web Application Messaging Protocol
- - high-performance, fully asynchronous implementation
- - best-in-class standards conformance (100% strict passes with `Autobahn Testsuite <https://crossbar.io/autobahn#testsuite>`__: `Client <https://autobahn.ws/testsuite/reports/clients/index.html>`__ `Server <https://autobahn.ws/testsuite/reports/servers/index.html>`__)
- - message-, frame- and streaming-APIs for WebSocket
- - supports TLS (secure WebSocket) and proxies
- - Open-source (`MIT license <https://github.com/crossbario/autobahn-python/blob/master/LICENSE>`__)
-
- -----
-
- Show me some code
- -----------------
-
- To give you a first impression, here are two examples. We have lot more `in the repo <https://github.com/crossbario/autobahn-python/tree/master/examples>`__.
-
- WebSocket Echo Server
- ~~~~~~~~~~~~~~~~~~~~~
-
- Here is a simple WebSocket Echo Server that will echo back any WebSocket
- message received:
-
- .. code:: python
-
- from autobahn.twisted.websocket import WebSocketServerProtocol
- # or: from autobahn.asyncio.websocket import WebSocketServerProtocol
-
- class MyServerProtocol(WebSocketServerProtocol):
-
- def onConnect(self, request):
- print("Client connecting: {}".format(request.peer))
-
- def onOpen(self):
- print("WebSocket connection open.")
-
- def onMessage(self, payload, isBinary):
- if isBinary:
- print("Binary message received: {} bytes".format(len(payload)))
- else:
- print("Text message received: {}".format(payload.decode('utf8')))
-
- # echo back message verbatim
- self.sendMessage(payload, isBinary)
-
- def onClose(self, wasClean, code, reason):
- print("WebSocket connection closed: {}".format(reason))
-
- To actually run above server protocol, you need some lines of `boilerplate <https://autobahn.readthedocs.io/en/latest/websocket/programming.html#running-a-server>`__.
-
- WAMP Application Component
- ~~~~~~~~~~~~~~~~~~~~~~~~~~
-
- Here is a WAMP Application Component that performs all four types of
- actions that WAMP provides:
-
- #. **subscribe** to a topic
- #. **publish** an event
- #. **register** a procedure
- #. **call** a procedure
-
- .. code:: python
-
- from autobahn.twisted.wamp import ApplicationSession
- # or: from autobahn.asyncio.wamp import ApplicationSession
-
- class MyComponent(ApplicationSession):
-
- @inlineCallbacks
- def onJoin(self, details):
-
- # 1. subscribe to a topic so we receive events
- def onevent(msg):
- print("Got event: {}".format(msg))
-
- yield self.subscribe(onevent, 'com.myapp.hello')
-
- # 2. publish an event to a topic
- self.publish('com.myapp.hello', 'Hello, world!')
-
- # 3. register a procedure for remote calling
- def add2(x, y):
- return x + y
-
- self.register(add2, 'com.myapp.add2')
-
- # 4. call a remote procedure
- res = yield self.call('com.myapp.add2', 2, 3)
- print("Got result: {}".format(res))
-
- Above code will work on Twisted and asyncio by changing a single line
- (the base class of ``MyComponent``). To actually run above application component, you need some lines of `boilerplate <https://autobahn.readthedocs.io/en/latest/wamp/programming.html#running-components>`__ and a `WAMP Router <https://autobahn.readthedocs.io/en/latest/wamp/programming.html#running-a-wamp-router>`__.
-
-
- Extensions
- ----------
-
- Networking framework
- ~~~~~~~~~~~~~~~~~~~~
-
- Autobahn runs on both Twisted and asyncio. To select the respective netoworking framework, install flavor:
-
- * ``asyncio``: Install asyncio (when on Python 2, otherwise it's included in the standard library already) and asyncio support in Autobahn
- * ``twisted``: Install Twisted and Twisted support in Autobahn
-
- -----
-
-
- WebSocket acceleration and compression
- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
- * ``accelerate``: Install WebSocket acceleration - *Only use on CPython - not on PyPy (which is faster natively)*
- * ``compress``: Install (non-standard) WebSocket compressors **bzip2** and **snappy** (standard **deflate** based WebSocket compression is already included in the base install)
-
- -----
-
-
- Encryption and WAMP authentication
- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
- Autobahn supports running over TLS (for WebSocket and all WAMP transports) as well as **WAMP-cryposign** authentication.
-
- To install use this flavor:
-
- * ``encryption``: Installs TLS and WAMP-cryptosign dependencies
-
- Autobahn also supports **WAMP-SCRAM** authentication. To install:
-
- * ``scram``: Installs WAMP-SCRAM dependencies
-
- -----
-
-
- XBR
- ~~~
-
- Autobahn includes support for `XBR <https://xbr.network/>`__. To install use this flavor:
-
- * ``xbr``:
-
- To install:
-
- .. code:: console
-
- pip install autobahn[xbr]
-
- or (Twisted, with more bells an whistles)
-
- .. code:: console
-
- pip install autobahn[twisted,encryption,serialization,xbr]
-
- or (asyncio, with more bells an whistles)
-
- .. code:: console
-
- pip install autobahn[asyncio,encryption,serialization,xbr]
-
- -----
-
-
- Native vector extensions (NVX)
- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
- > This is NOT yet complete - ALPHA!
-
- Autobahn contains **NVX**, a network accelerator library that provides SIMD accelerated native vector code for WebSocket (XOR masking) and UTF-8 validation.
-
- .. note:
-
- NVX lives in namespace `autobahn.nvx` and currently requires a x86-86 CPU with at least SSE2 and makes use of SSE4.1 if available. The code is written using vector instrinsics, should compile with both GCC and Clang,and interfaces with Python using CFFI, and hence runs fast on PyPy.
-
- -----
-
-
- WAMP Serializers
- ~~~~~~~~~~~~~~~~
-
- * ``serialization``: To install additional WAMP serializers: CBOR, MessagePack, UBJSON and Flatbuffers
-
- **Above is for advanced uses. In general we recommend to use CBOR where you can,
- and JSON (from the standard library) otherwise.**
-
- -----
-
- To install Autobahn with all available serializers:
-
- .. code:: console
-
- pip install autobahn[serializers]
-
- or (development install)
-
- .. code:: console
-
- pip install -e .[serializers]
-
- Further, to speed up JSON on CPython using ``ujson``, set the environment variable:
-
- .. code:: console
-
- AUTOBAHN_USE_UJSON=1
-
- .. warning::
-
- Using ``ujson`` (on both CPython and PyPy) will break the ability of Autobahn
- to transport and translate binary application payloads in WAMP transparently.
- This ability depends on features of the regular JSON standard library module
- not available on ``ujson``.
-
-
- .. |Version| image:: https://img.shields.io/pypi/v/autobahn.svg
- :target: https://pypi.python.org/pypi/autobahn
-
- .. |CI Test Status| image:: https://github.com/crossbario/autobahn-python/workflows/main/badge.svg
- :target: https://github.com/crossbario/autobahn-python/actions?query=workflow%3Amain
- :alt: CI Test Status
-
- .. |CI Deploy Status| image:: https://github.com/crossbario/autobahn-python/workflows/deploy/badge.svg
- :target: https://github.com/crossbario/autobahn-python/actions?query=workflow%3Adeploy
- :alt: CI Deploy Status
-
- .. |CI Docker Status| image:: https://github.com/crossbario/autobahn-python/workflows/docker/badge.svg
- :target: https://github.com/crossbario/autobahn-python/actions?query=workflow%3Adocker
- :alt: CI Docker Status
-
- .. |CI EXE Status| image:: https://github.com/crossbario/autobahn-python/workflows/pyinstaller/badge.svg
- :target: https://github.com/crossbario/autobahn-python/actions?query=workflow%3Apyinstaller
- :alt: CI EXE Status
-
- .. |Docs| image:: https://img.shields.io/badge/docs-latest-brightgreen.svg?style=flat
- :target: https://autobahn.readthedocs.io/en/latest/
-
- .. |Docker Images| image:: https://img.shields.io/badge/download-docker-blue.svg?style=flat
- :target: https://hub.docker.com/r/crossbario/autobahn-python/
-
- .. |EXE Download| image:: https://img.shields.io/badge/download-exe-blue.svg?style=flat
- :target: https://download.crossbario.com/xbrnetwork/linux-amd64/xbrnetwork-latest
|