PyPI - wexample-wex-addon-dev-python - Versions diffs - 0.0.63__tar.gz → 0.1.0__tar.gz - Mend

wexample-wex-addon-dev-python 0.0.63tar.gz → 0.1.0tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (46) hide show

{wexample_wex_addon_dev_python-0.0.63 → wexample_wex_addon_dev_python-0.1.0}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: wexample-wex-addon-dev-python
-Version: 0.0.63
+Version: 0.1.0
 Summary: Python dev addon for wex
 Author-Email: weeger <contact@wexample.com>
 License: MIT
@@ -11,61 +11,36 @@ 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.0.58
-Requires-Dist: wexample-wex-addon-app==0.0.55
-Requires-Dist: wexample-wex-core==6.0.67
+Requires-Dist: wexample-filestate-python>=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
-# wexample-wex-addon-dev-python
+# wex_addon_dev_python
-Version: 0.0.63
+Version: 0.1.0
 Python dev addon for wex
 ## Table of Contents
-- [Status Compatibility](#status-compatibility)
-- [Api Reference](#api-reference)
 - [Tests](#tests)
-- [Code Quality](#code-quality)
+- [Suite Integration](#suite-integration)
+- [Dependencies](#dependencies)
 - [Versioning](#versioning)
-- [Changelog](#changelog)
-- [Migration Notes](#migration-notes)
-- [Roadmap](#roadmap)
-- [Security](#security)
-- [Privacy](#privacy)
-- [Support](#support)
-- [Contribution Guidelines](#contribution-guidelines)
-- [Maintainers](#maintainers)
 - [License](#license)
-- [Useful Links](#useful-links)
 - [Suite Integration](#suite-integration)
-- [Compatibility Matrix](#compatibility-matrix)
-- [Dependencies](#dependencies)
 - [Suite Signature](#suite-signature)
-## Status & Compatibility
-**Maturity**: Production-ready
-**Python Support**: >=3.10
-**OS Support**: Linux, macOS, Windows
-**Status**: Actively maintained
-## API Reference
-Full API documentation is available in the source code docstrings.
-Key modules and classes are documented with type hints for better IDE support.
+- [Roadmap](#roadmap)
+- [Status Compatibility](#status-compatibility)
+- [Useful Links](#useful-links)
+- [Migration Notes](#migration-notes)
 ## Tests
@@ -116,16 +91,26 @@ To enforce a minimum coverage percentage:
 This will cause the test suite to fail if coverage drops below 80%.
-## Code Quality & Typing
+## Integration in the Suite
-All the suite packages follow strict quality standards:
+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.
-- **Type hints**: Full type coverage with mypy validation
-- **Code formatting**: Enforced with black and isort
-- **Linting**: Comprehensive checks with custom scripts and tools
-- **Testing**: High test coverage requirements
+### Related Packages
-These standards ensure reliability and maintainability across the suite.
+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.0.0
 ## Versioning & Compatibility Policy
@@ -137,72 +122,45 @@ Wexample packages follow **Semantic Versioning** (SemVer):
 We maintain backward compatibility within major versions and provide clear migration guides for breaking changes.
-## Changelog
-See [CHANGELOG.md](CHANGELOG.md) for detailed version history and release notes.
-Major changes are documented with migration guides when applicable.
-## 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.
-## 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.
-## Security Policy
-### Reporting Vulnerabilities
+## License
-If you discover a security vulnerability, please email contact@wexample.com.
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
-**Do not** open public issues for security vulnerabilities.
+Free to use in both personal and commercial projects.
-We take security seriously and will respond promptly to verified reports.
+## Integration in the Suite
-## Privacy & Telemetry
+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.
-This package does **not** collect any telemetry or usage data.
+### Related Packages
-Your privacy is respected — no data is transmitted to external services.
+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.
-## Support Channels
+Visit the [Wexample Suite documentation](https://docs.wexample.com) for the complete package ecosystem.
-- **GitHub Issues**: Bug reports and feature requests
-- **GitHub Discussions**: Questions and community support
-- **Documentation**: Comprehensive guides and API reference
-- **Email**: contact@wexample.com for general inquiries
+# About us
-Community support is available through GitHub Discussions.
+[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.
-## Contribution Guidelines
+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.
-We welcome contributions to the Wexample suite!
+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.
-### How to Contribute
+## Known Limitations & Roadmap
-1. **Fork** the repository
-2. **Create** a feature branch
-3. **Make** your changes
-4. **Test** thoroughly
-5. **Submit** a pull request
+Current limitations and planned features are tracked in the GitHub issues.
-## Maintainers & Authors
+See the [project roadmap](https://github.com/wexample/python-wex_addon_dev_python/issues) for upcoming features and improvements.
-Maintained by the Wexample team and community contributors.
+## Status & Compatibility
-See [CONTRIBUTORS.md](CONTRIBUTORS.md) for the full list of contributors.
+**Maturity**: Production-ready
-## License
+**Python Support**: >=3.10
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+**OS Support**: Linux, macOS, Windows
-Free to use in both personal and commercial projects.
+**Status**: Actively maintained
 ## Useful Links
@@ -210,41 +168,10 @@ Free to use in both personal and commercial projects.
 - **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/)
-## 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.
+- **PyPI**: [pypi.org/project/wex_addon_dev_python](https://pypi.org/project/wex_addon_dev_python/)
-### 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.
-## Compatibility Matrix
-This package is part of the Wexample suite and is compatible with other suite packages.
-Refer to each package's documentation for specific version compatibility requirements.
-## Dependencies
-- attrs: >=23.1.0
-- cattrs: >=23.1.0
-- networkx:
-- pylint:
-- pyright:
-- wexample-filestate-python: ==0.0.58
-- wexample-wex-addon-app: ==0.0.55
-- wexample-wex-core: ==6.0.67
-# 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.
+## Migration Notes
-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.
+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.63 → wexample_wex_addon_dev_python-0.1.0}/README.md RENAMED Viewed

@@ -1,47 +1,22 @@
-# wexample-wex-addon-dev-python
+# wex_addon_dev_python
-Version: 0.0.63
+Version: 0.1.0
 Python dev addon for wex
 ## Table of Contents
-- [Status Compatibility](#status-compatibility)
-- [Api Reference](#api-reference)
 - [Tests](#tests)
-- [Code Quality](#code-quality)
+- [Suite Integration](#suite-integration)
+- [Dependencies](#dependencies)
 - [Versioning](#versioning)
-- [Changelog](#changelog)
-- [Migration Notes](#migration-notes)
-- [Roadmap](#roadmap)
-- [Security](#security)
-- [Privacy](#privacy)
-- [Support](#support)
-- [Contribution Guidelines](#contribution-guidelines)
-- [Maintainers](#maintainers)
 - [License](#license)
-- [Useful Links](#useful-links)
 - [Suite Integration](#suite-integration)
-- [Compatibility Matrix](#compatibility-matrix)
-- [Dependencies](#dependencies)
 - [Suite Signature](#suite-signature)
-## Status & Compatibility
-**Maturity**: Production-ready
-**Python Support**: >=3.10
-**OS Support**: Linux, macOS, Windows
-**Status**: Actively maintained
-## API Reference
-Full API documentation is available in the source code docstrings.
-Key modules and classes are documented with type hints for better IDE support.
+- [Roadmap](#roadmap)
+- [Status Compatibility](#status-compatibility)
+- [Useful Links](#useful-links)
+- [Migration Notes](#migration-notes)
 ## Tests
@@ -92,16 +67,26 @@ To enforce a minimum coverage percentage:
 This will cause the test suite to fail if coverage drops below 80%.
-## Code Quality & Typing
+## Integration in the Suite
-All the suite packages follow strict quality standards:
+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.
-- **Type hints**: Full type coverage with mypy validation
-- **Code formatting**: Enforced with black and isort
-- **Linting**: Comprehensive checks with custom scripts and tools
-- **Testing**: High test coverage requirements
+### Related Packages
-These standards ensure reliability and maintainability across the suite.
+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.0.0
 ## Versioning & Compatibility Policy
@@ -113,72 +98,45 @@ Wexample packages follow **Semantic Versioning** (SemVer):
 We maintain backward compatibility within major versions and provide clear migration guides for breaking changes.
-## Changelog
-See [CHANGELOG.md](CHANGELOG.md) for detailed version history and release notes.
-Major changes are documented with migration guides when applicable.
-## 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.
-## 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.
-## Security Policy
-### Reporting Vulnerabilities
+## License
-If you discover a security vulnerability, please email contact@wexample.com.
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
-**Do not** open public issues for security vulnerabilities.
+Free to use in both personal and commercial projects.
-We take security seriously and will respond promptly to verified reports.
+## Integration in the Suite
-## Privacy & Telemetry
+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.
-This package does **not** collect any telemetry or usage data.
+### Related Packages
-Your privacy is respected — no data is transmitted to external services.
+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.
-## Support Channels
+Visit the [Wexample Suite documentation](https://docs.wexample.com) for the complete package ecosystem.
-- **GitHub Issues**: Bug reports and feature requests
-- **GitHub Discussions**: Questions and community support
-- **Documentation**: Comprehensive guides and API reference
-- **Email**: contact@wexample.com for general inquiries
+# About us
-Community support is available through GitHub Discussions.
+[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.
-## Contribution Guidelines
+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.
-We welcome contributions to the Wexample suite!
+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.
-### How to Contribute
+## Known Limitations & Roadmap
-1. **Fork** the repository
-2. **Create** a feature branch
-3. **Make** your changes
-4. **Test** thoroughly
-5. **Submit** a pull request
+Current limitations and planned features are tracked in the GitHub issues.
-## Maintainers & Authors
+See the [project roadmap](https://github.com/wexample/python-wex_addon_dev_python/issues) for upcoming features and improvements.
-Maintained by the Wexample team and community contributors.
+## Status & Compatibility
-See [CONTRIBUTORS.md](CONTRIBUTORS.md) for the full list of contributors.
+**Maturity**: Production-ready
-## License
+**Python Support**: >=3.10
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+**OS Support**: Linux, macOS, Windows
-Free to use in both personal and commercial projects.
+**Status**: Actively maintained
 ## Useful Links
@@ -186,41 +144,10 @@ Free to use in both personal and commercial projects.
 - **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/)
-## 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.
+- **PyPI**: [pypi.org/project/wex_addon_dev_python](https://pypi.org/project/wex_addon_dev_python/)
-### 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.
-## Compatibility Matrix
-This package is part of the Wexample suite and is compatible with other suite packages.
-Refer to each package's documentation for specific version compatibility requirements.
-## Dependencies
-- attrs: >=23.1.0
-- cattrs: >=23.1.0
-- networkx:
-- pylint:
-- pyright:
-- wexample-filestate-python: ==0.0.58
-- wexample-wex-addon-app: ==0.0.55
-- wexample-wex-core: ==6.0.67
-# 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.
+## Migration Notes
-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.
+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.63 → wexample_wex_addon_dev_python-0.1.0}/pyproject.toml RENAMED Viewed

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

{wexample_wex_addon_dev_python-0.0.63 → wexample_wex_addon_dev_python-0.1.0}/src/wexample_wex_addon_dev_python/commands/code/check.py RENAMED Viewed

@@ -2,6 +2,7 @@ from __future__ import annotations
 from typing import TYPE_CHECKING
+from wexample_wex_core.const.globals import COMMAND_TYPE_ADDON
 from wexample_wex_core.const.middleware import (
     MIDDLEWARE_OPTION_VALUE_ALLWAYS,
     MIDDLEWARE_OPTION_VALUE_OPTIONAL,
@@ -32,8 +33,9 @@ if TYPE_CHECKING:
     show_progress=MIDDLEWARE_OPTION_VALUE_ALLWAYS,
 )
 @command(
+    type=COMMAND_TYPE_ADDON,
     description="Check python code on every file: "
-    "bash cli/wex python::code/check --file ../../pip/wex-core/wexample_wex_core/ -sof"
+    "python::code/check --file ../../pip/wex-core/wexample_wex_core/ -sof",
 )
 def python__code__check(
     context: ExecutionContext,

{wexample_wex_addon_dev_python-0.0.63 → wexample_wex_addon_dev_python-0.1.0}/src/wexample_wex_addon_dev_python/commands/code/format.py RENAMED Viewed

@@ -2,6 +2,7 @@ from __future__ import annotations
 from typing import TYPE_CHECKING
+from wexample_wex_core.const.globals import COMMAND_TYPE_ADDON
 from wexample_wex_core.decorator.command import command
 from wexample_wex_core.decorator.middleware import middleware
 from wexample_wex_core.decorator.option import option
@@ -26,7 +27,7 @@ if TYPE_CHECKING:
 @middleware(
     name="each_python_file", should_exist=True, expand_glob=True, recursive=True
 )
-@command()
+@command(type=COMMAND_TYPE_ADDON)
 def python__code__format(
     kernel: Kernel,
     file: str,

{wexample_wex_addon_dev_python-0.0.63 → wexample_wex_addon_dev_python-0.1.0}/src/wexample_wex_addon_dev_python/commands/examples/validate.py RENAMED Viewed

@@ -2,13 +2,14 @@ from __future__ import annotations
 from typing import TYPE_CHECKING
+from wexample_wex_core.const.globals import COMMAND_TYPE_ADDON
 from wexample_wex_core.decorator.command import command
 if TYPE_CHECKING:
     from wexample_wex_core.context.execution_context import ExecutionContext
-@command(description="Check python code on every file.")
+@command(type=COMMAND_TYPE_ADDON, description="Check python code on every file.")
 def python__examples__validate(
     context: ExecutionContext,
 ) -> None:

{wexample_wex_addon_dev_python-0.0.63 → wexample_wex_addon_dev_python-0.1.0}/src/wexample_wex_addon_dev_python/file/python_pyproject_toml_file.py RENAMED Viewed

@@ -5,18 +5,20 @@ from typing import TYPE_CHECKING
 from wexample_filestate.item.file.toml_file import TomlFile
 from wexample_helpers.decorator.base_class import base_class
 from wexample_wex_addon_app.const.path import APP_PATH_README
+from wexample_wex_addon_app.item.file.mixin.app_dependencies_config_file_mixin import (
+    AppDependenciesConfigFileMixin,
+)
 if TYPE_CHECKING:
+    from packaging.requirements import Requirement
     from tomlkit import TOMLDocument
 @base_class
-class PythonPyprojectTomlFile(TomlFile):
-    def add_dependency(
+class PythonPyprojectTomlFile(AppDependenciesConfigFileMixin, TomlFile):
+    def add_dependency_from_spec(
         self,
-        package_name: str,
-        version: str,
-        operator: str = "==",
+        spec: Requirement,
         optional: bool = False,
         group: None | str = None,
     ) -> bool:
@@ -24,13 +26,11 @@ class PythonPyprojectTomlFile(TomlFile):
         from packaging.utils import canonicalize_name
         from wexample_filestate_python.helpers.toml import toml_sort_string_array
-        spec = f"{package_name}{operator}{version}"
-        new_req = Requirement(spec)
-        new_name = canonicalize_name(new_req.name)
+        new_name = canonicalize_name(spec.name)
         deps = self._get_deps_array(optional=optional, group=group)
-        # Look for existing dependency
+        # Look for existing dependency (string-based)
         old_spec = next(
             (d for d in deps if canonicalize_name(Requirement(d).name) == new_name),
             None,
@@ -40,8 +40,11 @@ class PythonPyprojectTomlFile(TomlFile):
         if old_spec:
             deps.remove(old_spec)
+        # Convert Requirement → string
+        new_spec_str = str(spec)
         # Add new version
-        deps.append(spec)
+        deps.append(new_spec_str)
         # Sort array
         toml_sort_string_array(deps)
@@ -49,7 +52,23 @@ class PythonPyprojectTomlFile(TomlFile):
         # Save file
         self.write_parsed()
-        return old_spec != spec
+        return old_spec != new_spec_str
+    def add_dependency_from_string(
+        self,
+        package_name: str,
+        version: str,
+        operator: str = "==",
+        optional: bool = False,
+        group: None | str = None,
+    ) -> bool:
+        from packaging.requirements import Requirement
+        return self.add_dependency_from_spec(
+            spec=Requirement(f"{package_name}{operator}{version}"),
+            optional=optional,
+            group=group,
+        )
     def dumps(self, content: TOMLDocument | dict | None = None) -> str:
         """Serialize a TOMLDocument (preferred) or a plain dict to TOML.

wexample_wex_addon_dev_python-0.1.0/src/wexample_wex_addon_dev_python/resources/package_publish_gitlab.yml ADDED Viewed

@@ -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.63 → wexample_wex_addon_dev_python-0.1.0}/src/wexample_wex_addon_dev_python/workdir/python_package_workdir.py RENAMED Viewed

@@ -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],
@@ -164,7 +224,7 @@ class PythonPackageWorkdir(PythonWorkdir):
                     pkg = suite_workdir.get_package(dep_name)
                     if pkg:
                         # Get dependencies of this suite package and recurse
-                        pkg_dependencies = pkg.list_dependencies_names()
+                        pkg_dependencies = pkg.get_dependencies_versions().keys()
                         collect_recursive(pkg_dependencies)
         # Start with direct dependencies from pyproject.toml
@@ -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,
         )
@@ -210,7 +273,9 @@ class PythonPackageWorkdir(PythonWorkdir):
             # Package is part of a suite that may have a venv configured.
             if suite_workdir:
                 # Get all dependencies from pyproject.toml
-                pyproject_toml_dependencies = toml_file.list_dependencies_names()
+                pyproject_toml_dependencies = (
+                    toml_file.get_dependencies_versions().keys()
+                )
                 # Get all packages from the suite ordered by dependencies (leaf -> trunk)
                 suite_packages = suite_workdir.get_ordered_packages()
@@ -289,25 +354,131 @@ 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,
+        )
-        client = PipyGateway(parent_io_handler=self)
+        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}'
             )
-        else:
-            # Map token to PyPI's token-based authentication if provided
-            username = "__token__"
-            password = self.get_env_parameter_or_suite_fallback("PIPY_TOKEN")
-            # Build the publish command, adding credentials only when given
-            publish_cmd = ["pdm", "publish"]
-            if username is not None:
-                publish_cmd += ["--username", username]
-            if password is not None:
-                publish_cmd += ["--password", password]
-            shell_run(publish_cmd, inherit_stdio=True, cwd=self.get_path())
+            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__"
+        ).get_str_or_none()
+        self.subtitle("Publishing to PyPI")
+        publish_cmd = ["pdm", "publish"]
+        username = repository_username or "__token__"
+        password = repository_token or self.get_env_parameter_or_suite_fallback(
+            "PIPY_TOKEN"
+        )
+        if username:
+            publish_cmd += ["--username", username]
+        if password:
+            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.63 → wexample_wex_addon_dev_python-0.1.0}/src/wexample_wex_addon_dev_python/workdir/python_workdir.py RENAMED Viewed

@@ -243,15 +243,15 @@ class PythonWorkdir(CodeBaseWorkdir):
         return raw_value
-    def save_dependency(self, package_name: str, 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_name=package_name, 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."""
@@ -298,47 +298,6 @@ class PythonWorkdir(CodeBaseWorkdir):
             if report_path.exists():
                 self.info(f"Report: @path{{{report_path}}}")
-    def update_dependencies(self, dependencies_map: dict[str, str]) -> None:
-        """Update dependencies versions based on the provided map.
-        Args:
-            dependencies_map: Dictionary mapping package names to their new versions.
-                             Example: {"wexample-helpers": "0.2.3", "attrs": "23.1.0"}
-        """
-        from packaging.requirements import Requirement
-        from packaging.utils import canonicalize_name
-        config_file = self.get_app_config_file()
-        # Canonicalize the keys in dependencies_map for consistent matching
-        canonical_map = {
-            canonicalize_name(name): version
-            for name, version in dependencies_map.items()
-        }
-        # Get current dependencies
-        current_deps = config_file.list_dependencies_names()
-        # Update each dependency if it's in the map
-        for dep_spec in current_deps:
-            try:
-                req = Requirement(dep_spec)
-                canonical_name = canonicalize_name(req.name)
-                # If this dependency is in our update map, update it
-                if canonical_name in canonical_map:
-                    new_version = canonical_map[canonical_name]
-                    # Use add_dependency which handles removal of old version
-                    config_file.add_dependency(
-                        package_name=req.name, version=new_version
-                    )
-            except Exception:
-                # Skip unparsable dependencies
-                continue
-        # Save the updated config
-        config_file.write_parsed()
     def _create_init_children_factory(self) -> ChildrenFileFactoryOption:
         from wexample_filestate.const.disk import DiskItemType
         from wexample_filestate.const.globals import NAME_PATTERN_NO_LEADING_DOT
@@ -517,7 +476,7 @@ class PythonWorkdir(CodeBaseWorkdir):
         toml_file = self.get_app_config_file()
         # Get all dependencies from pyproject.toml
         python_install_dependencies_in_venv(
-            venv_path=venv_path, names=toml_file.list_dependencies_names()
+            venv_path=venv_path, names=toml_file.get_dependencies_versions().keys()
         )
     def _on_test_event(self, event: Event) -> None: