taskflow 5.9.1__tar.gz → 5.11.0__tar.gz

{taskflow-5.9.1 → taskflow-5.11.0}/.pre-commit-config.yaml

@@ -1,15 +1,6 @@
-# We from the Oslo project decided to pin repos based on the
-# commit hash instead of the version tag to prevend arbitrary
-# code from running in developer's machines.  To update to a
-# newer version, run `pre-commit autoupdate` and then replace
-# the newer versions with their commit hash.
-
-default_language_version:
-  python: python3
-
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: 9136088a246768144165fcc3ecc3d31bb686920a # v3.3.0
+    rev: v5.0.0
     hooks:
       - id: trailing-whitespace
       # Replaces or checks mixed line ending
@@ -27,13 +18,9 @@ repos:
       - id: debug-statements
       - id: check-yaml
         files: .*\.(yaml|yml)$
-  - repo: local
+  - repo: https://opendev.org/openstack/hacking
+    rev: 7.0.0
     hooks:
-      - id: flake8
-        name: flake8
-        additional_dependencies:
-          - hacking>=6.1.0,<6.2.0
-        language: python
-        entry: flake8
-        files: '^.*\.py$'
+      - id: hacking
+        additional_dependencies: []
         exclude: '^(doc|releasenotes|tools)/.*$'

{taskflow-5.9.1 → taskflow-5.11.0}/.zuul.yaml

@@ -5,6 +5,12 @@
     pre-run: playbooks/tests/functional/pre.yml
     vars:
       tox_envlist: functional
+    irrelevant-files:
+      - ^.*\.rst$
+      - ^doc/.*$
+      - ^LICENSE$
+      - ^releasenotes/.*$
+      - ^\.pre-commit-config\.yaml$
 
 - job:
     name: taskflow-functional-redis

{taskflow-5.9.1 → taskflow-5.11.0}/ChangeLog

@@ -1,6 +1,34 @@
 CHANGES
 =======
 
+5.11.0
+------
+
+* Skip installation to speed up pep8
+* fix typo
+* Skip functional jobs for license file update
+* pre-commit: Bump versions
+* Remove "test" extra
+* Sync test requirements
+* Remove zake from runtime dependency
+* Read pifpaf environments to detect service ports
+* Drop unused constants
+* Bump etcd in tests
+* Replace oslo\_utils.encodeutils.exception\_to\_unicode
+* Bump pylint
+* Skip functional tests for doc update
+* reno: Update master for unmaintained/2023.1
+
+5.10.0
+------
+
+* Add note about requirements lower bounds
+* Remove Python 3.8 support
+* Declare Python 3.12 support
+* Remove unused usage of pkg\_resources
+* Drop SQLALCHEMY\_WARN\_20
+* Update master for stable/2024.2
+
 5.9.1
 -----
 

taskflow-5.11.0/PKG-INFO

