feat(bindings/haskell): add CONTRIBUTING.md

.devcontainer/post_create.sh

@@ -51,4 +51,8 @@ sudo apt install -y wget
 wget -q https://github.com/marler8997/zigup/releases/download/v2022_08_25/zigup.ubuntu-latest-x86_64.zip
 unzip zigup.ubuntu-latest-x86_64.zip -d /usr/bin
 chmod +x /usr/bin/zigup
-zigup master #TODO: replace to 0.11.0 (stable)
+zigup master #TODO: replace to 0.11.0 (stable)
+
+# Setup for Haskell binding
+sudo apt install -y ghc cabal-install
+cabal update

bindings/haskell/CONTRIBUTING.md

@@ -0,0 +1,93 @@
+# Contributing
+- [Contributing](#contributing)
+  - [Setup](#setup)
+    - [Using a dev container environment](#using-a-dev-container-environment)
+    - [Bring your own toolbox](#bring-your-own-toolbox)
+  - [Build](#build)
+  - [Test](#test)
+  - [Misc](#misc)
+
+## Setup
+
+### Using a dev container environment
+OpenDAL provides a pre-configured [dev container](https://containers.dev/) that could be used in [Github Codespaces](https://github.com/features/codespaces), [VSCode](https://code.visualstudio.com/), [JetBrains](https://www.jetbrains.com/remote-development/gateway/), [JuptyerLab](https://jupyterlab.readthedocs.io/en/stable/). Please pick up your favourite runtime environment.
+
+The fastest way is:
+
+[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/apache/incubator-opendal?quickstart=1&machine=standardLinux32gb)
+
+### Bring your own toolbox
+
+The `haskell` binding requires `haskell` and `cabal` to be built. We recommend using the latest stable version for development.
+
+If you are new to `haskell`, we recommend using [GHCup](https://www.haskell.org/ghcup/) to install `haskell` and `cabal`.
+
+For Unix-like systems:
+
+```bash
+curl --proto '=https' --tlsv1.2 -sSf https://get-ghcup.haskell.org | sh
+```
+
+For Windows:
+
+```powershell
+Set-ExecutionPolicy Bypass -Scope Process -Force;[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; try { Invoke-Command -ScriptBlock ([ScriptBlock]::Create((Invoke-WebRequest https://www.haskell.org/ghcup/sh/bootstrap-haskell.ps1 -UseBasicParsing))) -ArgumentList $true } catch { Write-Error $_ }
+```
+
+To verify that everything is working properly, run `ghc -V` and `cabal -V`:
+
+```shell
+> ghc -V
+The Glorious Glasgow Haskell Compilation System, version 9.6.1
+> cabal -V
+cabal-install version 3.10.1.0
+compiled using version 3.10.1.0 of the Cabal library
+```
+
+## Build
+
+```shell
+cargo build
+LIBRARY_PATH=../../target/debug cabal build
+```
+
+To clean up the build:
+
+```shell
+cargo clean
+cabal clean
+```
+
+## Test
+
+We use [`tasty`](https://hackage.haskell.org/package/tasty) as the test framework. To run the tests:
+
+```shell
+LD_LIBRARY_PATH=../../target/debug cabal test
+```
+
+```text
+...(Build Info)
+Test suite opendal-hs-test: RUNNING...
+Test suite opendal-hs-test: PASS
+Test suite logged to: 
+...(Log Path)
+1 of 1 test suites (1 of 1 test cases) passed.
+```
+
+## Misc
+
+If you don't want to specify `LIBRARY_PATH` every time, you can use [`direnv`](https://direnv.net/) to set the environment variable automatically. Add the following to your `.envrc`:
+
+```shell
+export LIBRARY_PATH=../../target/debug:LIBRARY_PATH
+export LD_LIBRARY_PATH=../../target/debug:LD_LIBRARY_PATH
+```
+
+If you are using [`Haskell`](https://marketplace.visualstudio.com/items?itemName=haskell.haskell) in VSCode, you may need to add the following configuration to your `settings.json`:
+
+```json
+"haskell.serverEnvironment": {
+    "LIBRARY_PATH": "../../target/debug:LIBRARY_PATH"
+},
+```