django-viewflow 2.2.8__tar.gz → 2.2.11__tar.gz

{django-viewflow-2.2.8/django_viewflow.egg-info → django-viewflow-2.2.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: django-viewflow
-Version: 2.2.8
+Version: 2.2.11
 Summary: Reusable library to build business applications fast
 Author: Mikhail Podgurskiy
 Author-email: kmmbvnr@gmail.com
@@ -13,17 +13,17 @@ Classifier: Operating System :: OS Independent
 Classifier: Framework :: Django
 Classifier: Framework :: Django :: 4.2
 Classifier: Framework :: Django :: 5.0
+Classifier: Framework :: Django :: 5.1
+Classifier: Framework :: Django :: 5.2
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
 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: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
-Requires-Python: >=3.8
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 
@@ -216,115 +216,10 @@ modifications of Viewflow. You can find the commercial license terms in
 
 ## Changelog
 
-### 2.2.8 2024-10-04
-
-- Prevent exceptions from being raised by Process/Task models when a flow class
-  is deleted but still referenced in the database.
-- Fix serialization issue with jsonstore.DecimalField.
-- Add missing 'index' view for celery.Task node.
-- Enable recovery of flow.Subprocess and flow.NSubprocess nodes from error state.
-- Correct invalid typing for FSM conditions.
-- Allow setting permission=None in the FSM @transition decorator to explicitly bypass permission checks.
-- Add support for MultiValueField and django-money fields form rendering
-
-
-### 2.2.7 2024-08-16
-
-- Added compatibility fix for Python 3.8.
-- Extend documentation with data management explanation - https://docs.viewflow.io/workflow/data_flow.html
-- Expanded documentation to cover permission management - https://docs.viewflow.io/workflow/permissions.html
-- Introduced an experimental JSONEditorWidget.
-- Fixed issue with saving the state of revived tasks.
-- Enabled the option to cancel If tasks.
-- Updated default FSM state change in FlowViewsMixin to now use transaction.atomic.
-- Added support for using DependentModelSelect in formsets.
-- Enabled AjaxModelSelect to function as a dependency for DependentModelSelect
-- Corrected typo in the deletion success message.
-- Test under django 5.1
-
-### 2.2.6 2024-08-04
-
-- Resolved the flow.If condition's this reference during class construction.
-- Improved error handling when a Celery task finishes.
-- Fixed an issue where errors occurring in a task after a successful celery.Job
-  task incorrectly prevented the job task from being marked as completed, with
-  the errored task correctly put into an error state.
-- Redirect to the next process task now will take into account tasks in the ERROR state
-- Add ability to revive flow.Function and flow.SplitFirst
-- Fixed an error that occurred when a deleted process.artifact was referenced in
-  the process field data listing within templates.
-- Allow to cancel Subprocess tasks
-- Allow to cancel Function tasks
-- Allow custom task models inherited from AbstactTask have no .seed and .data fields
-
-### 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=.
+## 2.3.11 2025-05-14
+
+- Return .Avaialble(..) for the start node
+
 
 
 [build]: https://img.shields.io/github/actions/workflow/status/viewflow/viewflow/django.yml?branch=main

{django-viewflow-2.2.8 → django-viewflow-2.2.11}/README.md

@@ -187,115 +187,10 @@ modifications of Viewflow. You can find the commercial license terms in
 
 ## Changelog
 
-### 2.2.8 2024-10-04
-
-- Prevent exceptions from being raised by Process/Task models when a flow class
-  is deleted but still referenced in the database.
-- Fix serialization issue with jsonstore.DecimalField.
-- Add missing 'index' view for celery.Task node.
-- Enable recovery of flow.Subprocess and flow.NSubprocess nodes from error state.
-- Correct invalid typing for FSM conditions.
-- Allow setting permission=None in the FSM @transition decorator to explicitly bypass permission checks.
-- Add support for MultiValueField and django-money fields form rendering
-
-
-### 2.2.7 2024-08-16
-
-- Added compatibility fix for Python 3.8.
-- Extend documentation with data management explanation - https://docs.viewflow.io/workflow/data_flow.html
-- Expanded documentation to cover permission management - https://docs.viewflow.io/workflow/permissions.html
-- Introduced an experimental JSONEditorWidget.
-- Fixed issue with saving the state of revived tasks.
-- Enabled the option to cancel If tasks.
-- Updated default FSM state change in FlowViewsMixin to now use transaction.atomic.
-- Added support for using DependentModelSelect in formsets.
-- Enabled AjaxModelSelect to function as a dependency for DependentModelSelect
-- Corrected typo in the deletion success message.
-- Test under django 5.1
-
-### 2.2.6 2024-08-04
-
-- Resolved the flow.If condition's this reference during class construction.
-- Improved error handling when a Celery task finishes.
-- Fixed an issue where errors occurring in a task after a successful celery.Job
-  task incorrectly prevented the job task from being marked as completed, with
-  the errored task correctly put into an error state.
-- Redirect to the next process task now will take into account tasks in the ERROR state
-- Add ability to revive flow.Function and flow.SplitFirst
-- Fixed an error that occurred when a deleted process.artifact was referenced in
-  the process field data listing within templates.
-- Allow to cancel Subprocess tasks
-- Allow to cancel Function tasks
-- Allow custom task models inherited from AbstactTask have no .seed and .data fields
-
-### 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=.
+## 2.3.11 2025-05-14
+
+- Return .Avaialble(..) for the start node
+
 
 
 [build]: https://img.shields.io/github/actions/workflow/status/viewflow/viewflow/django.yml?branch=main

{django-viewflow-2.2.8 → django-viewflow-2.2.11/django_viewflow.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: django-viewflow
-Version: 2.2.8
+Version: 2.2.11
 Summary: Reusable library to build business applications fast
 Author: Mikhail Podgurskiy
 Author-email: kmmbvnr@gmail.com
@@ -13,17 +13,17 @@ Classifier: Operating System :: OS Independent
 Classifier: Framework :: Django
 Classifier: Framework :: Django :: 4.2
 Classifier: Framework :: Django :: 5.0
+Classifier: Framework :: Django :: 5.1
+Classifier: Framework :: Django :: 5.2
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
 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: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
-Requires-Python: >=3.8
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 
@@ -216,115 +216,10 @@ modifications of Viewflow. You can find the commercial license terms in
 
 ## Changelog
 
-### 2.2.8 2024-10-04
-
-- Prevent exceptions from being raised by Process/Task models when a flow class
-  is deleted but still referenced in the database.
-- Fix serialization issue with jsonstore.DecimalField.
-- Add missing 'index' view for celery.Task node.
-- Enable recovery of flow.Subprocess and flow.NSubprocess nodes from error state.
-- Correct invalid typing for FSM conditions.
-- Allow setting permission=None in the FSM @transition decorator to explicitly bypass permission checks.
-- Add support for MultiValueField and django-money fields form rendering
-
-
-### 2.2.7 2024-08-16
-
-- Added compatibility fix for Python 3.8.
-- Extend documentation with data management explanation - https://docs.viewflow.io/workflow/data_flow.html
-- Expanded documentation to cover permission management - https://docs.viewflow.io/workflow/permissions.html
-- Introduced an experimental JSONEditorWidget.
-- Fixed issue with saving the state of revived tasks.
-- Enabled the option to cancel If tasks.
-- Updated default FSM state change in FlowViewsMixin to now use transaction.atomic.
-- Added support for using DependentModelSelect in formsets.
-- Enabled AjaxModelSelect to function as a dependency for DependentModelSelect
-- Corrected typo in the deletion success message.
-- Test under django 5.1
-
-### 2.2.6 2024-08-04
-
-- Resolved the flow.If condition's this reference during class construction.
-- Improved error handling when a Celery task finishes.
-- Fixed an issue where errors occurring in a task after a successful celery.Job
-  task incorrectly prevented the job task from being marked as completed, with
-  the errored task correctly put into an error state.
-- Redirect to the next process task now will take into account tasks in the ERROR state
-- Add ability to revive flow.Function and flow.SplitFirst
-- Fixed an error that occurred when a deleted process.artifact was referenced in
-  the process field data listing within templates.
-- Allow to cancel Subprocess tasks
-- Allow to cancel Function tasks
-- Allow custom task models inherited from AbstactTask have no .seed and .data fields
-
-### 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=.
+## 2.3.11 2025-05-14
+
+- Return .Avaialble(..) for the start node
+
 
 
 [build]: https://img.shields.io/github/actions/workflow/status/viewflow/viewflow/django.yml?branch=main

{django-viewflow-2.2.8 → django-viewflow-2.2.11}/setup.py

@@ -4,7 +4,7 @@ README = open("README.md", "r", encoding="utf-8").read()
 
 setuptools.setup(
     name="django-viewflow",
-    version="2.2.8",
+    version="2.2.11",
     author_email="kmmbvnr@gmail.com",
     author="Mikhail Podgurskiy",
     description="Reusable library to build business applications fast",
@@ -16,7 +16,7 @@ setuptools.setup(
     long_description_content_type="text/markdown",
     long_description=README,
     packages=setuptools.find_packages(exclude=["tests*"]),
-    python_requires=">=3.8",
+    python_requires=">=3.10",
     zip_safe=False,
     classifiers=[
         "Development Status :: 5 - Production/Stable",
@@ -26,10 +26,10 @@ setuptools.setup(
         "Framework :: Django",
         "Framework :: Django :: 4.2",
         "Framework :: Django :: 5.0",
+        "Framework :: Django :: 5.1",
+        "Framework :: Django :: 5.2",
         "Programming Language :: Python :: 3",
         "Programming Language :: Python :: 3 :: Only",
-        "Programming Language :: Python :: 3.8",
-        "Programming Language :: Python :: 3.9",
         "Programming Language :: Python :: 3.10",
         "Programming Language :: Python :: 3.11",
         "Programming Language :: Python :: 3.12",

{django-viewflow-2.2.8 → django-viewflow-2.2.11}/viewflow/fsm/base.py

@@ -36,7 +36,7 @@ class Transition:
         self,
         func: TransitionFunction,
         source: StateValue,
-        target: Optional[StateValue],
+        target: Optional[StateValue] = DEFAULT,
         label: Optional[str] = None,
         conditions: Optional[List[Condition]] = None,
         permission: Optional[Permission] = DEFAULT,
@@ -56,6 +56,9 @@ class Transition:
     def __str__(self) -> str:
         return f"{self.label} Transition"
 
+    def __lt__(self, other) -> bool:
+        return self.label < other.label
+
     @property
     def label(self) -> str:
         """Return the human-readable label for the transition."""
@@ -161,7 +164,7 @@ class TransitionBoundMethod:
                 )
 
             self.target_state = transition.target
-            if self.target_state:
+            if self.target_state is not DEFAULT:
                 self.parent._state.set(self.parent._instance, self.target_state)
 
         def __exit__(
@@ -409,7 +412,7 @@ class State:
     def transition(
         self,
         source: StateValue,
-        target: Optional[StateValue] = None,
+        target: Optional[StateValue] = DEFAULT,
         label: Optional[str] = None,
         conditions: Optional[List[Condition]] = None,
         permission: Optional[Permission] = DEFAULT,

{django-viewflow-2.2.8 → django-viewflow-2.2.11}/viewflow/fsm/chart.py

@@ -5,19 +5,19 @@
 # 'COMM_LICENSE', which is part of this source code package.
 
 from enum import Enum
-from typing import List, Set, Tuple
+from typing import List, Set, Tuple, Union
 from django.db.models import Choices
 from .base import State, StateDescriptor, Transition
 from .typing import StateValue
 
 
-def get_state_name(state_value):
+def get_state_name(state_value: StateValue) -> str:
     if isinstance(state_value, Enum):
         return str(state_value.value)
     return str(state_value)
 
 
-def get_state_label(state_value):
+def get_state_label(state_value: StateValue) -> str:
     if isinstance(state_value, Choices):
         return state_value.label
     elif isinstance(state_value, Enum):