ssb-nudb-use 2025.12.4__tar.gz

ssb_nudb_use-2025.12.4/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright © 2025 Statistics Norway
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ssb_nudb_use-2025.12.4/PKG-INFO

@@ -0,0 +1,164 @@
+Metadata-Version: 2.4
+Name: ssb-nudb-use
+Version: 2025.12.4
+Summary: NUDB Use - is a usage-package for the Norwegian National Education Database cloud-data. Both for data-consumers and data-deliverers
+License-Expression: MIT
+License-File: LICENSE
+Author: Carl F. Corneil
+Author-email: cfc@ssb.no
+Maintainer: Statistics Norway, Education statistics Department (360)
+Requires-Python: >=3.11
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Dist: brreg (>=1.3.0)
+Requires-Dist: pandas (>=2.3.3)
+Requires-Dist: pydantic (>=2.12.4)
+Requires-Dist: requests (>=2.32.5)
+Requires-Dist: ssb-fagfunksjoner (>=1.1.2) ; python_version >= "3.11" and python_version < "4.0"
+Requires-Dist: ssb-klass-python (>=1.0.4)
+Requires-Dist: ssb-nudb-config (>=2025.12.6)
+Project-URL: Changelog, https://github.com/statisticsnorway/ssb-nudb-use/releases
+Project-URL: Documentation, https://statisticsnorway.github.io/ssb-nudb-use
+Project-URL: Homepage, https://github.com/statisticsnorway/ssb-nudb-use
+Project-URL: Repository, https://github.com/statisticsnorway/ssb-nudb-use
+Description-Content-Type: text/markdown
+
+# SSB-NUDB-USE
+
+[![PyPI](https://img.shields.io/pypi/v/ssb-nudb-use.svg)][pypi status]
+[![Status](https://img.shields.io/pypi/status/ssb-nudb-use.svg)][pypi status]
+[![Python Version](https://img.shields.io/pypi/pyversions/ssb-nudb-use)][pypi status]
+[![License](https://img.shields.io/pypi/l/ssb-nudb-use)][license]
+
+[![Documentation](https://github.com/statisticsnorway/ssb-nudb-use/actions/workflows/docs.yml/badge.svg)][documentation]
+[![Tests](https://github.com/statisticsnorway/ssb-nudb-use/actions/workflows/tests.yml/badge.svg)][tests]
+[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=statisticsnorway_ssb-nudb-use&metric=coverage)][sonarcov]
+[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=statisticsnorway_ssb-nudb-use&metric=alert_status)][sonarquality]
+
+[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white)][pre-commit]
+[![Black](https://img.shields.io/badge/code%20style-black-000000.svg)][black]
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![Poetry](https://img.shields.io/endpoint?url=https://python-poetry.org/badge/v0.json)][poetry]
+
+[pypi status]: https://pypi.org/project/ssb-nudb-use/
+[documentation]: https://statisticsnorway.github.io/ssb-nudb-use
+[tests]: https://github.com/statisticsnorway/ssb-nudb-use/actions?workflow=Tests
+[sonarcov]: https://sonarcloud.io/summary/overall?id=statisticsnorway_ssb-nudb-use
+[sonarquality]: https://sonarcloud.io/summary/overall?id=statisticsnorway_ssb-nudb-use
+[pre-commit]: https://github.com/pre-commit/pre-commit
+[black]: https://github.com/psf/black
+[poetry]: https://python-poetry.org/
+
+# Description
+
+NUDB is the National Education Database of Norway. It is operated by Statsitics Norway - section 360.
+This package is the main "usage-package" for those seeking to use NUDB-data, or deliver data to NUDB.
+
+NUDBs data is kept as parquet files in GCP, and you will need seperate access to this data to utilize this package.
+Some features in this package might require access to other data, like BRREG (Brønnøysundregisteret), BOF (befolkningsregisteret), VOF (virksomhetsregisteret) etc.
+
+
+## Installation
+
+You can install _SSB Nudb Use_ via [poetry] from [PyPI]:
+
+```console
+poetry add ssb-nudb-use
+```
+
+## Dependencies
+
+This package depends on the package "ssb-nudb-config", which contains metadata, but also points to content in other metadatasystems like Vardef, Klass and Datadoc.
+
+
+## Usage
+
+Please see the [Reference Guide] for details.
+
+
+### Usage for extraction (data from NUDB)
+
+Find the latest of each file shared.
+```python
+from nudb_use import latest_shared_paths
+latest_shared_paths()
+```
+
+Get the periods out of any paths following the SSB-naming standard.
+```python
+from nudb_use import get_periods_from_path
+get_periods_from_path(path)
+```
+
+Deriving variables not stored in data, is done by the derive module:
+```python
+from nudb_use import derive
+df = derive.utd_skoleaar_slutt(df)
+```
+
+
+### Usage for delivery (data to NUDB)
+
+We have renamed a lot of our variables transitioning from the old on-prem systems. If you are looking for the new or old names of variables, you can use the find_var or find_vars functions:
+```python
+from nudb_use import find_vars
+find_vars(["snr", "sosbak"])
+```
+
+If you want to update the column names you have in a pandas dataframe, to the new column names - there's a function for that:
+```python
+from nudb_use import update_colnames
+df = update_colnames(df)
+```
+
+After renaming, you can get the pandas dtypes the columns should have with get_dtypes:
+```python
+from nudb_use import get_dtypes
+dtypes = get_dtypes(df)
+df = df.astype(dtypes)
+```
+If you are delivering to NUDB, we want you to run our quality suite before sharing the data with us:
+```python
+from nudb_use import run_quality_suite
+run_quality_suite(df, "avslutta")
+```
+Data about your delivery, like "avslutta", should first have its data entered into, and released in the ssb-nudb-config package before available in this function. Contact the NUDB-team to define a new delivery.
+
+
+
+
+## Contributing
+
+Contributions are very welcome.
+To learn more, see the [Contributor Guide].
+
+## License
+
+Distributed under the terms of the [MIT license][license],
+_SSB Nudb Use_ is free and open source software.
+
+## Issues
+
+If you encounter any problems,
+please [file an issue] along with a detailed description.
+
+## Credits
+
+This project was generated from [Statistics Norway]'s [SSB PyPI Template].
+
+[statistics norway]: https://www.ssb.no/en
+[pypi]: https://pypi.org/
+[ssb pypi template]: https://github.com/statisticsnorway/ssb-pypitemplate
+[file an issue]: https://github.com/statisticsnorway/ssb-nudb-use/issues
+[pip]: https://pip.pypa.io/
+
+<!-- github-only -->
+
+[license]: https://github.com/statisticsnorway/ssb-nudb-use/blob/main/LICENSE
+[contributor guide]: https://github.com/statisticsnorway/ssb-nudb-use/blob/main/CONTRIBUTING.md
+[reference guide]: https://statisticsnorway.github.io/ssb-nudb-use/reference.html
+

ssb_nudb_use-2025.12.4/README.md

@@ -0,0 +1,134 @@
+# SSB-NUDB-USE
+
+[![PyPI](https://img.shields.io/pypi/v/ssb-nudb-use.svg)][pypi status]
+[![Status](https://img.shields.io/pypi/status/ssb-nudb-use.svg)][pypi status]
+[![Python Version](https://img.shields.io/pypi/pyversions/ssb-nudb-use)][pypi status]
+[![License](https://img.shields.io/pypi/l/ssb-nudb-use)][license]
+
+[![Documentation](https://github.com/statisticsnorway/ssb-nudb-use/actions/workflows/docs.yml/badge.svg)][documentation]
+[![Tests](https://github.com/statisticsnorway/ssb-nudb-use/actions/workflows/tests.yml/badge.svg)][tests]
+[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=statisticsnorway_ssb-nudb-use&metric=coverage)][sonarcov]
+[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=statisticsnorway_ssb-nudb-use&metric=alert_status)][sonarquality]
+
+[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white)][pre-commit]
+[![Black](https://img.shields.io/badge/code%20style-black-000000.svg)][black]
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![Poetry](https://img.shields.io/endpoint?url=https://python-poetry.org/badge/v0.json)][poetry]
+
+[pypi status]: https://pypi.org/project/ssb-nudb-use/
+[documentation]: https://statisticsnorway.github.io/ssb-nudb-use
+[tests]: https://github.com/statisticsnorway/ssb-nudb-use/actions?workflow=Tests
+[sonarcov]: https://sonarcloud.io/summary/overall?id=statisticsnorway_ssb-nudb-use
+[sonarquality]: https://sonarcloud.io/summary/overall?id=statisticsnorway_ssb-nudb-use
+[pre-commit]: https://github.com/pre-commit/pre-commit
+[black]: https://github.com/psf/black
+[poetry]: https://python-poetry.org/
+
+# Description
+
+NUDB is the National Education Database of Norway. It is operated by Statsitics Norway - section 360.
+This package is the main "usage-package" for those seeking to use NUDB-data, or deliver data to NUDB.
+
+NUDBs data is kept as parquet files in GCP, and you will need seperate access to this data to utilize this package.
+Some features in this package might require access to other data, like BRREG (Brønnøysundregisteret), BOF (befolkningsregisteret), VOF (virksomhetsregisteret) etc.
+
+
+## Installation
+
+You can install _SSB Nudb Use_ via [poetry] from [PyPI]:
+
+```console
+poetry add ssb-nudb-use
+```
+
+## Dependencies
+
+This package depends on the package "ssb-nudb-config", which contains metadata, but also points to content in other metadatasystems like Vardef, Klass and Datadoc.
+
+
+## Usage
+
+Please see the [Reference Guide] for details.
+
+
+### Usage for extraction (data from NUDB)
+
+Find the latest of each file shared.
+```python
+from nudb_use import latest_shared_paths
+latest_shared_paths()
+```
+
+Get the periods out of any paths following the SSB-naming standard.
+```python
+from nudb_use import get_periods_from_path
+get_periods_from_path(path)
+```
+
+Deriving variables not stored in data, is done by the derive module:
+```python
+from nudb_use import derive
+df = derive.utd_skoleaar_slutt(df)
+```
+
+
+### Usage for delivery (data to NUDB)
+
+We have renamed a lot of our variables transitioning from the old on-prem systems. If you are looking for the new or old names of variables, you can use the find_var or find_vars functions:
+```python
+from nudb_use import find_vars
+find_vars(["snr", "sosbak"])
+```
+
+If you want to update the column names you have in a pandas dataframe, to the new column names - there's a function for that:
+```python
+from nudb_use import update_colnames
+df = update_colnames(df)
+```
+
+After renaming, you can get the pandas dtypes the columns should have with get_dtypes:
+```python
+from nudb_use import get_dtypes
+dtypes = get_dtypes(df)
+df = df.astype(dtypes)
+```
+If you are delivering to NUDB, we want you to run our quality suite before sharing the data with us:
+```python
+from nudb_use import run_quality_suite
+run_quality_suite(df, "avslutta")
+```
+Data about your delivery, like "avslutta", should first have its data entered into, and released in the ssb-nudb-config package before available in this function. Contact the NUDB-team to define a new delivery.
+
+
+
+
+## Contributing
+
+Contributions are very welcome.
+To learn more, see the [Contributor Guide].
+
+## License
+
+Distributed under the terms of the [MIT license][license],
+_SSB Nudb Use_ is free and open source software.
+
+## Issues
+
+If you encounter any problems,
+please [file an issue] along with a detailed description.
+
+## Credits
+
+This project was generated from [Statistics Norway]'s [SSB PyPI Template].
+
+[statistics norway]: https://www.ssb.no/en
+[pypi]: https://pypi.org/
+[ssb pypi template]: https://github.com/statisticsnorway/ssb-pypitemplate
+[file an issue]: https://github.com/statisticsnorway/ssb-nudb-use/issues
+[pip]: https://pip.pypa.io/
+
+<!-- github-only -->
+
+[license]: https://github.com/statisticsnorway/ssb-nudb-use/blob/main/LICENSE
+[contributor guide]: https://github.com/statisticsnorway/ssb-nudb-use/blob/main/CONTRIBUTING.md
+[reference guide]: https://statisticsnorway.github.io/ssb-nudb-use/reference.html

ssb_nudb_use-2025.12.4/pyproject.toml

@@ -0,0 +1,162 @@
+[project]
+name = "ssb-nudb-use"
+version = "2025.12.4"  # Year.Month.Patch - So the last number is not day of month, but patch number within month
+description = "NUDB Use - is a usage-package for the Norwegian National Education Database cloud-data. Both for data-consumers and data-deliverers"
+authors = [{ name = "Carl F. Corneil", email = "cfc@ssb.no" }, { name = "Kjell Slupphaug", email = "pph@ssb.no" }, { name = "Markus Storeide", email = "rku@ssb.no" }]
+maintainers = [{ name = "Statistics Norway, Education statistics Department (360)" }]
+license = "MIT"
+readme = "README.md"
+requires-python = ">=3.11"
+dynamic = ["classifiers"]
+dependencies = [
+    "ssb-klass-python >=1.0.4",
+    "pandas >=2.3.3",
+    "ssb-fagfunksjoner >=1.1.2; python_version >= '3.11' and python_version < '4.0'",
+    "pydantic >=2.12.4",
+    "brreg >=1.3.0",
+    "requests >=2.32.5",
+    "ssb-nudb-config >=2025.12.6"
+]
+
+[project.urls]
+homepage = "https://github.com/statisticsnorway/ssb-nudb-use"
+repository = "https://github.com/statisticsnorway/ssb-nudb-use"
+documentation = "https://statisticsnorway.github.io/ssb-nudb-use"
+Changelog = "https://github.com/statisticsnorway/ssb-nudb-use/releases"
+
+[tool.poetry]
+classifiers = ["Development Status :: 3 - Alpha"]
+requires-poetry = ">=2.0"
+packages = [{ include = "nudb_use", from = "src" }]
+
+[tool.poetry.group.dev.dependencies]
+pygments = ">=2.10.0"
+black = { extras = ["jupyter"], version = ">=23.1.0" }
+coverage = { extras = ["toml"], version = ">=6.2" }
+furo = ">=2021.11.12"
+mypy = ">=0.930"
+pre-commit = ">=2.16.0"
+pre-commit-hooks = ">=4.1.0"
+pydoclint = { version = ">=0.8.3" }
+ruff = ">=0.0.284"
+pytest = ">=6.2.5"
+sphinx = ">=6.2.1"
+sphinx-autobuild = ">=2021.3.14"
+sphinx-autodoc-typehints = ">=1.24.0"
+sphinx-click = ">=3.0.2"
+typeguard = ">=2.13.3"
+xdoctest = { extras = ["colors"], version = ">=0.15.10" }
+myst-parser = { version = ">=0.16.1" }
+deptry = {version=">=0.23.0", python = ">=3.10, <4.0"}
+colorama = ">=0.4.6"
+
+[tool.poetry.requires-plugins]
+poetry-plugin-export = ">=1.9"
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+
+[tool.coverage.paths]
+source = ["src", "*/site-packages"]
+tests = ["tests", "*/tests"]
+
+[tool.coverage.run]
+branch = true
+source = ["nudb_use", "tests"]
+relative_files = true
+
+[tool.coverage.report]
+show_missing = true
+fail_under = 50
+
+[tool.deptry.per_rule_ignores]
+DEP001 = ["nox", "nox_poetry"]  # packages available by default
+
+[tool.mypy]
+strict = true
+warn_unreachable = true
+pretty = true
+show_column_numbers = true
+show_error_context = true
+
+[tool.ruff]
+force-exclude = true  # Apply excludes to pre-commit
+show-fixes = true
+src = ["src", "tests"]
+target-version = "py311"  # Minimum Python version supported
+include = ["*.py", "*.pyi", "**/pyproject.toml", "*.ipynb"]
+extend-exclude = [
+    "__pycache__",
+    "old",
+    ".ipynb_checkpoints",
+    "noxfile.py",
+    "docs/conf.py"
+]
+
+# Ruff rules may be customized as desired: https://docs.astral.sh/ruff/rules/
+[tool.ruff.lint]
+select = [
+    "A",    # prevent using keywords that clobber python builtins
+    "ANN",  # check type annotations
+    "B",    # bugbear: security warnings
+    "D",    # documentation
+    "E",    # pycodestyle
+    "F",    # pyflakes
+    "ISC",  # implicit string concatenation
+    "I",    # sort imports
+    "UP",   # alert you when better syntax is available in your python version
+    "RUF",  # the ruff developer's own rules
+]
+ignore = [
+    "ANN202", # Don't require return type annotation for private functions.
+    "ANN401", # Allow type annotation with type Any.
+    "D100",   # Supress undocumented-public-module. Only doc of public api required.
+    "D107",   # We are of the opinion that inits dont need a docstring, when the class has one...
+    "FBT001", # Allow boolean positional arguments in a function.
+    "FBT002", # Allow boolean default positional arguments in a function.
+    "E402",   # Supress module-import-not-at-top-of-file, needed in jupyter notebooks.
+    "E501",   # Supress line-too-long warnings: trust black's judgement on this one.
+    "PLR2004", # Allow to compare with unnamed numerical constants.
+]
+
+[tool.ruff.lint.isort]
+force-single-line = true
+
+[tool.ruff.lint.mccabe]
+max-complexity = 15
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"  # You can also use "numpy".
+
+[tool.ruff.lint.pylint]
+max-args = 8
+
+[tool.ruff.lint.pep8-naming]
+classmethod-decorators = ["classmethod", "validator", "root_validator", "pydantic.validator"]
+
+[tool.ruff.lint.per-file-ignores]
+"*/__init__.py" = ["F401"]
+"**/tests/*" = [
+    "ANN001",  # type annotations don't add value for test functions
+    "ANN002",  # type annotations don't add value for test functions
+    "ANN003",  # type annotations don't add value for test functions
+    "ANN201",  # type annotations don't add value for test functions
+    "ANN204",  # type annotations don't add value for test functions
+"ANN205",  # type annotations don't add value for test functions
+"ANN206",  # type annotations don't add value for test functions
+"D100",    # docstrings are overkill for test functions
+"D101",
+"D102",
+"D103",
+"S101",    # asserts are encouraged in pytest
+]
+"src/nudb_use/variables/derive/*.py" = ["RUF100"]  # If we dont have this RUFF strips our inlined noqas for pydoclint
+
+[tool.pydoclint]
+style = "google"
+arg-type-hints-in-docstring = false
+native-mode-noqa-location = "definition"
+
+[build-system]
+requires = ["poetry-core>=1.0.0"]
+build-backend = "poetry.core.masonry.api"

ssb_nudb_use-2025.12.4/src/nudb_use/.gitignore

@@ -0,0 +1,3 @@
+
+# Ignore dynaconf secret files
+.secrets.*

ssb_nudb_use-2025.12.4/src/nudb_use/CLEANUP.md

@@ -0,0 +1,30 @@
+1. Klass "check against codelist" / getting klass data
+    1.  metadata/nudb_klass/codes
+    2.  variables/checks
+    3.  variables/var_utils/find_var
+2. Column renames from config:
+    1. variables/var_utils/renames
+    2. metadata/nudb_config/variable_names
+    3. nudb_build/variables/var_utils/renames
+3.  Nudb config around:
+    1. config.py
+    2. config_tomls/
+    3. metadata/nudb_config
+4. Checking column "presence" / in config / drop / keep
+    1. variables/var_utils/find_var
+    2. variables/checks.py
+    3. metadata/nudb_config/variable_names
+
+# Build vs. Use
+1. Moves from Build to Use?
+    1. nudb_build/variables/cleanup.py -> nudb_use/variables/
+    2. metadata/datadoc.py
+    3. metadata/klass_nudb.py
+    4. metadata/merge.py (inn i datadoc.py)?
+    5. quality?
+    6. "columns in pyarrow metadata" better place in use: nudb_build/variables/checks.py
+1. Paths in build, what is in use?
+    1. Remove hardcoding in functions, depend on config?
+2. Moves in build package
+    1. Make "exceptions" folder, move temporality-exeption there
+    2.

ssb_nudb_use-2025.12.4/src/nudb_use/__init__.py

@@ -0,0 +1,48 @@
+"""NUDB Use - is a usage-package for the Norwegian National Education Database cloud-data. Both for data-consumers and data-deliverers. Requires access to NUDBs shared data in most instances."""
+
+import importlib.metadata
+
+from nudb_config import settings
+
+from nudb_use.metadata import find_var
+from nudb_use.metadata import find_vars
+from nudb_use.metadata import get_dtypes
+from nudb_use.metadata import update_colnames
+from nudb_use.nudb_logger import LoggerStack
+from nudb_use.nudb_logger import logger
+from nudb_use.paths import get_periods_from_path
+from nudb_use.paths import latest_shared_paths
+from nudb_use.quality import run_quality_suite
+from nudb_use.utils.packages import _check_ssb_nudb_config_version
+from nudb_use.variables import derive
+
+__all__ = [
+    "LoggerStack",
+    "derive",
+    "find_var",
+    "find_vars",
+    "get_dtypes",
+    "get_periods_from_path",
+    "latest_shared_paths",
+    "logger",
+    "run_quality_suite",
+    "settings",
+    "update_colnames",
+]
+
+
+try:
+    _check_ssb_nudb_config_version()
+except Exception as err:
+    logger.warning(f"Unable to validate `ssb-nudb-config` version!\nMessage: {err}")
+
+
+try:
+    try:
+        __version__ = importlib.metadata.version(__name__)
+    except Exception:
+        __version__ = importlib.metadata.version("ssb-nudb-use")
+
+except Exception as err:
+    __version__ = "0.0.0"
+    logger.warning(f"Unable to determine package version!\nMessage: {err}")

ssb_nudb_use-2025.12.4/src/nudb_use/exceptions/__init__.py

@@ -0,0 +1 @@
+"""Custom exception types and helpers for nudb_use."""

ssb_nudb_use-2025.12.4/src/nudb_use/exceptions/exception_classes.py

@@ -0,0 +1,13 @@
+"""Exception types used across nudb_use."""
+
+
+class NudbQualityError(Exception):
+    """Domain-specific error for NUDB quality validations."""
+
+    ...
+
+
+class NudbDerivedFromNotFoundError(Exception):
+    """Domain-specific error for NUDB deriving issues when looking for columns needed."""
+
+    ...

ssb_nudb_use-2025.12.4/src/nudb_use/exceptions/groups.py

@@ -0,0 +1,32 @@
+"""Utilities for raising or logging grouped exceptions."""
+
+from collections.abc import Sequence
+
+from nudb_use.nudb_logger import logger
+
+
+def raise_exception_group(errors: Sequence[Exception]) -> None:
+    """Raise grouped exceptions as ExceptionGroup (Py3.11+) or ValueError.
+
+    Args:
+        errors: Exceptions that should be raised together.
+
+    Raises:
+        ExceptionGroup: On Python 3.11+, raised with every collected error.
+    """
+    if not errors:
+        return  # No errors to raise
+    raise ExceptionGroup("Multiple errors occurred", list(errors))
+
+
+def warn_exception_group(errors: Sequence[Exception]) -> None:
+    """Log each exception in the provided list using the active logger.
+
+    Args:
+        errors: Exceptions that should be emitted as warnings in sequence.
+    """
+    if not errors:
+        return  # No errors to raise
+
+    for error in errors:
+        logger.warning(str(error))

ssb_nudb_use-2025.12.4/src/nudb_use/metadata/__init__.py

@@ -0,0 +1,21 @@
+"""Expose NUDB metadata helpers for convenient imports."""
+
+from nudb_use.metadata.nudb_config import find_var
+from nudb_use.metadata.nudb_config import find_vars
+from nudb_use.metadata.nudb_config import get_cols2drop
+from nudb_use.metadata.nudb_config import get_cols2keep
+from nudb_use.metadata.nudb_config import get_dtypes
+from nudb_use.metadata.nudb_config import get_var_metadata
+from nudb_use.metadata.nudb_config import sort_cols_by_unit
+from nudb_use.metadata.nudb_config import update_colnames
+
+__all__ = [
+    "find_var",
+    "find_vars",
+    "get_cols2drop",
+    "get_cols2keep",
+    "get_dtypes",
+    "get_var_metadata",
+    "sort_cols_by_unit",
+    "update_colnames",
+]