icpp-binaryen 116.0.0__py3-none-macosx_11_0_universal2.whl

icpp_binaryen/__init__.py

@@ -0,0 +1,25 @@
+"""icpp-binaryen: cffi bindings over Binaryen's C API, with the official
+Binaryen shared library bundled per platform.
+
+Public API — all of it:
+
+    from icpp_binaryen import ffi, lib          # raw escape hatch
+    from icpp_binaryen import Module            # load / optimize / emit / write
+    from icpp_binaryen import fix_globals_limit # the IC globals-limit fix
+    from icpp_binaryen import BINARYEN_VERSION  # int, from bundled version.txt
+"""
+
+from icpp_binaryen.version import __version__
+from icpp_binaryen._lib import BINARYEN_VERSION, ffi, lib
+from icpp_binaryen.module import Module
+from icpp_binaryen.fix_globals import GlobalsFixReport, fix_globals_limit
+
+__all__ = [
+    "BINARYEN_VERSION",
+    "GlobalsFixReport",
+    "Module",
+    "__version__",
+    "ffi",
+    "fix_globals_limit",
+    "lib",
+]

icpp_binaryen/_cdef.py

@@ -0,0 +1,40 @@
+"""Hand-curated cffi cdef: the subset of binaryen-c.h that the public API needs.
+
+Signatures are verified against the bundled Binaryen version's binaryen-c.h
+(the header ships in every official release tarball). Do NOT auto-translate
+the full header — add declarations one by one, only when a new API needs them.
+"""
+
+CDEF = """
+typedef uint32_t BinaryenIndex;
+typedef uint32_t BinaryenExternalKind;
+typedef struct BinaryenModule *BinaryenModuleRef;
+typedef struct BinaryenExport *BinaryenExportRef;
+
+BinaryenExternalKind BinaryenExternalGlobal(void);
+
+BinaryenModuleRef BinaryenModuleRead(char *input, size_t inputSize);
+void BinaryenModuleDispose(BinaryenModuleRef module);
+bool BinaryenModuleValidate(BinaryenModuleRef module);
+void BinaryenModuleOptimize(BinaryenModuleRef module);
+void BinaryenSetOptimizeLevel(int level);
+void BinaryenSetShrinkLevel(int level);
+
+BinaryenIndex BinaryenGetNumExports(BinaryenModuleRef module);
+BinaryenExportRef BinaryenGetExportByIndex(BinaryenModuleRef module,
+                                           BinaryenIndex index);
+BinaryenExternalKind BinaryenExportGetKind(BinaryenExportRef export_);
+const char *BinaryenExportGetName(BinaryenExportRef export_);
+void BinaryenRemoveExport(BinaryenModuleRef module, const char *externalName);
+
+BinaryenIndex BinaryenGetNumGlobals(BinaryenModuleRef module);
+
+typedef struct BinaryenModuleAllocateAndWriteResult {
+  void *binary;
+  size_t binaryBytes;
+  char *sourceMap;
+} BinaryenModuleAllocateAndWriteResult;
+BinaryenModuleAllocateAndWriteResult
+BinaryenModuleAllocateAndWrite(BinaryenModuleRef module,
+                               const char *sourceMapUrl);
+"""

icpp_binaryen/_lib.py

@@ -0,0 +1,58 @@
+"""Load the bundled libbinaryen with cffi in ABI mode (ffi.dlopen).
+
+No compiled extension module: the same wheel works for every supported
+Python version on its platform.
+"""
+
+import platform
+from pathlib import Path
+from typing import Any, cast
+
+from cffi import FFI
+
+from icpp_binaryen._cdef import CDEF
+from icpp_binaryen.version import __version__
+
+LIB_DIR = Path(__file__).parent / "lib"
+
+ffi = FFI()
+ffi.cdef(CDEF)
+
+
+def _lib_path() -> Path:
+    system = platform.system()
+    if system == "Darwin":
+        return LIB_DIR / "libbinaryen.dylib"
+    if system == "Linux":
+        return LIB_DIR / "libbinaryen.so"
+    raise ImportError(
+        f"icpp-binaryen does not support platform '{system}'. "
+        "Supported: macOS and Linux (on Windows, use WSL)."
+    )
+
+
+_path = _lib_path()
+if not _path.exists():
+    raise ImportError(
+        f"icpp-binaryen: bundled library not found at {_path}. "
+        "In a source checkout, run `make get-binaryen` first."
+    )
+
+lib = cast(Any, ffi.dlopen(str(_path)))
+
+BINARYEN_VERSION: int = int(
+    (LIB_DIR / "version.txt").read_text(encoding="utf-8").strip()
+)
+_expected = int(__version__.split(".", maxsplit=1)[0])
+if BINARYEN_VERSION != _expected:
+    raise ImportError(
+        f"icpp-binaryen {__version__} expects bundled Binaryen {_expected}, "
+        f"but lib/version.txt says {BINARYEN_VERSION}"
+    )
+
+# Binaryen's Allocate-and-write APIs return malloc'ed buffers that the caller
+# must free. In ABI mode free() is not a libbinaryen symbol, so take it from
+# the process' libc.
+_ffi_libc = FFI()
+_ffi_libc.cdef("void free(void *ptr);")
+libc = cast(Any, _ffi_libc.dlopen(None))

