plasmite 0.6.1

Persistent JSON message queues backed by plain files for local and remote IPC
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101

"""
Purpose: Extend setuptools build to bundle native SDK artifacts into Python wheels.
Key Exports: build_py override that stages libplasmite + plasmite CLI under plasmite/_native.
Role: Packaging bridge for batteries-included Python distributions.
Invariants: PLASMITE_LIB_DIR remains a runtime override; bundled assets are optional for source installs.
Invariants: Wheels should include at most one shared library and one CLI binary.
Notes: Prefers PLASMITE_SDK_DIR (SDK layout), then falls back to repo-local target/debug.
"""

from __future__ import annotations

import os
import shutil
from pathlib import Path

from setuptools import setup
from setuptools.command.build_py import build_py

try:
    from setuptools.command.bdist_wheel import bdist_wheel
except ImportError:  # pragma: no cover - fallback for older setuptools
    from wheel.bdist_wheel import bdist_wheel

try:
    from setuptools.command.bdist_wheel import bdist_wheel
except ImportError:  # pragma: no cover - fallback for older setuptools
    from wheel.bdist_wheel import bdist_wheel

try:
    from setuptools.command.bdist_wheel import bdist_wheel
except ImportError:  # pragma: no cover - fallback for older setuptools
    from wheel.bdist_wheel import bdist_wheel


class BuildPyWithNativeBundle(build_py):
    """Copy native artifacts into the package before wheel build."""

    _NATIVE_FILES = (
        "plasmite.dll",
        "libplasmite.dylib",
        "libplasmite.so",
        "libplasmite.a",
        "plasmite.exe",
        "plasmite",
    )

    def run(self) -> None:
        self._bundle_native_assets()
        super().run()

    def _bundle_native_assets(self) -> None:
        project_root = Path(__file__).resolve().parent
        package_native_dir = project_root / "plasmite" / "_native"
        package_native_dir.mkdir(parents=True, exist_ok=True)

        for filename in self._NATIVE_FILES:
            candidate = package_native_dir / filename
            if candidate.exists():
                candidate.unlink()

        for src in self._native_candidates(project_root):
            if src.exists():
                dst = package_native_dir / src.name
                shutil.copy2(src, dst)
                if src.name == "plasmite":
                    dst.chmod(0o755)

    def _native_candidates(self, project_root: Path) -> list[Path]:
        sdk_dir_env = os.environ.get("PLASMITE_SDK_DIR")
        if sdk_dir_env:
            sdk_dir = Path(sdk_dir_env)
            return [
                sdk_dir / "lib" / "plasmite.dll",
                sdk_dir / "lib" / "libplasmite.dylib",
                sdk_dir / "lib" / "libplasmite.so",
                sdk_dir / "lib" / "libplasmite.a",
                sdk_dir / "bin" / "plasmite.exe",
                sdk_dir / "bin" / "plasmite",
            ]

        repo_root = project_root.parent.parent
        target_debug = repo_root / "target" / "debug"
        return [
            target_debug / "plasmite.dll",
            target_debug / "libplasmite.dylib",
            target_debug / "libplasmite.so",
            target_debug / "libplasmite.a",
            target_debug / "plasmite.exe",
            target_debug / "plasmite",
        ]


class BdistWheelWithNativeBundle(bdist_wheel):
    """Emit platform-tagged wheels because bundled assets are platform-specific."""

    def finalize_options(self) -> None:
        super().finalize_options()
        self.root_is_pure = False


setup(cmdclass={"build_py": BuildPyWithNativeBundle, "bdist_wheel": BdistWheelWithNativeBundle})