wexample-wex-addon-dev-python 0.0.61__tar.gz → 0.0.63__tar.gz

{wexample_wex_addon_dev_python-0.0.61 → wexample_wex_addon_dev_python-0.0.63}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: wexample-wex-addon-dev-python
-Version: 0.0.61
+Version: 0.0.63
 Summary: Python dev addon for wex
 Author-Email: weeger <contact@wexample.com>
 License: MIT
@@ -11,13 +11,12 @@ 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: jinja2
 Requires-Dist: networkx
 Requires-Dist: pylint
 Requires-Dist: pyright
-Requires-Dist: wexample-filestate-python==0.0.56
-Requires-Dist: wexample-wex-addon-app==0.0.53
-Requires-Dist: wexample-wex-core==6.0.65
+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"
@@ -25,10 +24,49 @@ Description-Content-Type: text/markdown
 
 # wexample-wex-addon-dev-python
 
-Version: 0.0.61
+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.
@@ -115,13 +153,13 @@ Breaking changes are clearly documented with upgrade paths and examples.
 
 Current limitations and planned features are tracked in the GitHub issues.
 
-See the [project roadmap](https://github.com/wexample/python-wex-dev-python/issues) for upcoming features and improvements.
+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 security@wexample.com.
+If you discover a security vulnerability, please email contact@wexample.com.
 
 **Do not** open public issues for security vulnerabilities.
 
@@ -144,7 +182,7 @@ Community support is available through GitHub Discussions.
 
 ## Contribution Guidelines
 
-We welcome contributions to the Wexample suite! 
+We welcome contributions to the Wexample suite!
 
 ### How to Contribute
 
@@ -162,19 +200,21 @@ See [CONTRIBUTORS.md](CONTRIBUTORS.md) for the full list of contributors.
 
 ## License
 
-MIT
+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-dev-python
+- **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-dev-python/issues
-- **Discussions**: https://github.com/wexample/python-wex-dev-python/discussions
+- **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 Python packages designed to work seamlessly together.
+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
 
@@ -182,9 +222,27 @@ The suite includes packages for configuration management, file handling, prompts
 
 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 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.
+[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_wex_addon_dev_python-0.0.61 → wexample_wex_addon_dev_python-0.0.63}/README.md

@@ -1,9 +1,48 @@
 # wexample-wex-addon-dev-python
 
-Version: 0.0.61
+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.
@@ -90,13 +129,13 @@ Breaking changes are clearly documented with upgrade paths and examples.
 
 Current limitations and planned features are tracked in the GitHub issues.
 
-See the [project roadmap](https://github.com/wexample/python-wex-dev-python/issues) for upcoming features and improvements.
+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 security@wexample.com.
+If you discover a security vulnerability, please email contact@wexample.com.
 
 **Do not** open public issues for security vulnerabilities.
 
@@ -119,7 +158,7 @@ Community support is available through GitHub Discussions.
 
 ## Contribution Guidelines
 
-We welcome contributions to the Wexample suite! 
+We welcome contributions to the Wexample suite!
 
 ### How to Contribute
 
@@ -137,19 +176,21 @@ See [CONTRIBUTORS.md](CONTRIBUTORS.md) for the full list of contributors.
 
 ## License
 
-MIT
+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-dev-python
+- **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-dev-python/issues
-- **Discussions**: https://github.com/wexample/python-wex-dev-python/discussions
+- **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 Python packages designed to work seamlessly together.
+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
 
@@ -157,9 +198,27 @@ The suite includes packages for configuration management, file handling, prompts
 
 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 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.
+[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_wex_addon_dev_python-0.0.61 → wexample_wex_addon_dev_python-0.0.63}/pyproject.toml

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

wexample_wex_addon_dev_python-0.0.63/src/wexample_wex_addon_dev_python/config_value/python_package_readme_config_value.py

@@ -0,0 +1,50 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from wexample_helpers.decorator.base_class import base_class
+from wexample_wex_addon_app.config_value.app_readme_config_value import (
+    AppReadmeConfigValue,
+)
+
+if TYPE_CHECKING:
+    pass
+
+
+@base_class
+class PythonPackageReadmeContentConfigValue(AppReadmeConfigValue):
+    """README generation for Python packages."""
+
+    def _get_app_description(self) -> str:
+        """Extract description from pyproject.toml."""
+        return self.workdir.get_app_config().get("project", {}).get("description")
+
+    def _get_app_homepage(self) -> str:
+        """Extract homepage URL from pyproject.toml."""
+        project = self.workdir.get_app_config()
+        urls = (
+            project.get("urls", {}) if isinstance(project.get("urls", {}), dict) else {}
+        )
+        return urls.get("homepage") or urls.get("Homepage") or ""
+
+    def _get_project_license(self) -> str | None:
+        """Extract license information from pyproject.toml."""
+        project = self.workdir.get_app_config()
+        license_field = project.get("license", {})
+        if isinstance(license_field, dict):
+            return license_field.get("text", "") or license_field.get("file", "")
+        return str(license_field) if license_field else ""
+
+    def _get_template_context(self) -> dict:
+        """Build template context with Python-specific variables.
+
+        Adds python_version to the base context.
+        """
+        context = super()._get_template_context()
+
+        # Add Python-specific variable
+        context["python_version"] = (
+            self.workdir.get_app_config().get("project", {}).get("requires-python", "")
+        )
+
+        return context

wexample_wex_addon_dev_python-0.0.63/src/wexample_wex_addon_dev_python/file/python_app_iml_file.py

@@ -0,0 +1,41 @@
+from __future__ import annotations
+
+from collections.abc import Iterable
+from typing import Any, ClassVar
+
+from wexample_app.item.file.iml_file import ImlFile
+
+
+class PythonAppImlFile(ImlFile):
+    """
+    IntelliJ IDEA .iml helper tailored for Python apps (src/tests layout, python module type).
+    """
+
+    MODULE_TYPE: ClassVar[str] = "PYTHON_MODULE"
+
+    def _default_exclude_folders(self) -> Iterable[dict[str, Any]]:
+        return (
+            {
+                "@url": f"{self.MODULE_DIR_URL}/dist",
+            },
+        )
+
+    def _default_module_attributes(self) -> dict[str, str]:
+        attrs = super()._default_module_attributes()
+        attrs.setdefault("@type", self.MODULE_TYPE)
+        return attrs
+
+    def _default_order_entries(self) -> Iterable[dict[str, Any]]:
+        return ({"@type": "sourceFolder", "@forTests": "false"},)
+
+    def _default_source_folders(self) -> Iterable[dict[str, Any]]:
+        return (
+            {
+                "@url": f"{self.MODULE_DIR_URL}/src",
+                "@isTestSource": "false",
+            },
+            {
+                "@url": f"{self.MODULE_DIR_URL}/tests",
+                "@isTestSource": "true",
+            },
+        )

wexample_wex_addon_dev_python-0.0.61/src/wexample_wex_addon_dev_python/file/python_package_toml_file.py → wexample_wex_addon_dev_python-0.0.63/src/wexample_wex_addon_dev_python/file/python_pyproject_toml_file.py

@@ -8,35 +8,47 @@ from wexample_wex_addon_app.const.path import APP_PATH_README
 
 if TYPE_CHECKING:
     from tomlkit import TOMLDocument
-    from wexample_wex_addon_app.workdir.code_base_workdir import (
-        CodeBaseWorkdir,
-    )
 
 
 @base_class
-class PythonPackageTomlFile(TomlFile):
+class PythonPyprojectTomlFile(TomlFile):
     def add_dependency(
-        self, spec: str, optional: bool = False, group: str = "dev"
+        self,
+        package_name: str,
+        version: str,
+        operator: str = "==",
+        optional: bool = False,
+        group: None | str = None,
     ) -> bool:
         from packaging.requirements import Requirement
         from packaging.utils import canonicalize_name
         from wexample_filestate_python.helpers.toml import toml_sort_string_array
 
-        deps = self._get_deps_array(optional=optional, group=group)
+        spec = f"{package_name}{operator}{version}"
         new_req = Requirement(spec)
         new_name = canonicalize_name(new_req.name)
 
-        old_spec = None
-        for dep in deps:
-            if canonicalize_name(Requirement(dep).name) == new_name:
-                old_spec = dep
-                break
+        deps = self._get_deps_array(optional=optional, group=group)
 
-        self.remove_dependency_by_name(new_name, optional=optional, group=group)
+        # Look for existing dependency
+        old_spec = next(
+            (d for d in deps if canonicalize_name(Requirement(d).name) == new_name),
+            None,
+        )
+
+        # Remove old dep if exists
+        if old_spec:
+            deps.remove(old_spec)
 
+        # Add new version
         deps.append(spec)
+
+        # Sort array
         toml_sort_string_array(deps)
 
+        # Save file
+        self.write_parsed()
+
         return old_spec != spec
 
     def dumps(self, content: TOMLDocument | dict | None = None) -> str:
@@ -47,10 +59,10 @@ class PythonPackageTomlFile(TomlFile):
 
         content = content or self.read_parsed()
 
-        package = self.find_package_workdir()
-        import_name = package.get_package_import_name() if package else None
-        project_name = package.get_package_name() if package else None
-        project_version = package.get_project_version() if package else None
+        workdir = self.get_parent_item()
+        import_name = workdir.get_package_import_name()
+        project_name = workdir.get_package_name()
+        project_version = workdir.get_project_version()
 
         self._enforce_build_system(content)
         self._enforce_pdm_build(content, import_name)
@@ -65,40 +77,21 @@ class PythonPackageTomlFile(TomlFile):
 
         return result
 
-    def find_package_workdir(self) -> CodeBaseWorkdir | None:
-        from wexample_wex_addon_app.workdir.code_base_workdir import CodeBaseWorkdir
-
-        return self.find_closest(CodeBaseWorkdir)
-
-    def list_dependencies(
+    def get_dependencies_versions(
         self, optional: bool = False, group: str = "dev"
-    ) -> list[str]:
-        deps = self._get_deps_array(optional=optional, group=group)
-        return [str(x) for x in list(deps)]
-
-    def list_dependency_names(
-        self,
-        canonicalize_names: bool = True,
-        optional: bool = False,
-        group: str = "dev",
-    ) -> list[str]:
-        """Return dependency package names derived from list_dependencies().
-
-        If canonicalize_names is True, names are normalized using packaging's
-        canonicalize_name for robust comparisons (dash/underscore, case, etc.).
-        """
+    ) -> dict[str, str]:
         from packaging.requirements import Requirement
         from packaging.utils import canonicalize_name
 
-        names: list[str] = []
-        for spec in self.list_dependencies(optional=optional, group=group):
-            try:
-                name = Requirement(spec).name
-                names.append(canonicalize_name(name) if canonicalize_names else name)
-            except Exception:
-                # Skip unparsable entries when deriving names
-                continue
-        return names
+        deps = self._get_deps_array(optional=optional, group=group)
+
+        map = {}
+        for spec in list(deps):
+            req = Requirement(spec)
+            # name: version
+            map[canonicalize_name(req.name)] = str(req.specifier)
+
+        return map
 
     def optional_group_array(self, group: str):
         """Ensure and return project.optional-dependencies[group] as multi-line array."""
@@ -197,34 +190,28 @@ class PythonPackageTomlFile(TomlFile):
             project_tbl["requires-python"] = ">=3.10"
 
         # Add description if available
-        package = self.find_package_workdir()
-        if package:
-            description = package.get_config().search("global.description")
-            if not description.is_none():
-                project_tbl["description"] = description.get_str()
+        workdir = self.get_parent_item()
+        description = workdir.get_config().search("global.description")
+        if not description.is_none():
+            project_tbl["description"] = description.get_str()
 
         # Add authors if available
-        if package:
-            from tomlkit import array, inline_table
+        from tomlkit import array, inline_table
 
-            author_name = package.search_in_package_or_suite_config(
-                "global.authors.name"
-            )
-            author_email = package.search_in_package_or_suite_config(
-                "global.authors.email"
-            )
+        author_name = workdir.search_in_package_or_suite_config("global.authors.name")
+        author_email = workdir.search_in_package_or_suite_config("global.authors.email")
 
-            if not author_name.is_none() or not author_email.is_none():
-                authors_arr = array()
-                author_tbl = inline_table()
+        if not author_name.is_none() or not author_email.is_none():
+            authors_arr = array()
+            author_tbl = inline_table()
 
-                if not author_name.is_none():
-                    author_tbl["name"] = author_name.get_str()
-                if not author_email.is_none():
-                    author_tbl["email"] = author_email.get_str()
+            if not author_name.is_none():
+                author_tbl["name"] = author_name.get_str()
+            if not author_email.is_none():
+                author_tbl["email"] = author_email.get_str()
 
-                authors_arr.append(author_tbl)
-                project_tbl["authors"] = authors_arr
+            authors_arr.append(author_tbl)
+            project_tbl["authors"] = authors_arr
 
         # Add classifiers (standard Python package metadata)
         project_tbl["classifiers"] = [
@@ -234,14 +221,11 @@ class PythonPackageTomlFile(TomlFile):
         ]
 
         # Add README if it exists
-        if package:
-            pass
-
-            readme_file = package.find_by_name(APP_PATH_README)
-            if readme_file:
-                readme_tbl, _ = toml_ensure_table(project_tbl, ["readme"])
-                readme_tbl["file"] = str(APP_PATH_README)
-                readme_tbl["content-type"] = "text/markdown"
+        readme_file = workdir.find_by_name(APP_PATH_README)
+        if readme_file:
+            readme_tbl, _ = toml_ensure_table(project_tbl, ["readme"])
+            readme_tbl["file"] = str(APP_PATH_README)
+            readme_tbl["content-type"] = "text/markdown"
 
         # Add MIT license
         license_tbl, _ = toml_ensure_table(project_tbl, ["license"])
@@ -305,7 +289,6 @@ class PythonPackageTomlFile(TomlFile):
 
         toml_sort_string_array(dev_arr)
 
-    # --- Unified dependency accessors (runtime vs optional) ---
     def _get_deps_array(self, optional: bool = False, group: str = "dev"):
         """Return TOML array for runtime deps or optional group (multiline)."""
         return (