Gloss is no longer actively maintained.
Gloss is an integration engine for healthcare applications.
Gloss comprises a Twisted server that can translate and route HL7 over MLLP, a flask server that speaks OPAL JSON over HTTP, and also abitrary batch file uploads/imports.
Gloss will also act as a shadow PAS, and includes archiving and demographic query functionality.
Some quick instructions to get you started
From the source directory
python setup.py install
You will also need the python dependencies:
pip install -r requirements.txt
create a folder in sites with the name of your site. Add a settings.py to this folder.
To run the HL7 server:
twistd --nodaemon gloss --site [[ your_site_name ]]
This will give you a gloss service that listens for HL7 messages on ports 2574 and 2575 and sends all of those messages to "http://127.0.0.1:8000/glossapi/v0.1/glossapi/"
To run the OPAL/JSON/HTTP API:
python -m gloss.api --site [[ your_app_name ]]
This will give you a flask service that sits at 0.0.0.0:6767
Gloss handles three types of upstream data sources.
- Query upstreams (e.g. an HL7 query or a database connection it can make queries via)
- Polling upstreams (e.g. reading a file produced by a daily batch process, or polling a server for updates every n minutes)
- Event upstreams (e.g. receiving a HL7 message every time a patient is admitted)
Each of these upstream data sources will provide data to a Gloss Importer - which take raw data from an upstream source and translate that data into GlossMessages.
Gloss also defines Subscribers which perform actions whenever a new GlossMessage arrives, from any upstream source. The Subscrier is responsible for sending data on downstream, saving information locally, or any other processing that needs to be done.
In order to configure Gloss to handle data from an Event Upstream, we define a Receiver.
Gloss ships with an MLLP server (commonly used with HL7 messages), you can configure this with the ports
GlossApi(
reciever=gloss.receivers.mullp_multi_servce(1190, 1999).make_service
)Gloss has an imoprt stage that takes the output of a receiver (which should be for example an hl7 message or a files contents) and translates it to a subclass gloss.message_type.MessageType. For example an AllergyMessage.
To help this translators should be used to to simplify for example the translation of hl7 to MessageType. Gloss comes with a tranlators to tranlate from hl7 in gloss.translators.hl7 nad to opal json (currently in serialisers, we'll probably change the name to serialisers so it will stay there)
A gloss service takes in one more subscriber methods, these take a message container (gloss.message_type.MessageContainer), which has an array of all messages that have just come in, and the gloss service itself.
Example subscribers are the database subscriber that will save all messages it receives to the database
When the query api requests information it hits this. This checks the database and returns everything about the patient. This should be overridden to make external calls.
You can set your own by settings an INFORMATION_SOURCE path to a class in your settings. This class has a single method called patient_information which takes an identifier. The class takes an intialiser of the information source.
Gloss also implements a REST Query API.
/api/patient/$IDENTIFIER
-> {'status': 'success': 'data': Patient.to_dict()}
#data:
dict(
identifier='UCH-555',
allergies=[
allergy_1
],
results= [
result_1, result_2
],
demographics=[
dict(
identifier='UCH-555'
)
]
)
# Includes all Allergies, Results, Admissions/Episodes
-> {'status': 'error': 'data': 'some error description to log'}
You can configure Gloss a settings file in your app, ie sites/[[ your_app_name ]]/settings.py
Available settings are:
The postgres database string you would like to use. Note gloss only supports postgres
These are the date and datetime formatting strings we would like to use for broadcasting dates. Defaults to:
DATE_FORMAT = '%d/%m/%Y'
DATETIME_FORMAT = '%d/%m/%Y %H:%M:%S'
Turn on debugging. Defaults to False.
Our load test script will fire a given amount messages as as many ports as are given in settings.
python gloss/tests/load_test.py {{ amount }}
Database migrations use ![alembic]
always use the -x attribute to point to your site.
To create a migration run "alembic -x site={{ your_site_name }} revision --autogenerate"
To update to head run "alembic -x site={{ your_site_name }} upgrade head"
To upgrade or downgrade you can use upgrade +1 (e.g. "alembic downgrade -1") or it pattern matches with the version number.
For example, if it is unique you can run "alembic upgrade ad" and it'll upgrade to the version number beginning "ad"
tests in gloss are done with py.test. py.test will run all the tests with the default settings. To run all the tests with your apps specific settings run py.test
Gloss is released under the GNU Affero GPLv3