Camunda client for Django
=========================
:Version: 0.13.0
:Source: https://github.com/maykinmedia/django-camunda
:Keywords: camunda, process engine, bpmn
|build-status| |linting| |coverage|
|python-versions| |django-versions| |pypi-version|
Interact with Camunda BPMN processes from Django projects.
.. contents::
.. section-numbering::
Tested against Camunda 7.16
Features
========
* Configure Camunda connection parameters from the admin
* Shared Celery tasks
* Domain models as Python objects
* Complex/custom process variable support
* DMN evaluation and introspection
Installation
============
Requirements
------------
* Python 3.7 or above
* setuptools 30.3.0 or above
* Django 3.2 or above
* Celery [optional]
Install
-------
.. code-block:: bash
pip install django-camunda
or with Celery support:
.. code-block:: bash
pip install django-camunda[celery]
Next, ensure the following apps are installed:
.. code-block:: python
INSTALLED_APPS = [
...,
"solo",
"django_camunda",
...
]
and run migrations:
.. code-block:: bash
python manage.py migrate
Usage
=====
Configuration
-------------
1. In the admin, navigate to **django-camunda** > **Camunda configuration**
2. Fill out the API connection parameters for your Camunda instance
Using the API client
--------------------
**Built-in API functions**
The module ``django_camunda.api`` contains a number of pre-defined API endpoint
bindings. If what you're looking for does not exist (yet), you can use the low-level
API client (see below).
**Core usage**
The Camunda client class is a wrapper around the
`requests <https://pypi.org/project/requests/>`_ library and as such aims to provide
the same Python interface.
.. code-block:: python
from django_camunda.client import get_client
with get_client() as client:
task = client.get("task/5c793356-24f5-4f82-a5ce-a3cce43b762b")
... # do something with the task details
.. |build-status| image:: https://github.com/maykinmedia/django-camunda/workflows/Run%20CI/badge.svg
:target: https://github.com/maykinmedia/django-camunda/actions?query=workflow%3A%22Run+CI%22
:alt: Run CI
.. |linting| image:: https://github.com/maykinmedia/django-camunda/workflows/Code%20quality%20checks/badge.svg
:target: https://github.com/maykinmedia/django-camunda/actions?query=workflow%3A%22Code+quality+checks%22
:alt: Code linting
.. |coverage| image:: https://codecov.io/gh/maykinmedia/django-camunda/branch/master/graph/badge.svg
:target: https://codecov.io/gh/maykinmedia/django-camunda
:alt: Coverage status
.. |python-versions| image:: https://img.shields.io/pypi/pyversions/django-camunda.svg
.. |django-versions| image:: https://img.shields.io/pypi/djversions/django-camunda.svg
.. |pypi-version| image:: https://img.shields.io/pypi/v/django-camunda.svg
:target: https://pypi.org/project/django-camunda/
Raw data
{
"_id": null,
"home_page": "https://github.com/maykinmedia/django-camunda",
"name": "django-camunda",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "camunda,process engine,bpmn,common ground",
"author": "Maykin Media",
"author_email": "support@maykinmedia.nl",
"download_url": "https://files.pythonhosted.org/packages/fb/45/45b6cabf0dd2fc821290d8a6b1b6886cd6f5e5e88760b995e1aa45823c2d/django-camunda-0.13.0.tar.gz",
"platform": null,
"description": "Camunda client for Django\n=========================\n\n:Version: 0.13.0\n:Source: https://github.com/maykinmedia/django-camunda\n:Keywords: camunda, process engine, bpmn\n\n|build-status| |linting| |coverage|\n\n|python-versions| |django-versions| |pypi-version|\n\nInteract with Camunda BPMN processes from Django projects.\n\n.. contents::\n\n.. section-numbering::\n\nTested against Camunda 7.16\n\nFeatures\n========\n\n* Configure Camunda connection parameters from the admin\n* Shared Celery tasks\n* Domain models as Python objects\n* Complex/custom process variable support\n* DMN evaluation and introspection\n\nInstallation\n============\n\nRequirements\n------------\n\n* Python 3.7 or above\n* setuptools 30.3.0 or above\n* Django 3.2 or above\n* Celery [optional]\n\n\nInstall\n-------\n\n.. code-block:: bash\n\n pip install django-camunda\n\nor with Celery support:\n\n.. code-block:: bash\n\n pip install django-camunda[celery]\n\nNext, ensure the following apps are installed:\n\n.. code-block:: python\n\n INSTALLED_APPS = [\n ...,\n \"solo\",\n \"django_camunda\",\n ...\n ]\n\nand run migrations:\n\n.. code-block:: bash\n\n python manage.py migrate\n\nUsage\n=====\n\nConfiguration\n-------------\n\n1. In the admin, navigate to **django-camunda** > **Camunda configuration**\n2. Fill out the API connection parameters for your Camunda instance\n\n\nUsing the API client\n--------------------\n\n**Built-in API functions**\n\nThe module ``django_camunda.api`` contains a number of pre-defined API endpoint\nbindings. If what you're looking for does not exist (yet), you can use the low-level\nAPI client (see below).\n\n**Core usage**\n\nThe Camunda client class is a wrapper around the\n`requests <https://pypi.org/project/requests/>`_ library and as such aims to provide\nthe same Python interface.\n\n.. code-block:: python\n\n from django_camunda.client import get_client\n\n with get_client() as client:\n task = client.get(\"task/5c793356-24f5-4f82-a5ce-a3cce43b762b\")\n\n ... # do something with the task details\n\n\n.. |build-status| image:: https://github.com/maykinmedia/django-camunda/workflows/Run%20CI/badge.svg\n :target: https://github.com/maykinmedia/django-camunda/actions?query=workflow%3A%22Run+CI%22\n :alt: Run CI\n\n.. |linting| image:: https://github.com/maykinmedia/django-camunda/workflows/Code%20quality%20checks/badge.svg\n :target: https://github.com/maykinmedia/django-camunda/actions?query=workflow%3A%22Code+quality+checks%22\n :alt: Code linting\n\n.. |coverage| image:: https://codecov.io/gh/maykinmedia/django-camunda/branch/master/graph/badge.svg\n :target: https://codecov.io/gh/maykinmedia/django-camunda\n :alt: Coverage status\n\n.. |python-versions| image:: https://img.shields.io/pypi/pyversions/django-camunda.svg\n\n.. |django-versions| image:: https://img.shields.io/pypi/djversions/django-camunda.svg\n\n.. |pypi-version| image:: https://img.shields.io/pypi/v/django-camunda.svg\n :target: https://pypi.org/project/django-camunda/\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Interact with Camunda from Django",
"version": "0.13.0",
"split_keywords": [
"camunda",
"process engine",
"bpmn",
"common ground"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "4ac33a45851511cf6665051f7799893e4810d98ebd6e2c742573ce9f2c3e994f",
"md5": "6140cd2a2b02b6a05f1815419380eed7",
"sha256": "4cba04bb7c86c7d51ae4141075e49c491f0579df69a9ac7a56fc68e57e2613cc"
},
"downloads": -1,
"filename": "django_camunda-0.13.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6140cd2a2b02b6a05f1815419380eed7",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 24418,
"upload_time": "2023-02-02T09:44:08",
"upload_time_iso_8601": "2023-02-02T09:44:08.628206Z",
"url": "https://files.pythonhosted.org/packages/4a/c3/3a45851511cf6665051f7799893e4810d98ebd6e2c742573ce9f2c3e994f/django_camunda-0.13.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "fb4545b6cabf0dd2fc821290d8a6b1b6886cd6f5e5e88760b995e1aa45823c2d",
"md5": "9c46cf524f1cffb2801e63e8690aed64",
"sha256": "79ab07d37b5ad22c26f0986c238f189450a6ee80df4fde433aa00c142dab4666"
},
"downloads": -1,
"filename": "django-camunda-0.13.0.tar.gz",
"has_sig": false,
"md5_digest": "9c46cf524f1cffb2801e63e8690aed64",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 18456,
"upload_time": "2023-02-02T09:44:09",
"upload_time_iso_8601": "2023-02-02T09:44:09.941446Z",
"url": "https://files.pythonhosted.org/packages/fb/45/45b6cabf0dd2fc821290d8a6b1b6886cd6f5e5e88760b995e1aa45823c2d/django-camunda-0.13.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-02-02 09:44:09",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "maykinmedia",
"github_project": "django-camunda",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "django-camunda"
}