Elixir SDK (#208)

Author: schmit

.changeset/light-socks-wait.md

@@ -0,0 +1,5 @@
+---
+"eppo_core": minor
+---
+
+Adds elixir support for VariationType

.github/workflows/elixir.yml

@@ -0,0 +1,102 @@
+---
+name: Elixir SDK
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'elixir-sdk/**'
+      - 'eppo_core/**'
+      - 'sdk-test-data/**'
+      - 'mock-server/**'
+      - 'package-lock.json'
+      - 'package.json'
+  pull_request:
+    paths:
+      - 'elixir-sdk/**'
+      - 'eppo_core/**'
+      - 'sdk-test-data/**'
+      - 'mock-server/**'
+      - 'package-lock.json'
+      - 'package.json'
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  elixir_test:
+    runs-on: ${{ matrix.os }}-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          # Elixir 1.18 with OTP 26 and 27
+          - os: ubuntu
+            elixir: '1.18'
+            otp: '26.0'
+          - os: ubuntu
+            elixir: '1.18'
+            otp: '27.0'
+          # Elixir 1.17 with OTP 26 and 27
+          - os: ubuntu
+            elixir: '1.17'
+            otp: '26.0'
+          - os: ubuntu
+            elixir: '1.17'
+            otp: '27.0'
+          # Elixir 1.16 with OTP 26 only
+          - os: ubuntu
+            elixir: '1.16'
+            otp: '26.0'
+          # Elixir 1.15 with OTP 26 only
+          - os: ubuntu
+            elixir: '1.15'
+            otp: '26.0'
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: true
+
+      - name: Set up Elixir & Rust
+        uses: erlef/setup-beam@v1
+        with:
+          elixir-version: ${{ matrix.elixir }}
+          otp-version: ${{ matrix.otp }}
+
+      - name: Set up Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Cache Rust dependencies
+        uses: Swatinem/rust-cache@v2
+
+      - name: Cache Mix dependencies
+        uses: actions/cache@v3
+        with:
+          path: |
+            deps
+            _build
+          key: ${{ runner.os }}-mix-${{ matrix.elixir }}-${{ matrix.otp }}-${{ hashFiles('**/mix.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-mix-
+
+      - run: npm ci
+
+      - name: Override eppo_core for testing
+        run: |
+          mkdir -p ~/.cargo/
+          echo "[patch.crates-io.eppo_core]" >> "${CARGO_HOME:-$HOME/.cargo}/config.toml"
+          echo "path = '$PWD/eppo_core'" >> "${CARGO_HOME:-$HOME/.cargo}/config.toml"
+
+      - name: Install dependencies
+        run: mix deps.get
+        working-directory: elixir-sdk
+
+      - name: Compile
+        run: mix compile
+        working-directory: elixir-sdk
+
+      - name: Run tests
+        run: npm run with-server test:elixir

README.md

@@ -23,6 +23,7 @@ Eppo is a modular flagging and experimentation analysis tool. Eppo's SDKs are bu
 
 1. Install [rustup](https://rustup.rs/).
 2. Install Ruby using your preferred package manager.
+3. To run tests, load the `sdk-test-data` submodule: `git submodule update --init --recursive`
 
 ### Release process
 

elixir-sdk/.cargo/config.toml

@@ -0,0 +1,5 @@
+[target.'cfg(target_os = "macos")']
+rustflags = [
+    "-C", "link-arg=-undefined",
+    "-C", "link-arg=dynamic_lookup",
+]

elixir-sdk/.formatter.exs

@@ -0,0 +1,4 @@
+# Used by "mix format"
+[
+  inputs: ["{mix,.formatter}.exs", "{config,lib,test}/**/*.{ex,exs}"]
+]

elixir-sdk/.gitignore

@@ -0,0 +1,29 @@
+# The directory Mix will write compiled artifacts to.
+/_build/
+
+# If you run "mix test --cover", coverage assets end up here.
+/cover/
+
+# The directory Mix downloads your dependencies sources to.
+/deps/
+
+# Where third-party dependencies like ExDoc output generated docs.
+/doc/
+
+# Ignore .fetch files in case you like to edit your project deps locally.
+/.fetch
+
+# If the VM crashes, it generates a dump, let's ignore it too.
+erl_crash.dump
+
+# Also ignore archive artifacts (built via "mix archive.build").
+*.ez
+
+# Ignore package tarball (built via "mix hex.build").
+eppo_sdk-*.tar
+
+# Temporary files, for example, from tests.
+/tmp/
+
+# Rust binary artifacts
+/target/