wexample-wex-addon-dev-python 0.0.63__py3-none-any.whl → 0.0.64__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/workdir/python_package_workdir.py

@@ -164,7 +164,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
@@ -210,7 +210,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()
@@ -290,24 +292,54 @@ class PythonPackageWorkdir(PythonWorkdir):
         from wexample_filestate_python.common.pipy_gateway import PipyGateway
         from wexample_helpers.helpers.shell import shell_run
 
-        client = PipyGateway(parent_io_handler=self)
+        # Retrieve custom repository configuration
+        repository_url = self.search_app_or_suite_runtime_config(
+            "pdm.repository.url", default=None
+        )
+
+        repository_token = self.search_app_or_suite_runtime_config(
+            "pdm.repository.token", default=None
+        )
+
+        repository_username = self.search_app_or_suite_runtime_config(
+            "pdm.repository.username", default="__token__"
+        )
 
         package_name = self.get_package_name()
         version = self.get_project_version()
-        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}'
-            )
+
+        # Only check if package exists on PyPI if no custom repository is configured
+        if not repository_url:
+            client = PipyGateway(parent_io_handler=self)
+            if client.package_release_exists(
+                package_name=package_name, version=version
+            ):
+                self.warning(
+                    f'Trying to publish an existing release for package "{package_name}" version {version}'
+                )
+                if not force:
+                    return
+
+        # Build the publish command
+        publish_cmd = ["pdm", "publish"]
+
+        # Add custom repository URL if provided
+        if repository_url:
+            publish_cmd += ["--repository", repository_url]
+            self.subtitle(f"Publishing to custom repository: {repository_url}")
         else:
-            # 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())
+            self.subtitle("Publishing to PyPI")
+
+        # Add credentials
+        # Priority: custom token > env variable fallback
+        username = repository_username or "__token__"
+        password = repository_token or self.get_env_parameter_or_suite_fallback(
+            "PIPY_TOKEN"
+        )
+
+        if username:
+            publish_cmd += ["--username", username]
+        if password:
+            publish_cmd += ["--password", password]
+
+        shell_run(publish_cmd, inherit_stdio=True, cwd=self.get_path())

wexample_wex_addon_dev_python/workdir/python_workdir.py

@@ -243,10 +243,10 @@ class PythonWorkdir(CodeBaseWorkdir):
 
         return raw_value
 
-    def save_dependency(self, package_name: str, version: str) -> bool:
+    def save_dependency(self, package: CodeBaseWorkdir, version: str) -> bool:
         """Add or update a dependency with strict version."""
         config = self.get_app_config_file()
-        updated = config.add_dependency(package_name=package_name, version=version)
+        updated = config.add_dependency(package=package, version=version)
 
         if updated:
             config.write_parsed()
@@ -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.64.dist-info/METADATA

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

{wexample_wex_addon_dev_python-0.0.63.dist-info → wexample_wex_addon_dev_python-0.0.64.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.0.64.dist-info/METADATA,sha256=dy01AAsK4CFE28-yfpF9e4bps_j6NfoJLhTDLUZxv54,3128
+wexample_wex_addon_dev_python-0.0.64.dist-info/WHEEL,sha256=Wb0ASbVj8JvWHpOiIpPi7ucfIgJeCi__PzivviEAQFc,90
+wexample_wex_addon_dev_python-0.0.64.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,7 +29,7 @@ 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
@@ -40,7 +40,7 @@ wexample_wex_addon_dev_python/resources/readme_templates/__init__.py,sha256=47DE
 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=4jMZRHYGpBg5FqJuYK5j1A9VS7X4spIlDD-MgHKz7b4,12750
 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=jChU8h4fj5NmZxdrI2SP5c6erlmf5WTG_FKk_pjL66w,18084
+wexample_wex_addon_dev_python-0.0.64.dist-info/RECORD,,

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

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

wexample_wex_addon_dev_python-0.0.63.dist-info/METADATA

@@ -1,250 +0,0 @@
-Metadata-Version: 2.1
-Name: wexample-wex-addon-dev-python
-Version: 0.0.63
-Summary: Python dev addon for wex
-Author-Email: weeger <contact@wexample.com>
-License: MIT
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Project-URL: homepage, https://github.com/wexample/python-wex-dev-python
-Requires-Python: >=3.10
-Requires-Dist: attrs>=23.1.0
-Requires-Dist: cattrs>=23.1.0
-Requires-Dist: networkx
-Requires-Dist: pylint
-Requires-Dist: pyright
-Requires-Dist: wexample-filestate-python==0.0.58
-Requires-Dist: wexample-wex-addon-app==0.0.55
-Requires-Dist: wexample-wex-core==6.0.67
-Provides-Extra: dev
-Requires-Dist: pytest; extra == "dev"
-Requires-Dist: pytest-cov; extra == "dev"
-Description-Content-Type: text/markdown
-
-# wexample-wex-addon-dev-python
-
-Version: 0.0.63
-
-Python dev addon for wex
-
-## Table of Contents
-
-- [Status Compatibility](#status-compatibility)
-- [Api Reference](#api-reference)
-- [Tests](#tests)
-- [Code Quality](#code-quality)
-- [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.
-
-## 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%.
-
-## Code Quality & Typing
-
-All the suite packages follow strict quality standards:
-
-- **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
-
-These standards ensure reliability and maintainability across the suite.
-
-## 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.
-
-## 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
-
-If you discover a security vulnerability, please email contact@wexample.com.
-
-**Do not** open public issues for security vulnerabilities.
-
-We take security seriously and will respond promptly to verified reports.
-
-## Privacy & Telemetry
-
-This package does **not** collect any telemetry or usage data.
-
-Your privacy is respected — no data is transmitted to external services.
-
-## Support Channels
-
-- **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
-
-Community support is available through GitHub Discussions.
-
-## Contribution Guidelines
-
-We welcome contributions to the Wexample suite!
-
-### How to Contribute
-
-1. **Fork** the repository
-2. **Create** a feature branch
-3. **Make** your changes
-4. **Test** thoroughly
-5. **Submit** a pull request
-
-## Maintainers & Authors
-
-Maintained by the Wexample team and community contributors.
-
-See [CONTRIBUTORS.md](CONTRIBUTORS.md) for the full list of contributors.
-
-## 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.
-
-## Useful Links
-
-- **Homepage**: https://github.com/wexample/python-wex-addon-dev-python
-- **Documentation**: [docs.wexample.com](https://docs.wexample.com)
-- **Issue Tracker**: https://github.com/wexample/python-wex-addon-dev-python/issues
-- **Discussions**: https://github.com/wexample/python-wex-addon-dev-python/discussions
-- **PyPI**: [pypi.org/project/wexample-wex-addon-dev-python](https://pypi.org/project/wexample-wex-addon-dev-python/)
-
-## 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.
-
-## 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.
-
-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.
-