Skip to main content

Reusable library to build business applications fast

Project description

Viewflow

The low-code for developers with yesterday's deadline

build coverage pypi-version py-versions

Viewflow is a low-code, reusable component library for creating comprehensive business applications with ease. Built on top of Django, Viewflow simplifies development by providing pre-built components for user management, workflows, and reporting, while still offering flexibility to customize and integrate with existing systems.

With Viewflow, you can create full-featured business applications in just a few lines of code using its reusable component library. It's shipped as a single package with batteries included, and each part of Viewflow can be used independently of the others, but they all work well together.

GPT assisted with Viewflow documentation: Viewflow Pair Programming Buddy

Viewflow comes in two flavors:

  • Viewflow Core: A lightweight, open-source library with only non-opinionated core classes that allows you to build your custom solution on top.
  • Viewflow PRO: A comprehensive package that includes reference functionality implementation and integrated with third-party Django packages. This package has a commercial-friendly license that allows private forks and modifications of Viewflow.
drawing

Features

  • Modern, responsive user interface with an SPA-style look and feel
  • Reusable workflow library for quick implementation of BPMN workflows
  • Built-in customizable CRUD for managing complex forms and data
  • Integrated reporting dashboard
  • Small and concise API

Installation

Viewflow works with Python 3.8 or greater and Django 4.0+

Viewflow:

pip install django-viewflow

Viewflow-PRO:

pip install django-viewflow-pro  --extra-index-url https://pypi.viewflow.io/<licence_id>/simple/

Add 'viewflow' and, in case you need workflow capabilities 'viewflow.workflow' to the INSTALLED_APPS settings.py

    INSTALLED_APPS = [
        ....
        'viewflow',
        'viewflow.workflow',
    ]

Quick start

Here's an example of how to create a simple pizza ordering workflow using Viewflow:

  1. Create a model to store process data

Before creating the workflow, you'll need to define a model to store the process data. Viewflow provides a Process model as the base model for your process instances. You can add your own fields to the model using jsonstore fields to avoid model inheritance and additional joins:

    from viewflow import jsonstore
    from viewflow.workflow.models import Process

    class PizzaOrder(Process):
        customer_name = jsonstore.CharField(max_length=250)
        address = jsonstore.TextField()
        toppings = jsonstore.TextField()
        tips_received = jsonstore.IntegerField(default=0)
        baking_time = jsonstore.IntegerField(default=10)

        class Meta:
            proxy = True
  1. Create a new flow definition file flows.py

Next, create a new flow definition file flows.py and define your workflow. In this example, we'll create a PizzaFlow class that inherits from flow.Flow. We'll define three steps in the workflow: start, bake, and deliver. We'll use CreateProcessView and UpdateProcessView to create and update the process data from PizzaOrder:

    from viewflow import this
    from viewflow.workflow import flow
    from viewflow.workflow.flow.views import CreateProcessView, UpdateProcessView
    from .models import PizzaOrder

    class PizzaFlow(flow.Flow):
        process_class = PizzaOrder

        start = flow.Start(
            CreateProcessView.as_view(
                fields=["customer_name", "address", "toppings"]
            )
        ).Next(this.bake)

        bake = flow.View(
            UpdateProcessView.as_view(fields=["baking_time"])
        ).Next(this.deliver)

        deliver = flow.View(
            UpdateProcessView.as_view(fields=["tips_received"])
        ).Next(this.end)

        end = flow.End()
  1. Add the flow to your URL configuration:

Finally, add the PizzaFlow to your URL configuration. You can use the Site and FlowAppViewset classes to register your workflow with the pre-built frontend.

    from django.urls import path
    from viewflow.contrib.auth import AuthViewset
    from viewflow.urls import Application, Site
    from viewflow.workflow.flow import FlowAppViewset
    from my_pizza.flows import PizzaFlow

    site = Site(
        title="Pizza Flow Demo",
        viewsets=[
            FlowAppViewset(PizzaFlow, icon="local_pizza"),
        ]
    )

    urlpatterns = [
        path("accounts/", AuthViewset().urls),
        path("", site.urls),
    ]
  1. Make and run migrations and access the workflow through the pre-built frontend.

Make and run migrations to create the necessary database tables, then start your Django server and access the workflow through the pre-built frontend. You should be able to create and track pizza orders with the workflow.

Go to the https://docs.viewflow.io/workflow/writing.html for the next steps

Documentation

Viewflow's documentation for the latest version is available at http://docs.viewflow.io/

Documentarian for Viewflow 1.xx series available at http://v1-docs.viewflow.io

Demo

http://demo.viewflow.io/

Cookbook

For sample applications and code snippets, check out the Viewflow PRO cookbook at

https://github.com/viewflow/cookbook

License