icpp_binaryen/fix_globals.py

@@ -0,0 +1,75 @@
+"""The one high-level entry point: the IC globals-limit fix.
+
+The Internet Computer rejects a wasm module with more than 1000 *defined*
+globals (install error IC0505). A wasi-sdk build of a large C++ project blows
+past this. The fix: remove every export of kind global (an exported global is
+otherwise kept alive), then run Binaryen's optimizer, which drops the now-dead
+globals.
+"""
+
+import shutil
+from dataclasses import dataclass
+from pathlib import Path
+from typing import Union
+
+from icpp_binaryen.module import Module
+
+
+@dataclass(frozen=True)
+class GlobalsFixReport:
+    """Before/after counts of a fix_globals_limit run."""
+
+    wasm_path: Path
+    backup_path: Path
+    exports_before: int
+    exports_after: int
+    globals_before: int
+    globals_after: int
+
+    def summary(self) -> str:
+        """The 4-line summary optimize_wasm.py prints today."""
+        return (
+            f"Exports before optimization: {self.exports_before}\n"
+            f"Exports after  optimization: {self.exports_after}\n"
+            f"Globals before optimization: {self.globals_before}\n"
+            f"Globals after  optimization: {self.globals_after}"
+        )
+
+
+def fix_globals_limit(
+    wasm_path: Union[Path, str], *, backup_suffix: str = "_before_opt"
+) -> GlobalsFixReport:
+    """Rewrite the wasm at wasm_path in place, keeping a backup copy.
+
+    The backup (default `<stem>_before_opt.wasm`) is a byte-identical copy of
+    the input: the optimize pass strips the wasm name section, and the backup
+    is what keeps named backtraces possible (e.g. under wasmtime).
+    """
+    path = Path(wasm_path).resolve()
+    backup_path = path.with_name(path.stem + backup_suffix + path.suffix)
+    shutil.copy(path, backup_path)
+
+    with Module.load(path) as module:
+        exports_before = module.num_exports
+        globals_before = module.num_globals
+
+        # Two passes: removing while iterating would invalidate the indices.
+        for name in module.global_export_names():
+            module.remove_export(name)
+
+        # Levels 0/0: this is an export-strip + dead-global removal, not a
+        # size optimization.
+        module.optimize(shrink_level=0, optimize_level=0)
+
+        exports_after = module.num_exports
+        globals_after = module.num_globals
+        module.write(path)
+
+    return GlobalsFixReport(
+        wasm_path=path,
+        backup_path=backup_path,
+        exports_before=exports_before,
+        exports_after=exports_after,
+        globals_before=globals_before,
+        globals_after=globals_after,
+    )

icpp_binaryen/lib/version.txt

@@ -0,0 +1 @@
+116

icpp_binaryen/module.py

