Merge branch 'development' into feature/enum-append-sequence

Author: timsavage

.github/workflows/release.yml

@@ -66,8 +66,8 @@ jobs:
           asset_name: ${{ steps.build_package.outputs.source }}
           asset_content_type: application/x-tar+gzip
 
-      - name: Upload to PyPI
-        id: upload_to_pypi
-        run: |
-          poetry config pypi-token.pypi "$POETRY_PYPI_TOKEN_PYPI"
-          poetry publish
+      - name: Publish to PyPI
+        uses: pypa/[email protected]
+        with:
+            user: __token__
+            password: ${{ secrets.POETRY_PYPI_TOKEN_PYPI }}

HISTORY

@@ -1,18 +1,78 @@
-4.9.0
-=====
+4.12
+====
 
 Changes
---------
+-------
+
+- Introduction of typed_settings, providing a cleaner way to access default settings
+  that supports auto-completion and type inference. And preparing the way for more
+  in-depth checks that ensure settings values match the expected types.
+
+- Support ``Literal`` types in CLI. Maps str and int literals to choices.
 
 - Support sequences of Enum values in the CLI. This is implemented via the
   ``AppendEnumValue`` and ``AppendEnumName`` actions.
 
+- Migrate from pkg_resources to the standardised builtin importlib.metadata.
+
+- Fix for handling events/callbacks on classes where the parent has __slots__ defined.
+
+
+4.11.0
+======
+
+Changes
+-------
+
+- Self is now ignored in command handlers if it is the first argument. This covers
+  the case where a non ``staticfunction`` is used as a handler when grouped as part
+  of a command group.
+
+- Allow CLI entry points to define an argument as a date, time or datetime type
+  which will accept an valid ISO8601 string.
+
+- Add pre_dispatch, post_dispatch and dispatch_error events to CliApplication
+
+
+4.10.1
+======
+
+Changes
+-------
+
+- Fix issue with docs build related to Poetry and RTD
+
+
+4.10.0
+======
+
+Changes
+-------
+
+- Add implementation of ``multiprocessing.Pool`` that ensures that settings are
+  mirrored into any worker process.
+
+- Include pytest plugin to provide fixtures
+
+
+4.9.0
+=====
+
+Changes
+-------
+
+- Changed settings to be support being pickled.
+
+- Added feature to export and restore settings into a serialised form for
+  use-cases where settings need to be duplicated (eg deploying tasks into a
+  spark cluster where settings are required).
+
 
 4.8.2
 =====
 
 Changes
---------
+-------
 
 - Extend change to RegexType to allow for any custom ArgumentType by extending
   the ArgumentType ABC.
@@ -25,7 +85,7 @@ Changes
 =====
 
 Changes
---------
+-------
 
 - Fix bug with RegexType argument where regex searched input string not raising
   an invalid argument if the input _contained_ a valid string.
@@ -37,7 +97,7 @@ Changes
 =====
 
 Changes
---------
+-------
 
 - Dropping official support for Python 3.6 and 3.7
 
@@ -60,7 +120,7 @@ Changes
 =====
 
 Changes
---------
+-------
 
 - Improve the settings reset to properly apply the base-settings after reset.
   These are the basic settings required for the application to operate

docs/reference/conf/base_settings.rst

@@ -0,0 +1 @@
+.. automodule:: pyapp.typed_settings

docs/reference/conf/typed-settings.rst

@@ -10,9 +10,10 @@ Contents:
    app
    checks
    conf
-   conf/base_settings
+   conf/typed-settings
    conf/helpers
    events
    injection
    feature-flags
+   multiprocessing
    extensions

docs/reference/index.rst

@@ -0,0 +1 @@
+.. automodule:: pyapp.multiprocessing

docs/reference/multiprocessing.rst

@@ -1,10 +1,10 @@
 [build-system]
-requires = ["poetry>=1.0", "rtd-poetry-tmp"]
-build-backend = "rtd_poetry"
+requires = ["poetry-core>=1.0.0"]
+build-backend = "poetry.core.masonry.api"
 
 [tool.poetry]
 name = "pyapp"
-version = "4.9"
+version = "4.12.0"
 description = "A Python application framework - Let us handle the boring stuff!"
 authors = ["Tim Savage <[email protected]>"]
 license = "BSD-3-Clause"
@@ -37,20 +37,24 @@ python = "^3.8"
 argcomplete = "*"
 colorama = "*"
 yarl = "*"
+importlib_metadata = {version = "*", python = "<=3.9"}
 
 pyyaml = {version = "*", optional = true }
 toml = {version = "*", optional = true }
 
 [tool.poetry.dev-dependencies]
-pytest = "^7.1.2"
-pytest-cov = "^3.0.0"
-pytest-asyncio = "^0.18.3"
+pytest = "^7.2"
+pytest-cov = "^4.0"
+pytest-asyncio = "^0.20"
 nox = "*"
-sphinx = "^5.0.2"
+sphinx = "^6.0"
 
 [tool.poetry.extras]
 yaml = ["pyyaml"]
 toml = ["toml"]
 
 [tool.poetry.urls]
 "Bug Tracker" = "https://github.com/pyapp-org/pyapp/issues"
+
+[tool.poetry.plugins."pytest11"]
+"pyapp-pytest" = "pyapp.testing.pytest_plugin"

poetry.lock

@@ -1,19 +1,27 @@
 """
 Single file sample
 """
-from pyapp.app import argument
 from pyapp.app import CliApplication
-from pyapp.app import CommandOptions
-from pyapp.app import KeyValueAction
+from pyapp.events import listen_to
 
 APP = CliApplication()
 
 
+@listen_to(APP.pre_dispatch)
+def pre_dispatch(opts):
+    print(opts)
+
+
 @APP.default
 def helper(*, bar: dict):
     print(bar)
     # print(opts.bar)
 
 
+@listen_to(APP.post_dispatch)
+def pre_dispatch(result, opts):
+    print(result, opts)
+
+
 if __name__ == "__main__":
     APP.dispatch()