Adding asyncio unit tests

[bradpenney]

Summary

• Expand CLI test coverage to validate logging setup plus every custom click.ParamType, including new negative cases and alias checks.
• Add resource loader tests for JSON/YAML, $ref resolution, and validation errors, alongside _jsonloader URI normalization.
• Bring new tests into pylint compliance and document the required lint/coverage workflow for contributors.
• Update contributor guidance to mandate Python 3.12+, local lint + coverage runs, and explain how (and when) to call module-private helpers.

[bradpenney]

pytest --cov=firestone_lib test/ --cov-report term-missing   
======================================= test session starts ========================================
platform linux -- Python 3.14.0, pytest-8.3.5, pluggy-1.5.0
rootdir: /home/brad/Documents/firestoned/firestone-lib
configfile: pyproject.toml
plugins: mock-3.14.0, cov-7.0.0
collected 36 items                                                                                 

test/test_cli.py ..........................                                                  [ 72%]
test/test_resource.py .....                                                                  [ 86%]
test/test_utils.py .....                                                                     [100%]

========================================== tests coverage ==========================================
_________________________ coverage: platform linux, python 3.14.0-final-0 __________________________

Name                                          Stmts   Miss  Cover   Missing
---------------------------------------------------------------------------
firestone_lib/__init__.py                         0      0   100%
firestone_lib/cli.py                            112      0   100%
firestone_lib/resource.py                        34      0   100%
firestone_lib/resources/__init__.py               0      0   100%
firestone_lib/resources/logging/__init__.py       0      0   100%
firestone_lib/utils.py                           16      0   100%
---------------------------------------------------------------------------
TOTAL                                           162      0   100%
======================================== 36 passed in 0.12s ========================================

  ~/Doc/f/firestone-lib on   adding-asyncio-unit-tests      firestone-lib-py3.14 at  14:56:27
❯ pylint .                                                     

--------------------------------------------------------------------
Your code has been rated at 10.00/10 (previous run: 10.00/10, +0.00)

[ebourgeois]

Why is this needed?

[bradpenney]

• _jsonloader now strips file:// URIs with uri[7:] and adds a fallback for plain file: . The old slice uri[8:] lopped off the first character of absolute paths like file:///tmp/schema.yaml, so jsonref tried to open tmp/schema.yaml relative to CWD and crashed whenever a schema contained $refs to other local files or when tests exercised those paths.
• Guarding the plain file: case lets jsonref hand us either file:///... or file:/... and still resolves correctly, which is how coverage tests trigger the loader.
• With this correction, nested schema references load reliably whether they arrive with file: or file:// URIs, eliminating the FileNotFound errors seen in test runs.

[ebourgeois]

Please update the builds to match these new python version constraints

[bradpenney]

Please update the builds to match these new python version constraints

Done! https://github.com/firestoned/firestone-lib/actions/runs/18824634843

[ebourgeois]

gtg