wexample-wex-addon-dev-javascript 0.0.58__tar.gz → 0.1.0__tar.gz

wexample_wex_addon_dev_javascript-0.1.0/PKG-INFO

@@ -0,0 +1,169 @@
+Metadata-Version: 2.1
+Name: wexample-wex-addon-dev-javascript
+Version: 0.1.0
+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: wexample-filestate-javascript>=0.1.0
+Requires-Dist: wexample-wex-addon-app>=1.0.0
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Description-Content-Type: text/markdown
+
+# wex_addon_dev_javascript
+
+Version: 0.1.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)
+- [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
+- wexample-filestate-javascript: >=0.1.0
+- wexample-wex-addon-app: >=1.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.
+
+## 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_javascript/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-javascript
+- **Documentation**: [docs.wexample.com](https://docs.wexample.com)
+- **Issue Tracker**: https://github.com/wexample/python-wex-addon-dev-javascript/issues
+- **Discussions**: https://github.com/wexample/python-wex-addon-dev-javascript/discussions
+- **PyPI**: [pypi.org/project/wex_addon_dev_javascript](https://pypi.org/project/wex_addon_dev_javascript/)
+
+## 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_javascript-0.1.0/README.md

@@ -0,0 +1,149 @@
+# wex_addon_dev_javascript
+
+Version: 0.1.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)
+- [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
+- wexample-filestate-javascript: >=0.1.0
+- wexample-wex-addon-app: >=1.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.
+
+## 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_javascript/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-javascript
+- **Documentation**: [docs.wexample.com](https://docs.wexample.com)
+- **Issue Tracker**: https://github.com/wexample/python-wex-addon-dev-javascript/issues
+- **Discussions**: https://github.com/wexample/python-wex-addon-dev-javascript/discussions
+- **PyPI**: [pypi.org/project/wex_addon_dev_javascript](https://pypi.org/project/wex_addon_dev_javascript/)
+
+## 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_javascript-0.0.58 → wexample_wex_addon_dev_javascript-0.1.0}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "pdm.backend"
 
 [project]
 name = "wexample-wex-addon-dev-javascript"
-version = "0.0.58"
+version = "0.1.0"
 description = "Python dev addon for wex"
 authors = [
     { name = "weeger", email = "contact@wexample.com" },
@@ -20,8 +20,8 @@ classifiers = [
 dependencies = [
     "attrs>=23.1.0",
     "cattrs>=23.1.0",
-    "wexample-filestate-javascript==0.0.15",
-    "wexample-wex-addon-app==0.0.56",
+    "wexample-filestate-javascript>=0.1.0",
+    "wexample-wex-addon-app>=1.0.0",
 ]
 
 [project.readme]

{wexample_wex_addon_dev_javascript-0.0.58 → wexample_wex_addon_dev_javascript-0.1.0}/src/wexample_wex_addon_dev_javascript/file/javascript_package_json_file.py

@@ -74,11 +74,10 @@ class JavascriptPackageJsonFile(AppDependenciesConfigFileMixin, JsonFile):
     def get_dependencies_versions(
         self, optional: bool = False, group: str = "dev"
     ) -> dict[str, str]:
-        return (
-            self.read_config()
-            .search(path="dependencies")
-            .get_dict_or_default(default={})
-        )
+        config = self.read_config()
+        deps = config.search(path="dependencies").get_dict_or_default(default={})
+        peer = config.search(path="peerDependencies").get_dict_or_default(default={})
+        return {**deps, **peer}
 
     def _apply_default_publish_config(self, content: dict) -> None:
         content.setdefault("type", "module")

wexample_wex_addon_dev_javascript-0.1.0/src/wexample_wex_addon_dev_javascript/services/vite/commands/service/install.py

@@ -0,0 +1,58 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from wexample_wex_core.const.globals import COMMAND_TYPE_SERVICE
+from wexample_wex_core.decorator.command import command
+
+if TYPE_CHECKING:
+    from wexample_wex_addon_app.service.app_service import AppService
+    from wexample_wex_core.context.execution_context import ExecutionContext
+
+
+@command(
+    type=COMMAND_TYPE_SERVICE,
+    description="Patch vite.config.ts to allow all hosts (needed behind a reverse proxy)",
+)
+def vite__service__install(
+    context: ExecutionContext,
+    service: AppService,
+) -> None:
+    import re
+
+    app_path = service.app_workdir.get_path()
+
+    for config_name in ["vite.config.ts", "vite.config.js"]:
+        config_path = app_path / config_name
+        if not config_path.exists():
+            continue
+
+        content = config_path.read_text()
+
+        if "allowedHosts" in content:
+            context.io.log(f"  {config_name}: allowedHosts already set, skipping")
+            return
+
+        # defineConfig() → defineConfig({ vite: { server: { allowedHosts: true } } })
+        # defineConfig({ ... }) → add server.allowedHosts: true inside vite: {}
+        if "defineConfig()" in content:
+            content = content.replace(
+                "defineConfig()",
+                "defineConfig({ vite: { server: { allowedHosts: true } } })",
+            )
+        elif re.search(r"defineConfig\(\s*\{", content):
+            content = re.sub(
+                r"(defineConfig\(\s*\{)",
+                r"\1 vite: { server: { allowedHosts: true } },",
+                content,
+                count=1,
+            )
+        else:
+            context.io.log(f"  {config_name}: unrecognized format, skipping")
+            return
+
+        config_path.write_text(content)
+        context.io.log(f"  ✓ {config_name}: allowedHosts patched")
+        return
+
+    context.io.log("  No vite.config.ts/js found, skipping allowedHosts patch")

wexample_wex_addon_dev_javascript-0.1.0/src/wexample_wex_addon_dev_javascript/services/vite/commands/service/ready.py

@@ -0,0 +1,42 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from wexample_wex_core.const.globals import COMMAND_TYPE_SERVICE
+from wexample_wex_core.decorator.command import command
+
+if TYPE_CHECKING:
+    from wexample_app.response.boolean_response import BooleanResponse
+    from wexample_wex_addon_app.service.app_service import AppService
+    from wexample_wex_core.context.execution_context import ExecutionContext
+
+
+@command(
+    type=COMMAND_TYPE_SERVICE, description="Check if the Vite dev server is responding"
+)
+def vite__service__ready(
+    context: ExecutionContext,
+    service: AppService,
+) -> BooleanResponse:
+    import subprocess
+
+    from wexample_app.response.boolean_response import BooleanResponse
+
+    runtime = service.app_workdir.get_runtime_config()
+    app_project_name = runtime.search("app.project_name").get_str()
+    container_name = f"{app_project_name}_vite"
+    port = service.manifest.get("vars", {}).get("VITE_PORT", {}).get("default", "8080")
+
+    result = subprocess.run(
+        [
+            "docker",
+            "exec",
+            container_name,
+            "bun",
+            "-e",
+            f"await fetch('http://localhost:{port}')",
+        ],
+        capture_output=True,
+    )
+
+    return BooleanResponse(kernel=context.kernel, content=result.returncode == 0)

wexample_wex_addon_dev_javascript-0.1.0/src/wexample_wex_addon_dev_javascript/services/vite/docker/docker-compose.yml

@@ -0,0 +1,26 @@
+services:
+
+  vite:
+    container_name: ${APP_PROJECT_NAME}_vite
+    image: oven/bun:latest
+    working_dir: /app
+    command: sh -c "bun install && bun run dev --host"
+    environment:
+      VIRTUAL_HOST: ${APP_DOMAINS_STRING}
+      VIRTUAL_PORT: ${VITE_PORT:-8080}
+    volumes:
+      - ${APP_PATH}:/app
+      - vite_node_modules:/app/node_modules
+    healthcheck:
+      test: ["CMD", "bun", "-e", "await fetch('http://localhost:8080')"]
+      interval: 10s
+      timeout: 5s
+      retries: 10
+      start_period: 60s
+    networks:
+      wex_net:
+        aliases:
+          - vite
+
+volumes:
+  vite_node_modules:

wexample_wex_addon_dev_javascript-0.1.0/src/wexample_wex_addon_dev_javascript/services/vite/service.yml

@@ -0,0 +1,10 @@
+name: vite
+tags:
+  - frontend
+  - javascript
+docker:
+  compose: docker/docker-compose.yml
+vars:
+  VITE_PORT:
+    default: "8080"
+    description: "Port exposed by the Vite dev server"

wexample_wex_addon_dev_javascript-0.1.0/src/wexample_wex_addon_dev_javascript/workdir/javascript_package_workdir.py

@@ -0,0 +1,210 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from wexample_helpers.helpers.string import string_to_kebab_case
+from wexample_helpers_git.helpers.git import (
+    git_tag_annotated,
+    git_tag_exists,
+)
+
+from wexample_wex_addon_dev_javascript.workdir.javascript_workdir import (
+    JavascriptWorkdir,
+)
+
+if TYPE_CHECKING:
+    from wexample_config.const.types import DictConfig
+    from wexample_filestate.config_value.readme_content_config_value import (
+        ReadmeContentConfigValue,
+    )
+    from wexample_wex_addon_app.workdir.framework_packages_suite_workdir import (
+        FrameworkPackageSuiteWorkdir,
+    )
+
+
+class JavascriptPackageWorkdir(JavascriptWorkdir):
+    def get_package_dependency_name(self) -> str:
+        return self.get_package_import_name()
+
+    def get_package_import_name(self) -> str:
+        """Get the full package import name with vendor prefix."""
+        return self.get_project_name()
+
+    def get_project_name(self) -> str:
+        return f"@{self.get_vendor_name()}/{string_to_kebab_case(super().get_project_name())}"
+
+    def prepare_value(self, raw_value: DictConfig | None = None) -> DictConfig:
+        from wexample_filestate.const.disk import DiskItemType
+        from wexample_helpers.helpers.file import file_read
+        from wexample_helpers.helpers.module import module_get_path
+
+        import wexample_wex_addon_dev_javascript
+
+        raw_value = super().prepare_value(raw_value=raw_value)
+        children = raw_value["children"]
+
+        children.extend(
+            [
+                {
+                    "name": ".github",
+                    "type": DiskItemType.DIRECTORY,
+                    "should_exist": True,
+                    "children": [
+                        {
+                            "name": "workflows",
+                            "type": DiskItemType.DIRECTORY,
+                            "should_exist": True,
+                            "children": [
+                                {
+                                    "name": "publish.yml",
+                                    "type": DiskItemType.FILE,
+                                    "should_exist": True,
+                                    "content": file_read(
+                                        module_get_path(
+                                            wexample_wex_addon_dev_javascript
+                                        )
+                                        / "resources"
+                                        / "package_publish.yml"
+                                    ),
+                                }
+                            ],
+                        }
+                    ],
+                }
+            ]
+        )
+
+        return raw_value
+
+    def _classify_version_bump(self, last_tag: str) -> str:
+        from wexample_helpers.const.types import (
+            UPGRADE_TYPE_MAJOR,
+            UPGRADE_TYPE_MINOR,
+        )
+        from wexample_helpers.helpers.shell import shell_run
+        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
+
+        # Check if all changes in src/ are whitespace-only — safe to treat as patch
+        result = shell_run(
+            ["git", "diff", "-w", "--ignore-blank-lines", last_tag, "--", "src/"],
+            cwd=self.get_path(),
+            check=False,
+            capture=True,
+        )
+        if not result.stdout.strip():
+            self.log("Only whitespace changes in src/, treating as patch.")
+            return UPGRADE_TYPE_MINOR
+
+        # Check if all changed files in src/ are non-TypeScript — cannot break the TS API
+        changed_files = shell_run(
+            ["git", "diff", "--name-only", last_tag, "--", "src/"],
+            cwd=self.get_path(),
+            check=False,
+            capture=True,
+        )
+        ts_files = [
+            f
+            for f in changed_files.stdout.splitlines()
+            if f.endswith(".ts") or f.endswith(".tsx")
+        ]
+        if not ts_files:
+            self.log("Only non-TypeScript files changed in src/, treating as minor.")
+            return UPGRADE_TYPE_INTERMEDIATE
+
+        return UPGRADE_TYPE_MAJOR
+
+    def _get_critical_directories(self) -> list[str]:
+        return ["src"]
+
+    def _get_readme_content(self) -> ReadmeContentConfigValue | None:
+        from wexample_wex_addon_dev_javascript.config_value.javascript_package_readme_config_value import (
+            JavascriptPackageReadmeContentConfigValue,
+        )
+
+        return JavascriptPackageReadmeContentConfigValue(workdir=self)
+
+    def _get_suite_workdir_class(self) -> type[FrameworkPackageSuiteWorkdir]:
+        from wexample_wex_addon_dev_javascript.workdir.javascript_packages_suite_workdir import (
+            JavascriptPackagesSuiteWorkdir,
+        )
+
+        return JavascriptPackagesSuiteWorkdir
+
+    def _publish(self, force: bool = False) -> None:
+        """Push a git tag to the deployment remote to trigger a CI/CD publication workflow."""
+        from wexample_helpers_git.helpers.git import git_push_tag
+
+        remote = self._get_deployment_remote_name()
+        if not remote:
+            self.log("No deployment remote configured, skipping publication.")
+            return
+
+        tag = f"v{self.get_project_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)
+
+    def _wait_for_registry(self) -> None:
+        """Poll the configured npm registry until the current version is available (max 20 min).
+
+        Fetches the package manifest and checks for the version in 'versions' — compatible
+        with both public npm and private registries (e.g. GitLab) that don't expose
+        per-version URLs.
+        """
+        import json
+        import time
+        import urllib.error
+        import urllib.request
+
+        package = self.get_project_name()
+        version = self.get_project_version()
+
+        registry_base = (
+            self.get_runtime_config().search("npm.registry_url").get_str_or_none()
+        )
+        token = self.get_runtime_config().search("npm.api_token").get_str_or_none()
+
+        encoded = package.replace("/", "%2F")
+        base = (registry_base or "https://registry.npmjs.org").rstrip("/")
+        url = f"{base}/{encoded}"
+
+        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:
+                    req.add_header("Authorization", f"Bearer {token}")
+                with urllib.request.urlopen(req, timeout=10) as resp:
+                    if resp.status == 200:
+                        data = json.loads(resp.read())
+                        if version in data.get("versions", {}):
+                            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_javascript-0.0.58/PKG-INFO

@@ -1,107 +0,0 @@
-Metadata-Version: 2.1
-Name: wexample-wex-addon-dev-javascript
-Version: 0.0.58
-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: wexample-filestate-javascript==0.0.15
-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-javascript
-
-Version: 0.0.58
-
-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_javascript/issues) for upcoming features and improvements.
-
-## Useful Links
-
-- **Homepage**: https://github.com/wexample/python-wex-addon-dev-javascript
-- **Documentation**: [docs.wexample.com](https://docs.wexample.com)
-- **Issue Tracker**: https://github.com/wexample/python-wex-addon-dev-javascript/issues
-- **Discussions**: https://github.com/wexample/python-wex-addon-dev-javascript/discussions
-- **PyPI**: [pypi.org/project/wexample-wex-addon-dev-javascript](https://pypi.org/project/wexample-wex-addon-dev-javascript/)
-

wexample_wex_addon_dev_javascript-0.0.58/README.md

@@ -1,87 +0,0 @@
-# wexample-wex-addon-dev-javascript
-
-Version: 0.0.58
-
-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_javascript/issues) for upcoming features and improvements.
-
-## Useful Links
-
-- **Homepage**: https://github.com/wexample/python-wex-addon-dev-javascript
-- **Documentation**: [docs.wexample.com](https://docs.wexample.com)
-- **Issue Tracker**: https://github.com/wexample/python-wex-addon-dev-javascript/issues
-- **Discussions**: https://github.com/wexample/python-wex-addon-dev-javascript/discussions
-- **PyPI**: [pypi.org/project/wexample-wex-addon-dev-javascript](https://pypi.org/project/wexample-wex-addon-dev-javascript/)
-

wexample_wex_addon_dev_javascript-0.0.58/src/wexample_wex_addon_dev_javascript/workdir/javascript_package_workdir.py

@@ -1,104 +0,0 @@
-from __future__ import annotations
-
-from typing import TYPE_CHECKING
-
-from wexample_helpers.helpers.string import string_to_kebab_case
-from wexample_helpers_git.helpers.git import (
-    git_tag_annotated,
-    git_tag_exists,
-)
-
-from wexample_wex_addon_dev_javascript.workdir.javascript_workdir import (
-    JavascriptWorkdir,
-)
-
-if TYPE_CHECKING:
-    from wexample_config.const.types import DictConfig
-    from wexample_filestate.config_value.readme_content_config_value import (
-        ReadmeContentConfigValue,
-    )
-    from wexample_wex_addon_app.workdir.framework_packages_suite_workdir import (
-        FrameworkPackageSuiteWorkdir,
-    )
-
-
-class JavascriptPackageWorkdir(JavascriptWorkdir):
-    def get_package_dependency_name(self) -> str:
-        return self.get_package_import_name()
-
-    def get_package_import_name(self) -> str:
-        """Get the full package import name with vendor prefix."""
-        return self.get_project_name()
-
-    def get_project_name(self) -> str:
-        return f"@{self.get_vendor_name()}/{string_to_kebab_case(super().get_project_name())}"
-
-    def prepare_value(self, raw_value: DictConfig | None = None) -> DictConfig:
-        from wexample_filestate.const.disk import DiskItemType
-        from wexample_helpers.helpers.file import file_read
-        from wexample_helpers.helpers.module import module_get_path
-
-        import wexample_wex_addon_dev_javascript
-
-        raw_value = super().prepare_value(raw_value=raw_value)
-        children = raw_value["children"]
-
-        children.extend(
-            [
-                {
-                    "name": ".github",
-                    "type": DiskItemType.DIRECTORY,
-                    "should_exist": True,
-                    "children": [
-                        {
-                            "name": "workflows",
-                            "type": DiskItemType.DIRECTORY,
-                            "should_exist": True,
-                            "children": [
-                                {
-                                    "name": "publish.yml",
-                                    "type": DiskItemType.FILE,
-                                    "should_exist": True,
-                                    "content": file_read(
-                                        module_get_path(
-                                            wexample_wex_addon_dev_javascript
-                                        )
-                                        / "resources"
-                                        / "package_publish.yml"
-                                    ),
-                                }
-                            ],
-                        }
-                    ],
-                }
-            ]
-        )
-
-        return raw_value
-
-    def _get_readme_content(self) -> ReadmeContentConfigValue | None:
-        from wexample_wex_addon_dev_javascript.config_value.javascript_package_readme_config_value import (
-            JavascriptPackageReadmeContentConfigValue,
-        )
-
-        return JavascriptPackageReadmeContentConfigValue(workdir=self)
-
-    def _get_suite_package_workdir_class(self) -> type[FrameworkPackageSuiteWorkdir]:
-        from wexample_wex_addon_dev_javascript.workdir.javascript_packages_suite_workdir import (
-            JavascriptPackagesSuiteWorkdir,
-        )
-
-        return JavascriptPackagesSuiteWorkdir
-
-    def _publish(self, force: bool = False) -> None:
-        """Create a git tag (vX.Y.Z) to trigger Trusted Publisher workflow."""
-        tag = f"v{self.get_project_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)
-
-        # Uses git repo to deploy packages (tag push triggers GitHub Actions publication).
-        self.push_to_deployment_remote()