A simple Orthanc python plugin based framework to extend Orthanc’s feature set with testable python scripts.
Project description
Orthanc Server Extensions
A simple Orthanc python plugin based framework to extend Orthanc’s feature set with testable python scripts. It focusses on integration and orchestration scripts, like study routing, event notifications and audit logging.
Free software: GNU Affero General Public License v3
Documentation: https://orthanc-server-extensions.readthedocs.io.
Features
run (integration) tests for your Orthanc python scripts
currently supports handling of change events
Why this library was written
Improve developer happiness: the development roundtrip is just a little bit long to build, run and test a function, even with Docker. With this library, you can start from the unit tests, move to integration tests, and then deploy the result in the Docker image.
Enable testability: the Orthanc API is provided as a module which is not easy to mock in a clean way. Orthanc server extensions provide a few simple abstractions that keep functions clean and independently testable.
Requests was chosen as a base library to access the Orthanc API, rather than orthanc.RestApi*, because it is well known, developer friendly, and external API access avoids deadlocks in the Python plugin (before this was solved in 3.1).
Running
docker-compose up --build should greet you with ‘orthanc started event handled!’ message and provides the first boilerplate to get started.
Credits
This project would obviously not exist without Orthanc, its documentation and its community.
This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.
History
3.1.1 (2021-02-11)
Add DICOM auto forwarding sample with retries
3.1.0 (2021-02-07)
Improved logging, aligned log format and levels with Orthanc.
0.1.0 (2021-01-09)
First release on PyPI.
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 orthanc-server-extensions-3.1.4.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | a872bd3ac071ed2254a97551c0b19245dc23c241c76377ce2fc650597b7d5284 |
|
MD5 | 23d8940042ac0ae38236d70825483cc9 |
|
BLAKE2b-256 | 63195ca9e660a220dfa83e14c9bbb0c348a0a7b93a5ac6c5caddfbf0bc8c628d |
Hashes for orthanc_server_extensions-3.1.4-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 869a77480fb2df2b8255e9a6f968d4259ad95b6d278d0bea38caf0c3dc066c91 |
|
MD5 | 93909ddd4ec6aad30d0afa55507b454f |
|
BLAKE2b-256 | 414a5c79e3be0e938f38c5280e6a255eea742264239ad72aa6772f08d43e2ebc |