@@ -0,0 +1,117 @@
+"""Pythonic wrapper around the raw Binaryen C API (read / inspect / optimize /
+emit). The raw `ffi` / `lib` pair stays available as the escape hatch."""
+
+from pathlib import Path
+from types import TracebackType
+from typing import Any, Optional, Union
+
+from icpp_binaryen._lib import ffi, lib, libc
+
+
+class Module:
+    """A Binaryen module handle."""
+
+    def __init__(self, ref: Any, keepalive: Any = None) -> None:
+        # keepalive holds the cffi buffer BinaryenModuleRead parsed from:
+        # the C API takes a non-const char* and the buffer must outlive the
+        # module.
+        self._ref: Any = ref
+        self._keepalive = keepalive
+
+    @classmethod
+    def read(cls, wasm_bytes: bytes) -> "Module":
+        """Construct a Module from wasm bytes."""
+        buf = ffi.new("char[]", wasm_bytes)
+        ref = lib.BinaryenModuleRead(buf, len(wasm_bytes))
+        if ref == ffi.NULL:
+            raise ValueError("BinaryenModuleRead failed to parse the wasm")
+        return cls(ref, keepalive=buf)
+
+    @classmethod
+    def load(cls, wasm_path: Union[Path, str]) -> "Module":
+        """Construct a Module from a wasm file."""
+        return cls.read(Path(wasm_path).read_bytes())
+
+    @property
+    def ref(self) -> Any:
+        """The raw BinaryenModuleRef, for use with `lib` directly."""
+        return self._ref
+
+    @property
+    def num_exports(self) -> int:
+        """Number of exports of any kind."""
+        return int(lib.BinaryenGetNumExports(self._ref))
+
+    @property
+    def num_globals(self) -> int:
+        """Number of *defined* globals (what the IC's 1000 limit counts)."""
+        return int(lib.BinaryenGetNumGlobals(self._ref))
+
+    def global_export_names(self) -> list[str]:
+        """Names of all exports of kind global."""
+        kind_global = lib.BinaryenExternalGlobal()
+        names: list[str] = []
+        for i in range(self.num_exports):
+            export_ref = lib.BinaryenGetExportByIndex(self._ref, i)
+            if lib.BinaryenExportGetKind(export_ref) == kind_global:
+                name = ffi.string(lib.BinaryenExportGetName(export_ref))
+                if isinstance(name, bytes):
+                    name = name.decode("utf-8")
+                names.append(name)
+        return names
+
+    def remove_export(self, external_name: str) -> None:
+        """Remove the export with the given external name."""
+        lib.BinaryenRemoveExport(self._ref, external_name.encode("utf-8"))
+
+    def optimize(self, shrink_level: int, optimize_level: int) -> None:
+        """Run Binaryen's default optimization pipeline at the given levels.
+
+        Note: the optimizer strips the wasm name section — keep a copy of the
+        input when named backtraces matter.
+        """
+        lib.BinaryenSetShrinkLevel(shrink_level)
+        lib.BinaryenSetOptimizeLevel(optimize_level)
+        lib.BinaryenModuleOptimize(self._ref)
+
+    def validate(self) -> bool:
+        """Run Binaryen validation on the module."""
+        return bool(lib.BinaryenModuleValidate(self._ref))
+
+    def emit(self) -> bytes:
+        """Serialize the module to wasm bytes."""
+        result = lib.BinaryenModuleAllocateAndWrite(self._ref, ffi.NULL)
+        try:
+            return bytes(ffi.buffer(result.binary, result.binaryBytes))
+        finally:
+            libc.free(result.binary)
+            if result.sourceMap != ffi.NULL:
+                libc.free(result.sourceMap)
+
+    def write(self, wasm_path: Union[Path, str]) -> None:
+        """Serialize the module to a wasm file."""
+        Path(wasm_path).write_bytes(self.emit())
+
+    def dispose(self) -> None:
+        """Free the Binaryen module; safe to call more than once."""
+        if self._ref is not None:
+            lib.BinaryenModuleDispose(self._ref)
+            self._ref = None
+            self._keepalive = None
+
+    def __enter__(self) -> "Module":
+        return self
+
+    def __exit__(
+        self,
+        exc_type: Optional[type[BaseException]],
+        exc: Optional[BaseException],
+        traceback: Optional[TracebackType],
+    ) -> None:
+        self.dispose()
+
+    def __del__(self) -> None:
+        try:
+            self.dispose()
+        except Exception:  # pylint: disable = broad-exception-caught
+            pass  # interpreter shutdown: lib may already be unloaded

icpp_binaryen/version.py

@@ -0,0 +1,7 @@
+"""Version of icpp-binaryen: <binaryen>.<minor>.<patch>.
+
+The major component IS the bundled Binaryen version; do not add anything but
+the version number here!
+"""
+
+__version__ = "116.0.0"

