wexample-wex-addon-dev-python 0.0.63__py3-none-any.whl → 0.1.0__py3-none-any.whl

wexample_wex_addon_dev_python/commands/code/check.py

@@ -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/commands/code/format.py

@@ -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/commands/examples/validate.py

@@ -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/file/python_pyproject_toml_file.py

@@ -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/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/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],
@@ -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/workdir/python_workdir.py

@@ -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:

{wexample_wex_addon_dev_python-0.0.63.dist-info → wexample_wex_addon_dev_python-0.1.0.dist-info}/METADATA

@@ -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.dist-info → wexample_wex_addon_dev_python-0.1.0.dist-info}/RECORD

@@ -1,23 +1,23 @@
-wexample_wex_addon_dev_python-0.0.63.dist-info/METADATA,sha256=PLQFvaRQQdEWjXJqFeaka-gjx7ip9AJwkVG1yVnEqJM,8124
-wexample_wex_addon_dev_python-0.0.63.dist-info/WHEEL,sha256=tsUv_t7BDeJeRHaSrczbGeuK-TtDpGsWi_JfpzD255I,90
-wexample_wex_addon_dev_python-0.0.63.dist-info/entry_points.txt,sha256=6OYgBcLyFCUgeqLgnvMyOJxPCWzgy7se4rLPKtNonMs,34
+wexample_wex_addon_dev_python-0.1.0.dist-info/METADATA,sha256=Fc49_n_IPbkQvqXpmsXHCGnZL5WqcwMiuDcYJIOmIVQ,6259
+wexample_wex_addon_dev_python-0.1.0.dist-info/WHEEL,sha256=Z36eTX6lG3PITRleSd5hAZHCcz52yg3c0JQVxKBbLW0,90
+wexample_wex_addon_dev_python-0.1.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
 wexample_wex_addon_dev_python/commands/code/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-wexample_wex_addon_dev_python/commands/code/check.py,sha256=wCL9KM64kCJ76OaxVDus7fjqiEhtLI8jUHFtSLG89u4,3324
+wexample_wex_addon_dev_python/commands/code/check.py,sha256=Bm5ON0UA7QmFTfO70QkfkqjzpGJu3fAw3tQjzdxbW7I,3404
 wexample_wex_addon_dev_python/commands/code/check/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 wexample_wex_addon_dev_python/commands/code/check/mypy.py,sha256=hZ1taOAofaFgqhtbHLXA14-4cFkVcw6QUi9PmpbEKuk,1401
 wexample_wex_addon_dev_python/commands/code/check/pylint.py,sha256=cSnirIVrMH9-_ETAiIVdjCvHQWcNJzCwwAfvcxNBodM,3328
 wexample_wex_addon_dev_python/commands/code/check/pyright.py,sha256=jCKZxQ5Ln2Vh1QlhKqz3i0djnQwWbNHzDcttu41jhsI,3619
-wexample_wex_addon_dev_python/commands/code/format.py,sha256=7Xep5RCgbt_JNKM9FROipuEFYfXojJjJDRNRKfqTkoM,2444
+wexample_wex_addon_dev_python/commands/code/format.py,sha256=7HnXLl2-b_ZYsuj45wDr1ue9AL7g7gOo12fLkV1dilE,2530
 wexample_wex_addon_dev_python/commands/code/format/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
 wexample_wex_addon_dev_python/commands/code/format/black.py,sha256=wo3BEODFD6BUrmnfheESMyLppLPwtvcgkOVfvHWdAZs,1462
 wexample_wex_addon_dev_python/commands/code/format/isort.py,sha256=pRYYPZWFza6e_HgKYpYplzV5hwJvbM3NNJ_-A3x1yV8,1540
 wexample_wex_addon_dev_python/commands/examples/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 wexample_wex_addon_dev_python/commands/examples/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 wexample_wex_addon_dev_python/commands/examples/utils/some_example_type.py,sha256=zusGlLOLkt2EpPFk38FIRA6d_5Q92Y7-TLj8ofHhQk0,121
