feat: Add OCaml Binding

.github/workflows/bindings_ocaml.yml

@@ -0,0 +1,57 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you 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.
+
+name: Bindings Ocaml CI
+
+on:
+  push:
+    branches:
+      - main
+    tags:
+      - '*'
+  pull_request:
+    branches:
+      - main
+    paths:
+      - "bindings/ocaml/**"
+      - ".github/workflows/bindings_ocaml.yml"
+  workflow_dispatch:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout PR
+        uses: actions/checkout@v2
+
+      - name: Set up ocaml
+        uses: ocaml/setup-ocaml@v2
+        with:
+          ocaml-compiler: 4.14
+          dune-cache: true
+      - name: Checks
+        run: |
+          # make sure tests pass
+          opam install -y dune ounit2 ocamlformat
+          eval $(opam env)
+          cd bindings/ocaml
+          dune runtest
+          dune build @fmt
+
+
+

.github/workflows/ci.yml

@@ -75,6 +75,16 @@ jobs:
           distribution: temurin
           java-version: "11"
 
+      - name: Checkout ocaml env
+        uses: ocaml/setup-ocaml@v2
+        with:
+          ocaml-compiler: 4.14
+          dune-cache: true
+      - name: Set Opam env
+        run: opam env | tr '\n' ' ' >> $GITHUB_ENV
+      - name: Add Opam switch to PATH
+        run: opam var bin >> $GITHUB_PATH
+
       - name: Cargo doc
         run: cargo doc --lib --no-deps --all-features -p opendal
 
@@ -99,6 +109,15 @@ jobs:
         with:
           distribution: temurin
           java-version: "11"
+      - name: Checkout ocaml env
+        uses: ocaml/setup-ocaml@v2
+        with:
+          ocaml-compiler: 4.14
+          dune-cache: true
+      - name: Set Opam env
+        run: opam env | tr '\n' ' ' >> $GITHUB_ENV
+      - name: Add Opam switch to PATH
+        run: opam var bin >> $GITHUB_PATH
 
       - name: Cargo clippy
         run: cargo clippy --all-targets --all-features --workspace -- -D warnings
@@ -145,6 +164,15 @@ jobs:
         with:
           distribution: temurin
           java-version: "11"
+      - name: Checkout ocaml env
+        uses: ocaml/setup-ocaml@v2
+        with:
+          ocaml-compiler: 4.14
+          dune-cache: true
+      - name: Set Opam env
+        run: opam env | tr '\n' ' ' >> $GITHUB_ENV
+      - name: Add Opam switch to PATH
+        run: opam var bin >> $GITHUB_PATH
 
       - name: Setup Rust toolchain
         uses: ./.github/actions/setup
@@ -168,6 +196,15 @@ jobs:
         with:
           distribution: temurin
           java-version: "11"
+      - name: Checkout ocaml env
+        uses: ocaml/setup-ocaml@v2
+        with:
+          ocaml-compiler: 4.14
+          dune-cache: true
+      - name: Set Opam env
+        run: opam env | tr '\n' ' ' >> $GITHUB_ENV
+      - name: Add Opam switch to PATH
+        run: opam var bin >> $GITHUB_PATH
 
       - name: Setup Rust toolchain
         uses: ./.github/actions/setup

Cargo.toml

@@ -33,6 +33,7 @@ members = [
   "bindings/haskell",
   "bindings/lua",
   "bindings/dotnet",
+  "bindings/ocaml",
 
   "bin/oli",
   "bin/oay",

bindings/ocaml/.gitignore

@@ -0,0 +1 @@
+_build

bindings/ocaml/.ocamlformat-ignore

@@ -0,0 +1 @@
+src/**

bindings/ocaml/Cargo.toml

@@ -0,0 +1,40 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you 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.
+
+[package]
+name = "opendal-ocaml"
+publish = false
+
+authors.workspace = true
+edition.workspace = true
+homepage.workspace = true
+license.workspace = true
+repository.workspace = true
+rust-version.workspace = true
+version.workspace = true
+
+[lib]
+crate-type = ["staticlib", "cdylib"]
+doc = false
+
+[dependencies]
+opendal.workspace = true
+ocaml = {version = "^1.0.0-beta"}
+
+[build-dependencies]
+ocaml-build = {version = "^1.0.0-beta"}
+

bindings/ocaml/README.md

@@ -0,0 +1,22 @@
+# OpenDAL OCaml Binding (WIP)
+
+## Requirements
+
+* OCaml version > 4.03 and < 5.0.0
+
+
+## Build
+
+
+
+```bash
+cd bindings/ocaml
+dune build
+```
+
+## Test
+
+```bash
+cd bindings/ocaml
+dune test
+```

bindings/ocaml/build.rs

@@ -0,0 +1,20 @@
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The ASF licenses this file
+// to you 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.
+
+pub fn main() -> std::io::Result<()> {
+    ocaml_build::Sigs::new("src/opendal.ml").generate()
+}

bindings/ocaml/dune

@@ -0,0 +1,18 @@
+; Licensed to the Apache Software Foundation (ASF) under one
+; or more contributor license agreements.  See the NOTICE file
+; distributed with this work for additional information
+; regarding copyright ownership.  The ASF licenses this file
+; to you 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.
+
+(dirs :standard \ target)

bindings/ocaml/dune-project

@@ -0,0 +1,35 @@
+(lang dune 2.0)
+; Licensed to the Apache Software Foundation (ASF) under one
+; or more contributor license agreements.  See the NOTICE file
+; distributed with this work for additional information
+; regarding copyright ownership.  The ASF licenses this file
+; to you 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.
+
+(name opendal)
+(generate_opam_files true)
+(license Apache-2.0)
+(maintainers "OpenDAL Contributors <dev@opendal.apache.org>")
+(authors "OpenDAL Contributors <dev@opendal.apache.org>")
+(source (github apache/incubator-opendal))
+(documentation "https://opendal.apache.org/")
+(package
+ (name opendal)
+ (synopsis "Open Data Access Layer: Access data freely")
+ (description
+  "OpenDAL is a data access layer that allows users to easily and efficiently retrieve data from various storage services in a unified way.")
+ (depends
+  (ounit2 (and (>= 2.2.6) :with-test))
+  (ocaml (>= "4.03.0"))
+  (dune (>= "1.5"))
+  conf-rust))