Merge branch 'main' into fix-guardrails

valentinabojan · web-flow · commit 02078b491341 · 2026-03-04T19:53:07.000+02:00
diff --git a/.github/workflows/integration_tests.yml b/.github/workflows/integration_tests.yml
@@ -1,8 +1,6 @@
 name: uipath - Integration Tests
 
 on:
-  push:
-    branches: [ main, develop ]
   pull_request:
     branches: [ main ]
 
@@ -12,30 +10,71 @@ permissions:
   actions: read
 
 jobs:
+  detect-changed-packages:
+    runs-on: ubuntu-latest
+    outputs:
+      packages: ${{ steps.detect.outputs.packages }}
+      count: ${{ steps.detect.outputs.count }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Detect changed packages
+        id: detect
+        env:
+          GITHUB_EVENT_NAME: ${{ github.event_name }}
+          BASE_SHA: ${{ github.event.pull_request.base.sha }}
+          HEAD_SHA: ${{ github.event.pull_request.head.sha }}
+        run: python .github/scripts/detect_changed_packages.py
+
   discover-testcases:
+    needs: [detect-changed-packages]
+    if: needs.detect-changed-packages.outputs.count > 0
     runs-on: ubuntu-latest
     outputs:
       testcases: ${{ steps.discover.outputs.testcases }}
+      count: ${{ steps.discover.outputs.count }}
     steps:
     - name: Checkout code
       uses: actions/checkout@v4
 
     - name: Discover testcases
       id: discover
-      working-directory: packages/uipath
+      env:
+        PACKAGES: ${{ needs.detect-changed-packages.outputs.packages }}
       run: |
-        # Find all testcase folders (excluding common folders like README, etc.)
-        testcase_dirs=$(find testcases -maxdepth 1 -type d -name "*-*" | sed 's|testcases/||' | sort)
-
-        echo "Found testcase directories:"
-        echo "$testcase_dirs"
+        # Discover testcases from all affected packages
+        all_testcases="[]"
+
+        for package in $(echo "$PACKAGES" | jq -r '.[]'); do
+          testcases_dir="packages/$package/testcases"
+          if [ -d "$testcases_dir" ]; then
+            testcase_dirs=$(find "$testcases_dir" -maxdepth 1 -type d -name "*-*" | sed "s|$testcases_dir/||" | sort)
+            if [ -n "$testcase_dirs" ]; then
+              echo "Found testcases in $package:"
+              echo "$testcase_dirs"
+              # Add as package/testcase entries
+              package_testcases=$(echo "$testcase_dirs" | jq -R -c --arg pkg "$package" '{package: $pkg, testcase: .}')
+              all_testcases=$(echo "$all_testcases" | jq -c --argjson new "[$( echo "$package_testcases" | paste -sd, )]" '. + $new')
+            fi
+          fi
+        done
 
-        # Convert to JSON array for matrix
-        testcases_json=$(echo "$testcase_dirs" | jq -R -s -c 'split("\n")[:-1]')
-        echo "testcases=$testcases_json" >> $GITHUB_OUTPUT
+        echo "All testcases: $all_testcases"
+        count=$(echo "$all_testcases" | jq 'length')
+        echo "testcases=$all_testcases" >> $GITHUB_OUTPUT
+        echo "count=$count" >> $GITHUB_OUTPUT
 
   integration-tests:
     needs: [discover-testcases]
+    if: needs.discover-testcases.outputs.count > 0
     runs-on: ubuntu-latest
     container:
       image: ghcr.io/astral-sh/uv:python3.12-bookworm
@@ -48,14 +87,14 @@ jobs:
         testcase: ${{ fromJson(needs.discover-testcases.outputs.testcases) }}
         environment: [alpha, cloud, staging]
 
-    name: "${{ matrix.testcase }} / ${{ matrix.environment }}"
+    name: "${{ matrix.testcase.testcase }} / ${{ matrix.environment }}"
 
     steps:
     - name: Checkout code
       uses: actions/checkout@v4
 
     - name: Install dependencies
-      working-directory: packages/uipath
+      working-directory: packages/${{ matrix.testcase.package }}
       run: uv sync
 
     - name: Run testcase
@@ -70,12 +109,13 @@ jobs:
         TELEMETRY_CONNECTION_STRING: ${{ secrets.APPLICATIONINSIGHTS_CONNECTION_STRING }}
         APP_INSIGHTS_APP_ID: ${{ secrets.APP_INSIGHTS_APP_ID }}
         APP_INSIGHTS_API_KEY: ${{ secrets.APP_INSIGHTS_API_KEY }}
-      working-directory: packages/uipath/testcases/${{ matrix.testcase }}
+      working-directory: packages/${{ matrix.testcase.package }}/testcases/${{ matrix.testcase.testcase }}
       run: |
         # If any errors occur execution will stop with exit code
         set -e
 
-        echo "Running testcase: ${{ matrix.testcase }}"
+        echo "Running testcase: ${{ matrix.testcase.testcase }}"
+        echo "Package: ${{ matrix.testcase.package }}"
         echo "Environment: ${{ matrix.environment }}"
         echo "Working directory: $(pwd)"
 
@@ -84,12 +124,20 @@ jobs:
         bash ../common/validate_output.sh
 
   summarize-results:
-    needs: [integration-tests]
+    needs: [detect-changed-packages, discover-testcases, integration-tests]
     runs-on: ubuntu-latest
-    if: always() # This ensures the job runs even if the tests fail
+    if: always()
     steps:
       - name: Check integration tests status
         run: |
+          if [[ "${{ needs.detect-changed-packages.outputs.count }}" == "0" ]]; then
+            echo "No packages changed - skipping integration tests"
+            exit 0
+          fi
+          if [[ "${{ needs.discover-testcases.outputs.count }}" == "0" ]]; then
+            echo "No testcases found for changed packages - skipping"
+            exit 0
+          fi
           if [[ "${{ needs.integration-tests.result }}" == "success" ]]; then
             echo "All integration tests passed"
           else
diff --git a/README.md b/README.md
@@ -0,0 +1,206 @@
+# UiPath Python SDK
+
+[![PyPI downloads](https://img.shields.io/pypi/dm/uipath.svg)](https://pypi.org/project/uipath/)
+[![PyPI - Version](https://img.shields.io/pypi/v/uipath)](https://img.shields.io/pypi/v/uipath)
+[![Python versions](https://img.shields.io/pypi/pyversions/uipath.svg)](https://pypi.org/project/uipath/)
+
+A Python SDK that enables programmatic interaction with UiPath Cloud Platform services including processes, assets, buckets, context grounding, data services, jobs, and more. The package also features a CLI for creation, packaging, and deployment of automations to UiPath Cloud Platform.
+
+Use the [UiPath LangChain SDK](https://github.com/UiPath/uipath-langchain-python) to pack and publish LangGraph Agents.
+
+Check out other [UiPath Integrations](https://github.com/UiPath/uipath-integrations-python) to pack and publish agents built with LlamaIndex, OpenAI Agents, Google ADK, and more.
+
+This [quickstart guide](https://uipath.github.io/uipath-python/) walks you through deploying your first agent to UiPath Cloud Platform.
+
+## Table of Contents
+
+-   [Installation](#installation)
+-   [Configuration](#configuration)
+    -   [Environment Variables](#environment-variables)
+-   [Basic Usage](#basic-usage)
+-   [Available Services](#available-services)
+-   [Examples](#examples)
+    -   [Buckets Service](#buckets-service)
+    -   [Context Grounding Service](#context-grounding-service)
+-   [Command Line Interface (CLI)](#command-line-interface-cli)
+    -   [Authentication](#authentication)
+    -   [Initialize a Project](#initialize-a-project)
+    -   [Debug a Project](#debug-a-project)
+    -   [Package a Project](#package-a-project)
+    -   [Publish a Package](#publish-a-package)
+-   [Project Structure](#project-structure)
+-   [Development](#development)
+    -   [Setting Up a Development Environment](#setting-up-a-development-environment)
+
+## Installation
+
+```bash
+pip install uipath
+```
+
+using `uv`:
+
+```bash
+uv add uipath
+```
+
+## Configuration
+
+### Environment Variables
+
+Create a `.env` file in your project root with the following variables:
+
+```
+UIPATH_URL=https://cloud.uipath.com/ACCOUNT_NAME/TENANT_NAME
+UIPATH_ACCESS_TOKEN=YOUR_TOKEN_HERE
+```
+
+## Basic Usage
+
+```python
+from uipath.platform import UiPath
+# Initialize the SDK
+sdk = UiPath()
+# Execute a process
+job = sdk.processes.invoke(
+    name="MyProcess",
+    input_arguments={"param1": "value1", "param2": 42}
+)
+# Work with assets
+asset = sdk.assets.retrieve(name="MyAsset")
+```
+
+## Available Services
+
+The SDK provides access to various UiPath services:
+
+-   `sdk.processes` - Manage and execute UiPath automation processes
+
+-   `sdk.assets` - Work with assets (variables, credentials) stored in UiPath
+
+-   `sdk.buckets` - Manage cloud storage containers for automation files
+
+-   `sdk.connections` - Handle connections to external systems
+
+-   `sdk.context_grounding` - Work with semantic contexts for AI-enabled automation
+
+-   `sdk.jobs` - Monitor and manage automation jobs
+
+-   `sdk.queues` - Work with transaction queues
+
+-   `sdk.tasks` - Work with Action Center
+
+-   `sdk.api_client` - Direct access to the API client for custom requests
+
+## Examples
+
+### Buckets Service
+
+```python
+# Download a file from a bucket
+sdk.buckets.download(
+    bucket_key="my-bucket",
+    blob_file_path="path/to/file.xlsx",
+    destination_path="local/path/file.xlsx"
+)
+```
+
+### Context Grounding Service
+
+```python
+# Search for contextual information
+results = sdk.context_grounding.search(
+    name="my-knowledge-index",
+    query="How do I process an invoice?",
+    number_of_results=5
+)
+```
+
+## Command Line Interface (CLI)
+
+The SDK also provides a command-line interface for creating, packaging, and deploying automations:
+
+### Authentication
+
+```bash
+uipath auth
+```
+
+This command opens a browser for authentication and creates/updates your `.env` file with the proper credentials.
+
+### Initialize a Project
+
+```bash
+uipath init
+```
+
+The `uipath.json` file should include your entry points in the `functions` section:
+```json
+{
+  "functions": {
+    "main": "main.py:main"
+  }
+}
+```
+
+Running `uipath init` will process these function definitions and create the corresponding `entry-points.json` file needed for deployment.
+
+For more details on the configuration format, see the [UiPath configuration specifications](specs/README.md).
+
+### Debug a Project
+
+```bash
+uipath run ENTRYPOINT [INPUT]
+```
+
+Executes a Python script with the provided JSON input arguments.
+
+### Package a Project
+
+```bash
+uipath pack
+```
+
+Packages your project into a `.nupkg` file that can be deployed to UiPath.
+
+**Note:** Your `pyproject.toml` must include:
+
+-   A description field (avoid characters: &, <, >, ", ', ;)
+-   Author information
+
+Example:
+
+```toml
+description = "Your package description"
+authors = [{name = "Your Name", email = "your.email@example.com"}]
+```
+
+### Publish a Package
+
+```bash
+uipath publish
+```
+
+Publishes the most recently created package to your UiPath Orchestrator.
+
+## Project Structure
+
+To properly use the CLI for packaging and publishing, your project should include:
+
+-   A `pyproject.toml` file with project metadata
+-   A `uipath.json` file with your function definitions (e.g., `"functions": {"main": "main.py:main"}`)
+-   A `entry-points.json` file (generated by `uipath init`)
+-   A `bindings.json` file (generated by `uipath init`) to configure resource overrides
+-   Any Python files needed for your automation
+
+
+## Development
+
+### Tools
+
+Check out [uipath-dev](https://github.com/uipath/uipath-dev-python) - an interactive application for building, testing, and debugging UiPath Python runtimes, agents, and automation scripts.
+
+### Contributions
+
+Please read our [contribution guidelines](https://github.com/UiPath/uipath-integrations-python/blob/main/CONTRIBUTING.md) before submitting a pull request.
+