-wexample_wex_addon_dev_python/commands/examples/validate.py,sha256=jHiWkEtETkVSYJKuvUJRNqd9Ag81z3sPdUbX6FUpEng,664
+wexample_wex_addon_dev_python/commands/examples/validate.py,sha256=IgUHNpkdc_Z76HGDWmCvztP7B3ars0Cu2Yknq9MGt0o,752
 wexample_wex_addon_dev_python/commands/release/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 wexample_wex_addon_dev_python/config_value/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 wexample_wex_addon_dev_python/config_value/__pycache__/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -29,18 +29,19 @@ wexample_wex_addon_dev_python/const/python.py,sha256=jxdPt5CnD0dcp4SmobEc_c7XcCk
 wexample_wex_addon_dev_python/file/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 wexample_wex_addon_dev_python/file/__pycache__/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 wexample_wex_addon_dev_python/file/python_app_iml_file.py,sha256=l6YHEILxSGFjOvYWY20zIyAODjOIfuyHsuCfSMw0jVE,1201
-wexample_wex_addon_dev_python/file/python_pyproject_toml_file.py,sha256=GM89r1ZwN88MUMysItqlIrPCN-r-Rc9hvahRMjA2Ny0,15323
+wexample_wex_addon_dev_python/file/python_pyproject_toml_file.py,sha256=31KcRaewYzK1mHYFLSltyZ9WhuEzV98I5vllmmGWGkU,15952
 wexample_wex_addon_dev_python/middleware/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 wexample_wex_addon_dev_python/middleware/__pycache__/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 wexample_wex_addon_dev_python/middleware/each_python_file_middleware.py,sha256=UzNEpedCYf31aNONFl0SuSJnoXRzhJhgEiTCaPark6E,2311
 wexample_wex_addon_dev_python/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 wexample_wex_addon_dev_python/python_addon_manager.py,sha256=Mmr9F5lOS2gbb8JTB4-vTri4Qn5Cd2Jukjk7uiTr1Hs,582
 wexample_wex_addon_dev_python/resources/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+wexample_wex_addon_dev_python/resources/package_publish_gitlab.yml,sha256=WVMj-DeFedQak5s5FraEnM1Rx1-ut4KgPodvAVv25ZM,304
 wexample_wex_addon_dev_python/resources/readme_templates/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 wexample_wex_addon_dev_python/resources/readme_templates/tests.md.j2,sha256=tKLcDwx7jhQkryXIxWr12AK-hKEaP6Rusu2MrluiABs,1289
 wexample_wex_addon_dev_python/workdir/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 wexample_wex_addon_dev_python/workdir/__pycache__/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-wexample_wex_addon_dev_python/workdir/python_package_workdir.py,sha256=djUfgI1MCn9KOgYCYiwFIpZaGQ28spaiOz6t8gL6FoA,11780
+wexample_wex_addon_dev_python/workdir/python_package_workdir.py,sha256=Fd2A7Qpsy_jstE4zj6AD4PPbMSOGkoBibhCFLDAZrXo,17637
 wexample_wex_addon_dev_python/workdir/python_packages_suite_workdir.py,sha256=ICHHewLpsXiheYzGDEahphBryH98ZVezWzSAy6A5w5I,2874
-wexample_wex_addon_dev_python/workdir/python_workdir.py,sha256=ERpSw5qti1NmHiufOix6bS5lW2vIvclr82SKwlWOhKk,19681
-wexample_wex_addon_dev_python-0.0.63.dist-info/RECORD,,
+wexample_wex_addon_dev_python/workdir/python_workdir.py,sha256=tx6UcaBHnrq9khQ6ndG14BzFPNOlqhl-626iNoL6T1o,18078
+wexample_wex_addon_dev_python-0.1.0.dist-info/RECORD,,

{wexample_wex_addon_dev_python-0.0.63.dist-info → wexample_wex_addon_dev_python-0.1.0.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: pdm-backend (2.4.6)
+Generator: pdm-backend (2.4.8)
 Root-Is-Purelib: true
 Tag: py3-none-any