feat: uipath-python-integrations

Author: cosmyo

.github/workflows/ci.yml

@@ -5,7 +5,7 @@ on:
     branches:
       - main
     paths-ignore:
-      - pyproject.toml
+      - packages/*/pyproject.toml
   pull_request:
     branches:
       - main
@@ -19,4 +19,4 @@ jobs:
     uses: ./.github/workflows/lint.yml
 
   test:
-    uses: ./.github/workflows/test.yml
+    uses: ./.github/workflows/test.yml

.github/workflows/integration_tests.yml

@@ -23,15 +23,29 @@ jobs:
     - name: Discover testcases
       id: discover
       run: |
-        # Find all testcase folders (excluding common folders like README, etc.)
-        testcase_dirs=$(find testcases -maxdepth 1 -type d -name "*-*" | sed 's|testcases/||' | sort)
+        # Find all packages with testcases directories
+        testcases_array="[]"
 
-        echo "Found testcase directories:"
-        echo "$testcase_dirs"
+        for package_dir in packages/*/testcases; do
+          if [ -d "$package_dir" ]; then
+            package_name=$(echo "$package_dir" | sed 's|packages/\(.*\)/testcases|\1|')
+            echo "Discovering testcases in $package_name"
 
-        # Convert to JSON array for matrix
-        testcases_json=$(echo "$testcase_dirs" | jq -R -s -c 'split("\n")[:-1]')
-        echo "testcases=$testcases_json" >> $GITHUB_OUTPUT
+            # Find all testcase folders in this package
+            for testcase_dir in "$package_dir"/*-*; do
+              if [ -d "$testcase_dir" ]; then
+                testcase_name=$(basename "$testcase_dir")
+                echo "  Found: $testcase_name"
+
+                # Add to JSON array with package and testcase info
+                testcases_array=$(echo "$testcases_array" | jq -c ". += [{\"package\": \"$package_name\", \"testcase\": \"$testcase_name\"}]")
+              fi
+            done
+          fi
+        done
+
+        echo "Testcases matrix: $testcases_array"
+        echo "testcases=$testcases_array" >> $GITHUB_OUTPUT
 
   integration-tests:
     needs: [discover-testcases]
@@ -41,13 +55,16 @@ jobs:
       image: ghcr.io/astral-sh/uv:python3.12-bookworm
       env:
         UIPATH_JOB_KEY: "3a03d5cb-fa21-4021-894d-a8e2eda0afe0"
+    defaults:
+      run:
+        working-directory: packages/${{ matrix.testcase-info.package }}
     strategy:
       fail-fast: false
       matrix:
-        testcase: ${{ fromJson(needs.discover-testcases.outputs.testcases) }}
+        testcase-info: ${{ fromJson(needs.discover-testcases.outputs.testcases) }}
         environment: [alpha, cloud, staging]
 
-    name: "${{ matrix.testcase }} / ${{ matrix.environment }}"
+    name: "${{ matrix.testcase-info.package }}/${{ matrix.testcase-info.testcase }} / ${{ matrix.environment }}"
 
     steps:
     - name: Checkout code
@@ -61,9 +78,10 @@ jobs:
         CLIENT_ID:      ${{ matrix.environment == 'alpha' && secrets.ALPHA_TEST_CLIENT_ID || matrix.environment == 'staging' && secrets.STAGING_TEST_CLIENT_ID || matrix.environment == 'cloud' && secrets.CLOUD_TEST_CLIENT_ID }}
         CLIENT_SECRET:  ${{ matrix.environment == 'alpha' && secrets.ALPHA_TEST_CLIENT_SECRET || matrix.environment == 'staging' && secrets.STAGING_TEST_CLIENT_SECRET || matrix.environment == 'cloud' && secrets.CLOUD_TEST_CLIENT_SECRET }}
         BASE_URL:       ${{ matrix.environment == 'alpha' && secrets.ALPHA_BASE_URL || matrix.environment == 'staging' && secrets.STAGING_BASE_URL || matrix.environment == 'cloud' && secrets.CLOUD_BASE_URL }}
-      working-directory: testcases/${{ matrix.testcase }}
+      working-directory: packages/${{ matrix.testcase-info.package }}/testcases/${{ matrix.testcase-info.testcase }}
       run: |
-        echo "Running testcase: ${{ matrix.testcase }}"
+        echo "Running testcase: ${{ matrix.testcase-info.testcase }}"
+        echo "Package: ${{ matrix.testcase-info.package }}"
         echo "Environment: ${{ matrix.environment }}"
         echo "Working directory: $(pwd)"
 

.github/workflows/lint.yml

@@ -4,6 +4,31 @@ on:
   workflow_call
 
 jobs:
+  discover-packages:
+    runs-on: ubuntu-latest
+    outputs:
+      packages: ${{ steps.discover.outputs.packages }}
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+
+    - name: Discover packages
+      id: discover
+      run: |
+        # Find all packages with pyproject.toml
+        packages_array="[]"
+
+        for package_dir in packages/*/pyproject.toml; do
+          if [ -f "$package_dir" ]; then
+            package_name=$(echo "$package_dir" | sed 's|packages/\(.*\)/pyproject.toml|\1|')
+            echo "Found package: $package_name"
+            packages_array=$(echo "$packages_array" | jq -c ". += [\"$package_name\"]")
+          fi
+        done
+
+        echo "Packages: $packages_array"
+        echo "packages=$packages_array" >> $GITHUB_OUTPUT
+
   skip-lint:
     name: Skip Lint (Custom Version Testing)
     runs-on: ubuntu-latest
