Aiohttp transport for Spyne RPC library
Project description
About
Aiohttp transport for Spyne RPC library.
Requirements:
- Python 3.8, 3.9, 3.10, 3.11
- Aiohttp >= 3.9.0
- Spyne >= 2.14.0
Spyne alpha versions should also work.
Installation
Just run pip install aiohttp-spyne
:)
Examples
- Test server:
python -m examples.hello_world
- Threaded test server:
python -m examples.hello_world_threads
- Test client:
python -m examples.test_client
Usage
First, initialize your spyne application as normal. Here's an example for a simple SOAP service (See spyne examples and documentation for a more complete service setup).
spyne_app = spyne.Application(
[HelloWorldService],
tns='aiohttp_spyne.examples.hello',
in_protocol=Soap11(validator='lxml'),
out_protocol=Soap11())
Next, wrap your Spyne application with AIOSpyne. Note that you can run your application entrypoints in a thread by setting the "threads" parameter. If you want to keep your entrypoints running in the same thread as the main application, just leave this None. If you DO run your entrypoints in threads, be aware that some signals sent by spyne will also be run in threads, and be extra careful of using your main loop!
handler = AIOSpyne(spyne_app, threads=25)
Lastly, make an aiohttp application as usual, and just bind GET and POST entrypoints from AIOSpyne to wherever. Note that both paths need to be the same.
With GET, if the request address ends ?wsdl or .wsdl, a WSDL schema is returned in a response. Otherwise, requests are redirected to spynes RPC handler.
app = web.Application()
app.router.add_get('/{tail:.*}', handler.get)
app.router.add_post('/{tail:.*}', handler.post)
web.run_app(app, port=8080)
Chunked encoding
If you offer large result sets in your soap entrypoints, and yield the results properly, you may want to enable chunked encoding. This way the aiohttp server can stream your results and reduce memory usage.
handler = AIOSpyne(spyne_app, chunked=True)
WSDL caching
By default, aiohttp-spyne will cache WSDL documents generated by spyne. This makes it cheap to offer the WSDL documents to any clients. If for some reason you want to disable this caching, you can do so by setting the cache_wsdl argument as False.
handler = AIOSpyne(spyne_app, cache_wsdl=False)
Testing and formatting
pytest
mypy -p aiohttp_spyne
black aiohttp_spyne/
License
LGPL-2.1 -- Please see LICENSE for details.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for aiohttp_spyne-1.6.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7f2bab8e2cb329b90a9fd64cee242d45ca288b43d95257787edf12631da6c432 |
|
MD5 | 2b9045b7f62b57928940df25b41f0cc9 |
|
BLAKE2b-256 | eb6016c0e9b644bf4e7f7d907dd2d10edca38004664d14bdd8f6262f5dc3d670 |