Pyapp

=======

Features
--------

- Add root_execution_policy used to define behaviour of pyapp when executed as
root or Administrator. The default behaviour is to deny execution. This can
be overridden by specifying an alternate policy or by using the environment
variable PYAPP_ROOT_EXECUTION_POLICY.


Backward Compatibility
----------------------

- The addition of the root_execution_policy will by default confirm execution of
applications as root/Administrator. This policy needs to be explicitly set
to override this default behaviour when execution by root is required.

Any user with permissions to execute as Administrator is included in this
policy on Windows.

======

Bugfix
------

- TypedDef prefix was not being applied to setting merged into ``pyapp.conf.Setting``
instance.

====

Features
--------

- Feature flags now has a modify context manager that allows for patching flags
that are reverted when the context manager exits (similar to settings).
- Add PyTest fixture `patch_feature_flags` that returns modify context for feature
flags.
- Fully implement split logging configuration. Settings now contains `LOG_HANDLERS`
and `LOG_LOGGERS` that are merged into the logging configuration before it is
applied.
- Add a function `settings_in_module` in the testing package to fetch a list of
setting names from a settings module.
- The injection FactoryRegistry now has a modify context manager that allows for
patching (and mocking) factories that are reverted when the context manager
exits.
- Add PyTest fixture `patch_injection` that returns modify context for the
factory registry.

======

Bugfix
------

- Fix for certain edge cases where loglevel is not supplied.

====

Features
--------

- Command decorators can now be supplied with an alternate loglevel to
allow certain commands to use a different level.

Bugfix
------

- Fix initial log replay so the specified log-level is correctly applied.

====

Features
--------

- Add tooling for generating documentation of settings by inspecting the
default_settings file.


Project Changes
---------------

- All linting and formatting is now handled by pre-commit using ruff.