icpp_binaryen-116.0.0.dist-info/METADATA

@@ -0,0 +1,339 @@
+Metadata-Version: 2.4
+Name: icpp-binaryen
+Version: 116.0.0
+Summary: cffi bindings over Binaryen's C API with the official Binaryen shared library bundled per platform
+Author-email: icpp-pro <icpp@icpp.world>
+Maintainer-email: icpp-pro <icpp@icpp.world>
+License:                                  Apache License
+                                   Version 2.0, January 2004
+                                http://www.apache.org/licenses/
+        
+           TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+        
+           1. Definitions.
+        
+              "License" shall mean the terms and conditions for use, reproduction,
+              and distribution as defined by Sections 1 through 9 of this document.
+        
+              "Licensor" shall mean the copyright owner or entity authorized by
+              the copyright owner that is granting the License.
+        
+              "Legal Entity" shall mean the union of the acting entity and all
+              other entities that control, are controlled by, or are under common
+              control with that entity. For the purposes of this definition,
+              "control" means (i) the power, direct or indirect, to cause the
+              direction or management of such entity, whether by contract or
+              otherwise, or (ii) ownership of fifty percent (50%) or more of the
+              outstanding shares, or (iii) beneficial ownership of such entity.
+        
+              "You" (or "Your") shall mean an individual or Legal Entity
+              exercising permissions granted by this License.
+        
+              "Source" form shall mean the preferred form for making modifications,
+              including but not limited to software source code, documentation
+              source, and configuration files.
+        
+              "Object" form shall mean any form resulting from mechanical
+              transformation or translation of a Source form, including but
+              not limited to compiled object code, generated documentation,
+              and conversions to other media types.
+        
+              "Work" shall mean the work of authorship, whether in Source or
+              Object form, made available under the License, as indicated by a
+              copyright notice that is included in or attached to the work
+              (an example is provided in the Appendix below).
+        
+              "Derivative Works" shall mean any work, whether in Source or Object
+              form, that is based on (or derived from) the Work and for which the
+              editorial revisions, annotations, elaborations, or other modifications
+              represent, as a whole, an original work of authorship. For the purposes
+              of this License, Derivative Works shall not include works that remain
+              separable from, or merely link (or bind by name) to the interfaces of,
+              the Work and Derivative Works thereof.
+        
+              "Contribution" shall mean any work of authorship, including
+              the original version of the Work and any modifications or additions
+              to that Work or Derivative Works thereof, that is intentionally
+              submitted to Licensor for inclusion in the Work by the copyright owner
+              or by an individual or Legal Entity authorized to submit on behalf of
+              the copyright owner. For the purposes of this definition, "submitted"
+              means any form of electronic, verbal, or written communication sent
+              to the Licensor or its representatives, including but not limited to
+              communication on electronic mailing lists, source code control systems,
+              and issue tracking systems that are managed by, or on behalf of, the
+              Licensor for the purpose of discussing and improving the Work, but
+              excluding communication that is conspicuously marked or otherwise
+              designated in writing by the copyright owner as "Not a Contribution."
+        
+              "Contributor" shall mean Licensor and any individual or Legal Entity
+              on behalf of whom a Contribution has been received by Licensor and
+              subsequently incorporated within the Work.
+        
+           2. Grant of Copyright License. Subject to the terms and conditions of
+              this License, each Contributor hereby grants to You a perpetual,
+              worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+              copyright license to reproduce, prepare Derivative Works of,
+              publicly display, publicly perform, sublicense, and distribute the
+              Work and such Derivative Works in Source or Object form.
+        
+           3. Grant of Patent License. Subject to the terms and conditions of
+              this License, each Contributor hereby grants to You a perpetual,
+              worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+              (except as stated in this section) patent license to make, have made,
+              use, offer to sell, sell, import, and otherwise transfer the Work,
+              where such license applies only to those patent claims licensable
+              by such Contributor that are necessarily infringed by their
+              Contribution(s) alone or by combination of their Contribution(s)
+              with the Work to which such Contribution(s) was submitted. If You
+              institute patent litigation against any entity (including a
+              cross-claim or counterclaim in a lawsuit) alleging that the Work
+              or a Contribution incorporated within the Work constitutes direct
+              or contributory patent infringement, then any patent licenses
+              granted to You under this License for that Work shall terminate
+              as of the date such litigation is filed.
+        
+           4. Redistribution. You may reproduce and distribute copies of the
+              Work or Derivative Works thereof in any medium, with or without
+              modifications, and in Source or Object form, provided that You
+              meet the following conditions:
+        
+              (a) You must give any other recipients of the Work or
+                  Derivative Works a copy of this License; and
+        
+              (b) You must cause any modified files to carry prominent notices
+                  stating that You changed the files; and
+        
+              (c) You must retain, in the Source form of any Derivative Works
+                  that You distribute, all copyright, patent, trademark, and
+                  attribution notices from the Source form of the Work,
+                  excluding those notices that do not pertain to any part of
+                  the Derivative Works; and
+        
+              (d) If the Work includes a "NOTICE" text file as part of its
+                  distribution, then any Derivative Works that You distribute must
+                  include a readable copy of the attribution notices contained
+                  within such NOTICE file, excluding those notices that do not
+                  pertain to any part of the Derivative Works, in at least one
+                  of the following places: within a NOTICE text file distributed
+                  as part of the Derivative Works; within the Source form or
+                  documentation, if provided along with the Derivative Works; or,
+                  within a display generated by the Derivative Works, if and
+                  wherever such third-party notices normally appear. The contents
+                  of the NOTICE file are for informational purposes only and
+                  do not modify the License. You may add Your own attribution
+                  notices within Derivative Works that You distribute, alongside
+                  or as an addendum to the NOTICE text from the Work, provided
+                  that such additional attribution notices cannot be construed
+                  as modifying the License.
+        
+              You may add Your own copyright statement to Your modifications and
+              may provide additional or different license terms and conditions
+              for use, reproduction, or distribution of Your modifications, or
+              for any such Derivative Works as a whole, provided Your use,
+              reproduction, and distribution of the Work otherwise complies with
+              the conditions stated in this License.
+        
+           5. Submission of Contributions. Unless You explicitly state otherwise,
+              any Contribution intentionally submitted for inclusion in the Work
+              by You to the Licensor shall be under the terms and conditions of
+              this License, without any additional terms or conditions.
+              Notwithstanding the above, nothing herein shall supersede or modify
+              the terms of any separate license agreement you may have executed
+              with Licensor regarding such Contributions.
+        
+           6. Trademarks. This License does not grant permission to use the trade
+              names, trademarks, service marks, or product names of the Licensor,
+              except as required for reasonable and customary use in describing the
+              origin of the Work and reproducing the content of the NOTICE file.
+        
+           7. Disclaimer of Warranty. Unless required by applicable law or
+              agreed to in writing, Licensor provides the Work (and each
+              Contributor provides its Contributions) on an "AS IS" BASIS,
+              WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+              implied, including, without limitation, any warranties or conditions
+              of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+              PARTICULAR PURPOSE. You are solely responsible for determining the
+              appropriateness of using or redistributing the Work and assume any
+              risks associated with Your exercise of permissions under this License.
+        
+           8. Limitation of Liability. In no event and under no legal theory,
+              whether in tort (including negligence), contract, or otherwise,
+              unless required by applicable law (such as deliberate and grossly
+              negligent acts) or agreed to in writing, shall any Contributor be
+              liable to You for damages, including any direct, indirect, special,
+              incidental, or consequential damages of any character arising as a
+              result of this License or out of the use or inability to use the
+              Work (including but not limited to damages for loss of goodwill,
+              work stoppage, computer failure or malfunction, or any and all
+              other commercial damages or losses), even if such Contributor
+              has been advised of the possibility of such damages.
+        
+           9. Accepting Warranty or Additional Liability. While redistributing
+              the Work or Derivative Works thereof, You may choose to offer,
+              and charge a fee for, acceptance of support, warranty, indemnity,
+              or other liability obligations and/or rights consistent with this
+              License. However, in accepting such obligations, You may act only
+              on Your own behalf and on Your sole responsibility, not on behalf
+              of any other Contributor, and only if You agree to indemnify,
+              defend, and hold each Contributor harmless for any liability
+              incurred by, or claims asserted against, such Contributor by reason
+              of your accepting any such warranty or additional liability.
+        
+           END OF TERMS AND CONDITIONS
+        
+           APPENDIX: How to apply the Apache License to your work.
+        
+              To apply the Apache License to your work, attach the following
+              boilerplate notice, with the fields enclosed by brackets "{}"
+              replaced with your own identifying information. (Don't include
+              the brackets!)  The text should be enclosed in the appropriate
+              comment syntax for the file format. We also recommend that a
+              file or class name and description of purpose be included on the
+              same "printed page" as the copyright notice for easier
+              identification within third-party archives.
+        
+           Copyright {yyyy} {name of copyright owner}
+        
+           Licensed under the Apache License, Version 2.0 (the "License");
+           you may not use this file except in compliance with the License.
+           You may obtain a copy of the License at
+        
+               http://www.apache.org/licenses/LICENSE-2.0
+        
+           Unless required by applicable law or agreed to in writing, software
+           distributed under the License is distributed on an "AS IS" BASIS,
+           WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+           See the License for the specific language governing permissions and
+           limitations under the License.
+Project-URL: Homepage, https://www.onicai.com/
+Project-URL: Documentation, https://docs.icpp.world/
+Project-URL: Repository, https://github.com/icppWorld/icpp-binaryen
+Project-URL: Issues, https://github.com/icppWorld/icpp-binaryen/issues
+Project-URL: Changelog, https://github.com/icppWorld/icpp-binaryen/blob/main/CHANGELOG.md
+Keywords: Binaryen,WebAssembly,wasm,Internet Computer,blockchain
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: cffi>=1.15.1
+Provides-Extra: dev
+Requires-Dist: black==26.3.1; extra == "dev"
+Requires-Dist: pylint==3.3.4; extra == "dev"
+Requires-Dist: mypy==1.13.0; extra == "dev"
+Requires-Dist: build==1.2.2; extra == "dev"
+Requires-Dist: twine==6.0.1; extra == "dev"
+Requires-Dist: pytest==8.3.4; extra == "dev"
+Requires-Dist: types-cffi==2.1.0.20260827; extra == "dev"
+Requires-Dist: wasmtime==29.0.0; extra == "dev"
+Dynamic: license-file
+
+# icpp-binaryen
+
+[cffi](https://cffi.readthedocs.io/) bindings over
+[Binaryen](https://github.com/WebAssembly/binaryen)'s C API, with the official
+Binaryen shared library bundled per platform.
+
+Built and maintained by [icppWorld](https://github.com/icppWorld) for the
+[icpp-pro](https://docs.icpp.world) toolchain of the Internet Computer, and
+usable by any project that needs Binaryen from Python.
+
+## Why
+
+The Internet Computer rejects a wasm module with more than 1000 *defined*
+globals (install error `IC0505`). A wasi-sdk build of a large C++ project
+blows past this. The fix: remove every export of kind global (an exported
+global is otherwise kept alive), then run Binaryen's optimizer, which drops
+the now-dead globals. `fix_globals_limit` does exactly that.
+
+## Install
+
+```bash
+pip install icpp-binaryen
+```
+
+One wheel per platform (macOS x86_64 / arm64, Linux x86_64) covers every
+Python version >= 3.11: the bindings use cffi in ABI mode, so there is no
+compiled extension module. On Windows, use WSL.
+
+## Public API — all of it
+
+```python
+from icpp_binaryen import fix_globals_limit  # the one high-level entry point
+from icpp_binaryen import Module             # load / optimize / emit / write
+from icpp_binaryen import ffi, lib           # raw escape hatch
+from icpp_binaryen import BINARYEN_VERSION   # int, from the bundled version.txt
+```
+
+### fix_globals_limit
+
+```python
+from pathlib import Path
+from icpp_binaryen import fix_globals_limit
+
+report = fix_globals_limit(Path("build/my_canister.wasm"))
+print(report.summary())
+```
+
+Rewrites the wasm in place and keeps a byte-identical backup copy (default
+`<stem>_before_opt.wasm`). Returns a `GlobalsFixReport` with the
+before/after counts of exports and defined globals.
+
+Documented side effect: the optimize pass strips the wasm *name section*.
+The `_before_opt` backup is what keeps named backtraces possible (e.g. under
+wasmtime). This is by design — do not delete the backup pair.
+
+### Module
+
+```python
+from icpp_binaryen import Module
+
+with Module.load("my.wasm") as module:      # or Module.read(wasm_bytes)
+    print(module.num_exports, module.num_globals)
+    for name in module.global_export_names():
+        module.remove_export(name)
+    module.optimize(shrink_level=0, optimize_level=0)
+    assert module.validate()
+    module.write("my_fixed.wasm")           # or wasm_bytes = module.emit()
+```
+
+### ffi / lib
+
+The raw ABI-mode cffi handles, for post-processing needs beyond the wrapper.
+The cdef is a hand-curated subset of `binaryen-c.h` — see
+`src/icpp_binaryen/_cdef.py` for what is available. `module.ref` hands you
+the raw `BinaryenModuleRef` for use with `lib` directly.
+
+## Versioning
+
+`<binaryen>.<minor>.<patch>` — the major component IS the bundled Binaryen
+version, asserted at import time. The wasm bytes this package emits are part
+of its contract: minor/patch releases are byte-identical in
+`fix_globals_limit` output; a Binaryen bump is a major release.
+
+## Contributing
+
+See [README-feature-guide.md](README-feature-guide.md) (the ceremony-based
+development process) and
+[README-release-guide.md](README-release-guide.md). Development setup:
+
+```bash
+conda create --name icpp-binaryen python=3.11
+conda activate icpp-binaryen
+make install-python
+make get-binaryen        # fetch the official Binaryen lib for this platform
+make all-tests
+```
+
+## Credits & license
+
+Apache-2.0, like [Binaryen](https://github.com/WebAssembly/binaryen) itself.
+The cffi-over-libbinaryen approach was inspired by
+[jonathanharg/binaryen.py](https://github.com/jonathanharg/binaryen.py),
+which this package replaces for the icpp-pro toolchain.

icpp_binaryen-116.0.0.dist-info/RECORD

@@ -0,0 +1,14 @@
+icpp_binaryen/__init__.py,sha256=NnmVb0YuE3iqsVYjpGJcZq4uaqNAJMQTY2ZJehntJsQ,816
+icpp_binaryen/_cdef.py,sha256=kfJOa55b81k-JsgjtZuBEZADSkVswYUjhdbdaJWODcw,1652
+icpp_binaryen/_lib.py,sha256=hWKemZBxQuppIe0OT6QRkYd7IMnAZNSph1hCSKgAzrQ,1641
+icpp_binaryen/fix_globals.py,sha256=JEe0rZflzopON0d-JpIjJAUu40xKOG8elfZRSmyQ9AY,2542
+icpp_binaryen/module.py,sha256=S6sRSpSB7PfPejCpMOgd_4Jwiol0GoEctn736UcY9J4,4282
+icpp_binaryen/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+icpp_binaryen/version.py,sha256=bR4JP7tii83QkwfG47j6xQh6YJd3xwV8rsfc0aQFhFg,189
+icpp_binaryen/lib/libbinaryen.dylib,sha256=JqF-Y5KHigf0HsVeuZXUpmukMUsHn5FS9RHqmcPgmeE,17002480
+icpp_binaryen/lib/version.txt,sha256=5bhhptipZt_KfnNBzT62vpkBaI1UenLr7QsfXhTz0I0,3
+icpp_binaryen-116.0.0.dist-info/licenses/LICENSE,sha256=xazLvYVG6Uw0rtJK_miaYXYn0Y7tWmxIJ35I21fCOFE,11356
+icpp_binaryen-116.0.0.dist-info/METADATA,sha256=XBZwTr0Mk3jxErwp9NyOtiIXmnKyki2eIw-clHlx6Ac,18188
+icpp_binaryen-116.0.0.dist-info/WHEEL,sha256=FPT8q8lmwJmqWWKWOfxFvTTs_idkkncMGBHC_t8YJ3M,111
+icpp_binaryen-116.0.0.dist-info/top_level.txt,sha256=FkeMNx9-Zs1gg9hmChsugE7vn-iog3RBqLuOasfVTlc,14
+icpp_binaryen-116.0.0.dist-info/RECORD,,

icpp_binaryen-116.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: false
+Tag: py3-none-macosx_11_0_universal2
+

icpp_binaryen-116.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "{}"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright {yyyy} {name of copyright owner}
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

icpp_binaryen-116.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+icpp_binaryen