package pyml_bindgen

  1. Overview
  2. Docs
Generate pyml bindings from OCaml value specifications

Install

Dune Dependency

Authors

Maintainers

Sources

0.1.1.tar.gz
md5=69d7838ad3a32865974aa911d095e114
sha512=e84e7028c8bf573748655dd572c24bbe649641bee97c28976a6d9553ed28d5366f76158c191db466318862b4127bdab6efa7779d900639943034de7f7526a490

Description

Published: 09 Nov 2021

README

OCaml-Python Bindings Generator

Generate Python bindings with pyml directly from OCaml value specifications.

While you could write all your Python bindings by hand, it can be tedious and it gets old real quick. While pyml_bindgen can't yet auto-generate all the bindings you may need, it can definitely take care of a lot of the tedious and repetitive work you need to do when writing bindings for a big Python library!! 💖

Quick start

You have a Python class you want to bind and use in OCaml. (Filename: adder.py)

class Adder:
    @staticmethod
    def add(x, y):
        return x + y

To do so, you write OCaml value specifications for the class and methods you want to bind. (Filename: val_specs.txt)

val add : x:int -> y:int -> unit -> int

Then, you run pyml_bindgen.

$ pyml_bindgen val_specs.txt adder Adder --caml-module Adder > lib.ml

Now you can use your generated functions in your OCaml code. (Filename: run.ml)

open Lib

let () = Py.initialize ()

let result = Adder.add ~x:1 ~y:2 ()

let () = assert (result = 3)

Finally, set up a dune file and run it.

(executable
 (name run)
 (libraries pyml))
$ dune exec ./run.exe

Documentation

For information on installing and using pyml_bindgen, check out the docs.

License

Copyright (c) 2021 Ryan M. Moore.

Licensed under the Apache License, Version 2.0 or the MIT license, at your option. This program may not be copied, modified, or distributed except according to those terms.

Dependencies (10)

  1. ocaml >= "4.08.0"
  2. stdio >= "v0.12"
  3. re2 >= "v0.12"
  4. ppx_string >= "v0.12"
  5. ppx_sexp_conv >= "v0.12"
  6. ppx_let >= "v0.12"
  7. cmdliner >= "1.0"
  8. base >= "v0.12" & < "v0.17.0"
  9. angstrom >= "0.15.0"
  10. dune >= "2.8"

Dev Dependencies (10)

  1. odoc with-doc
  2. bisect_ppx dev
  3. pyml with-test
  4. ppx_expect >= "v0.12" & with-test
  5. ppx_inline_test >= "v0.12" & with-test
  6. ocamlformat with-test & < "0.20.0"
  7. core_kernel >= "v0.12" & with-test
  8. conf-python-3-dev >= "1" & with-test
  9. cmdliner with-test & < "1.1.0"
  10. dune with-test & < "3.0"

Used by

None

Conflicts

None

OCaml

Innovation. Community. Security.