Release 0.10.0

- Minimal Python version raised to 3.11
- Type hints adjusted to Python 3.11 standards
- Improved documentation.
- Dependencies updated to saturnin == 0.10.0, firebird-driver ~= 2.0 and
firebird-lib ~= 2.0
- Minor bugfixes.

Author: pcisar

.gitignore

@@ -133,4 +133,7 @@ dmypy.json
 *.wpu
 
 # Sphinx build
-docs/_build
+docs/_build
+
+# Local files
+local/

CHANGELOG.md

@@ -4,6 +4,16 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](http://semver.org/).
 
+## [0.10.0] - 2025-06-02
+
+### Changed
+
+- Minimal Python version raised to 3.11
+- Type hints adjusted to Python 3.11 standards
+- Improved documentation.
+- Dependencies updated to saturnin == 0.10.0, firebird-driver ~= 2.0 and firebird-lib ~= 2.0
+- Minor bugfixes.
+
 ## [0.9.0] - 2023-10-05
 
 ### Added

README.md

@@ -33,7 +33,7 @@ For information how to use these services, see [Saturnin CORE documentation](htt
 
 ## License
 
-`saturnin` is distributed under the terms of the [MIT](https://spdx.org/licenses/MIT.html) license.
+`saturnin` and `saturnin-core` are distributed under the terms of the [MIT](https://spdx.org/licenses/MIT.html) license.
 
 ## Installation
 

docs/changelog.rst

@@ -2,6 +2,15 @@
 Changelog
 #########
 
+Version 0.10.0
+==============
+
+* Minimal Python version raised to 3.11
+* Type hints adjusted to Python 3.11 standards
+* Improved documentation.
+* Dependencies updated to saturnin == 0.10.0, firebird-driver ~= 2.0 and firebird-lib ~= 2.0
+* Minor bugfixes.
+
 Version 0.9.0
 =============
 

docs/conf.py

@@ -20,7 +20,7 @@
 # -- Project information -----------------------------------------------------
 
 project = 'saturnin-core'
-copyright = '2019-2023, The Firebird Project'
+copyright = '2019-present, The Firebird Project'
 author = 'Pavel Císař'
 
 # The short X.Y version

docs/index.rst

@@ -15,7 +15,7 @@ The core set of services for Saturnin currently contains next services:
 
    For installation instructions, see the Saturnin_ documentation.
 
-.. note:: Requires Python 3.8+
+.. note:: Requires Python 3.11+
 
 Saturnin development is sponsored by IBPhoenix_.
 

pyproject.toml

@@ -7,7 +7,7 @@ name = "saturnin-core"
 dynamic = ["version"]
 description = "Saturnin core services"
 readme = "README.md"
-requires-python = ">=3.8"
+requires-python = ">=3.11"
 license = { file = "LICENSE" }
 authors = [
   { name = "Pavel Cisar", email = "[email protected]"},
@@ -19,10 +19,9 @@ classifiers = [
     "Intended Audience :: System Administrators",
     "License :: OSI Approved :: MIT License",
     "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",
+    "Programming Language :: Python :: 3.13",
     "Operating System :: POSIX :: Linux",
     "Operating System :: Microsoft :: Windows",
     "Operating System :: MacOS",
@@ -32,9 +31,9 @@ classifiers = [
     "Topic :: Database",
     ]
 dependencies = [
-    "saturnin>=0.9.0",
-    "firebird-driver>=1.10.0",
-    "firebird-lib>=1.5.0"
+    "saturnin==0.10.0",
+    "firebird-driver~=2.0",
+    "firebird-lib~=2.0"
     ]
 
 [project.urls]
@@ -72,104 +71,48 @@ include = ["src"]
 [tool.hatch.build.targets.wheel]
 packages = ["src/saturnin"]
 
+[tool.hatch.metadata]
+allow-direct-references = true
+
 [tool.hatch.envs.default]
 dependencies = [
 ]
 
-[tool.hatch.envs.test]
-dependencies = [
-  "coverage[toml]>=6.5",
-  "pytest",
-]
-[tool.hatch.envs.test.scripts]
-test = "pytest {args:tests}"
-test-cov = "coverage run -m pytest {args:tests}"
-cov-report = [
-  "- coverage combine",
-  "coverage report",
-]
-cov = [
-  "test-cov",
-  "cov-report",
+[tool.hatch.envs.hatch-test]
+extra-dependencies = [
 ]
-version = "python --version"
 
-[[tool.hatch.envs.test.matrix]]
-python = ["3.8", "3.9", "3.10", "3.11"]
+[[tool.hatch.envs.hatch-test.matrix]]
+python = ["3.11", "3.12", "3.13"]
 
 [tool.hatch.envs.doc]
 detached = false
 platforms = ["linux"]
 dependencies = [
-  "Sphinx>=7.1",
+  "Sphinx==7.2.6",
   "sphinx-bootstrap-theme>=0.8.1",
   "sphinx-autodoc-typehints>=1.24.0",
   "doc2dash>=3.0.0"
 ]
 [tool.hatch.envs.doc.scripts]
 build = "cd docs ; make html"
 docset = [
-  "cd docs ; doc2dash -u https://saturnin-core.readthedocs.io/en/latest/ -f -i ./_static/fb-favicon.png -n saturnin-core ./_build/html/",
+  "cd docs ; doc2dash -u https://saturnin-core.rtfd.io/en/latest/ -f -i ./_static/fb-favicon.png -n saturnin-core ./_build/html/",
   "cd docs; VERSION=`hatch version` ; tar --exclude='.DS_Store' -cvzf ../dist/saturnin-core-$VERSION-docset.tgz saturnin-core.docset",
 ]
 
-[tool.hatch.envs.lint]
-detached = true
-dependencies = [
-  "black>=23.1.0",
-  "mypy>=1.0.0",
-  "ruff>=0.0.243",
-]
-[tool.hatch.envs.lint.scripts]
-typing = "mypy --install-types --non-interactive {args:src/saturnin tests}"
-style = [
-  "ruff {args:.}",
-  "black --check --diff {args:.}",
-]
-fmt = [
-  "black {args:.}",
-  "ruff --fix {args:.}",
-  "style",
-]
-all = [
-  "style",
-  "typing",
-]
-
-[tool.black]
-target-version = ["py38"]
-line-length = 120
-skip-string-normalization = true
-
 [tool.ruff]
-target-version = "py38"
+target-version = "py311"
 line-length = 120
-select = [
-  "A",
-  "ARG",
-  "B",
-  "C",
-  "DTZ",
-  "E",
-  "EM",
-  "F",
-  "FBT",
-  "I",
-  "ICN",
-  "ISC",
-  "N",
-  "PLC",
-  "PLE",
-  "PLR",
-  "PLW",
-  "Q",
-  "RUF",
-  "S",
-  "T",
-  "TID",
-  "UP",
-  "W",
-  "YTT",
+
+[tool.ruff.format]
+preview = true
+quote-style = "single"
+exclude = ["*.pyi"]
+
+[tool.ruff.lint]
+select = ["A", "ARG", "B", "C", "DTZ", "E", "EM", "F", "FBT", "I", "ICN", "ISC", "N",
+  "PLC", "PLE", "PLR", "PLW", "Q", "RUF", "S", "T", "TID", "UP", "W", "YTT",
 ]
 ignore = [
   # Allow non-abstract empty methods in abstract base classes
@@ -180,21 +123,37 @@ ignore = [
   "S105", "S106", "S107",
   # Ignore complexity
   "C901", "PLR0911", "PLR0912", "PLR0913", "PLR0915",
+  #
+  "E741",
+  # Allow relative imports
+  "TID252",
+  # Allow literals in exceptions
+  "EM101", "EM102",
+  # Single quotes instead double
+  "Q000"
 ]
 unfixable = [
   # Don't touch unused imports
   "F401",
+  # Don't change single quotes to double
+  "Q000"
 ]
+exclude = ["*_pb2.py", "*.pyi", "tests/*", "docs/*", "work/*"]
 
-[tool.ruff.isort]
-known-first-party = ["saturnin"]
+[tool.ruff.lint.isort]
+known-first-party = [
+  "firebird.driver",
+  "firebird.base",
+  "firebird.lib",
+  "firebird.uuid",
+  "saturnin",
+]
 
-[tool.ruff.flake8-tidy-imports]
+[tool.ruff.lint.flake8-tidy-imports]
 ban-relative-imports = "all"
 
-[tool.ruff.per-file-ignores]
+[tool.ruff.lint.per-file-ignores]
 # Tests can use magic values, assertions, and relative imports
-"tests/**/*" = ["PLR2004", "S101", "TID252"]
 
 [tool.coverage.run]
 source_pkgs = ["saturnin", "tests"]
@@ -204,8 +163,8 @@ omit = [
 ]
 
 [tool.coverage.paths]
-saturnin = ["src/python", "*/python/src/saturnin"]
-tests = ["tests", "*/python/tests"]
+firebird_base = ["src/saturnin"]
+tests = ["tests"]
 
 [tool.coverage.report]
 exclude_lines = [

src/saturnin/core/__about__.py

@@ -1,4 +1,4 @@
 # SPDX-FileCopyrightText: 2018-present The Firebird Project <www.firebirdsql.org>
 #
 # SPDX-License-Identifier: MIT
-__version__ = "0.9.0"
+__version__ = "0.10.0"

src/saturnin/core/binary_reader/api.py

@@ -40,10 +40,12 @@
 """
 
 from __future__ import annotations
-from firebird.base.config import StrOption, IntOption
+
 import uuid
 from functools import partial
-from saturnin.base import create_config, VENDOR_UID, Error, AgentDescriptor, ServiceDescriptor
+
+from firebird.base.config import IntOption, StrOption
+from saturnin.base import VENDOR_UID, AgentDescriptor, Error, ServiceDescriptor, create_config
 from saturnin.lib.data.onepipe import DataProviderConfig
 
 # OID: iso.org.dod.internet.private.enterprise.firebird.butler.platform.saturnin.micro.binary.reader
@@ -54,7 +56,7 @@
 # Configuration
 
 class BinaryReaderConfig(DataProviderConfig):
-    """Text file reader microservice configuration.
+    """Bindary file reader microservice configuration.
     """
     def __init__(self, name: str):
         super().__init__(name)