Metadata-Version: 2.5
Name: jupyterlab_camunda_modeller_extension
Version: 1.0.32
Summary: Jupyterlab extension to allow modelling bpmn diagrams (and opening camunda bpmn diagrams) directly in jupyterlab
Project-URL: Homepage, https://github.com/stellarshenson/jupyterlab_camunda_modeller_extension
Project-URL: Bug Tracker, https://github.com/stellarshenson/jupyterlab_camunda_modeller_extension/issues
Project-URL: Repository, https://github.com/stellarshenson/jupyterlab_camunda_modeller_extension.git
Author-email: Stellars Henson <konrad.jelen@gmail.com>
License-Expression: BSD-3-Clause
License-File: LICENSE
Keywords: jupyter,jupyterlab,jupyterlab-extension
Classifier: Framework :: Jupyter
Classifier: Framework :: Jupyter :: JupyterLab
Classifier: Framework :: Jupyter :: JupyterLab :: 4
Classifier: Framework :: Jupyter :: JupyterLab :: Extensions
Classifier: Framework :: Jupyter :: JupyterLab :: Extensions :: Prebuilt
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.10
Requires-Dist: jupyter-server<3,>=2.21
Provides-Extra: dev
Requires-Dist: jupyter-builder<2,>=1.2; extra == 'dev'
Requires-Dist: jupyterlab<5,>=4.6; extra == 'dev'
Provides-Extra: test
Requires-Dist: coverage<8,>=7.16; extra == 'test'
Requires-Dist: pytest-asyncio<2,>=1.4; extra == 'test'
Requires-Dist: pytest-cov<8,>=7.1; extra == 'test'
Requires-Dist: pytest-jupyter[server]<1,>=0.11; extra == 'test'
Requires-Dist: pytest<10,>=9.1; extra == 'test'
Description-Content-Type: text/markdown

# jupyterlab_camunda_modeller_extension

[![GitHub Actions](https://github.com/stellarshenson/jupyterlab_camunda_modeller_extension/actions/workflows/build.yml/badge.svg)](https://github.com/stellarshenson/jupyterlab_camunda_modeller_extension/actions/workflows/build.yml)
[![npm version](https://img.shields.io/npm/v/jupyterlab_camunda_modeller_extension.svg)](https://www.npmjs.com/package/jupyterlab_camunda_modeller_extension)
[![PyPI version](https://img.shields.io/pypi/v/jupyterlab-camunda-modeller-extension.svg)](https://pypi.org/project/jupyterlab-camunda-modeller-extension/)
[![Total PyPI downloads](https://static.pepy.tech/badge/jupyterlab-camunda-modeller-extension)](https://pepy.tech/project/jupyterlab-camunda-modeller-extension)
[![JupyterLab 4](https://img.shields.io/badge/JupyterLab-4-orange.svg)](https://jupyterlab.readthedocs.io/en/stable/)
[![Brought To You By KOLOMOLO](https://img.shields.io/badge/Brought%20To%20You%20By-KOLOMOLO-00ffff?style=flat)](https://kolomolo.com)
[![Donate PayPal](https://img.shields.io/badge/Donate-PayPal-blue?style=flat)](https://www.paypal.com/donate/?hosted_button_id=B4KPBJDLLXTSA)

> [!TIP]
> This extension is part of the [stellars_jupyterlab_extensions](https://github.com/stellarshenson/stellars_jupyterlab_extensions) metapackage. Install all Stellars extensions at once: `pip install stellars_jupyterlab_extensions`

Model BPMN diagrams and open Camunda BPMN files directly in JupyterLab. This extension provides a visual editor for business process modelling within the JupyterLab environment.

![Screenshot](.resources/screenshot.png)

## Features

- **BPMN diagram modelling** - Create and edit BPMN 2.0 diagrams visually
- **Camunda BPMN support** - Open and modify Camunda-specific BPMN files
- **JupyterLab integration** - Native file browser integration for .bpmn files
- **Element colouring** - Colour picker in the element context pad
- **Export as SVG** - Download the diagram as an SVG file from the canvas context menu
- **Realign Connectors** - Widen text annotations and redraw their association lines from the canvas context menu
- **Toolbar** - Reload from disk, zoom out, zoom in and fit the diagram to the view
- **Text editor** - Open With > Editor shows the BPMN XML with syntax highlighting, closing-tag completion and folding

## Requirements

- JupyterLab >= 4.6

## Installation

```bash
pip install jupyterlab-camunda-modeller-extension
```

## Uninstall

```bash
pip uninstall jupyterlab_camunda_modeller_extension
```

## Contributing

If you would like to contribute to this extension, please refer to the [Contributing Guide](CONTRIBUTING.md).

---

_Built with the mass irony of using a visual BPMN editor to model workflows that will inevitably be replaced by an AI agent that doesn't need diagrams to understand what you meant. Until then, we'll keep drawing boxes and arrows, pretending that documenting our processes makes them more efficient - when in reality, the diagram will be outdated before the meeting to review it even starts. But hey, at least the boxes are nicely rounded and the gateway diamonds are perfectly centered._
