feat(#100): python bindings (#101)

* Python bindings

* docs

* CI issues

* Removed license, this is an Apache 2 project and this module doesn't need separate licencing

Author: siomporas

.github/workflows/ci-full.yml

@@ -15,6 +15,8 @@ on:
       # Policy/fixture changes that affect tests
       - "fixtures/**"
       - "**.rego"
+      # Python binding changes
+      - "cupcake-py/**"
   workflow_dispatch:
 
 env:
@@ -162,6 +164,95 @@ jobs:
       - uses: eqtylab-actions/install-nix-action@v31
       - run: nix build .#cupcake-cli -L
 
+  test-python:
+    name: Python Bindings (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [cupcake-ubuntu-latest, macos-latest, windows-latest]
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Setup Rust cache
+        uses: Swatinem/rust-cache@v2
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install OPA (Unix)
+        if: runner.os != 'Windows'
+        run: |
+          if [[ "$RUNNER_OS" == "Linux" ]]; then
+            curl -L -o opa https://github.com/open-policy-agent/opa/releases/download/v1.7.1/opa_linux_amd64_static
+          elif [[ "$RUNNER_OS" == "macOS" ]]; then
+            curl -L -o opa https://github.com/open-policy-agent/opa/releases/download/v1.7.1/opa_darwin_amd64
+          fi
+          chmod +x opa
+          sudo mv opa /usr/local/bin/
+          opa version
+
+      - name: Install OPA (Windows)
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: |
+          Invoke-WebRequest -Uri "https://github.com/open-policy-agent/opa/releases/download/v1.7.1/opa_windows_amd64.exe" -OutFile "opa.exe"
+          Move-Item opa.exe "C:\Windows\System32\opa.exe" -Force
+          & opa version
+
+      - name: Create virtualenv and install dependencies (Unix)
+        if: runner.os != 'Windows'
+        run: |
+          python -m venv .venv
+          source .venv/bin/activate
+          pip install maturin pytest pytest-asyncio
+
+      - name: Create virtualenv and install dependencies (Windows)
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: |
+          python -m venv .venv
+          .venv\Scripts\Activate.ps1
+          pip install maturin pytest pytest-asyncio
+
+      - name: Build Python bindings (Unix)
+        if: runner.os != 'Windows'
+        run: |
+          source .venv/bin/activate
+          cd cupcake-py
+          maturin develop --release
+
+      - name: Build Python bindings (Windows)
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: |
+          .venv\Scripts\Activate.ps1
+          cd cupcake-py
+          maturin develop --release
+
+      - name: Run Python tests (Unix)
+        if: runner.os != 'Windows'
+        run: |
+          source .venv/bin/activate
+          cd cupcake-py
+          pytest tests/ -v
+
+      - name: Run Python tests (Windows)
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: |
+          .venv\Scripts\Activate.ps1
+          cd cupcake-py
+          pytest tests/ -v
+        env:
+          CI: true
+
   fmt:
     name: Format
     runs-on: ubuntu-latest

.github/workflows/ci.yml

@@ -15,6 +15,8 @@ on:
       # Policy/fixture changes that affect tests
       - "fixtures/**"
       - "**.rego"
+      # Python binding changes
+      - "cupcake-py/**"
   workflow_dispatch:
 
 env:
@@ -88,3 +90,50 @@ jobs:
           cargo test --doc -j 1 -- --test-threads=1
         env:
           CI: true
+
+  test-python:
+    name: Python Bindings (Linux)
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Setup Rust cache
+        uses: Swatinem/rust-cache@v2
+        with:
+          cache-targets: false
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install OPA
+        run: |
+          curl -L -o opa https://github.com/open-policy-agent/opa/releases/download/v1.7.1/opa_linux_amd64_static
+          chmod +x opa
+          sudo mv opa /usr/local/bin/
+          opa version
+
+      - name: Create virtualenv and install dependencies
+        run: |
+          python -m venv .venv
+          source .venv/bin/activate
+          pip install maturin pytest pytest-asyncio
+
+      - name: Build Python bindings
+        run: |
+          source .venv/bin/activate
+          cd cupcake-py
+          maturin develop --release
+
+      - name: Run Python tests
+        run: |
+          source .venv/bin/activate
+          cd cupcake-py
+          pytest tests/ -v
+        env:
+          CI: true