Changelog

Version 2.0.3

• Fix: Problem with entry_points in protobuf module under Python 3.14

Version 2.0.2

• Fix: “quick fingers” issue with _decompose fix.

Version 2.0.1

• Fix: for trace configuration.

• Fix: issues with _decompose.

• Fix: Signature match in eventsocket.

Version 2.0.0

• Change tests from unittest to pytest, 96% code coverage.

• Minimal Python version raised to 3.11.

• Code cleanup and optimization for Python 3.11 features.

• types module:

  • Change: Function Conjunctive renamed to conjunctive.

  • Fix: Distinct support for dataclasses was broken.

  • Fix: Distinct support for hash was broken.

  • Change: Sentinel objects completely reworked. Individual sentinels are now classes derived from Sentinel.

  • Added: __repr__ method for PyCode and PyCallable that will limit output to 50 characters.

  • Added: Optional encoding parameter for ZMQAddress constructor.

• buffer module:

  • Added MemoryBuffer.get_raw method.

  • Added get_raw method to BufferFactory, BytesBufferFactory and CTypesBufferFactory.

  • Fix: resize, read and read_number now raise BufferError istead IOError.

• collections module:

  • DataList.__init__ parameter frozen is now keyword-only.

  • DataList.extract parameter copy is now keyword-only.

  • DataList.sort parameter reverse is now keyword-only.

  • DataList.split parameter frozen is now keyword-only.

  • Registry.popitem parameter last is now keyword-only.

  • BaseObjectCollection.contains parameter expr now does not have default value.

  • Fix: problem with Registry.pop that did not raised KeyError when default was not specified.

  • Fix: bug in Registry.popitem with last = True.

• config module:

  • Deprecated create_config function was removed.

  • Change: DirectoryScheme parameter force_home is now keyword only.

  • Change: Option parameters required and default are now keyword only.

  • Fix: Problem with name handling in ConfigOption.clear and set_value.

  • Fix: Problem with WindowsDirectoryScheme and MacOSDirectoryScheme constructors.

  • Fix: Problem with ListOption.item_types value.

  • Fix: Problem with internal Convertor initialization in ListOption.

  • Fix: Use copy of default list stead direct use in ListOption.

  • Fix: ListOption.get_formatted and ListOption.get_as_str should return typed values for multitype lists.

  • Fix: ConfigOption.validate should validate the Config as well if defined.

  • Fix: ConfigListOption.validate should report error for empty list when required.

• strconv module:

  • Fix: Problem with conversion of flags from string.

• Changed: The logging module was completelly reworked.

• trace module:

  • Change: Parameter context was removed from traced decorator

  • Change: Option context was removed from BaseTraceConfig.

  • Change: Log function return value as repr rather than str.

Version 1.8.0

• config module:

  • New EnvExtendedInterpolation class that extends configparser.ExtendedInterpolation with special handling for “env” section that returns value of specified environment variable, or empty string if such variable is not defined.

Version 1.7.2

• Error.getattr() should not mask the absence of __notes__ attribute.

Version 1.7.1

• Log record values module and filename were not assigned properly under Python 3.11,

• Failed tests due to subtle changes in Python 3.11

• Downgrade dependency to protobuf>=4.23.4

Version 1.7.0

• Update dependency to protobuf >=4.24.3

• Build system changed from setuptools to hatch

• Package version is now defined in firebird.base.__about__.py (__version__)

Version 1.6.1

• config module:

  • Fixed bug with Config.get_config() and plain bool argument.

  • StrOption now supports preservation of significant leading whitespace for multiline values (like PyCodeOption).

Version 1.6.0

• protobuf module:

  • Registration of already registered protobuf registration is now ignored instead raising exception.

• config module:

  • Config.get_config() and Option.get_config() now provides plain bool argument to return configuration text without comments. Deafult is False.

  • create_config is now deprecated, will be removed in version 2.0.

• trace module:

  • Fixed bug in TraceManager.load_config().

Version 1.5.0

• Move away from setup.cfg to pyproject.toml, new source tree layout.

Version 1.4.3

• types module:

  • Added internal functions _decompose and _power_of_two from stdlib enum module, because they were removed in Python 3.11.

• protobuf module:

  • Use importlib.metadata.entry_points instead pkg_resources.iter_entry_points.

• Improved documentation.

Version 1.4.2

• Optimizations.

• Cleanup of pylint warnings.

• Updated documentation.