@@ -0,0 +1,147 @@
+Metadata-Version: 2.1
+Name: taskflow
+Version: 5.11.0
+Summary: Taskflow structured state management library.
+Home-page: https://docs.openstack.org/taskflow/latest/
+Author: OpenStack
+Author-email: openstack-discuss@lists.openstack.org
+Keywords: reliable,tasks,execution,parallel,dataflow,workflows,distributed
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: OpenStack
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Information Technology
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+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 :: Only
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: System :: Distributed Computing
+Requires-Python: >=3.9
+License-File: LICENSE
+Requires-Dist: pbr>=2.0.0
+Requires-Dist: futurist>=1.2.0
+Requires-Dist: fasteners>=0.17.3
+Requires-Dist: networkx>=2.1.0
+Requires-Dist: stevedore>=1.20.0
+Requires-Dist: jsonschema>=3.2.0
+Requires-Dist: automaton>=1.9.0
+Requires-Dist: oslo.utils>=3.33.0
+Requires-Dist: oslo.serialization>=2.18.0
+Requires-Dist: tenacity>=6.0.0
+Requires-Dist: cachetools>=2.0.0
+Requires-Dist: pydot>=1.2.4
+Provides-Extra: zookeeper
+Requires-Dist: kazoo>=2.6.0; extra == "zookeeper"
+Provides-Extra: redis
+Requires-Dist: redis>=4.0.0; extra == "redis"
+Provides-Extra: etcd
+Requires-Dist: etcd3gw>=2.0.0; extra == "etcd"
+Provides-Extra: workers
+Requires-Dist: kombu>=4.3.0; extra == "workers"
+Provides-Extra: eventlet
+Requires-Dist: eventlet>=0.18.2; extra == "eventlet"
+Provides-Extra: database
+Requires-Dist: SQLAlchemy>=1.0.10; extra == "database"
+Requires-Dist: alembic>=0.8.10; extra == "database"
+Requires-Dist: SQLAlchemy-Utils>=0.30.11; extra == "database"
+Requires-Dist: PyMySQL>=0.7.6; extra == "database"
+Requires-Dist: psycopg2>=2.8.0; extra == "database"
+Provides-Extra: test
+Requires-Dist: kazoo>=2.6.0; extra == "test"
+Requires-Dist: redis>=4.0.0; extra == "test"
+Requires-Dist: etcd3gw>=2.0.0; extra == "test"
+Requires-Dist: kombu>=4.3.0; extra == "test"
+Requires-Dist: eventlet>=0.18.2; extra == "test"
+Requires-Dist: SQLAlchemy>=1.0.10; extra == "test"
+Requires-Dist: alembic>=0.8.10; extra == "test"
+Requires-Dist: SQLAlchemy-Utils>=0.30.11; extra == "test"
+Requires-Dist: PyMySQL>=0.7.6; extra == "test"
+Requires-Dist: psycopg2>=2.8.0; extra == "test"
+Requires-Dist: zake>=0.1.6; extra == "test"
+Requires-Dist: pydotplus>=2.0.2; extra == "test"
+Requires-Dist: oslotest>=3.2.0; extra == "test"
+Requires-Dist: testtools>=2.2.0; extra == "test"
+Requires-Dist: testscenarios>=0.4; extra == "test"
+Requires-Dist: stestr>=2.0.0; extra == "test"
+Requires-Dist: pifpaf>=0.10.0; extra == "test"
+
+========================
+Team and repository tags
+========================
+
+.. image:: https://governance.openstack.org/tc/badges/taskflow.svg
+    :target: https://governance.openstack.org/tc/reference/tags/index.html
+
+.. Change things from this point on
+
+TaskFlow
+========
+
+.. image:: https://img.shields.io/pypi/v/taskflow.svg
+    :target: https://pypi.org/project/taskflow/
+    :alt: Latest Version
+
+A library to do [jobs, tasks, flows] in a highly available, easy to understand
+and declarative manner (and more!) to be used with OpenStack and other
+projects.
+
+* Free software: Apache license
+* Documentation: https://docs.openstack.org/taskflow/latest/
+* Source: https://opendev.org/openstack/taskflow
+* Bugs: https://bugs.launchpad.net/taskflow/
+* Release notes: https://docs.openstack.org/releasenotes/taskflow/
+
+Join us
+-------
+
+- https://launchpad.net/taskflow
+
+Testing and requirements
+------------------------
+
+Requirements
+~~~~~~~~~~~~
+
+Because this project has many optional (pluggable) parts like persistence
+backends and engines, we decided to split our requirements into two
+parts: - things that are absolutely required (you can't use the project
+without them) are put into ``requirements.txt``. The requirements
+that are required by some optional part of this project (you can use the
+project without them) are put into our ``test-requirements.txt`` file (so
+that we can still test the optional functionality works as expected). If
+you want to use the feature in question (`eventlet`_ or the worker based engine
+that uses `kombu`_ or the `sqlalchemy`_ persistence backend or jobboards which
+have an implementation built using `kazoo`_ ...), you should add
+that requirement(s) to your project or environment.
+
+Tox.ini
+~~~~~~~
+
+Our ``tox.ini`` file describes several test environments that allow to test
+TaskFlow with different python versions and sets of requirements installed.
+Please refer to the `tox`_ documentation to understand how to make these test
+environments work for you.
+
+Developer documentation
+-----------------------
+
+We also have sphinx documentation in ``docs/source``.
+
+*To build it, run:*
+
+::
+
+    $ python setup.py build_sphinx
+
+.. _kazoo: https://kazoo.readthedocs.io/en/latest/
+.. _sqlalchemy: https://www.sqlalchemy.org/
+.. _kombu: https://kombu.readthedocs.io/en/latest/
+.. _eventlet: http://eventlet.net/
+.. _tox: https://tox.testrun.org/
+

