SpiffWorkflow


NameSpiffWorkflow JSON
Version 3.0.0 PyPI version JSON
download
home_pageNone
SummaryA workflow framework and BPMN/DMN Processor
upload_time2024-05-01 16:39:51
maintainerNone
docs_urlNone
authorNone
requires_python>=3.8
licenselGPLv3
keywords spiff workflow bpmn engine
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI
coveralls test coverage No coveralls.
            ## SpiffWorkflow
![Logo](./graphics/logo_med.png)

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](https://github.com/sartography/SpiffWorkflow/actions/workflows/tests.yaml/badge.svg)](https://github.com/sartography/SpiffWorkflow/actions/workflows/tests.yaml)
[![Documentation Status](https://readthedocs.org/projects/spiffworkflow/badge/?version=latest)](http://spiffworkflow.readthedocs.io/en/latest/?badge=latest)
[![Issues](https://img.shields.io/github/issues/sartography/spiffworkflow)](https://github.com/sartography/SpiffWorkflow/issues)
[![Pull Requests](https://img.shields.io/github/issues-pr/sartography/spiffworkflow)](https://github.com/sartography/SpiffWorkflow/pulls)

## Code style

[![PEP8](https://img.shields.io/badge/code%20style-pep8-orange.svg)](https://www.python.org/dev/peps/pep-0008/)


## Dependencies
We've worked to minimize external dependencies.  We rely on lxml for parsing
XML Documents, and that's it!
<b>Built with</b>
- [lxml](https://lxml.de/)

## 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](https://github.com/sartography/SpiffWorkflow/releases/tag/1.0) for
version 1.0._

## Code Examples and Documentation
Detailed documentation is available on [ReadTheDocs](https://spiffworkflow.readthedocs.io/en/latest/)
Also, checkout our [example application](https://github.com/sartography/spiff-example-cli), 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](https://sartography.com)

## 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](https://www.linkedin.com/in/ron-hutchins-b19603123/),
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

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "SpiffWorkflow",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": null,
    "keywords": "spiff, workflow, bpmn, engine",
    "author": null,
    "author_email": "Sartography <dan@sartography.com>",
    "download_url": "https://files.pythonhosted.org/packages/f8/0e/484d3b802a6d9f3ef110eb31359cd67e39d67e9a7f6ffadabba1f8a60c2d/spiffworkflow-3.0.0.tar.gz",
    "platform": null,
    "description": "## SpiffWorkflow\n![Logo](./graphics/logo_med.png)\n\nSpiff Workflow is a workflow engine implemented in pure Python. It is based on\nthe excellent work of the Workflow Patterns initiative. In 2020 and 2021,\nextensive support was added for BPMN / DMN processing.\n\n## Motivation\nWe created SpiffWorkflow to support the development of low-code business\napplications in Python.  Using BPMN will allow non-developers to describe\ncomplex workflow processes in a visual diagram, coupled with a powerful python\nscript engine that works seamlessly within the diagrams.  SpiffWorkflow can parse\nthese diagrams and execute them.  The ability for businesses to create\nclear, coherent diagrams that drive an application has far reaching potential.\nWhile multiple tools exist for doing this in Java, we believe that wide\nadoption of the Python Language, and it's ease of use, create a winning\nstrategy for building Low-Code applications.\n\n\n## Build status\n[![SpiffWorkflow](https://github.com/sartography/SpiffWorkflow/actions/workflows/tests.yaml/badge.svg)](https://github.com/sartography/SpiffWorkflow/actions/workflows/tests.yaml)\n[![Documentation Status](https://readthedocs.org/projects/spiffworkflow/badge/?version=latest)](http://spiffworkflow.readthedocs.io/en/latest/?badge=latest)\n[![Issues](https://img.shields.io/github/issues/sartography/spiffworkflow)](https://github.com/sartography/SpiffWorkflow/issues)\n[![Pull Requests](https://img.shields.io/github/issues-pr/sartography/spiffworkflow)](https://github.com/sartography/SpiffWorkflow/pulls)\n\n## Code style\n\n[![PEP8](https://img.shields.io/badge/code%20style-pep8-orange.svg)](https://www.python.org/dev/peps/pep-0008/)\n\n\n## Dependencies\nWe've worked to minimize external dependencies.  We rely on lxml for parsing\nXML Documents, and that's it!\n<b>Built with</b>\n- [lxml](https://lxml.de/)\n\n## Features\n* __BPMN__ - support for parsing BPMN diagrams, including the more complex\ncomponents, like pools and lanes, multi-instance tasks, sub-workflows, timer\nevents, signals, messages, boudary events and looping.\n* __DMN__ - We have a baseline implementation of DMN that is well integrated\nwith our Python Execution Engine.\n* __Python Workflows__ - We've retained support for building workflows directly\nin code, or running workflows based on a internal json data structure.\n\n_A complete list of the latest features is available with our [release notes](https://github.com/sartography/SpiffWorkflow/releases/tag/1.0) for\nversion 1.0._\n\n## Code Examples and Documentation\nDetailed documentation is available on [ReadTheDocs](https://spiffworkflow.readthedocs.io/en/latest/)\nAlso, checkout our [example application](https://github.com/sartography/spiff-example-cli), which we\nreference extensively from the Documentation.\n\n## Installation\n```\npip install spiffworkflow\n```\n\n## Tests\n```\npip install spiffworkflow[dev]\ncd tests/SpiffWorkflow\ncoverage run --source=SpiffWorkflow -m unittest discover -v . \"*Test.py\"\n```\n\n## Support\nYou can find us on Discord at https://discord.gg/BYHcc7PpUC\n\nCommercial support for SpiffWorkflow is available from\n[Sartography](https://sartography.com)\n\n## Contribute\nPull Requests are and always will be welcome!\n\nPlease check your formatting, assure that all tests are passing, and include\nany additional tests that can demonstrate the new code you created is working\nas expected.  If applicable, please reference the issue number in your pull\nrequest.\n\n## Credits and Thanks\n\nSamuel Abels (@knipknap) for creating SpiffWorkflow and maintaining it for over\na decade.\n\nMatthew Hampton (@matthewhampton) for his initial contributions around BPMN\nparsing and execution.\n\nThe University of Virginia for allowing us to take on the mammoth task of\nbuilding a general-purpose workflow system for BPMN, and allowing us to\ncontribute that back to the open source community. In particular, we would like\nto thank [Ron Hutchins](https://www.linkedin.com/in/ron-hutchins-b19603123/),\nfor his trust and support.  Without him our efforts would not be possible.\n\nBruce Silver, the author of BPMN Quick and Easy Using Method and Style, whose\nwork we referenced extensively as we made implementation decisions and\neducated ourselves on the BPMN and DMN standards.\n\nThe BPMN.js library, without which we would not have the tools to effectively\nbuild out our models, embed an editor in our application, and pull this mad\nmess together.\n\nKelly McDonald (@w4kpm) who dove deeper into the core of SpiffWorkflow than\nanyone else, and was instrumental in helping us get some of these major\nenhancements working correctly.\n\nThanks also to the many contributions from our community.  Large and small.\nFrom Ziad (@ziadsawalha) in the early days to Elizabeth (@essweine) more\nrecently.  It is good to be a part of this long lived and strong\ncommunity.\n\n\n## License\nGNU LESSER GENERAL PUBLIC LICENSE\n",
    "bugtrack_url": null,
    "license": "lGPLv3",
    "summary": "A workflow framework and BPMN/DMN Processor",
    "version": "3.0.0",
    "project_urls": {
        "Documentation": "https://spiffworkflow.readthedocs.io",
        "Homepage": "https://github.com/sartography/SpiffWorkflow"
    },
    "split_keywords": [
        "spiff",
        " workflow",
        " bpmn",
        " engine"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "b40c253aeaf38bf697993d0acf954d56e7a5f71c84c4bb38343a305ef96cd6e3",
                "md5": "4d79038c263171aef670bee6ca158062",
                "sha256": "4877e85ca4095329827ff66eaa5e93a03fe63947f3298be711eeb28eaae838f6"
            },
            "downloads": -1,
            "filename": "SpiffWorkflow-3.0.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "4d79038c263171aef670bee6ca158062",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 267688,
            "upload_time": "2024-05-01T16:39:48",
            "upload_time_iso_8601": "2024-05-01T16:39:48.055689Z",
            "url": "https://files.pythonhosted.org/packages/b4/0c/253aeaf38bf697993d0acf954d56e7a5f71c84c4bb38343a305ef96cd6e3/SpiffWorkflow-3.0.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "f80e484d3b802a6d9f3ef110eb31359cd67e39d67e9a7f6ffadabba1f8a60c2d",
                "md5": "cf9b9907e60ed73f5d8e6338a25e79b5",
                "sha256": "84bc2732cc51fbedadf7de817bb78610e2b569fcb948c471aa711cd78e2e9829"
            },
            "downloads": -1,
            "filename": "spiffworkflow-3.0.0.tar.gz",
            "has_sig": false,
            "md5_digest": "cf9b9907e60ed73f5d8e6338a25e79b5",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 147366,
            "upload_time": "2024-05-01T16:39:51",
            "upload_time_iso_8601": "2024-05-01T16:39:51.062069Z",
            "url": "https://files.pythonhosted.org/packages/f8/0e/484d3b802a6d9f3ef110eb31359cd67e39d67e9a7f6ffadabba1f8a60c2d/spiffworkflow-3.0.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-05-01 16:39:51",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "sartography",
    "github_project": "SpiffWorkflow",
    "travis_ci": true,
    "coveralls": false,
    "github_actions": true,
    "lcname": "spiffworkflow"
}
        
Elapsed time: 0.24519s