config-as-json 0.1__tar.gz

config_as_json-0.1/LICENSE.txt

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Tom Björkholm
+
+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.
+

config_as_json-0.1/PKG-INFO

@@ -0,0 +1,98 @@
+Metadata-Version: 2.4
+Name: config-as-json
+Version: 0.1
+Summary: Read, write, validate, and migrate JSON-backed config classes.
+Author: Tom Björkholm
+Author-email: Tom Björkholm <klausuler_linnet0q@icloud.com>
+License-Expression: MIT
+Project-URL: Source code, https://bitbucket.org/tom-bjorkholm/config_as_json/
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Requires-Dist: setuptools>=82.0.1
+Requires-Dist: build>=1.4.2
+Requires-Dist: wheel>=0.46.3
+Dynamic: author
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+
+# config-as-json
+
+`config-as-json` helps an application keep its configuration schema in a
+Python class while storing actual configuration data in JSON files.
+
+The intended usage model is:
+
+- Derive an application-specific class from `config_as_json.Config`.
+- Add one instance attribute per supported configuration parameter. An
+  instance attribute can also be a dict or list, optionally with nested
+  dicts and lists.
+- Let the values assigned in the derived constructor act as the default
+  configuration.
+- Use the library to write those defaults as JSON and to read JSON back into
+  the derived configuration object.
+
+The library is designed to support evolving configuration formats by letting
+applications define:
+
+- custom parsers for values that should become richer Python types
+- optional keys that receive default values when omitted
+- backward-compatible key renames for older configuration files
+- hooks that can warn or report when automatic compatibility changes were
+  needed
+
+## Installation
+
+`config-as-json` requires Python 3.12 or newer.
+
+```sh
+pip install --upgrade config-as-json
+```
+
+## Main entry points
+
+- `config_as_json.Config`
+  Base class for JSON-backed configuration objects.
+- `config_as_json.config_factory_from_json`
+  Select the correct configuration class by inspecting JSON input.
+- `config_as_json.ConfigAutoChangeHook`
+  Receive notifications about automatic changes during parsing.
+- `config_as_json.MigrateCfgWarnHook`
+  Warn when backward compatibility was used.
+- `config_as_json.migrate_cfg`
+  Read an older configuration file and write it back in the newest supported
+  format.
+
+The generated API reference also shows the implementation modules where these
+public objects are defined.
+
+## Documentation and examples
+
+- Example directory: [example/src/example/README.md](https://bitbucket.org/tom-bjorkholm/config_as_json/src/master/example/src/example/README.md)
+- Public API notes: [doc/api.md](https://bitbucket.org/tom-bjorkholm/config_as_json/src/master/doc/api.md)
+- Protected/internal API notes: [doc/protected_api.md](https://bitbucket.org/tom-bjorkholm/config_as_json/src/master/doc/protected_api.md)
+- Source repository: [config_as_json](https://bitbucket.org/tom-bjorkholm/config_as_json/)
+
+The example directory contains worked examples for new users. It is not
+included in the package installed from PyPI.
+
+## Project status
+
+This package originated as configuration code from a larger application and
+has been refactored into a stand-alone reusable library. The public API
+reference and worked examples are maintained in the source repository.
+
+## License
+
+MIT
+
+## Test summary
+
+- Test result: 3397 passed in 9s
+- No flake8 warnings.
+- No mypy errors found.
+- Built version(s): 0.1
+- Build and test using Python 3.14.3

config_as_json-0.1/README.md

@@ -0,0 +1,139 @@
+# config-as-json
+
+> Looking for installation and user-facing package information?
+> See [README_pypi.md](README_pypi.md) or the
+> [PyPI project page](https://pypi.org/project/config-as-json).
+
+## Repository purpose
+
+`config-as-json` is a reusable library that grew out of configuration code
+from an application.
+
+The intended library model is:
+
+- An application derives its own configuration class from
+  `config_as_json.Config`.
+- The derived class creates one instance attribute per supported
+  configuration parameter. Supported configuration parameters can also
+  be dicts and lists.
+- The values assigned in the derived class constructor are the default
+  configuration values.
+- The library writes those values as JSON, reads JSON back into the object,
+  and helps users with clear diagnostics when configuration data is missing,
+  misspelled, outdated, or of the wrong type.
+
+The source docstrings are used to generate the API reference in `doc/`, and
+the examples in `example/src/example/` are the main worked documentation for
+new users. User-facing documentation names public classes and functions as
+exports from `config_as_json`; the generated API reference may also show the
+implementation modules where those objects are defined.
+
+## Product vision and boundaries
+
+This package is about representing an application's configuration as a Python
+object with an explicit schema and a JSON representation.
+
+The library is intended to:
+
+- Keep the application's configuration schema visible in normal Python code.
+- Use the derived class itself as the source of default values.
+- Read and write human-editable JSON configuration files.
+- Support evolution of the configuration format through optional keys,
+  converters, and backward-compatible key renames.
+- Help end users with actionable error messages instead of silent fallback.
+
+The library is not intended to invent configuration structure dynamically or
+to hide the application's schema behind a large generic framework.
+
+
+## Main building blocks
+
+- `config_as_json.Config`
+  The base class for derived configuration classes.
+- `config_as_json.config_factory_from_json`
+  Select among several configuration classes by inspecting JSON input.
+- `config_as_json.ConfigAutoChangeHook`
+  Hook interface for reporting automatic changes applied during parsing.
+- `config_as_json.migrate_cfg`
+  Helper for reading an older configuration file and writing it back in the
+  newest supported format.
+- `config_as_json.MigrateCfgWarnHook`
+  Standard hook that warns users when backward compatibility was needed.
+- Utility modules such as `str_to_enum`, `file_extension`,
+  `file_must_exist`, `commontypes`, and `assert_dict_equal`
+  These are part of the current public surface and are documented as such.
+
+## Related documentation
+
+- User-facing package overview: [README_pypi.md](README_pypi.md)
+- Example directory: [example/src/example/README.md](example/src/example/README.md)
+- Public API notes: [doc/api.md](doc/api.md)
+- Protected/internal API notes: [doc/protected_api.md](doc/protected_api.md)
+- Build system design: [common_build_tools/README.md](common_build_tools/README.md)
+
+The example directory contains worked examples for new users and is also
+useful for maintainers who want to see intended API usage in context.
+
+## Cloning
+
+This repository uses submodules. Clone it with:
+
+```sh
+git clone --recurse-submodules \
+  git@bitbucket.org:tom-bjorkholm/config_as_json.git
+```
+
+If you already cloned without submodules, initialize them with:
+
+```sh
+git submodule update --init --recursive
+```
+
+To update the checked-out submodule revisions:
+
+```sh
+git submodule update --remote --merge
+```
+
+## Supported Python versions
+
+- Package runtime baseline: Python 3.12 or newer
+- Maintainer validation target: Python 3.12, 3.13, and 3.14
+- Main day-to-day development: usually the newest supported Python version
+
+## Development workflow
+
+On macOS and Linux, the normal workflow is:
+
+1. Run `./run_setup_build_environment.py` once after cloning or when the
+   build environment needs to be recreated.
+2. Run `./run_build.py` for the normal build-and-test cycle.
+3. Run `./run_clean_build.py` before review or release work that needs a
+   completely fresh build.
+
+The helper scripts are:
+
+- `run_setup_build_environment.py`
+  Create or refresh the build environment.
+- `run_build.py`
+  Build the package and run the configured checks in the project virtual
+  environment.
+- `run_clean.py`
+  Remove files generated by the build system.
+- `run_clean_build.py`
+  Perform a clean build from scratch. This is especially useful because some
+  duplicate-code diagnostics only appear on a clean build.
+- `run_pypi_build.py`
+  Create the distribution artifacts intended for PyPI publishing.
+
+The standard verification suite includes pytest, pylint, flake8, and mypy.
+After a build, the generated reports can be browsed through
+`reports/index.html`.
+
+## Test summary
+
+- Test result: 3397 passed in 9s
+- No flake8 warnings.
+- No mypy errors found.
+- Built version(s): 0.1
+- Build and test using Python 3.14.3

config_as_json-0.1/README_pypi.md

@@ -0,0 +1,77 @@
+# config-as-json
+
+`config-as-json` helps an application keep its configuration schema in a
+Python class while storing actual configuration data in JSON files.
+
+The intended usage model is:
+
+- Derive an application-specific class from `config_as_json.Config`.
+- Add one instance attribute per supported configuration parameter. An
+  instance attribute can also be a dict or list, optionally with nested
+  dicts and lists.
+- Let the values assigned in the derived constructor act as the default
+  configuration.
+- Use the library to write those defaults as JSON and to read JSON back into
+  the derived configuration object.
+
+The library is designed to support evolving configuration formats by letting
+applications define:
+
+- custom parsers for values that should become richer Python types
+- optional keys that receive default values when omitted
+- backward-compatible key renames for older configuration files
+- hooks that can warn or report when automatic compatibility changes were
+  needed
+
+## Installation
+
+`config-as-json` requires Python 3.12 or newer.
+
+```sh
+pip install --upgrade config-as-json
+```
+
+## Main entry points
+
+- `config_as_json.Config`
+  Base class for JSON-backed configuration objects.
+- `config_as_json.config_factory_from_json`
+  Select the correct configuration class by inspecting JSON input.
+- `config_as_json.ConfigAutoChangeHook`
+  Receive notifications about automatic changes during parsing.
+- `config_as_json.MigrateCfgWarnHook`
+  Warn when backward compatibility was used.
+- `config_as_json.migrate_cfg`
+  Read an older configuration file and write it back in the newest supported
+  format.
+
+The generated API reference also shows the implementation modules where these
+public objects are defined.
+
+## Documentation and examples
+
+- Example directory: [example/src/example/README.md](https://bitbucket.org/tom-bjorkholm/config_as_json/src/master/example/src/example/README.md)
+- Public API notes: [doc/api.md](https://bitbucket.org/tom-bjorkholm/config_as_json/src/master/doc/api.md)
+- Protected/internal API notes: [doc/protected_api.md](https://bitbucket.org/tom-bjorkholm/config_as_json/src/master/doc/protected_api.md)
+- Source repository: [config_as_json](https://bitbucket.org/tom-bjorkholm/config_as_json/)
+
+The example directory contains worked examples for new users. It is not
+included in the package installed from PyPI.
+
+## Project status
+
+This package originated as configuration code from a larger application and
+has been refactored into a stand-alone reusable library. The public API
+reference and worked examples are maintained in the source repository.
+
+## License
+
+MIT
+
+## Test summary
+
+- Test result: 3397 passed in 9s
+- No flake8 warnings.
+- No mypy errors found.
+- Built version(s): 0.1
+- Build and test using Python 3.14.3

config_as_json-0.1/config_as_json.egg-info/PKG-INFO

@@ -0,0 +1,98 @@
+Metadata-Version: 2.4
+Name: config-as-json
+Version: 0.1
+Summary: Read, write, validate, and migrate JSON-backed config classes.
+Author: Tom Björkholm
+Author-email: Tom Björkholm <klausuler_linnet0q@icloud.com>
+License-Expression: MIT
+Project-URL: Source code, https://bitbucket.org/tom-bjorkholm/config_as_json/
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Requires-Dist: setuptools>=82.0.1
+Requires-Dist: build>=1.4.2
+Requires-Dist: wheel>=0.46.3
+Dynamic: author
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+
+# config-as-json
+
+`config-as-json` helps an application keep its configuration schema in a
+Python class while storing actual configuration data in JSON files.
+
+The intended usage model is:
+
+- Derive an application-specific class from `config_as_json.Config`.
+- Add one instance attribute per supported configuration parameter. An
+  instance attribute can also be a dict or list, optionally with nested
+  dicts and lists.
+- Let the values assigned in the derived constructor act as the default
+  configuration.
+- Use the library to write those defaults as JSON and to read JSON back into
+  the derived configuration object.
+
+The library is designed to support evolving configuration formats by letting
+applications define:
+
+- custom parsers for values that should become richer Python types
+- optional keys that receive default values when omitted
+- backward-compatible key renames for older configuration files
+- hooks that can warn or report when automatic compatibility changes were
+  needed
+
+## Installation
+
+`config-as-json` requires Python 3.12 or newer.
+
+```sh
+pip install --upgrade config-as-json
+```
+
+## Main entry points
+
+- `config_as_json.Config`
+  Base class for JSON-backed configuration objects.
+- `config_as_json.config_factory_from_json`
+  Select the correct configuration class by inspecting JSON input.
+- `config_as_json.ConfigAutoChangeHook`
+  Receive notifications about automatic changes during parsing.
+- `config_as_json.MigrateCfgWarnHook`
+  Warn when backward compatibility was used.
+- `config_as_json.migrate_cfg`
+  Read an older configuration file and write it back in the newest supported
+  format.
+
+The generated API reference also shows the implementation modules where these
+public objects are defined.
+
+## Documentation and examples
+
+- Example directory: [example/src/example/README.md](https://bitbucket.org/tom-bjorkholm/config_as_json/src/master/example/src/example/README.md)
+- Public API notes: [doc/api.md](https://bitbucket.org/tom-bjorkholm/config_as_json/src/master/doc/api.md)
+- Protected/internal API notes: [doc/protected_api.md](https://bitbucket.org/tom-bjorkholm/config_as_json/src/master/doc/protected_api.md)
+- Source repository: [config_as_json](https://bitbucket.org/tom-bjorkholm/config_as_json/)
+
+The example directory contains worked examples for new users. It is not
+included in the package installed from PyPI.
+
+## Project status
+
+This package originated as configuration code from a larger application and
+has been refactored into a stand-alone reusable library. The public API
+reference and worked examples are maintained in the source repository.
+
+## License
+
+MIT
+
+## Test summary
+
+- Test result: 3397 passed in 9s
+- No flake8 warnings.
+- No mypy errors found.
+- Built version(s): 0.1
+- Build and test using Python 3.14.3

config_as_json-0.1/config_as_json.egg-info/SOURCES.txt

@@ -0,0 +1,27 @@
+LICENSE.txt
+README.md
+README_pypi.md
+pyproject.toml
+setup.py
+config_as_json.egg-info/PKG-INFO
+config_as_json.egg-info/SOURCES.txt
+config_as_json.egg-info/dependency_links.txt
+config_as_json.egg-info/requires.txt
+config_as_json.egg-info/top_level.txt
+src/config_as_json/__init__.py
+src/config_as_json/assert_dict_equal.py
+src/config_as_json/commontypes.py
+src/config_as_json/config.py
+src/config_as_json/config_auto_change_hook.py
+src/config_as_json/config_factory.py
+src/config_as_json/dict_validators.py
+src/config_as_json/discriminated_dict_validators.py
+src/config_as_json/file_extension.py
+src/config_as_json/file_must_exist.py
+src/config_as_json/list_validators.py
+src/config_as_json/migrate_cfg.py
+src/config_as_json/migrate_cfg_warn_hook.py
+src/config_as_json/projected_validators.py
+src/config_as_json/py.typed
+src/config_as_json/str_to_enum.py
+src/config_as_json/validator.py

config_as_json-0.1/config_as_json.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

config_as_json-0.1/config_as_json.egg-info/requires.txt

@@ -0,0 +1,3 @@
+setuptools>=82.0.1
+build>=1.4.2
+wheel>=0.46.3

config_as_json-0.1/config_as_json.egg-info/top_level.txt

@@ -0,0 +1 @@
+config_as_json

config_as_json-0.1/pyproject.toml

@@ -0,0 +1,24 @@
+[build-system]
+requires = ["setuptools"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "config-as-json"
+version = "0.1"
+authors = [
+  { name="Tom Björkholm", email="klausuler_linnet0q@icloud.com" },
+]
+description = "Read, write, validate, and migrate JSON-backed config classes."
+readme = "README_pypi.md"
+requires-python = ">=3.12"
+license = "MIT"
+license-files = ["LICENSE.txt"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent"
+]
+dynamic = ["dependencies"]
+
+[project.urls]
+"Source code" = "https://bitbucket.org/tom-bjorkholm/config_as_json/"
+

config_as_json-0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

config_as_json-0.1/setup.py

@@ -0,0 +1,21 @@
+#! /usr/local/bin/python3
+"""Setup file specifying build of .whl."""
+
+from setuptools import setup  # type: ignore[import-untyped]
+
+setup(
+  name='config-as-json',
+  version='0.1',
+  description='Read, write, validate, and migrate JSON-backed config classes.',
+  author='Tom Björkholm',
+  author_email='klausuler_linnet0q@icloud.com',
+  python_requires='>=3.12',
+  packages=['config_as_json'],
+  package_dir={'config_as_json': 'src/config_as_json'},
+  package_data={'config_as_json': ['py.typed']},
+  install_requires=[
+    'setuptools >= 82.0.1',
+    'build >= 1.4.2',
+    'wheel >= 0.46.3',
+  ]
+)

config_as_json-0.1/src/config_as_json/__init__.py

@@ -0,0 +1,74 @@
+#! /usr/local/bin/python3
+"""Define application configuration classes that serialize to JSON.
+
+The package centers on :class:`config_as_json.config.Config`. Applications
+derive their own configuration classes, declare supported settings as
+instance attributes, and use the library to read, validate, migrate, and
+write JSON configuration files.
+"""
+
+# Copyright (c) 2026 Tom Björkholm
+# MIT License
+
+
+from config_as_json.config import Config, BackwardCompatible, ConfigBadJson, \
+    ParseConverter
+from config_as_json.commontypes import JsonType, PathOrStr
+from config_as_json.config_factory import config_factory_from_json, \
+    MatchConfig, MatchConfigSeq, JsonValueMatcher
+from config_as_json.config_auto_change_hook import ConfigAutoChangeHook
+from config_as_json.migrate_cfg_warn_hook import MigrateCfgWarnHook
+from config_as_json.migrate_cfg import migrate_cfg
+from config_as_json.validator import ValidationPlan, ValidationStep, \
+    WholeConfigValidationStep, MemberValidationStep, WholeConfigValidator, \
+    MemberValidator, StrValidator, IntFloatValidator, string_best_match, \
+    InvalidConfiguration, InvalidConfigurationValue
+from config_as_json.list_validators import ListValueValidator, \
+    ListSizeValidator, ListIsOrderedValidator, ListOrderingValidator, \
+    ListForEachValidator
+from config_as_json.dict_validators import DictKeysValidator, DictRule, \
+    DictForEachValidator
+from config_as_json.discriminated_dict_validators import DictVariant, \
+    DiscriminatedDictValidator
+from config_as_json.projected_validators import ProjectedMemberValidator
+from config_as_json.str_to_enum import string_to_enum_best_match
+from config_as_json.assert_dict_equal import assert_dict_equal
+
+
+__all__ = ['Config',
+           'BackwardCompatible',
+           'ConfigBadJson',
+           'JsonType',
+           'PathOrStr',
+           'ParseConverter',
+           'ConfigAutoChangeHook',
+           'MigrateCfgWarnHook',
+           'migrate_cfg',
+           'config_factory_from_json',
+           'MatchConfig',
+           'MatchConfigSeq',
+           'JsonValueMatcher',
+           'ValidationPlan',
+           'ValidationStep',
+           'WholeConfigValidationStep',
+           'MemberValidationStep',
+           'WholeConfigValidator',
+           'MemberValidator',
+           'StrValidator',
+           'IntFloatValidator',
+           'string_best_match',
+           'string_to_enum_best_match',
+           'InvalidConfiguration',
+           'InvalidConfigurationValue',
+           'ListValueValidator',
+           'ListSizeValidator',
+           'ListIsOrderedValidator',
+           'ListOrderingValidator',
+           'ListForEachValidator',
+           'DictKeysValidator',
+           'DictRule',
+           'DictForEachValidator',
+           'DictVariant',
+           'DiscriminatedDictValidator',
+           'ProjectedMemberValidator',
+           'assert_dict_equal']

config_as_json-0.1/src/config_as_json/assert_dict_equal.py

@@ -0,0 +1,82 @@
+#! /usr/local/bin/python3
+"""Compare mapping objects while ignoring selected keys.
+
+This primarily exists as a tool for developers of applications that use
+configuration classes derived from ``Config``.
+It is also useful in test code that wants a readable failure message
+before asserting equality of configuration objects in applications that
+use the library.
+"""
+
+# Copyright (c) 2024-2026 Tom Björkholm
+# MIT License
+
+from typing import Mapping, TextIO
+import sys
+
+
+def _print_dict_differs(msg: str, lhs: Mapping[str, object],
+                        rhs: Mapping[str, object],
+                        stderr_file: TextIO = sys.stderr) -> None:
+    """Print a detailed mismatch report to standard error.
+
+    Args:
+        msg: Summary of the mismatch that was detected.
+        lhs: Left-hand mapping after any ignored keys were removed.
+        rhs: Right-hand mapping after any ignored keys were removed.
+        stderr_file: Stream used for diagnostics. Defaults to ``sys.stderr``.
+    """
+    print(f'{msg}\n' +
+          f'Number of keys in left dict: {len(lhs)}\n' +
+          f'Number of keys in right dict: {len(rhs)}\n' +
+          f' left dict: {str(lhs)}\nright dict: {str(rhs)}',
+          file=stderr_file)
+
+
+def assert_dict_equal(lhs: Mapping[str, object], rhs: Mapping[str, object],
+                      ignorekeys: list[str],
+                      stderr_file: TextIO = sys.stderr) -> None:
+    """Assert that two mappings are equal after ignoring selected keys.
+
+    The function makes defensive copies, removes any keys listed in
+    ``ignorekeys`` from both sides, prints a readable difference report when
+    a mismatch is detected, and finally raises ``AssertionError`` through the
+    normal ``assert`` statements.
+
+    Args:
+        lhs: Left-hand mapping to compare.
+        rhs: Right-hand mapping to compare.
+        ignorekeys: Keys to drop from both mappings before comparison.
+        stderr_file: Stream used for diagnostics. Defaults to ``sys.stderr``.
+
+    Raises:
+        AssertionError: The mappings do not match after ignored keys have been
+                        removed.
+    """
+    lhs_val = dict(lhs)
+    rhs_val = dict(rhs)
+    assert isinstance(lhs_val, dict)
+    assert isinstance(rhs_val, dict)
+    for key in ignorekeys:
+        if key in lhs_val:
+            del lhs_val[key]
+        if key in rhs_val:
+            del rhs_val[key]
+    if len(lhs_val) != len(rhs_val):
+        _print_dict_differs('Different number of keys in dicts',
+                            lhs_val, rhs_val, stderr_file)
+    assert len(lhs_val) == len(rhs_val)
+    for key, value in lhs_val.items():
+        if key not in rhs_val:
+            _print_dict_differs(f'Key "{key}" exist only in left dict.',
+                                lhs_val, rhs_val, stderr_file)
+            assert key in rhs_val
+        if value != rhs_val[key]:
+            txt = f'Key "{key}" has different values in left and right\n'
+            txt += f' left[{key}] = {value}\n'
+            txt += f'right[{key}] = {rhs_val[key]}\n'
+            _print_dict_differs(txt, lhs_val, rhs_val, stderr_file)
+        assert value == rhs_val[key]
+    if lhs_val != rhs_val:  # pragma: no cover
+        _print_dict_differs('Dicts differ', lhs_val, rhs_val, stderr_file)
+    assert lhs_val == rhs_val