taskflow-5.11.0/releasenotes/notes/remove-py38-15af791146f479e1.yaml

@@ -0,0 +1,5 @@
+---
+upgrade:
+  - |
+    Support for Python 3.8 has been removed. Now the minimum python version
+    supported is 3.9 .

{taskflow-5.9.1 → taskflow-5.11.0}/releasenotes/source/2023.1.rst

@@ -3,4 +3,4 @@
 ===========================
 
 .. release-notes::
-   :branch: stable/2023.1
+   :branch: unmaintained/2023.1

taskflow-5.11.0/releasenotes/source/2024.2.rst

@@ -0,0 +1,6 @@
+===========================
+2024.2 Series Release Notes
+===========================
+
+.. release-notes::
+   :branch: stable/2024.2

{taskflow-5.9.1 → taskflow-5.11.0}/releasenotes/source/index.rst

@@ -6,6 +6,7 @@
    :maxdepth: 1
 
    unreleased
+   2024.2
    2024.1
    2023.2
    2023.1

{taskflow-5.9.1 → taskflow-5.11.0}/requirements.txt

@@ -1,3 +1,7 @@
+# Requirements lower bounds listed here are our best effort to keep them up to
+# date but we do not test them so no guarantee of having them all correct. If
+# you find any incorrect lower bounds, let us know or propose a fix.
+
 # See: https://bugs.launchpad.net/pbr/+bug/1384919 for why this is here...
 pbr>=2.0.0 # Apache-2.0
 

{taskflow-5.9.1 → taskflow-5.11.0}/setup-etcd-env.sh

@@ -1,7 +1,7 @@
 #!/bin/bash
 set -eux
 if [ -z "$(which etcd)" ]; then
-    ETCD_VERSION=3.3.27
+    ETCD_VERSION=3.4.27
     case `uname -s` in
         Darwin)
             OS=darwin

{taskflow-5.9.1 → taskflow-5.11.0}/setup.cfg

@@ -7,7 +7,7 @@ author = OpenStack
 author_email = openstack-discuss@lists.openstack.org
 home_page = https://docs.openstack.org/taskflow/latest/
 keywords = reliable,tasks,execution,parallel,dataflow,workflows,distributed
-python_requires = >=3.8
+python_requires = >=3.9
 classifier = 
 	Development Status :: 5 - Production/Stable
 	Environment :: OpenStack
@@ -17,10 +17,10 @@ classifier =
 	Operating System :: POSIX :: Linux
 	Programming Language :: Python
 	Programming Language :: Python :: 3
-	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
 	Programming Language :: Python :: 3 :: Only
 	Programming Language :: Python :: Implementation :: CPython
 	Topic :: Software Development :: Libraries
@@ -56,7 +56,6 @@ taskflow.engines =
 [extras]
 zookeeper = 
 	kazoo>=2.6.0 # Apache-2.0
-	zake>=0.1.6 # Apache-2.0
 redis = 
 	redis>=4.0.0 # MIT
 etcd = 
