wexample-wex-addon-dev-python 0.0.64__tar.gz → 0.1.1__tar.gz

wexample_wex_addon_dev_python-0.1.1/PKG-INFO

@@ -0,0 +1,177 @@
+Metadata-Version: 2.1
+Name: wexample-wex-addon-dev-python
+Version: 0.1.1
+Summary: Python dev addon for wex
+Author-Email: weeger <contact@wexample.com>
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Project-URL: homepage, https://github.com/wexample/python-wex-dev-python
+Requires-Python: >=3.10
+Requires-Dist: attrs>=23.1.0
+Requires-Dist: cattrs>=23.1.0
+Requires-Dist: griffe>=2.0.2
+Requires-Dist: networkx
+Requires-Dist: pylint
+Requires-Dist: pyright
+Requires-Dist: wexample-filestate-python>=0.1.0
+Requires-Dist: wexample-wex-addon-app>=1.1.0
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Description-Content-Type: text/markdown
+
+# wex_addon_dev_python
+
+Version: 0.1.1
+
+Python dev addon for wex
+
+## Table of Contents
+
+- [Tests](#tests)
+- [Suite Integration](#suite-integration)
+- [Dependencies](#dependencies)
+- [Versioning](#versioning)
+- [License](#license)
+- [Suite Integration](#suite-integration)
+- [Suite Signature](#suite-signature)
+- [Roadmap](#roadmap)
+- [Status Compatibility](#status-compatibility)
+- [Useful Links](#useful-links)
+- [Migration Notes](#migration-notes)
+
+## Tests
+
+This project uses `pytest` for testing and `pytest-cov` for code coverage analysis.
+
+### Installation
+
+First, install the required testing dependencies:
+```bash
+.venv/bin/python -m pip install pytest pytest-cov
+```
+
+### Basic Usage
+
+Run all tests with coverage:
+```bash
+.venv/bin/python -m pytest --cov --cov-report=html
+```
+
+### Common Commands
+```bash
+# Run tests with coverage for a specific module
+.venv/bin/python -m pytest --cov=your_module
+
+# Show which lines are not covered
+.venv/bin/python -m pytest --cov=your_module --cov-report=term-missing
+
+# Generate an HTML coverage report
+.venv/bin/python -m pytest --cov=your_module --cov-report=html
+
+# Combine terminal and HTML reports
+.venv/bin/python -m pytest --cov=your_module --cov-report=term-missing --cov-report=html
+
+# Run specific test file with coverage
+.venv/bin/python -m pytest tests/test_file.py --cov=your_module --cov-report=term-missing
+```
+
+### Viewing HTML Reports
+
+After generating an HTML report, open `htmlcov/index.html` in your browser to view detailed line-by-line coverage information.
+
+### Coverage Threshold
+
+To enforce a minimum coverage percentage:
+```bash
+.venv/bin/python -m pytest --cov=your_module --cov-fail-under=80
+```
+
+This will cause the test suite to fail if coverage drops below 80%.
+
+## Integration in the Suite
+
+This package is part of the Wexample Suite — a collection of high-quality, modular tools designed to work seamlessly together across multiple languages and environments.
+
+### Related Packages
+
+The suite includes packages for configuration management, file handling, prompts, and more. Each package can be used independently or as part of the integrated suite.
+
+Visit the [Wexample Suite documentation](https://docs.wexample.com) for the complete package ecosystem.
+
+## Dependencies
+
+- attrs: >=23.1.0
+- cattrs: >=23.1.0
+- griffe: >=2.0.2
+- networkx: 
+- pylint: 
+- pyright: 
+- wexample-filestate-python: >=0.1.0
+- wexample-wex-addon-app: >=1.1.0
+
+## Versioning & Compatibility Policy
+
+Wexample packages follow **Semantic Versioning** (SemVer):
+
+- **MAJOR**: Breaking changes
+- **MINOR**: New features, backward compatible
+- **PATCH**: Bug fixes, backward compatible
+
+We maintain backward compatibility within major versions and provide clear migration guides for breaking changes.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+Free to use in both personal and commercial projects.
+
+## Integration in the Suite
+
+This package is part of the Wexample Suite — a collection of high-quality, modular tools designed to work seamlessly together across multiple languages and environments.
+
+### Related Packages
+
+The suite includes packages for configuration management, file handling, prompts, and more. Each package can be used independently or as part of the integrated suite.
+
+Visit the [Wexample Suite documentation](https://docs.wexample.com) for the complete package ecosystem.
+
+# About us
+
+[Wexample](https://wexample.com) stands as a cornerstone of the digital ecosystem — a collective of seasoned engineers, researchers, and creators driven by a relentless pursuit of technological excellence. More than a media platform, it has grown into a vibrant community where innovation meets craftsmanship, and where every line of code reflects a commitment to clarity, durability, and shared intelligence.
+
+This packages suite embodies this spirit. Trusted by professionals and enthusiasts alike, it delivers a consistent, high-quality foundation for modern development — open, elegant, and battle-tested. Its reputation is built on years of collaboration, refinement, and rigorous attention to detail, making it a natural choice for those who demand both robustness and beauty in their tools.
+
+Wexample cultivates a culture of mastery. Each package, each contribution carries the mark of a community that values precision, ethics, and innovation — a community proud to shape the future of digital craftsmanship.
+
+## Known Limitations & Roadmap
+
+Current limitations and planned features are tracked in the GitHub issues.
+
+See the [project roadmap](https://github.com/wexample/python-wex_addon_dev_python/issues) for upcoming features and improvements.
+
+## Status & Compatibility
+
+**Maturity**: Production-ready
+
+**Python Support**: >=3.10
+
+**OS Support**: Linux, macOS, Windows
+
+**Status**: Actively maintained
+
+## Useful Links
+
+- **Homepage**: https://github.com/wexample/python-wex-addon-dev-python
+- **Documentation**: [docs.wexample.com](https://docs.wexample.com)
+- **Issue Tracker**: https://github.com/wexample/python-wex-addon-dev-python/issues
+- **Discussions**: https://github.com/wexample/python-wex-addon-dev-python/discussions
+- **PyPI**: [pypi.org/project/wex_addon_dev_python](https://pypi.org/project/wex_addon_dev_python/)
+
+## Migration Notes
+
+When upgrading between major versions, refer to the migration guides in the documentation.
+
+Breaking changes are clearly documented with upgrade paths and examples.

wexample_wex_addon_dev_python-0.1.1/README.md

@@ -0,0 +1,153 @@
+# wex_addon_dev_python
+
+Version: 0.1.1
+
+Python dev addon for wex
+
+## Table of Contents
+
+- [Tests](#tests)
+- [Suite Integration](#suite-integration)
+- [Dependencies](#dependencies)
+- [Versioning](#versioning)
+- [License](#license)
+- [Suite Integration](#suite-integration)
+- [Suite Signature](#suite-signature)
+- [Roadmap](#roadmap)
+- [Status Compatibility](#status-compatibility)
+- [Useful Links](#useful-links)
+- [Migration Notes](#migration-notes)
+
+## Tests
+
+This project uses `pytest` for testing and `pytest-cov` for code coverage analysis.
+
+### Installation
+
+First, install the required testing dependencies:
+```bash
+.venv/bin/python -m pip install pytest pytest-cov
+```
+
+### Basic Usage
+
+Run all tests with coverage:
+```bash
+.venv/bin/python -m pytest --cov --cov-report=html
+```
+
+### Common Commands
+```bash
+# Run tests with coverage for a specific module
+.venv/bin/python -m pytest --cov=your_module
+
+# Show which lines are not covered
+.venv/bin/python -m pytest --cov=your_module --cov-report=term-missing
+
+# Generate an HTML coverage report
+.venv/bin/python -m pytest --cov=your_module --cov-report=html
+
+# Combine terminal and HTML reports
+.venv/bin/python -m pytest --cov=your_module --cov-report=term-missing --cov-report=html
+
+# Run specific test file with coverage
+.venv/bin/python -m pytest tests/test_file.py --cov=your_module --cov-report=term-missing
+```
+
+### Viewing HTML Reports
+
+After generating an HTML report, open `htmlcov/index.html` in your browser to view detailed line-by-line coverage information.
+
+### Coverage Threshold
+
+To enforce a minimum coverage percentage:
+```bash
+.venv/bin/python -m pytest --cov=your_module --cov-fail-under=80
+```
+
+This will cause the test suite to fail if coverage drops below 80%.
+
+## Integration in the Suite
+
+This package is part of the Wexample Suite — a collection of high-quality, modular tools designed to work seamlessly together across multiple languages and environments.
+
+### Related Packages
+
+The suite includes packages for configuration management, file handling, prompts, and more. Each package can be used independently or as part of the integrated suite.
+
+Visit the [Wexample Suite documentation](https://docs.wexample.com) for the complete package ecosystem.
+
+## Dependencies
+
+- attrs: >=23.1.0
+- cattrs: >=23.1.0
+- griffe: >=2.0.2
+- networkx: 
+- pylint: 
+- pyright: 
+- wexample-filestate-python: >=0.1.0
+- wexample-wex-addon-app: >=1.1.0
+
+## Versioning & Compatibility Policy
+
+Wexample packages follow **Semantic Versioning** (SemVer):
+
+- **MAJOR**: Breaking changes
+- **MINOR**: New features, backward compatible
+- **PATCH**: Bug fixes, backward compatible
+
+We maintain backward compatibility within major versions and provide clear migration guides for breaking changes.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+Free to use in both personal and commercial projects.
+
+## Integration in the Suite
+
+This package is part of the Wexample Suite — a collection of high-quality, modular tools designed to work seamlessly together across multiple languages and environments.
+
+### Related Packages
+
+The suite includes packages for configuration management, file handling, prompts, and more. Each package can be used independently or as part of the integrated suite.
+
+Visit the [Wexample Suite documentation](https://docs.wexample.com) for the complete package ecosystem.
+
+# About us
+
+[Wexample](https://wexample.com) stands as a cornerstone of the digital ecosystem — a collective of seasoned engineers, researchers, and creators driven by a relentless pursuit of technological excellence. More than a media platform, it has grown into a vibrant community where innovation meets craftsmanship, and where every line of code reflects a commitment to clarity, durability, and shared intelligence.
+
+This packages suite embodies this spirit. Trusted by professionals and enthusiasts alike, it delivers a consistent, high-quality foundation for modern development — open, elegant, and battle-tested. Its reputation is built on years of collaboration, refinement, and rigorous attention to detail, making it a natural choice for those who demand both robustness and beauty in their tools.
+
+Wexample cultivates a culture of mastery. Each package, each contribution carries the mark of a community that values precision, ethics, and innovation — a community proud to shape the future of digital craftsmanship.
+
+## Known Limitations & Roadmap
+
+Current limitations and planned features are tracked in the GitHub issues.
+
+See the [project roadmap](https://github.com/wexample/python-wex_addon_dev_python/issues) for upcoming features and improvements.
+
+## Status & Compatibility
+
+**Maturity**: Production-ready
+
+**Python Support**: >=3.10
+
+**OS Support**: Linux, macOS, Windows
+
+**Status**: Actively maintained
+
+## Useful Links
+
+- **Homepage**: https://github.com/wexample/python-wex-addon-dev-python
+- **Documentation**: [docs.wexample.com](https://docs.wexample.com)
+- **Issue Tracker**: https://github.com/wexample/python-wex-addon-dev-python/issues
+- **Discussions**: https://github.com/wexample/python-wex-addon-dev-python/discussions
+- **PyPI**: [pypi.org/project/wex_addon_dev_python](https://pypi.org/project/wex_addon_dev_python/)
+
+## Migration Notes
+
+When upgrading between major versions, refer to the migration guides in the documentation.
+
+Breaking changes are clearly documented with upgrade paths and examples.

{wexample_wex_addon_dev_python-0.0.64 → wexample_wex_addon_dev_python-0.1.1}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "pdm.backend"
 
 [project]
 name = "wexample-wex-addon-dev-python"
-version = "0.0.64"
+version = "0.1.1"
 description = "Python dev addon for wex"
 authors = [
     { name = "weeger", email = "contact@wexample.com" },
@@ -20,11 +20,12 @@ classifiers = [
 dependencies = [
     "attrs>=23.1.0",
     "cattrs>=23.1.0",
+    "griffe>=2.0.2",
     "networkx",
     "pylint",
     "pyright",
-    "wexample-filestate-python==0.0.59",
-    "wexample-wex-addon-app==0.0.56",
+    "wexample-filestate-python>=0.1.0",
+    "wexample-wex-addon-app>=1.1.0",
 ]
 
 [project.readme]

wexample_wex_addon_dev_python-0.1.1/src/wexample_wex_addon_dev_python/resources/package_publish_gitlab.yml

@@ -0,0 +1,8 @@
+publish:
+  stage: deploy
+  image: python:3.12-slim
+  script:
+    - pip install pdm --quiet
+    - pdm publish --repository "${CI_API_V4_URL}/projects/${CI_PROJECT_ID}/packages/pypi" --username gitlab-ci-token --password "${CI_JOB_TOKEN}"
+  rules:
+    - if: '$CI_COMMIT_TAG =~ /^v[0-9]+\.[0-9]+\.[0-9]+$/'

{wexample_wex_addon_dev_python-0.0.64 → wexample_wex_addon_dev_python-0.1.1}/src/wexample_wex_addon_dev_python/workdir/python_package_workdir.py

@@ -27,10 +27,34 @@ class PythonPackageWorkdir(PythonWorkdir):
 
     def prepare_value(self, raw_value: DictConfig | None = None) -> DictConfig:
         from wexample_helpers.helpers.array import array_dict_get_by
+        from wexample_helpers.helpers.file import file_read
+        from wexample_helpers.helpers.module import module_get_path
+
+        import wexample_wex_addon_dev_python
 
         raw_value = super().prepare_value(raw_value=raw_value)
         children = raw_value.get("children")
 
+        # Add .gitlab-ci.yml for private GitLab registry packages.
+        # Both callbacks are evaluated after configure() completes, so base_name
+        # and runtime config are fully available at that point.
+        children.append(
+            {
+                "name": ".gitlab-ci.yml",
+                "type": DiskItemType.FILE,
+                "should_exist": lambda _target, _self=self: bool(
+                    _self.search_app_or_suite_runtime_config(
+                        "pdm.repository.url", default=None
+                    ).get_str_or_none()
+                ),
+                "content": lambda _: file_read(
+                    module_get_path(wexample_wex_addon_dev_python)
+                    / "resources"
+                    / "package_publish_gitlab.yml"
+                ),
+            }
+        )
+
         children.append(
             {
                 "name": "examples",
@@ -139,6 +163,42 @@ class PythonPackageWorkdir(PythonWorkdir):
 
         return found
 
+    def _classify_version_bump(self, last_tag: str) -> str:
+        from wexample_helpers.const.types import (
+            UPGRADE_TYPE_INTERMEDIATE,
+            UPGRADE_TYPE_MAJOR,
+            UPGRADE_TYPE_MINOR,
+        )
+        from wexample_helpers_git.helpers.git import git_has_changes_since_tag
+
+        if not git_has_changes_since_tag(last_tag, "src", cwd=self.get_path()):
+            return UPGRADE_TYPE_MINOR
+
+        try:
+            import griffe
+
+            module_name = self.get_package_name().replace("-", "_")
+            repo_path = str(self.get_path())
+
+            previous = griffe.load_git(
+                module_name,
+                ref=last_tag,
+                repo=repo_path,
+                search_paths=["src"],
+            )
+            current = griffe.load(
+                module_name,
+                search_paths=[str(self.get_path() / "src")],
+            )
+
+            if list(griffe.find_breaking_changes(previous, current)):
+                return UPGRADE_TYPE_MAJOR
+
+            return UPGRADE_TYPE_INTERMEDIATE
+
+        except Exception:
+            return UPGRADE_TYPE_MAJOR
+
     def _collect_suite_dependencies(
         self,
         direct_dependencies: list[str],
@@ -180,6 +240,9 @@ class PythonPackageWorkdir(PythonWorkdir):
 
         return suite_deps_ordered
 
+    def _get_critical_directories(self) -> list[str]:
+        return ["src"]
+
     def _get_readme_content(self) -> ReadmeContentConfigValue | None:
         from wexample_wex_addon_dev_python.config_value.python_package_readme_config_value import (
             PythonPackageReadmeContentConfigValue,
@@ -187,7 +250,7 @@ class PythonPackageWorkdir(PythonWorkdir):
 
         return PythonPackageReadmeContentConfigValue(workdir=self)
 
-    def _get_suite_package_workdir_class(self) -> type[FrameworkPackageSuiteWorkdir]:
+    def _get_suite_workdir_class(self) -> type[FrameworkPackageSuiteWorkdir]:
         from wexample_wex_addon_dev_python.workdir.python_packages_suite_workdir import (
             PythonPackagesSuiteWorkdir,
         )
@@ -291,47 +354,56 @@ class PythonPackageWorkdir(PythonWorkdir):
     def _publish(self, force: bool = False) -> None:
         from wexample_filestate_python.common.pipy_gateway import PipyGateway
         from wexample_helpers.helpers.shell import shell_run
+        from wexample_helpers_git.helpers.git import (
+            git_push_tag,
+            git_tag_annotated,
+            git_tag_exists,
+        )
 
-        # Retrieve custom repository configuration
         repository_url = self.search_app_or_suite_runtime_config(
             "pdm.repository.url", default=None
-        )
+        ).get_str_or_none()
+
+        package_name = self.get_package_name()
+        version = self.get_project_version()
+
+        # Private GitLab registry: trigger CI by pushing a git tag
+        if repository_url:
+            remote = self._get_deployment_remote_name()
+            tag = f"v{version}"
+            cwd = self.get_path()
+
+            if git_tag_exists(tag, cwd=cwd, inherit_stdio=False):
+                self.log(f"Tag {tag} already exists, skipping creation.")
+            else:
+                git_tag_annotated(tag, f"Release {tag}", cwd=cwd, inherit_stdio=True)
+
+            git_push_tag(tag, cwd=cwd, remote=remote, inherit_stdio=True)
+            return
+
+        # TODO: align public PyPI packages with the private registry approach — publish
+        #       via a GitLab CI pipeline triggered by a git tag rather than running
+        #       `pdm publish` locally.
+        # PyPI public: publish locally
+        client = PipyGateway(parent_io_handler=self)
+        if client.package_release_exists(package_name=package_name, version=version):
+            self.warning(
+                f'Trying to publish an existing release for package "{package_name}" version {version}'
+            )
+            if not force:
+                return
 
         repository_token = self.search_app_or_suite_runtime_config(
             "pdm.repository.token", default=None
-        )
+        ).get_str_or_none()
 
         repository_username = self.search_app_or_suite_runtime_config(
             "pdm.repository.username", default="__token__"
-        )
-
-        package_name = self.get_package_name()
-        version = self.get_project_version()
+        ).get_str_or_none()
 
-        # Only check if package exists on PyPI if no custom repository is configured
-        if not repository_url:
-            client = PipyGateway(parent_io_handler=self)
-            if client.package_release_exists(
-                package_name=package_name, version=version
-            ):
-                self.warning(
-                    f'Trying to publish an existing release for package "{package_name}" version {version}'
-                )
-                if not force:
-                    return
-
-        # Build the publish command
+        self.subtitle("Publishing to PyPI")
         publish_cmd = ["pdm", "publish"]
 
-        # Add custom repository URL if provided
-        if repository_url:
-            publish_cmd += ["--repository", repository_url]
-            self.subtitle(f"Publishing to custom repository: {repository_url}")
-        else:
-            self.subtitle("Publishing to PyPI")
-
-        # Add credentials
-        # Priority: custom token > env variable fallback
         username = repository_username or "__token__"
         password = repository_token or self.get_env_parameter_or_suite_fallback(
             "PIPY_TOKEN"
@@ -343,3 +415,70 @@ class PythonPackageWorkdir(PythonWorkdir):
             publish_cmd += ["--password", password]
 
         shell_run(publish_cmd, inherit_stdio=True, cwd=self.get_path())
+
+    def _wait_for_registry(self) -> None:
+        import time
+        import urllib.error
+        import urllib.request
+
+        repository_url = self.search_app_or_suite_runtime_config(
+            "pdm.repository.url", default=None
+        ).get_str_or_none()
+
+        if not repository_url:
+            return  # PyPI public — published locally, no polling needed
+
+        token = self.search_app_or_suite_runtime_config(
+            "pdm.repository.token", default=None
+        ).get_str_or_none()
+
+        username = (
+            self.search_app_or_suite_runtime_config(
+                "pdm.repository.username", default="__token__"
+            ).get_str_or_none()
+            or "__token__"
+        )
+
+        package = self.get_package_name()
+        version = self.get_project_version()
+
+        base = repository_url.rstrip("/")
+        url = f"{base}/simple/{package}/"
+
+        max_attempts = 40
+        delay = 30.0
+
+        self.log(f"Waiting for {package}=={version} to appear on registry…")
+
+        for attempt in range(1, max_attempts + 1):
+            try:
+                req = urllib.request.Request(url)
+                if token:
+                    import base64
+
+                    credentials = base64.b64encode(
+                        f"{username}:{token}".encode()
+                    ).decode()
+                    req.add_header("Authorization", f"Basic {credentials}")
+                with urllib.request.urlopen(req, timeout=10) as resp:
+                    if resp.status == 200:
+                        content = resp.read().decode()
+                        if version in content:
+                            self.success(f"{package}=={version} is available.")
+                            return
+            except urllib.error.HTTPError as e:
+                if e.code != 404:
+                    raise
+            except Exception:
+                pass
+
+            self.log(
+                f"Not yet available (attempt {attempt}/{max_attempts}), "
+                f"retrying in {int(delay)}s…"
+            )
+            time.sleep(delay)
+
+        raise RuntimeError(
+            f"Timed out waiting for {package}=={version} on registry after "
+            f"{max_attempts * int(delay) // 60} minutes."
+        )

{wexample_wex_addon_dev_python-0.0.64 → wexample_wex_addon_dev_python-0.1.1}/src/wexample_wex_addon_dev_python/workdir/python_workdir.py

@@ -243,15 +243,15 @@ class PythonWorkdir(CodeBaseWorkdir):
 
         return raw_value
 
-    def save_dependency(self, package: CodeBaseWorkdir, version: str) -> bool:
-        """Add or update a dependency with strict version."""
+    def save_dependency(
+        self, package: CodeBaseWorkdir, version: str, operator: str = "=="
+    ) -> bool:
         config = self.get_app_config_file()
-        updated = config.add_dependency(package=package, version=version)
-
-        if updated:
-            config.write_parsed()
-
-        return updated
+        return config.add_dependency_from_string(
+            package_name=package.get_package_name(),
+            version=version,
+            operator=operator,
+        )
 
     def save_project_config_file(self, config: StructuredData) -> None:
         """Save the project configuration to pyproject.toml."""

wexample_wex_addon_dev_python-0.0.64/PKG-INFO

@@ -1,110 +0,0 @@
-Metadata-Version: 2.1
-Name: wexample-wex-addon-dev-python
-Version: 0.0.64
-Summary: Python dev addon for wex
-Author-Email: weeger <contact@wexample.com>
-License: MIT
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Project-URL: homepage, https://github.com/wexample/python-wex-dev-python
-Requires-Python: >=3.10
-Requires-Dist: attrs>=23.1.0
-Requires-Dist: cattrs>=23.1.0
-Requires-Dist: networkx
-Requires-Dist: pylint
-Requires-Dist: pyright
-Requires-Dist: wexample-filestate-python==0.0.59
-Requires-Dist: wexample-wex-addon-app==0.0.56
-Provides-Extra: dev
-Requires-Dist: pytest; extra == "dev"
-Requires-Dist: pytest-cov; extra == "dev"
-Description-Content-Type: text/markdown
-
-# wexample-wex-addon-dev-python
-
-Version: 0.0.64
-
-Python dev addon for wex
-
-## Table of Contents
-
-- [Status Compatibility](#status-compatibility)
-- [Tests](#tests)
-- [Roadmap](#roadmap)
-- [Useful Links](#useful-links)
-
-
-## Status & Compatibility
-
-**Maturity**: Production-ready
-
-**Python Support**: >=3.10
-
-**OS Support**: Linux, macOS, Windows
-
-**Status**: Actively maintained
-
-## Tests
-
-This project uses `pytest` for testing and `pytest-cov` for code coverage analysis.
-
-### Installation
-
-First, install the required testing dependencies:
-```bash
-.venv/bin/python -m pip install pytest pytest-cov
-```
-
-### Basic Usage
-
-Run all tests with coverage:
-```bash
-.venv/bin/python -m pytest --cov --cov-report=html
-```
-
-### Common Commands
-```bash
-# Run tests with coverage for a specific module
-.venv/bin/python -m pytest --cov=your_module
-
-# Show which lines are not covered
-.venv/bin/python -m pytest --cov=your_module --cov-report=term-missing
-
-# Generate an HTML coverage report
-.venv/bin/python -m pytest --cov=your_module --cov-report=html
-
-# Combine terminal and HTML reports
-.venv/bin/python -m pytest --cov=your_module --cov-report=term-missing --cov-report=html
-
-# Run specific test file with coverage
-.venv/bin/python -m pytest tests/test_file.py --cov=your_module --cov-report=term-missing
-```
-
-### Viewing HTML Reports
-
-After generating an HTML report, open `htmlcov/index.html` in your browser to view detailed line-by-line coverage information.
-
-### Coverage Threshold
-
-To enforce a minimum coverage percentage:
-```bash
-.venv/bin/python -m pytest --cov=your_module --cov-fail-under=80
-```
-
-This will cause the test suite to fail if coverage drops below 80%.
-
-## Known Limitations & Roadmap
-
-Current limitations and planned features are tracked in the GitHub issues.
-
-See the [project roadmap](https://github.com/wexample/python-wex_addon_dev_python/issues) for upcoming features and improvements.
-
-## Useful Links
-
-- **Homepage**: https://github.com/wexample/python-wex-addon-dev-python
-- **Documentation**: [docs.wexample.com](https://docs.wexample.com)
-- **Issue Tracker**: https://github.com/wexample/python-wex-addon-dev-python/issues
-- **Discussions**: https://github.com/wexample/python-wex-addon-dev-python/discussions
-- **PyPI**: [pypi.org/project/wexample-wex-addon-dev-python](https://pypi.org/project/wexample-wex-addon-dev-python/)
-

wexample_wex_addon_dev_python-0.0.64/README.md

@@ -1,87 +0,0 @@
-# wexample-wex-addon-dev-python
-
-Version: 0.0.64
-
-Python dev addon for wex
-
-## Table of Contents
-
-- [Status Compatibility](#status-compatibility)
-- [Tests](#tests)
-- [Roadmap](#roadmap)
-- [Useful Links](#useful-links)
-
-
-## Status & Compatibility
-
-**Maturity**: Production-ready
-
-**Python Support**: >=3.10
-
-**OS Support**: Linux, macOS, Windows
-
-**Status**: Actively maintained
-
-## Tests
-
-This project uses `pytest` for testing and `pytest-cov` for code coverage analysis.
-
-### Installation
-
-First, install the required testing dependencies:
-```bash
-.venv/bin/python -m pip install pytest pytest-cov
-```
-
-### Basic Usage
-
-Run all tests with coverage:
-```bash
-.venv/bin/python -m pytest --cov --cov-report=html
-```
-
-### Common Commands
-```bash
-# Run tests with coverage for a specific module
-.venv/bin/python -m pytest --cov=your_module
-
-# Show which lines are not covered
-.venv/bin/python -m pytest --cov=your_module --cov-report=term-missing
-
-# Generate an HTML coverage report
-.venv/bin/python -m pytest --cov=your_module --cov-report=html
-
-# Combine terminal and HTML reports
-.venv/bin/python -m pytest --cov=your_module --cov-report=term-missing --cov-report=html
-
-# Run specific test file with coverage
-.venv/bin/python -m pytest tests/test_file.py --cov=your_module --cov-report=term-missing
-```
-
-### Viewing HTML Reports
-
-After generating an HTML report, open `htmlcov/index.html` in your browser to view detailed line-by-line coverage information.
-
-### Coverage Threshold
-
-To enforce a minimum coverage percentage:
-```bash
-.venv/bin/python -m pytest --cov=your_module --cov-fail-under=80
-```
-
-This will cause the test suite to fail if coverage drops below 80%.
-
-## Known Limitations & Roadmap
-
-Current limitations and planned features are tracked in the GitHub issues.
-
-See the [project roadmap](https://github.com/wexample/python-wex_addon_dev_python/issues) for upcoming features and improvements.
-
-## Useful Links
-
-- **Homepage**: https://github.com/wexample/python-wex-addon-dev-python
-- **Documentation**: [docs.wexample.com](https://docs.wexample.com)
-- **Issue Tracker**: https://github.com/wexample/python-wex-addon-dev-python/issues
-- **Discussions**: https://github.com/wexample/python-wex-addon-dev-python/discussions
-- **PyPI**: [pypi.org/project/wexample-wex-addon-dev-python](https://pypi.org/project/wexample-wex-addon-dev-python/)
-