wexample-wex-addon-dev-python 7.3.0__tar.gz → 7.4.0__tar.gz

{wexample_wex_addon_dev_python-7.3.0 → wexample_wex_addon_dev_python-7.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: wexample-wex-addon-dev-python
-Version: 7.3.0
+Version: 7.4.0
 Summary: Python dev addon for wex
 Author-Email: weeger <contact@wexample.com>
 License: MIT
@@ -16,7 +16,7 @@ Requires-Dist: networkx
 Requires-Dist: pylint
 Requires-Dist: pyright
 Requires-Dist: wexample-filestate-python>=6.4.0
-Requires-Dist: wexample-wex-addon-app>=10.0.0
+Requires-Dist: wexample-wex-addon-app>=11.1.0
 Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-cov; extra == "dev"
@@ -24,7 +24,7 @@ Description-Content-Type: text/markdown
 
 # wex_addon_dev_python
 
-Version: 7.3.0
+Version: 7.4.0
 
 Python dev addon for wex
 
@@ -111,7 +111,7 @@ Visit the [Wexample Suite documentation](https://docs.wexample.com) for the comp
 - pylint: 
 - pyright: 
 - wexample-filestate-python: >=6.4.0
-- wexample-wex-addon-app: >=10.0.0
+- wexample-wex-addon-app: >=11.1.0
 
 ## Versioning & Compatibility Policy
 

{wexample_wex_addon_dev_python-7.3.0 → wexample_wex_addon_dev_python-7.4.0}/README.md

@@ -1,6 +1,6 @@
 # wex_addon_dev_python
 
-Version: 7.3.0
+Version: 7.4.0
 
 Python dev addon for wex
 
@@ -87,7 +87,7 @@ Visit the [Wexample Suite documentation](https://docs.wexample.com) for the comp
 - pylint: 
 - pyright: 
 - wexample-filestate-python: >=6.4.0
-- wexample-wex-addon-app: >=10.0.0
+- wexample-wex-addon-app: >=11.1.0
 
 ## Versioning & Compatibility Policy
 

{wexample_wex_addon_dev_python-7.3.0 → wexample_wex_addon_dev_python-7.4.0}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "pdm.backend"
 
 [project]
 name = "wexample-wex-addon-dev-python"
-version = "7.3.0"
+version = "7.4.0"
 description = "Python dev addon for wex"
 authors = [
     { name = "weeger", email = "contact@wexample.com" },
@@ -25,7 +25,7 @@ dependencies = [
     "pylint",
     "pyright",
     "wexample-filestate-python>=6.4.0",
-    "wexample-wex-addon-app>=10.0.0",
+    "wexample-wex-addon-app>=11.1.0",
 ]
 
 [project.readme]

wexample_wex_addon_dev_python-7.4.0/src/wexample_wex_addon_dev_python/services/python/app_service.py

@@ -0,0 +1,85 @@
+from __future__ import annotations
+
+from wexample_wex_addon_app.service.app_service import AppService as BaseAppService
+
+PYPROJECT_TOML_CONTENT = """\
+[build-system]
+requires = ["pdm-backend"]
+build-backend = "pdm.backend"
+
+[project]
+name = "app"
+version = "0.0.1"
+description = "Python app"
+authors = [
+    { name = "weeger", email = "contact@wexample.com" },
+]
+requires-python = ">=3.11,<3.14"
+dependencies = [
+]
+
+[tool.pdm]
+distribution = true
+
+[tool.pdm.build]
+package-dir = "src"
+
+[[tool.pdm.build.packages]]
+include = "app"
+from = "src"
+
+[tool.pdm.dev-dependencies]
+dev = [
+    "pytest>=8.0.0",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]
+"""
+
+MAIN_CONTENT = """\
+if __name__ == "__main__":
+    print("OK")
+"""
+
+
+class AppService(BaseAppService):
+    def get_workdir_contribution(self) -> dict:
+        from wexample_filestate.const.disk import DiskItemType
+
+        return {
+            "children": [
+                {
+                    "name": "pyproject.toml",
+                    "type": DiskItemType.FILE,
+                    "should_exist": True,
+                    "default_content": PYPROJECT_TOML_CONTENT,
+                },
+                {
+                    "name": "src",
+                    "type": DiskItemType.DIRECTORY,
+                    "should_exist": True,
+                    "children": [
+                        {
+                            "name": "app",
+                            "type": DiskItemType.DIRECTORY,
+                            "should_exist": True,
+                            "children": [
+                                {
+                                    "name": "__init__.py",
+                                    "type": DiskItemType.FILE,
+                                    "should_exist": True,
+                                },
+                                {
+                                    "name": "__main__.py",
+                                    "type": DiskItemType.FILE,
+                                    "should_exist": True,
+                                    "default_content": MAIN_CONTENT,
+                                },
+                            ],
+                        }
+                    ],
+                },
+            ]
+        }

wexample_wex_addon_dev_python-7.4.0/src/wexample_wex_addon_dev_python/services/python/commands/service/install.py

@@ -0,0 +1,42 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from wexample_wex_core.const.globals import COMMAND_TYPE_SERVICE
+from wexample_wex_core.decorator.command import command
+
+if TYPE_CHECKING:
+    from wexample_wex_addon_app.service.app_service import AppService
+    from wexample_wex_core.context.execution_context import ExecutionContext
+
+
+@command(
+    type=COMMAND_TYPE_SERVICE,
+    description="Register docker image build config for the python service",
+)
+def python__service__install(
+    context: ExecutionContext,
+    service: AppService,
+) -> None:
+    project_name = service.app_workdir.get_project_name()
+
+    config_file = service.app_workdir.get_config_file()
+    config = config_file.read_config()
+
+    if config.search("docker.images").is_none():
+        config.set_by_path(
+            "docker.images",
+            {
+                "base": {
+                    "dockerfile": ".wex/docker/images/Dockerfile.base",
+                    "tag": f"{project_name}:local",
+                },
+                "develop": {
+                    "dockerfile": ".wex/docker/images/Dockerfile.develop",
+                    "tag": f"{project_name}-dev:local",
+                    "depends_on": "base",
+                },
+            },
+        )
+        config_file.write_config(config)
+        context.io.log(f"Registered docker images for '{project_name}'")

wexample_wex_addon_dev_python-7.4.0/src/wexample_wex_addon_dev_python/services/python/commands/service/setup.py

@@ -0,0 +1,58 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from wexample_wex_core.const.globals import COMMAND_TYPE_SERVICE
+from wexample_wex_core.decorator.command import command
+
+if TYPE_CHECKING:
+    from wexample_wex_addon_app.service.app_service import AppService
+    from wexample_wex_core.context.execution_context import ExecutionContext
+
+
+@command(
+    type=COMMAND_TYPE_SERVICE,
+    description="Build python docker images if not already built (idempotent via lock)",
+)
+def python__service__setup(
+    context: ExecutionContext,
+    service: AppService,
+) -> None:
+    import subprocess
+
+    from wexample_helpers.helpers.file import file_mkdir_as_real_user
+    from wexample_wex_addon_app.helpers.image_builds import (
+        load_builds,
+        resolve_build_order,
+    )
+
+    app_path = service.app_workdir.get_path()
+    lock_dir = app_path / ".wex" / "local" / "setup"
+    lock_file = lock_dir / "python.done"
+
+    if lock_file.exists():
+        return
+
+    try:
+        builds = load_builds(app_path)
+    except (FileNotFoundError, KeyError):
+        context.io.log("No docker.images in config.yml, skipping image build")
+        return
+
+    ordered = resolve_build_order(builds)
+
+    for build_name in ordered:
+        build = builds[build_name]
+        dockerfile = str(app_path / build["dockerfile"])
+        tag = build["tag"]
+        cmd = ["docker", "build", "-f", dockerfile, "-t", tag]
+        if "depends_on" in build:
+            parent_tag = builds[build["depends_on"]]["tag"]
+            cmd += ["--build-arg", f"BASE_IMAGE={parent_tag}"]
+        cmd.append(str(app_path))
+        context.io.log(f"Building image '{build_name}' → {tag}")
+        subprocess.run(cmd, check=True)
+
+    file_mkdir_as_real_user(lock_dir)
+    lock_file.write_text("done\n")
+    context.io.log("Python setup complete.")

wexample_wex_addon_dev_python-7.4.0/src/wexample_wex_addon_dev_python/services/python/docker/.wex.yml

@@ -0,0 +1,2 @@
+filestate:
+  python_init: false

wexample_wex_addon_dev_python-7.4.0/src/wexample_wex_addon_dev_python/services/python/docker/docker-compose.yml

@@ -0,0 +1,17 @@
+services:
+  python:
+    container_name: ${APP_PROJECT_NAME}_python
+    image: ${APP_NAME}-dev:local
+    build:
+      context: ${APP_PATH}
+      dockerfile: ${APP_SETUP_PATH}docker/images/Dockerfile.develop
+      args:
+        BASE_IMAGE: ${APP_NAME}:local
+    command: [ "bash", "/opt/app/.wex/docker/entrypoint.sh" ]
+    volumes:
+      - ${APP_PATH}:/opt/app/
+    expose:
+      - "8000"
+    extends:
+      file: ${SERVICE_DEFAULT_COMPOSE}
+      service: default

wexample_wex_addon_dev_python-7.4.0/src/wexample_wex_addon_dev_python/services/python/samples/docker/docker-compose.yml

@@ -0,0 +1,5 @@
+services:
+  python:
+    extends:
+      file: ${SERVICE_PYTHON_COMPOSE}
+      service: python

wexample_wex_addon_dev_python-7.4.0/src/wexample_wex_addon_dev_python/services/python/samples/docker/entrypoint.sh

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+set -e
+
+exec python -m app

wexample_wex_addon_dev_python-7.4.0/src/wexample_wex_addon_dev_python/services/python/samples/docker/images/Dockerfile.base

@@ -0,0 +1,16 @@
+FROM python:3.12-bookworm
+
+WORKDIR /opt/app/
+
+RUN useradd --uid 1000 owner --create-home \
+  && adduser owner sudo \
+  && mkdir -p /etc/sudoers.d \
+  && echo "owner ALL=(ALL) NOPASSWD: ALL" > /etc/sudoers.d/owner
+
+RUN pip install --no-cache-dir --upgrade pip setuptools wheel
+
+COPY . /opt/app/
+
+RUN pip install --no-cache-dir .
+
+CMD ["bash"]

wexample_wex_addon_dev_python-7.4.0/src/wexample_wex_addon_dev_python/services/python/samples/docker/images/Dockerfile.develop

@@ -0,0 +1,7 @@
+ARG BASE_IMAGE
+FROM ${BASE_IMAGE:-app:local}
+
+RUN pip install --no-cache-dir watchdog>=3.0.0
+
+# Reinstall in editable mode so volume-mounted source is always live
+RUN pip install -e /opt/app/

wexample_wex_addon_dev_python-7.4.0/src/wexample_wex_addon_dev_python/services/python/service.yml

@@ -0,0 +1,8 @@
+name: python
+tags:
+  - python
+  - dev
+docker:
+  compose: docker/docker-compose.yml
+config:
+  proxy: true