Viewflow is an Open Source project licensed under the terms of the AGPL license - The GNU Affero General Public License v3.0 with the Additional Permissions described in LICENSE_EXCEPTION

The AGPL license with Additional Permissions is a free software license that allows commercial use and distribution of the software. It is similar to the GNU GCC Runtime Library license, and it includes additional permissions that make it more friendly for commercial development.

You can read more about AGPL and its compatibility with commercial use at the AGPL FAQ

If you use Linux already, this package license likely won't bring anything new to your stack.

Viewflow PRO has a commercial-friendly license allowing private forks and modifications of Viewflow. You can find the commercial license terms in COMM-LICENSE.

Changelog

2.2.5 2024-07-17

  • The 'pattern' widget attribute is now passed to the underlying form input.
  • Fixed issue with flow image reload.
  • Fixed dashboard max height on pages with long sidebars.
  • Added .get_success_url(request) shortcut method to StartViewActivation and ViewActivation for convenient use in function-based views.
  • Fixed duplicated task_finished signal on flow.View completion.
  • Enabled callable defaults on jsonstore fields.
  • Improved SVG and BPMN export shapes for SplitFirst and Timer Tasks.
  • Created cookbook demo for common workflow patterns

2.2.4 2024-07-12

  • Clone data, seed, and artifacts from canceled tasks to revived tasks.
  • Enhance error handling for celery.Job.
  • Improve the process cancellation template.
  • Redirect to the task detail page after canceling or undoing actions, instead of redirecting to the process detail page.
  • Added links to parent subprocess and parent task on the subprocess process and task details pages.
  • Updated the Process.parent_task field to use related_name='subprocess', allowing access to subprocesses via task.subprocess
  • Enhanced CreateProcessView and UpdateProcessView to set process_seed and artifact_generic_foreign_key fields based on form.cleaned_data, as Django model forms do not handle this automatically.
  • Added tasks with an ERROR status to the process dashboard for better visibility and tracking.
  • Added tooltip hover titles to nodes without text labels in the SVG workflow graph.
  • Marked StartHandler nodes as BPMN Start Message events on the SVG graph.
  • Fixed rendering of hidden field errors in forms.

2.2.3 2024-07-09

  • Fixed issue with Split/Join operations when an immediate split to join connection occurs.
  • Improved redirect functionality for "Execute and Continue." Now redirects to the process details if the process has finished.
  • Enabled the Undo action for End() nodes.

2.2.2 2024-07-05

  • Introduced new parameters for .If().Then(.., task_data=, task_seed) and .Else(...)
  • Include {{ form.media }} into default workflow/task.html template

2.2.1 2024-07-03

  • Introduced a new parameter for .Next(..., task_seed=) that allows the instantiation of new tasks with additional initialized .seed generic foreign key
  • Introduced a new parameter for .Split(..., task_seed_source=) same as task_data_source, prodices outgoing tasks with initializaed .seed value
  • Introduced a new parameter for flow.Subprocess(process_data=, process_seed=, task_data=, task_seed=) allows to provide data nad seed for newly created process and/or start task

2.2.0 2024-06-28

  • Introduced a new parameter for .Next(..., task_data=) that allows the instantiation of new tasks with additional initialized .data, enabling data to be passed from task to task.
  • Added process.seed and task.seed generic foreign keys to the default workflow models. Along with process.artifact and task.artifact, these additions enable tracking of business process results from start to finish.
  • Renamed Split.Next(data_source=) to task_data_source=.

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

django_viewflow-2.2.7.tar.gz (15.4 MB view details)

Uploaded Source

Built Distribution

django_viewflow-2.2.7-py3-none-any.whl (15.6 MB view details)

Uploaded Python 3

File details

Details for the file django_viewflow-2.2.7.tar.gz.

File metadata

  • Download URL: django_viewflow-2.2.7.tar.gz
  • Upload date:
  • Size: 15.4 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.10.14

File hashes

Hashes for django_viewflow-2.2.7.tar.gz
Algorithm Hash digest
SHA256 c81a91d55e235c9bd75dc26bbc26dcfdda5f21eb97a381537040d9b7b07221cc
MD5 d636f932dcaae23c6c3f545f715c5941
BLAKE2b-256 b4c17fb11bc42bdde4d42bff0a091335e90cd30117ab0ec39529eebd92a45c8a

See more details on using hashes here.

File details

Details for the file django_viewflow-2.2.7-py3-none-any.whl.

File metadata

File hashes

Hashes for django_viewflow-2.2.7-py3-none-any.whl
Algorithm Hash digest
SHA256 38c8493dc25efc49df2003777b951980b773b8bb8e31926dd591e9fe0e8acb91
MD5 7d04bdbda147c7141755c60faa6cd335
BLAKE2b-256 4aa1d282f194f0dc8978c602b4c46946b927b05d5e40f46dcd71172420b0de7f

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