@grain/binaryen.ml 0.10.0 → 0.12.0

{binaryen-archive → binaryen-archive-v0.12.0}/CHANGELOG.md

@@ -1,5 +1,56 @@
 # Changelog
 
+## [0.12.0](https://www.github.com/grain-lang/binaryen.ml/compare/v0.11.2...v0.12.0) (2022-01-26)
+
+
+### ⚠ BREAKING CHANGES
+
+* Add table type to add_table signature
+* Rename Event to Tag to match Binaryen
+
+### Features
+
+* Add table type to add_table signature ([5c50272](https://www.github.com/grain-lang/binaryen.ml/commit/5c502720943a8bf6e649891051db00336eec9451))
+* Add update_maps function that Binaryen added ([5c50272](https://www.github.com/grain-lang/binaryen.ml/commit/5c502720943a8bf6e649891051db00336eec9451))
+* Rename Event to Tag to match Binaryen ([5c50272](https://www.github.com/grain-lang/binaryen.ml/commit/5c502720943a8bf6e649891051db00336eec9451))
+* Upgrade to libbinaryen v102 ([#120](https://www.github.com/grain-lang/binaryen.ml/issues/120)) ([5c50272](https://www.github.com/grain-lang/binaryen.ml/commit/5c502720943a8bf6e649891051db00336eec9451))
+
+### [0.11.2](https://www.github.com/grain-lang/binaryen.ml/compare/v0.11.1...v0.11.2) (2022-01-24)
+
+
+### Bug Fixes
+
+* Handle JS global in non-node environments ([#125](https://www.github.com/grain-lang/binaryen.ml/issues/125)) ([74e94fe](https://www.github.com/grain-lang/binaryen.ml/commit/74e94fe8ac7b2c2a66b8118b5eaa3a81e5f9296a))
+
+### [0.11.1](https://www.github.com/grain-lang/binaryen.ml/compare/v0.11.0...v0.11.1) (2022-01-16)
+
+
+### Bug Fixes
+
+* Make features work in 32-bit mode ([#123](https://www.github.com/grain-lang/binaryen.ml/issues/123)) ([e435c8b](https://www.github.com/grain-lang/binaryen.ml/commit/e435c8bd9f6619c42b82e53e5d1caa929b5d4ebf))
+
+## [0.11.0](https://www.github.com/grain-lang/binaryen.ml/compare/v0.10.0...v0.11.0) (2022-01-13)
+
+
+### ⚠ BREAKING CHANGES
+
+* Mention implicit python dependency in the docs
+* Switch to libbinaryen dependency (#113)
+* Remove MacOS-specific library flags (#111)
+* Require OCaml 4.12 (#108)
+
+### Features
+
+* Depend on libbinaryen ([59874ce](https://www.github.com/grain-lang/binaryen.ml/commit/59874ce785288d4a33ed5408ac4a0a33e16ff4c1))
+* Remove MacOS-specific library flags ([#111](https://www.github.com/grain-lang/binaryen.ml/issues/111)) ([5a67f9f](https://www.github.com/grain-lang/binaryen.ml/commit/5a67f9f330332f8957976841819707d09124dc94))
+* Require OCaml 4.12 ([#108](https://www.github.com/grain-lang/binaryen.ml/issues/108)) ([36eedea](https://www.github.com/grain-lang/binaryen.ml/commit/36eedea279fb19ee6131b72b21c24ba0a9d7f993))
+* Switch to libbinaryen dependency ([#113](https://www.github.com/grain-lang/binaryen.ml/issues/113)) ([59874ce](https://www.github.com/grain-lang/binaryen.ml/commit/59874ce785288d4a33ed5408ac4a0a33e16ff4c1))
+
+
+### Miscellaneous Chores
+
+* Mention implicit python dependency in the docs ([59874ce](https://www.github.com/grain-lang/binaryen.ml/commit/59874ce785288d4a33ed5408ac4a0a33e16ff4c1))
+
 ## [0.10.0](https://www.github.com/grain-lang/binaryen.ml/compare/v0.9.1...v0.10.0) (2021-05-09)
 
 

{binaryen-archive → binaryen-archive-v0.12.0}/README.md

@@ -18,9 +18,9 @@ let params = Type.create [| Type.int32; Type.int32 |]
 let results = Type.int32
 
 (* Get arguments 0 and 1, add them *)
-let x = Expression.local_get wasm_mod 0 Type.int32
-let y = Expression.local_get wasm_mod 1 Type.int32
-let add = Expression.binary wasm_mod Op.add_int32 x y
+let x = Expression.Local_get.make wasm_mod 0 Type.int32
+let y = Expression.Local_get.make wasm_mod 1 Type.int32
+let add = Expression.Binary.make wasm_mod Op.add_int32 x y
 
 (* Create the add function *)
 (* Note: no additional local variables *)
@@ -35,13 +35,37 @@ let _ = Module.dispose wasm_mod
 This project aims to provide full feature parity with the [Binaryen C API](https://github.com/WebAssembly/binaryen/blob/master/src/binaryen-c.h). It's fairly complete, but a few things still need bindings:
 
 - SIMD instructions
-- Events
+- Tags
 - Atomics
 - Query operations on expressions
 - Query operations on functions
 
 None of these are particularly challenging to create bindings for—they just haven't been written yet. If you need anything that's missing, feel free to open a PR.
 
+## Python dependency
+
+When using this package with `esy`, you'll need to ensure that a `python` executable exists in one of these locations: `/usr/local/bin/python`, `/usr/bin/python`, `/bin/python`, `/usr/sbin/python`, or `/sbin/python`. Esy will only look for python in those locations, and it is not provided for you in the sandbox.
+
+**Note:** This implicit dependency will be removed in a future version.
+
+## MacOS C++ Compiler
+
+When including this library in your `dune` MacOS executables, you'll need to specify `-cc clang++` in your `(ocamlopt_flags)` stanza. This is required because Binaryen will throw errors for itself to catch and using `clang++` is the only way to handle them correctly. You can find more info on this [ocaml issue](https://github.com/ocaml/ocaml/issues/10423).
+
+Your stanza could look something like this:
+
+```diff
+ (executable
+  (name example)
+  (public_name example)
+  (package example)
++ (ocamlopt_flags -cc clang++)
+  (modules example)
+  (libraries binaryen))
+```
+
+These flags likely won't work on other operating systems, so you'll probably need to use `dune-configurator` to vary the flags per platform. You can see an example of this in our [tests/](./tests/dune).
+
 ## Static Linking
 
 If you are planning to create portable binaries for Windows, it will try to find Cygwin/MinGW locations in your `PATH`. To avoid this, you probably want to add this to your `(executable)` stanzas:

{binaryen-archive → binaryen-archive-v0.12.0}/binaryen.opam

@@ -1,5 +1,5 @@
 opam-version: "2.0"
-version: "0.10.0"
+version: "0.12.0"
 synopsis: "OCaml bindings for Binaryen"
 maintainer: "oscar@grain-lang.org"
 author: "Oscar Spencer"
@@ -12,11 +12,11 @@ build: [
   [ "dune" "build" "-p" name "-j" jobs ]
 ]
 depends: [
-  "ocaml" {>= "4.09"}
-  "dune" {>= "2.7.1"}
-  "dune-configurator" {>= "2.7.1"}
-  "js_of_ocaml" {>= "3.6.0"}
-  "js_of_ocaml-ppx" {>= "3.6.0"}
-  "js_of_ocaml-compiler" {>= "3.6.0"}
+  "ocaml" {>= "4.12"}
+  "dune" {>= "2.9.1"}
+  "dune-configurator" {>= "2.9.1"}
+  "js_of_ocaml" {>= "3.10.0"}
+  "js_of_ocaml-ppx" {>= "3.10.0"}
+  "js_of_ocaml-compiler" {>= "3.10.0"}
+  "libbinaryen" {>= "102.0.4" < "103.0.0"}
 ]
-available: arch = "x86_64" & (os = "linux" | os = "macos" | os = "win32")