@@ -71,14 +70,6 @@ database =
 	SQLAlchemy-Utils>=0.30.11 # BSD License
 	PyMySQL>=0.7.6 # MIT License
 	psycopg2>=2.8.0 # LGPL/ZPL
-test = 
-	pydotplus>=2.0.2 # MIT License
-	hacking<0.11,>=0.10.0
-	oslotest>=3.2.0 # Apache-2.0
-	mock>=2.0.0 # BSD
-	testtools>=2.2.0 # MIT
-	testscenarios>=0.4 # Apache-2.0/BSD
-	stestr>=2.0.0 # Apache-2.0
 
 [egg_info]
 tag_build = 

{taskflow-5.9.1 → taskflow-5.11.0}/taskflow/tests/unit/jobs/test_etcd_job.py

@@ -26,12 +26,14 @@ from taskflow.tests.unit.jobs import base
 from taskflow.tests import utils as test_utils
 
 ETCD_AVAILABLE = test_utils.etcd_available()
+ETCD_PORT = test_utils.ETCD_PORT
 
 
 class EtcdJobBoardMixin:
     def create_board(self, conf=None, persistence=None):
         self.path = f"test-{uuidutils.generate_uuid()}"
         board_conf = {
+            "port": ETCD_PORT,
             "path": self.path,
         }
         if conf:

{taskflow-5.9.1 → taskflow-5.11.0}/taskflow/tests/unit/jobs/test_redis_job.py

@@ -32,6 +32,7 @@ from taskflow.utils import redis_utils as ru
 
 REDIS_AVAILABLE = test_utils.redis_available(
     impl_redis.RedisJobBoard.MIN_REDIS_VERSION)
+REDIS_PORT = test_utils.REDIS_PORT
 
 
 @testtools.skipIf(not REDIS_AVAILABLE, 'redis is not available')
@@ -41,7 +42,7 @@ class RedisJobboardTest(test.TestCase, base.BoardTestMixin):
 
     def create_board(self, persistence=None):
         namespace = uuidutils.generate_uuid()
-        client = ru.RedisClient()
+        client = ru.RedisClient(port=REDIS_PORT)
         config = {
             'namespace': ("taskflow-%s" % namespace).encode('latin-1'),
         }

{taskflow-5.9.1 → taskflow-5.11.0}/taskflow/tests/unit/test_failure.py

@@ -17,8 +17,6 @@
 import pickle
 import sys
 
-from oslo_utils import encodeutils
-
 from taskflow import exceptions
 from taskflow import test
 from taskflow.tests import utils as test_utils
@@ -334,8 +332,7 @@ class NonAsciiExceptionsTestCase(test.TestCase):
         bad_string = chr(200)
         excp = ValueError(bad_string)
         fail = failure.Failure.from_exception(excp)
-        self.assertEqual(encodeutils.exception_to_unicode(excp),
-                         fail.exception_str)
+        self.assertEqual(str(excp), fail.exception_str)
         expected = u'Failure: ValueError: \xc8'
         self.assertEqual(expected, str(fail))
 
@@ -350,7 +347,7 @@ class NonAsciiExceptionsTestCase(test.TestCase):
     def test_wrapped_failure_non_ascii_unicode(self):
         hi_cn = u'嗨'
         fail = ValueError(hi_cn)
