fix: usr: make sure github can see the license, add tox files, update reuse

Signed-off-by: Stephen L Arnold <sarnold@vctlabs.com>

Author: sarnold

LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) <year> <copyright holders>
+
+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.

LICENSE

@@ -0,0 +1 @@
+../LICENSE

LICENSES/MIT.txt

@@ -6,3 +6,8 @@ SPDX-FileCopyrightText = [
     "2025 Stephen Arnold <sarnold@vctlabs.com>",
 ]
 SPDX-License-Identifier = "MIT"
+
+[[annotations]]
+path = "toxfile.py"
+SPDX-FileCopyrightText = "Copyright (c) 2023 Masen Furer"
+SPDX-License-Identifier = "MIT"

LICENSES/MIT.txt

@@ -0,0 +1,104 @@
+[tox]
+envlist = sync,do,dev,changes,clean
+skip_missing_interpreters = true
+isolated_build = true
+skipsdist = true
+
+[base]
+deps =
+    pip>=22.1
+
+[testenv]
+skip_install = true
+install_command = pip install {opts} {packages}
+
+[testenv:{sync,do}]
+envdir = {toxinidir}/.sync
+# these 2 tox env cmds share a virtual env using the following plugin
+# https://github.com/masenf/tox-ignore-env-name-mismatch
+runner = ignore_env_name_mismatch
+
+description =
+    do: Run cmd following "--" from .sync environment, e.g. "tox -e do -- repolite --show"
+    sync: Install repolite and use it for cloning worflow deps
+
+passenv =
+    REPO_CFG
+    DISPLAY
+    XAUTHORITY
+    HOME
+    USERNAME
+    USER
+    CI
+    LANG
+    LC_COLLATE
+    SSH_*
+    GID
+    UID
+    XDG_*
+    PYTHONIOENCODING
+    PIP_DOWNLOAD_CACHE
+
+deps =
+    # logging_tree
+    {[base]deps}
+    -r requirements-sync.txt
+
+commands =
+    sync: repolite {posargs:--quiet}
+    do: {posargs:python -c 'print("No cmd provided")'}
+
+[testenv:dev]
+envdir = {toxinidir}/.venv
+
+description =
+    Create a devel .venv with repolite-managed deps
+
+passenv =
+    DISPLAY
+    XAUTHORITY
+    HOME
+    USERNAME
+    USER
+    CI
+    LANG
+    LC_COLLATE
+    SSH_*
+    GID
+    UID
+    XDG_*
+    PYTHONIOENCODING
+    PIP_DOWNLOAD_CACHE
+
+deps =
+    # logging_tree
+    {[base]deps}
+    reuse
+
+commands =
+    reuse {posargs:"lint"}
+
+[testenv:changes]
+skip_install = true
+always_copy = False
+
+allowlist_externals =
+    bash
+
+deps =
+    {[base]deps}
+    gitchangelog @ https://github.com/sarnold/gitchangelog/releases/download/3.2.0/gitchangelog-3.2.0-py3-none-any.whl
+
+commands =
+    bash -c 'gitchangelog {posargs} > CHANGELOG.rst'
+
+[testenv:clean]
+skip_install = true
+allowlist_externals =
+    bash
+
+deps =
+    pip>=21.1
+
+commands =
+    bash -c 'rm -rf ext/*/dist ext/*/build __pycache__'

REUSE.toml

@@ -0,0 +1,77 @@
+"""
+https://github.com/masenf/tox-ignore-env-name-mismatch
+
+MIT License
+Copyright (c) 2023 Masen Furer
+"""
+from contextlib import contextmanager
+from typing import Any, Iterator, Optional, Sequence, Tuple
+
+from tox.plugin import impl
+from tox.tox_env.api import ToxEnv
+from tox.tox_env.info import Info
+from tox.tox_env.python.virtual_env.runner import VirtualEnvRunner
+from tox.tox_env.register import ToxEnvRegister
+
+
+class FilteredInfo(Info):
+    """Subclass of Info that optionally filters specific keys during compare()."""
+
+    def __init__(
+        self,
+        *args: Any,
+        filter_keys: Optional[Sequence[str]] = None,
+        filter_section: Optional[str] = None,
+        **kwargs: Any,
+    ):
+        """
+        :param filter_keys: key names to pop from value
+        :param filter_section: if specified, only pop filter_keys when the compared section matches
+
+        All other args and kwargs are passed to super().__init__
+        """
+        self.filter_keys = filter_keys
+        self.filter_section = filter_section
+        super().__init__(*args, **kwargs)
+
+    @contextmanager
+    def compare(
+        self,
+        value: Any,
+        section: str,
+        sub_section: Optional[str] = None,
+    ) -> Iterator[Tuple[bool, Optional[Any]]]:
+        """Perform comparison and update cached info after filtering `value`."""
+        if self.filter_section is None or section == self.filter_section:
+            try:
+                value = value.copy()
+            except AttributeError:  # pragma: no cover
+                pass
+            else:
+                for fkey in self.filter_keys or []:
+                    value.pop(fkey, None)
+        with super().compare(value, section, sub_section) as rv:
+            yield rv
+
+
+class IgnoreEnvNameMismatchVirtualEnvRunner(VirtualEnvRunner):
+    """EnvRunner that does NOT save the env name as part of the cached info."""
+
+    @staticmethod
+    def id() -> str:
+        return "ignore_env_name_mismatch"
+
+    @property
+    def cache(self) -> Info:
+        """Return a modified Info class that does NOT pass "name" key to `Info.compare`."""
+        return FilteredInfo(
+            self.env_dir,
+            filter_keys=["name"],
+            filter_section=ToxEnv.__name__,
+        )
+
+
+@impl
+def tox_register_tox_env(register: ToxEnvRegister) -> None:
+    """tox4 entry point: add IgnoreEnvNameMismatchVirtualEnvRunner to registry."""
+    register.add_run_env(IgnoreEnvNameMismatchVirtualEnvRunner)