Skip to main content

A workflow framework and BPMN/DMN Processor

Project description

SpiffWorkflow

Logo

Spiff Workflow is a workflow engine implemented in pure Python. It is based on the excellent work of the Workflow Patterns initiative. In 2020 and 2021, extensive support was added for BPMN / DMN processing.

Motivation

We created SpiffWorkflow to support the development of low-code business applications in Python. Using BPMN will allow non-developers to describe complex workflow processes in a visual diagram, coupled with a powerful python script engine that works seamlessly within the diagrams. SpiffWorkflow can parse these diagrams and execute them. The ability for businesses to create clear, coherent diagrams that drive an application has far reaching potential. While multiple tools exist for doing this in Java, we believe that wide adoption of the Python Language, and it's ease of use, create a winning strategy for building Low-Code applications.

Build status

SpiffWorkflow Documentation Status Issues Pull Requests

Code style

PEP8

Dependencies

We've worked to minimize external dependencies. We rely on lxml for parsing XML Documents, and that's it! Built with

Features

  • BPMN - support for parsing BPMN diagrams, including the more complex components, like pools and lanes, multi-instance tasks, sub-workflows, timer events, signals, messages, boudary events and looping.
  • DMN - We have a baseline implementation of DMN that is well integrated with our Python Execution Engine.
  • Python Workflows - We've retained support for building workflows directly in code, or running workflows based on a internal json data structure.

A complete list of the latest features is available with our release notes for version 1.0.

Code Examples and Documentation

Detailed documentation is available on ReadTheDocs Also, checkout our example application, which we reference extensively from the Documentation.

Installation

pip install spiffworkflow

Tests

pip install spiffworkflow[dev]
cd tests/SpiffWorkflow
coverage run --source=SpiffWorkflow -m unittest discover -v . "*Test.py"

Support

You can find us on Discord at https://discord.gg/BYHcc7PpUC

Commercial support for SpiffWorkflow is available from Sartography

Contribute

Pull Requests are and always will be welcome!

Please check your formatting, assure that all tests are passing, and include any additional tests that can demonstrate the new code you created is working as expected. If applicable, please reference the issue number in your pull request.

Credits and Thanks

Samuel Abels (@knipknap) for creating SpiffWorkflow and maintaining it for over a decade.

Matthew Hampton (@matthewhampton) for his initial contributions around BPMN parsing and execution.

The University of Virginia for allowing us to take on the mammoth task of building a general-purpose workflow system for BPMN, and allowing us to contribute that back to the open source community. In particular, we would like to thank Ron Hutchins, for his trust and support. Without him our efforts would not be possible.

Bruce Silver, the author of BPMN Quick and Easy Using Method and Style, whose work we referenced extensively as we made implementation decisions and educated ourselves on the BPMN and DMN standards.

The BPMN.js library, without which we would not have the tools to effectively build out our models, embed an editor in our application, and pull this mad mess together.

Kelly McDonald (@w4kpm) who dove deeper into the core of SpiffWorkflow than anyone else, and was instrumental in helping us get some of these major enhancements working correctly.

Thanks also to the many contributions from our community. Large and small. From Ziad (@ziadsawalha) in the early days to Elizabeth (@essweine) more recently. It is good to be a part of this long lived and strong community.

License

GNU LESSER GENERAL PUBLIC LICENSE

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

spiffworkflow-3.0.0.tar.gz (147.4 kB view details)

Uploaded Source

Built Distribution

SpiffWorkflow-3.0.0-py3-none-any.whl (267.7 kB view details)

Uploaded Python 3

File details

Details for the file spiffworkflow-3.0.0.tar.gz.

File metadata

  • Download URL: spiffworkflow-3.0.0.tar.gz
  • Upload date:
  • Size: 147.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.12.3

File hashes

Hashes for spiffworkflow-3.0.0.tar.gz
Algorithm Hash digest
SHA256 84bc2732cc51fbedadf7de817bb78610e2b569fcb948c471aa711cd78e2e9829
MD5 cf9b9907e60ed73f5d8e6338a25e79b5
BLAKE2b-256 f80e484d3b802a6d9f3ef110eb31359cd67e39d67e9a7f6ffadabba1f8a60c2d

See more details on using hashes here.

File details

Details for the file SpiffWorkflow-3.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for SpiffWorkflow-3.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 4877e85ca4095329827ff66eaa5e93a03fe63947f3298be711eeb28eaae838f6
MD5 4d79038c263171aef670bee6ca158062
BLAKE2b-256 b40c253aeaf38bf697993d0acf954d56e7a5f71c84c4bb38343a305ef96cd6e3

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page