@@ -17,9 +42,16 @@ jobs:
           echo "This job completes successfully to allow PR merging"
 
   lint:
-    name: Lint
+    name: Lint ${{ matrix.package }}
+    needs: [discover-packages]
     runs-on: ubuntu-latest
     if: "!contains(github.event.pull_request.labels.*.name, 'test-core-dev-version')"
+    defaults:
+      run:
+        working-directory: packages/${{ matrix.package }}
+    strategy:
+      matrix:
+        package: ${{ fromJson(needs.discover-packages.outputs.packages) }}
     permissions:
       contents: read
 

.github/workflows/publish-dev.yml

@@ -7,6 +7,14 @@ on:
 jobs:
   publish-dev:
     runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: ${{ matrix.package.path }}
+    strategy:
+      matrix:
+        package:
+          - name: uipath-llamaindex
+            path: packages/uipath-llamaindex
     permissions:
       contents: read
       pull-requests: write
@@ -36,7 +44,8 @@ jobs:
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
-          $pyprojcontent = Get-Content pyproject.toml -Raw
+          $pyprojPath = "${{ matrix.package.path }}/pyproject.toml"
+          $pyprojcontent = Get-Content $pyprojPath -Raw
 
           $PROJECT_NAME    = ($pyprojcontent | Select-String -Pattern '(?m)^\[(project|tool\.poetry)\][^\[]*?name\s*=\s*"([^"]*)"' -AllMatches).Matches[0].Groups[2].Value
           $CURRENT_VERSION = ($pyprojcontent | Select-String -Pattern '(?m)^\[(project|tool\.poetry)\][^\[]*?version\s*=\s*"([^"]*)"' -AllMatches).Matches[0].Groups[2].Value
@@ -55,9 +64,9 @@ jobs:
           $DEV_VERSION = "$CURRENT_VERSION.dev1$PADDED_PR$PADDED_RUN"
 
           # Update version in pyproject.toml
-          (Get-Content pyproject.toml) -replace "version = `"$CURRENT_VERSION`"", "version = `"$DEV_VERSION`"" | Set-Content pyproject.toml
+          (Get-Content $pyprojPath) -replace "version = `"$CURRENT_VERSION`"", "version = `"$DEV_VERSION`"" | Set-Content $pyprojPath
 
-          Write-Output "Package version set to $DEV_VERSION"
+          Write-Output "Package $PROJECT_NAME version set to $DEV_VERSION"
 
           $dependencyMessage = @"
           ## Development Package

.github/workflows/publish-docs.yml

@@ -5,13 +5,13 @@ on:
     branches:
       - main
     paths:
-      - "docs/**"
-      - "pyproject.toml"
+      - "packages/*/docs/**"
+      - "packages/*/pyproject.toml"
 
 jobs:
   publish-docs:
     runs-on: ubuntu-latest
-    if: ${{ github.repository == 'UiPath/uipath-llamaindex-python' }}
+    if: ${{ github.repository == 'UiPath/uipath-integrations-python' }}
     steps:
       - name: Trigger Publish Docs
         run: |

.github/workflows/publish.yml

@@ -16,14 +16,21 @@ jobs:
     uses: ./.github/workflows/test.yml
 
   build:
-    name: Build
+    name: Build ${{ matrix.package }}
     runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: packages/${{ matrix.package }}
+    strategy:
+      matrix:
+        package:
+          - uipath-llamaindex
 
     needs:
       - lint
       - test
 
-    if: ${{ github.repository == 'UiPath/uipath-llamaindex-python' }}
+    if: ${{ github.repository == 'UiPath/uipath-integrations-python' }}
     permissions:
       contents: read
       actions: write
@@ -51,13 +58,17 @@ jobs:
       - name: Upload artifacts
         uses: actions/upload-artifact@v4
         with:
-          name: release-dists
-          path: dist/
+          name: release-dists-${{ matrix.package }}
+          path: packages/${{ matrix.package }}/dist/
 
   pypi-publish:
-    name: Upload release to PyPI
+    name: Upload ${{ matrix.package }} to PyPI
     runs-on: ubuntu-latest
     environment: pypi
+    strategy:
+      matrix:
+        package:
+          - uipath-llamaindex
 
     needs:
       - build
@@ -69,7 +80,7 @@ jobs:
       - name: Retrieve release distributions
         uses: actions/download-artifact@v4
         with:
-          name: release-dists
+          name: release-dists-${{ matrix.package }}
           path: dist/
 
       - name: Publish package distributions to PyPI

.github/workflows/test-custom-version.yml

