VortexPY
Flying Ion's observable, routable, data serialisation and transport code.
See README_PERMISSIONS.md for the two-level permission system (endpoint guards + access control context) introduced in v5.0.
Why PY at the end? To be consistent with VortexJS, which is the Browser side package. See https://gitlab.com/flyingion/vortexjs
Requirements:
- Python 3.5
- Twisted 16+
- SQLAlchemy 1, 1.1
The "vortex" is designed to transport "Payloads" from a web browser (VortexJS) to a twisted web server (VortexPY). There is also a python client for python client to python server communication.
Vortex, The Observable Part
Vortex was designed to allow the Python server to send updates to the browser with out the browser having to create HTTP request polls.
This is achieved by the browser/client sending one or more payloads to the server as a HTTP POST, the server then uses this connection to send payloads back to the client.
This HTTP POST connection remains active, Until the client needs to send more Payloads to the server. To do this, the client simply starts a new HTTP POST request to the server, the server will then close the old request and begin sending Payloads down the respose path of the new request.
Python classes = Vortex
Transport
Transport occurs over a HTTP(S) layer.
Experimental classes are present to transport data to/from subprocess pipes, this worked, except the subprocess didn't die and the idea was abandoned (It was a Celery worker).
Because of this effort, it's much easier to add other transport mechanisms.
Python classes = VortexResource (Receive), VortexConnection (Send)
Payloads
A "Payload" is a class that stores some routing information, a result and a list of "Tuples".
The routing information is a dict / json object which looks like this {key:"anything.type.of.data.list"} (See Routable for more info)
The tuples attribute stores the data, typically this is a list of Tuple (see Tuples) objects, however, it can be any data structure that JSON can serialise, plus Date()/datetime.
The Payload class is responsible for serialising and compressing it's data down to a "Vortex Msg", ready for transport. Compression is done with zlib, this imrpovement sees data reduced to 10% of the original size.
There is custom code that handles converting the structure to JSON objects for json.dumps so support can be (carefully) added for other data types such as bytes.
Python classes = Payload
Tuples
Not to be confused with the built in Python tuple syntax (1, 2, 3), Tuples are registered classes with registered attributes.
Vortex Tuples are important in the design as classes that inherit the vortex Tuple class will reconstructed as the proper classes at the other end in python. They will have onlt the fields registerd as TupleFields populated when they are reconstructed.
This is especially useful when using the SQLAlchemy ORM, as the Tuple code recognises column definitions as TupleFields.
You can just assign session.query(MyTable).all() to payload.tuples, and the vortex will know how to serialise.
From here you can send it do the browser, where the browser may edit some attributes of the tuples, then send it back to the python server to update the database. (More on this in Handlers)
Python classes = Tuple, TupleField
Routable
When a vortex receives a payload, it is sent to the PayloadIO
The PayloadIO, then passes it on to each PayloadEndpoint that has registered with it.
Payload routing ends with PayloadEndpoints, These endpoints are constructed with another filter dict/json like object, and a callback.
When PayloadIO tells a PaylaodEndpoint that a new Payload has arrived, the PayloadEndpoint checks the Payload.filt against it's own filt.
If the PayloadEndpoints filt is a subset of the Payload.filt, the PayloadEndpoint then calls it's callable and passes it the Payload.
PayloadEndpoints register them selves with PayloadIO on construction. PayloadIO keeps a list of weak refs to the PayloadEndpoints.
Payloads contain a "filt" attribute, which is a json like dict/object.
Python classes = PayloadEndpoint, PayloadIO
Handlers
Handlers are the provided classes that handle data from the PayloadEndpoints.
- ModelHandler : Simply specify the payload filter and implement the "buildModel" method.
- OrmCrudHandler : This handler used to Create, Update, Retrieve and Delete SQLAlchemy data. It can handle an array of tuples, of different types, and has various hooks allowing the data to be customised before being stored or retreived.
- AsyncModelHandler : Experimental handler that will likely be deleted.
#Change Log
0.3.0
Implemented PY side WebSockets
License
Copyright (c) 2016-2026 Flying Ion Pty Ltd. Released under the MIT License.
1 maintainer
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
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file vortexpy-4.1.2.tar.gz.
File metadata
- Download URL: vortexpy-4.1.2.tar.gz
- Upload date:
- Size: 112.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.11
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7a8f6147c86c9a2e076124672c7b1b04ba04ec5ce4bbf220b4aaaf9f97db1d56
|
|
| MD5 |
7bc004835df21be46426fd032a20794c
|
|
| BLAKE2b-256 |
2ab07877d1f4dc10c155dff46a782db78f0636c8ce2dc2590fc7f411c2cbd679
|
File details
Details for the file vortexpy-4.1.2-py3-none-any.whl.
File metadata
- Download URL: vortexpy-4.1.2-py3-none-any.whl
- Upload date:
- Size: 166.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.11
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
dbe6561a596bf333e1da77a6eea39f9ecec25540d1e930f8c37c8e1af7c1ea48
|
|
| MD5 |
e2d45461997aadffccc01547ac584dc4
|
|
| BLAKE2b-256 |
f43bc1746984efcc4383fa969f2be82baf847f59caae80346d450edc4a293d31
|
