wexample-wex-addon-dev-python 8.2.1__py3-none-any.whl → 8.5.0__py3-none-any.whl

wexample_wex_addon_dev_python/workdir/python_package_workdir.py

@@ -454,21 +454,23 @@ class PythonPackageWorkdir(PythonWorkdir):
         shell_run(publish_cmd, inherit_stdio=True, cwd=self.get_path())
 
     def _wait_for_registry(self) -> None:
-        import time
+        import base64
         import urllib.error
         import urllib.request
 
+        from wexample_helpers.helpers.polling_callback_manager import (
+            PollingCallbackManager,
+        )
+
         repository_url = self.search_app_or_suite_runtime_config(
             "pdm.repository.url", default=None
         ).get_str_or_none()
-
         if not repository_url:
             repository_url = "https://pypi.org"
 
         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__"
@@ -478,44 +480,45 @@ class PythonPackageWorkdir(PythonWorkdir):
 
         package = self.get_package_name()
         version = self.get_setup_version()
+        url = f"{repository_url.rstrip('/')}/simple/{package}/"
 
-        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):
+        def check_available() -> bool | None:
             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
+                    if resp.status == 200 and version in resp.read().decode():
+                        return True
             except urllib.error.HTTPError as e:
                 if e.code != 404:
                     raise
             except Exception:
                 pass
+            return None
+
+        max_attempts = 40
+        delay_seconds = 30
 
+        self.log(f"Waiting for {package}=={version} to appear on registry…")
+
+        def on_retry(attempt, max_a, delay, _exc, _msg) -> None:
             self.log(
-                f"Not yet available (attempt {attempt}/{max_attempts}), "
-                f"retrying in {int(delay)}s…"
+                f"Not yet available (attempt {attempt}/{max_a}), retrying in {delay}s…"
             )
-            time.sleep(delay)
 
-        raise RuntimeError(
-            f"Timed out waiting for {package}=={version} on registry after "
-            f"{max_attempts * int(delay) // 60} minutes."
-        )
+        PollingCallbackManager(
+            callback=check_available,
+            max_attempts=max_attempts,
+            delay_seconds_callback=lambda _attempt: delay_seconds,
+            on_retry_callback=on_retry,
+            timeout_message=(
+                f"Timed out waiting for {package}=={version} on registry after "
+                f"{max_attempts * delay_seconds // 60} minutes."
+            ),
+        ).run()
+
+        self.success(f"{package}=={version} is available.")

{wexample_wex_addon_dev_python-8.2.1.dist-info → wexample_wex_addon_dev_python-8.5.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: wexample-wex-addon-dev-python
-Version: 8.2.1
+Version: 8.5.0
 Summary: Python dev addon for wex
 Author-Email: weeger <contact@wexample.com>
 License: MIT
@@ -15,8 +15,8 @@ Requires-Dist: griffe>=2.0.2
 Requires-Dist: networkx
 Requires-Dist: pylint
 Requires-Dist: pyright
-Requires-Dist: wexample-filestate-python>=6.5.0
-Requires-Dist: wexample-wex-addon-app>=16.6.0
+Requires-Dist: wexample-filestate-python>=6.7.0
+Requires-Dist: wexample-wex-addon-app>=18.0.0
 Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-cov; extra == "dev"
@@ -24,6 +24,131 @@ Description-Content-Type: text/markdown
 
 # wex_addon_dev_python
 
+Version: 8.5.0
+
+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)
+- [Introduction](#introduction)
+- [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: >=6.7.0
+- wexample-wex-addon-app: >=18.0.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.
+
+# wex_addon_dev_python
+
 Version: 8.2.1
 
 Python dev addon for wex
@@ -330,3 +455,33 @@ See the [project roadmap](https://github.com/wexample/python-wex_addon_dev_pytho
 When upgrading between major versions, refer to the migration guides in the documentation.
 
 Breaking changes are clearly documented with upgrade paths and examples.
+
+## 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-8.2.1.dist-info → wexample_wex_addon_dev_python-8.5.0.dist-info}/RECORD

@@ -1,6 +1,6 @@
-wexample_wex_addon_dev_python-8.2.1.dist-info/METADATA,sha256=bVB-Q_0u-9I5HegMrp-dvxink-ffENVmWz2FFIovRVc,11755
-wexample_wex_addon_dev_python-8.2.1.dist-info/WHEEL,sha256=Z36eTX6lG3PITRleSd5hAZHCcz52yg3c0JQVxKBbLW0,90
-wexample_wex_addon_dev_python-8.2.1.dist-info/entry_points.txt,sha256=6OYgBcLyFCUgeqLgnvMyOJxPCWzgy7se4rLPKtNonMs,34
+wexample_wex_addon_dev_python-8.5.0.dist-info/METADATA,sha256=fJpOykjuKxT-PLTnXKx-Ehjx1-8ptJVvGTkDDj3q5XY,17250
+wexample_wex_addon_dev_python-8.5.0.dist-info/WHEEL,sha256=Z36eTX6lG3PITRleSd5hAZHCcz52yg3c0JQVxKBbLW0,90
+wexample_wex_addon_dev_python-8.5.0.dist-info/entry_points.txt,sha256=6OYgBcLyFCUgeqLgnvMyOJxPCWzgy7se4rLPKtNonMs,34
 wexample_wex_addon_dev_python/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 wexample_wex_addon_dev_python/__pycache__/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 wexample_wex_addon_dev_python/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -62,7 +62,7 @@ wexample_wex_addon_dev_python/workdir/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCe
 wexample_wex_addon_dev_python/workdir/__pycache__/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 wexample_wex_addon_dev_python/workdir/mixin/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 wexample_wex_addon_dev_python/workdir/mixin/with_profiling_python_workdir_mixin.py,sha256=rWf_AMq4YM_vvKYZiXyhFeAz2xg0KMt_u-1FJACtvjc,3042
-wexample_wex_addon_dev_python/workdir/python_package_workdir.py,sha256=Bl3Jf2NqawSCUkH3Fi59QInF3JJVWpkaBzfQ86WFf6I,18835
+wexample_wex_addon_dev_python/workdir/python_package_workdir.py,sha256=WQnVSSOixv_fl124DX0jswGPTJ3xMi4QpGPskVafyUc,19092
 wexample_wex_addon_dev_python/workdir/python_packages_suite_workdir.py,sha256=ICHHewLpsXiheYzGDEahphBryH98ZVezWzSAy6A5w5I,2874
 wexample_wex_addon_dev_python/workdir/python_workdir.py,sha256=hBlqRfJ1eRvUzGFasftnn0SxGw0_Yyoe7AhBDLWntl4,20261
-wexample_wex_addon_dev_python-8.2.1.dist-info/RECORD,,
+wexample_wex_addon_dev_python-8.5.0.dist-info/RECORD,,