@@ -13,12 +13,43 @@ on:
     types: [opened, synchronize, labeled, unlabeled]
 
 jobs:
+  discover-packages:
+    runs-on: ubuntu-latest
+    if: contains(github.event.pull_request.labels.*.name, 'test-core-dev-version')
+    outputs:
+      packages: ${{ steps.discover.outputs.packages }}
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+
+    - name: Discover packages
+      id: discover
+      run: |
+        # Find all packages with pyproject.toml
+        packages_array="[]"
+
+        for package_dir in packages/*/pyproject.toml; do
+          if [ -f "$package_dir" ]; then
+            package_name=$(echo "$package_dir" | sed 's|packages/\(.*\)/pyproject.toml|\1|')
+            echo "Found package: $package_name"
+            packages_array=$(echo "$packages_array" | jq -c ". += [\"$package_name\"]")
+          fi
+        done
+
+        echo "Packages: $packages_array"
+        echo "packages=$packages_array" >> $GITHUB_OUTPUT
+
   test-core-dev-version:
-    name: Test Core Dev Version
+    name: Test ${{ matrix.package }} - Core Dev Version
+    needs: [discover-packages]
     runs-on: ${{ matrix.os }}
     if: contains(github.event.pull_request.labels.*.name, 'test-core-dev-version')
+    defaults:
+      run:
+        working-directory: packages/${{ matrix.package }}
     strategy:
       matrix:
+        package: ${{ fromJson(needs.discover-packages.outputs.packages) }}
         python-version: ["3.11", "3.12", "3.13"]
         os: [ubuntu-latest, windows-latest]
 
@@ -98,5 +129,4 @@ jobs:
       - name: Restore original pyproject.toml
         if: always()
         shell: bash
-        run: |
-          mv pyproject.toml.backup pyproject.toml
+        run: mv pyproject.toml.backup pyproject.toml

.github/workflows/test.yml

@@ -4,11 +4,41 @@ on:
   workflow_call:
 
 jobs:
+  discover-packages:
+    runs-on: ubuntu-latest
+    outputs:
+      packages: ${{ steps.discover.outputs.packages }}
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+
+    - name: Discover packages
+      id: discover
+      run: |
+        # Find all packages with pyproject.toml
+        packages_array="[]"
+
+        for package_dir in packages/*/pyproject.toml; do
+          if [ -f "$package_dir" ]; then
+            package_name=$(echo "$package_dir" | sed 's|packages/\(.*\)/pyproject.toml|\1|')
+            echo "Found package: $package_name"
+            packages_array=$(echo "$packages_array" | jq -c ". += [\"$package_name\"]")
+          fi
+        done
+
+        echo "Packages: $packages_array"
+        echo "packages=$packages_array" >> $GITHUB_OUTPUT
+
   test:
-    name: Test
+    name: Test ${{ matrix.package }}
+    needs: [discover-packages]
     runs-on: ${{ matrix.os }}
+    defaults:
+      run:
+        working-directory: packages/${{ matrix.package }}
     strategy:
       matrix:
+        package: ${{ fromJson(needs.discover-packages.outputs.packages) }}
         python-version: ["3.11", "3.12", "3.13"]
         os: [ubuntu-latest, windows-latest]
 

.python-version …ckages/uipath-llamaindex/.python-version.python-version renamed to packages/uipath-llamaindex/.python-version .python-version renamed to packages/uipath-llamaindex/.python-version

@@ -0,0 +1,42 @@
+# Contributing to UiPath SDK
+
+## Local Development Setup
+
+### Prerequisites
+
+1. **Install Python 3.13**:
+    - Download and install Python 3.13 from the official [Python website](https://www.python.org/downloads/)
+    - Verify the installation by running:
+        ```sh
+        python3.13 --version
+        ```
+
+    Alternative: [mise](https://mise.jdx.dev/lang/python.html)
+
+2. **Install [uv](https://docs.astral.sh/uv/)**:
+    ```sh
+    pip install uv
+    ```
+
+3. **Create a virtual environment in the current working directory**:
+    ```sh
+    uv venv
+    ```
+
+4. **Install dependencies**:
+    ```sh
+    uv sync --all-extras
+    ```
+
+See `just --list` for linting, formatting and build commands.
+
+
+### Use SDK Locally
+1. Create a folder on your own device `mkdir project; cd project`
+2. Initialize the python project `uv` `uv init . --python 3.11`
+3. Obtain the project path `PATH_TO_SDK=/Users/YOU_USER/uipath-llamaindex-python/uipath-llamaindex`
+4. Install the sdk in editable mode `uv add --editable ${PATH_TO_SDK}`
+
+:information_source: Instead of cloning the project into `.venv/lib/python3.11/site-packages/uipath-llamaindex`, this mode creates a file named `_uipath-mcp.pth` inside `.venv/lib/python3.11/site-packages`. This file contains the value of `PATH_TO_SDK`, which is added to `sys.path`—the list of directories where python searches for packages. (Run `python -c 'import sys; print(sys.path)'` to see the entries.)
+
+