• Fixed unregistered bugs:

  • Signature in firebird.base.config.IntOption.clear.

  • Signature in firebird.base.trace.TraceManager.add_trace. Keyword argument decorator (with default) could not be used with args/kwargs, so it was removed. New decorator attribute was added to TraceManager that could be used to change trace decorator used for intrumentation.

Version 1.4.1

• Fix: uregistered bug in trace.TraceConfig - redundant flags definition.

• New: Documentation is now also provided as Dash / Zeal docset, downloadable from releases at github.

Version 1.4.0

• Upgrade to protobuf 4.21.1. As this upgrade has consequences, please read https://developers.google.com/protocol-buffers/docs/news/2022-05-06#python-updates

Version 1.3.1

• buffer module:

  • Added MemoryBuffer.write_sized_string for symetry with read_sized_string.

  • Now MemoryBuffer string functions has also errors parameter in addition to encoding.

• config module:

  • Direct assignment to Config option raises a ValueError exception with message “Cannot assign values to option itself, use option.value instead”.

Version 1.3.0

• config module:

  • Layout produced by get_config() was changed.

  • Config has new constructor keyword-only argument description.

  • Fix: uregistered bug in config.ListOption - value and default was the same instance

Version 1.2.0

• Build scheme changed to PEP 517.

• Various changes to documentation and type hint adjustments.

• config module:

  • BREAKING CHANGE: ApplicationDirectoryScheme was replaced by DirectoryScheme class, and get_directory_scheme() has changed signature.

  • Directory scheme was reworked and now also supports concept of HOME directory.

  • New MacOS directory scheme support. As I don’t have access to MacOS, this support should be considered EXPERIMENTAL. Any feedback about it’s correctness is welcome.

  • Added: New Config constructor keyword-only bool argument optional and associated optional read-only property.

  • Added: Config.has_value() function.

  • New class: PathOption for Configuration options with pathlib.Path value.

• protobuf module:

  • Added: function get_message_factory.

• signal module:

  • Fix: Bug in eventsocket signature handling.

• trace module:

  • Added: apply_to_descendants boolean configuration option to apply configuration also to all registered descendant classes. The default value is True.

Version 1.1.0

• New module: signal - Callback system based on Signals and Slots, and “Delphi events”

• types module:

  • load function now supports object_name[.object_name...] specifications instead single object_name.

• config module:

  • New class ApplicationDirectoryScheme

  • load_config(): raises error when section is missing, better error handling when exception is raised while loading options

  • PyCallableOption signature argument could be inspect.Signature or Callable

  • Introduced PROTO_CONFIG constant with fully qualified name for ConfigProto protobuf

  • Optional argument to_default in clear() is now keyword-only.

• logging module:

  • get_logging_id() uses __qualname__ instead __name__

• protobuf module:

  • Added direct support for key well-known data types Empty, Any, Duration, Timestamp, Struct, Value, ListValue and FieldMask. They are automatically registered. New constants ‘PROTO_<type>’ with fully qualified names.

  • create_message() has new optional serialized argument with bytes that should be parsed into newly created message instance.

  • New functions struct2dict() and dict2struct()

• trace module:

  • TraceFlag value DISABLED was renamed to NONE.

  • Added support for trace configuration based on config, using new classes BaseTraceConfig, TracedMethodConfig, TracedClassConfig and TraceConfig.

  • New methods in TraceManager:

    • load_config() to update trace from configuration.

    • set_flag() and clear_flag().

• types module:

  • MIME now handles access to properties more efficiently and faster.

  • New function load().

• Changes in documentation.

Version 1.0.0

• Documentation: new examples for trace - Trace/audit for class instances, logging - Context-based logging and hooks - Hook manager

• Documentation: adjustments to css

• DataList is now generic class

• DataList.extract() has new ‘copy’ argument.

Version 0.6.1

• Promoted to stable

• More documentation

Version 0.6.0

• New module: strconv - Data conversion from/to string

• New module: trace - Trace/audit for class instances

• Reworked module: config - Classes for configuration definitions

  • New class: ConfigOption - Configuration option with Config value

  • New class: ConfigListOption - Configuration option with list of Config values

  • New class: DataclassOption - Configuration option with a dataclass value

• Changed module: types

  • New class: MIME - MIME type specification

  • New class: PyExpr - Source code for Python expression

  • New class: PyCode - Python source code

  • New class: PyCallable - Source code for Python callable

  • Removed function: str2bool

• Changed module: logging

  • Trace/audit functionality removed (into new module trace)

Version 0.5.0

Initial release.