-        self.assertEqual(hi_cn, encodeutils.exception_to_unicode(fail))
+        self.assertEqual(hi_cn, str(fail))
         fail = failure.Failure.from_exception(fail)
         wrapped_fail = exceptions.WrappedFailure([fail])
         expected_result = (u"WrappedFailure: "

{taskflow-5.9.1 → taskflow-5.11.0}/taskflow/tests/utils.py

@@ -15,6 +15,7 @@
 #    under the License.
 
 import contextlib
+import os
 import string
 import threading
 import time
@@ -32,12 +33,12 @@ from taskflow.types import failure
 from taskflow.utils import kazoo_utils
 from taskflow.utils import redis_utils
 
-ARGS_KEY = '__args__'
-KWARGS_KEY = '__kwargs__'
-ORDER_KEY = '__order__'
+ETCD_PORT = int(os.getenv("TASKFLOW_TEST_ETCD_PORT", 2379))
+REDIS_PORT = int(os.getenv("TASKFLOW_TEST_REDIS_SENTINEL_PORT", 6379))
+ZK_PORT = int(os.getenv("TASKFLOW_TEST_ZOOKEEPER_PORT", 2181))
 ZK_TEST_CONFIG = {
     'timeout': 1.0,
-    'hosts': ["localhost:2181"],
+    'hosts': ["localhost:%d" % ZK_PORT],
 }
 # If latches/events take longer than this to become empty/set, something is
 # usually wrong and should be debugged instead of deadlocking...
@@ -78,7 +79,7 @@ def zookeeper_available(min_version, timeout=3):
 
 
 def redis_available(min_version):
-    client = redis.Redis()
+    client = redis.Redis(port=REDIS_PORT)
     try:
         client.ping()
     except Exception:
@@ -90,7 +91,7 @@ def redis_available(min_version):
 
 
 def etcd_available():
-    client = etcd3gw.Etcd3Client()
+    client = etcd3gw.Etcd3Client(port=ETCD_PORT)
     try:
         client.get("/")
     except Exception:

{taskflow-5.9.1 → taskflow-5.11.0}/taskflow/types/failure.py

@@ -21,7 +21,6 @@ import os
 import sys
 import traceback
 
-from oslo_utils import encodeutils
 from oslo_utils import reflection
 
 from taskflow import exceptions as exc
@@ -29,9 +28,6 @@ from taskflow.utils import iter_utils
 from taskflow.utils import schema_utils as su
 
 
-_exception_message = encodeutils.exception_to_unicode
-
-
 def _copy_exc_info(exc_info):
     if exc_info is None:
         return None
@@ -57,7 +53,7 @@ def _are_equal_exc_info_tuples(ei1, ei2):
     # because we want the types to be exactly the same, not just have
     # one be inherited from the other.
     if not all((type(ei1[1]) == type(ei2[1]),  # noqa: E721
-                _exception_message(ei1[1]) == _exception_message(ei2[1]),
+                str(ei1[1]) == str(ei2[1]),
                 repr(ei1[1]) == repr(ei2[1]))):
         return False
     if ei1[2] == ei2[2]:
@@ -195,7 +191,7 @@ class Failure():
             if not self._exc_type_names:
                 raise TypeError("Invalid exception type '%s' (%s)"
                                 % (exc_info[0], type(exc_info[0])))
-            self._exception_str = _exception_message(self._exc_info[1])
+            self._exception_str = str(self._exc_info[1])
             self._traceback_str = ''.join(
                 traceback.format_tb(self._exc_info[2]))
             self._causes = kwargs.pop('causes', None)

{taskflow-5.9.1 → taskflow-5.11.0}/taskflow/utils/eventlet_utils.py

@@ -29,6 +29,6 @@ def check_for_eventlet(exc=None):
     """
     if not EVENTLET_AVAILABLE:
         if exc is None:
-            raise RuntimeError('Eventlet is not current available')
+            raise RuntimeError('Eventlet is not currently available')
         else:
             raise exc

{taskflow-5.9.1 → taskflow-5.11.0}/taskflow/version.py

@@ -14,19 +14,14 @@
 #    License for the specific language governing permissions and limitations
 #    under the License.
 
-import pkg_resources
+from pbr import version as pbr_version
 
 TASK_VENDOR = "OpenStack Foundation"
 TASK_PRODUCT = "OpenStack TaskFlow"
 TASK_PACKAGE = None  # OS distro package version suffix
 
-try:
-    from pbr import version as pbr_version
-    _version_info = pbr_version.VersionInfo('taskflow')
-    version_string = _version_info.version_string
-except ImportError:
-    _version_info = pkg_resources.get_distribution('taskflow')
-    version_string = lambda: _version_info.version
+_version_info = pbr_version.VersionInfo('taskflow')
+version_string = _version_info.version_string
 
 
 def version_string_with_package():

taskflow-5.11.0/taskflow.egg-info/PKG-INFO

@@ -0,0 +1,147 @@
+Metadata-Version: 2.1
+Name: taskflow
+Version: 5.11.0
+Summary: Taskflow structured state management library.
+Home-page: https://docs.openstack.org/taskflow/latest/
+Author: OpenStack
+Author-email: openstack-discuss@lists.openstack.org
+Keywords: reliable,tasks,execution,parallel,dataflow,workflows,distributed
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: OpenStack
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Information Technology
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+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 :: Only
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: System :: Distributed Computing
+Requires-Python: >=3.9
+License-File: LICENSE
+Requires-Dist: pbr>=2.0.0
+Requires-Dist: futurist>=1.2.0
+Requires-Dist: fasteners>=0.17.3
+Requires-Dist: networkx>=2.1.0
+Requires-Dist: stevedore>=1.20.0
+Requires-Dist: jsonschema>=3.2.0
+Requires-Dist: automaton>=1.9.0
+Requires-Dist: oslo.utils>=3.33.0
+Requires-Dist: oslo.serialization>=2.18.0
+Requires-Dist: tenacity>=6.0.0
+Requires-Dist: cachetools>=2.0.0
+Requires-Dist: pydot>=1.2.4
+Provides-Extra: zookeeper
+Requires-Dist: kazoo>=2.6.0; extra == "zookeeper"
+Provides-Extra: redis
+Requires-Dist: redis>=4.0.0; extra == "redis"
+Provides-Extra: etcd
+Requires-Dist: etcd3gw>=2.0.0; extra == "etcd"
+Provides-Extra: workers
+Requires-Dist: kombu>=4.3.0; extra == "workers"
+Provides-Extra: eventlet
+Requires-Dist: eventlet>=0.18.2; extra == "eventlet"
+Provides-Extra: database
+Requires-Dist: SQLAlchemy>=1.0.10; extra == "database"
+Requires-Dist: alembic>=0.8.10; extra == "database"
+Requires-Dist: SQLAlchemy-Utils>=0.30.11; extra == "database"
+Requires-Dist: PyMySQL>=0.7.6; extra == "database"
+Requires-Dist: psycopg2>=2.8.0; extra == "database"
+Provides-Extra: test
+Requires-Dist: kazoo>=2.6.0; extra == "test"
+Requires-Dist: redis>=4.0.0; extra == "test"
+Requires-Dist: etcd3gw>=2.0.0; extra == "test"
+Requires-Dist: kombu>=4.3.0; extra == "test"
+Requires-Dist: eventlet>=0.18.2; extra == "test"
+Requires-Dist: SQLAlchemy>=1.0.10; extra == "test"
+Requires-Dist: alembic>=0.8.10; extra == "test"
+Requires-Dist: SQLAlchemy-Utils>=0.30.11; extra == "test"
+Requires-Dist: PyMySQL>=0.7.6; extra == "test"
+Requires-Dist: psycopg2>=2.8.0; extra == "test"
+Requires-Dist: zake>=0.1.6; extra == "test"
+Requires-Dist: pydotplus>=2.0.2; extra == "test"
+Requires-Dist: oslotest>=3.2.0; extra == "test"
+Requires-Dist: testtools>=2.2.0; extra == "test"
+Requires-Dist: testscenarios>=0.4; extra == "test"
+Requires-Dist: stestr>=2.0.0; extra == "test"
+Requires-Dist: pifpaf>=0.10.0; extra == "test"
+
+========================
+Team and repository tags
+========================
+
+.. image:: https://governance.openstack.org/tc/badges/taskflow.svg
+    :target: https://governance.openstack.org/tc/reference/tags/index.html
+
+.. Change things from this point on
+
+TaskFlow
+========
+
+.. image:: https://img.shields.io/pypi/v/taskflow.svg
+    :target: https://pypi.org/project/taskflow/
+    :alt: Latest Version
+
+A library to do [jobs, tasks, flows] in a highly available, easy to understand
+and declarative manner (and more!) to be used with OpenStack and other
+projects.
+
+* Free software: Apache license
+* Documentation: https://docs.openstack.org/taskflow/latest/
+* Source: https://opendev.org/openstack/taskflow
+* Bugs: https://bugs.launchpad.net/taskflow/
+* Release notes: https://docs.openstack.org/releasenotes/taskflow/
+
+Join us
+-------
+
+- https://launchpad.net/taskflow
+
+Testing and requirements
+------------------------
+
+Requirements
+~~~~~~~~~~~~
+
+Because this project has many optional (pluggable) parts like persistence
+backends and engines, we decided to split our requirements into two
+parts: - things that are absolutely required (you can't use the project
+without them) are put into ``requirements.txt``. The requirements
+that are required by some optional part of this project (you can use the
+project without them) are put into our ``test-requirements.txt`` file (so
+that we can still test the optional functionality works as expected). If
+you want to use the feature in question (`eventlet`_ or the worker based engine
+that uses `kombu`_ or the `sqlalchemy`_ persistence backend or jobboards which
+have an implementation built using `kazoo`_ ...), you should add
+that requirement(s) to your project or environment.
+
+Tox.ini
+~~~~~~~
+
+Our ``tox.ini`` file describes several test environments that allow to test
+TaskFlow with different python versions and sets of requirements installed.
+Please refer to the `tox`_ documentation to understand how to make these test
+environments work for you.
+
+Developer documentation
+-----------------------
+
+We also have sphinx documentation in ``docs/source``.
+
+*To build it, run:*
+
+::
+
+    $ python setup.py build_sphinx
+
+.. _kazoo: https://kazoo.readthedocs.io/en/latest/
+.. _sqlalchemy: https://www.sqlalchemy.org/
+.. _kombu: https://kombu.readthedocs.io/en/latest/
+.. _eventlet: http://eventlet.net/
+.. _tox: https://tox.testrun.org/
+

{taskflow-5.9.1 → taskflow-5.11.0}/taskflow.egg-info/SOURCES.txt

@@ -1,6 +1,7 @@
 .coveragerc
 .mailmap
 .pre-commit-config.yaml
+.pylintrc
 .stestr.conf
 .zuul.yaml
 AUTHORS
@@ -9,7 +10,6 @@ ChangeLog
 LICENSE
 README.rst
 bindep.txt
-pylintrc
 requirements.txt
 run_tests.sh
 setup-etcd-env.sh
@@ -74,6 +74,7 @@ releasenotes/notes/fix-revert-all-revert-a0310cd7beaa7409.yaml
 releasenotes/notes/fix-storage-failure-handling-5c115d92daa0eb82.yaml
 releasenotes/notes/fix-zookeeper-option-parsing-f9d37fbc39af47f4.yaml
 releasenotes/notes/redis-username-df0eb33869db09a2.yaml
+releasenotes/notes/remove-py38-15af791146f479e1.yaml
 releasenotes/notes/remove-strict-redis-f2a5a924b314de41.yaml
 releasenotes/notes/sentinel-fallbacks-6fe2ab0d68959cdf.yaml
 releasenotes/notes/sentinel-ssl-399c56ed7067d282.yaml
@@ -82,6 +83,7 @@ releasenotes/notes/zookeeper-ssl-support-b9abf24a39096b62.yaml
 releasenotes/source/2023.1.rst
 releasenotes/source/2023.2.rst
 releasenotes/source/2024.1.rst
+releasenotes/source/2024.2.rst
 releasenotes/source/conf.py
 releasenotes/source/index.rst
 releasenotes/source/ocata.rst