uipath 2.1.85__tar.gz → 2.1.86__tar.gz

uipath-2.1.86/.github/workflows/test-uipath-langchain.yml

@@ -0,0 +1,144 @@
+name: Test UiPath Langchain
+
+on:
+  pull_request:
+    types: [ opened, synchronize, reopened, labeled ]
+
+jobs:
+  test-uipath-langchain:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        python-version: [ "3.10", "3.11", "3.12", "3.13" ]
+        os: [ ubuntu-latest, windows-latest ]
+
+    permissions:
+      contents: read
+
+    # Only run if PR has the test:uipath-langchain label
+    if: contains(github.event.pull_request.labels.*.name, 'test:uipath-langchain')
+
+    steps:
+      - name: Checkout uipath-python
+        uses: actions/checkout@v4
+        with:
+          path: 'uipath-python'
+
+      - name: Setup uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Build uipath-python package
+        working-directory: uipath-python
+        run: uv build
+
+      - name: Checkout uipath-langchain-python
+        uses: actions/checkout@v4
+        with:
+          repository: 'UiPath/uipath-langchain-python'
+          path: 'uipath-langchain-python'
+
+      - name: Update uipath-python version
+        shell: bash
+        working-directory: uipath-langchain-python
+        run: uv add ../uipath-python/dist/*.whl --dev
+
+      - name: Run uipath-langchain tests
+        working-directory: uipath-langchain-python
+        run: |
+          uv sync
+          uv run pytest
+
+  discover-testcases:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    needs: [test-uipath-langchain]
+    outputs:
+      testcases: ${{ steps.discover.outputs.testcases }}
+    steps:
+      - name: Checkout uipath-langchain-python
+        uses: actions/checkout@v4
+        with:
+          repository: 'UiPath/uipath-langchain-python'
+          path: 'uipath-langchain-python'
+
+      - name: Discover testcases
+        id: discover
+        working-directory: uipath-langchain-python
+        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"
+
+          # Convert to JSON array for matrix
+          testcases_json=$(echo "$testcase_dirs" | jq -R -s -c 'split("\n")[:-1]')
+          echo "testcases=$testcases_json" >> $GITHUB_OUTPUT
+
+  run-uipath-langchain-integration-tests:
+    runs-on: ubuntu-latest
+    needs: [discover-testcases]
+    container:
+      image: ghcr.io/astral-sh/uv:python3.12-bookworm
+      env:
+        UIPATH_JOB_KEY: "3a03d5cb-fa21-4021-894d-a8e2eda0afe0"
+    permissions:
+      contents: read
+    strategy:
+      fail-fast: false
+      matrix:
+        testcase: ${{ fromJson(needs.discover-testcases.outputs.testcases) }}
+        environment: [alpha, staging] # temporary disable [cloud]
+        use_azure_chat: [true, false]
+
+    name: "${{ matrix.testcase }} / ${{ matrix.environment }} / ${{ matrix.use_azure_chat && 'UiPathAzureChatOpenAI' || 'UiPathChat' }}"
+
+    steps:
+      - name: Checkout uipath-python
+        uses: actions/checkout@v4
+        with:
+          path: 'uipath-python'
+
+      - name: Build uipath-python package
+        working-directory: uipath-python
+        run: uv build
+
+      - name: Checkout uipath-langchain-python
+        uses: actions/checkout@v4
+        with:
+          repository: 'UiPath/uipath-langchain-python'
+          path: 'uipath-langchain-python'
+
+      - name: Update uipath-python version
+        shell: bash
+        working-directory: uipath-langchain-python
+        run: uv add ../uipath-python/dist/*.whl
+
+      - name: Install dependencies
+        working-directory: uipath-langchain-python
+        run: uv sync
+
+      - name: Run testcase
+        env:
+          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 }}
+          USE_AZURE_CHAT: ${{ matrix.use_azure_chat }}
+          UV_PYTHON: "3.12"
+        working-directory: uipath-langchain-python/testcases/${{ matrix.testcase }}
+        run: |
+          echo "Running testcase: ${{ matrix.testcase }}"
+          echo "Environment: ${{ matrix.environment }}"
+          echo "LLM: ${{ matrix.use_azure_chat && 'UiPathAzureChatOpenAI' || 'UiPathChat' }}"
+          echo "USE_AZURE_CHAT: ${{ matrix.use_azure_chat }}"
+
+          # Execute the testcase run script directly
+          bash run.sh
+          bash ../common/validate_output.sh
+

{uipath-2.1.85 → uipath-2.1.86}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: uipath
-Version: 2.1.85
+Version: 2.1.86
 Summary: Python SDK and CLI for UiPath Platform, enabling programmatic interaction with automation services, process management, and deployment tools.
 Project-URL: Homepage, https://uipath.com
 Project-URL: Repository, https://github.com/UiPath/uipath-python

{uipath-2.1.85 → uipath-2.1.86}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "uipath"
-version = "2.1.85"
+version = "2.1.86"
 description = "Python SDK and CLI for UiPath Platform, enabling programmatic interaction with automation services, process management, and deployment tools."
 readme = { file = "README.md", content-type = "text/markdown" }
 requires-python = ">=3.10"

{uipath-2.1.85 → uipath-2.1.86}/src/uipath/_cli/_utils/_project_files.py

@@ -1,13 +1,22 @@
 # type: ignore
+import hashlib
 import json
 import os
 import re
+from pathlib import Path
 from typing import Any, Dict, Optional, Tuple
 
+import click
 from pydantic import BaseModel
 
 from .._utils._console import ConsoleLogger
 from ._constants import is_binary_file
+from ._studio_project import (
+    ProjectFile,
+    ProjectFolder,
+    StudioClient,
+    get_folder_by_name,
+)
 
 try:
     import tomllib
@@ -431,3 +440,116 @@ def files_to_include(
                     )
                 )
     return extra_files
+
+
+def compute_normalized_hash(content: str) -> str:
+    """Compute hash of normalized content.
+
+    Args:
+        content: Content to hash
+
+    Returns:
+        str: SHA256 hash of the normalized content
+    """
+    try:
+        # Try to parse as JSON to handle formatting
+        json_content = json.loads(content)
+        normalized = json.dumps(json_content, indent=2)
+    except json.JSONDecodeError:
+        # Not JSON, normalize line endings
+        normalized = content.replace("\r\n", "\n").replace("\r", "\n")
+
+    return hashlib.sha256(normalized.encode("utf-8")).hexdigest()
+
+
+def collect_files_from_folder(
+    folder: ProjectFolder, base_path: str, files_dict: Dict[str, ProjectFile]
+) -> None:
+    """Recursively collect all files from a folder and its subfolders.
+
+    Args:
+        folder: The folder to collect files from
+        base_path: Base path for file paths
+        files_dict: Dictionary to store collected files
+    """
+    # Add files from current folder
+    for file in folder.files:
+        file_path = os.path.join(base_path, file.name)
+        files_dict[file_path] = file
+
+    # Recursively process subfolders
+    for subfolder in folder.folders:
+        subfolder_path = os.path.join(base_path, subfolder.name)
+        collect_files_from_folder(subfolder, subfolder_path, files_dict)
+
+
+async def download_folder_files(
+    studio_client: StudioClient,
+    folder: ProjectFolder,
+    base_path: Path,
+) -> None:
+    """Download files from a folder recursively.
+
+    Args:
+        studio_client: Studio client
+        folder: The folder to download files from
+        base_path: Base path for local file storage
+    """
+    files_dict: Dict[str, ProjectFile] = {}
+    collect_files_from_folder(folder, "", files_dict)
+    for file_path, remote_file in files_dict.items():
+        local_path = base_path / file_path
+        local_path.parent.mkdir(parents=True, exist_ok=True)
+
+        # Download remote file
+        response = await studio_client.download_file_async(remote_file.id)
+        remote_content = response.read().decode("utf-8")
+        remote_hash = compute_normalized_hash(remote_content)
+
+        if os.path.exists(local_path):
+            # Read and hash local file
+            with open(local_path, "r", encoding="utf-8") as f:
+                local_content = f.read()
+                local_hash = compute_normalized_hash(local_content)
+
+            # Compare hashes
+            if local_hash != remote_hash:
+                styled_path = click.style(str(file_path), fg="cyan")
+                console.warning(f"File {styled_path}" + " differs from remote version.")
+                response = click.prompt("Do you want to overwrite it? (y/n)", type=str)
+                if response.lower() == "y":
+                    with open(local_path, "w", encoding="utf-8", newline="\n") as f:
+                        f.write(remote_content)
+                    console.success(f"Updated {click.style(str(file_path), fg='cyan')}")
+                else:
+                    console.info(f"Skipped {click.style(str(file_path), fg='cyan')}")
+            else:
+                console.info(
+                    f"File {click.style(str(file_path), fg='cyan')} is up to date"
+                )
+        else:
+            # File doesn't exist locally, create it
+            with open(local_path, "w", encoding="utf-8", newline="\n") as f:
+                f.write(remote_content)
+            console.success(f"Downloaded {click.style(str(file_path), fg='cyan')}")
+
+
+async def pull_project(project_id: str, download_configuration: dict[str, Path]):
+    studio_client = StudioClient(project_id)
+
+    with console.spinner("Pulling UiPath project files..."):
+        try:
+            structure = await studio_client.get_project_structure_async()
+            for source_key, destination in download_configuration.items():
+                source_folder = get_folder_by_name(structure, source_key)
+                if source_folder:
+                    await download_folder_files(
+                        studio_client,
+                        source_folder,
+                        destination,
+                    )
+                else:
+                    console.warning(f"No {source_key} folder found in remote project")
+
+        except Exception as e:
+            console.error(f"Failed to pull UiPath project: {str(e)}")

uipath-2.1.86/src/uipath/_cli/cli_pull.py

@@ -0,0 +1,59 @@
+# type: ignore
+"""CLI command for pulling remote project files from UiPath StudioWeb solution.
+
+This module provides functionality to pull remote project files from a UiPath StudioWeb solution.
+It handles:
+- File downloads from source_code and evals folders
+- Maintaining folder structure locally
+- File comparison using hashes
+- Interactive confirmation for overwriting files
+"""
+
+# type: ignore
+import asyncio
+import os
+from pathlib import Path
+
+import click
+
+from ..telemetry import track
+from ._utils._console import ConsoleLogger
+from ._utils._constants import UIPATH_PROJECT_ID
+from ._utils._project_files import pull_project
+
+console = ConsoleLogger()
+
+
+@click.command()
+@click.argument(
+    "root",
+    type=click.Path(exists=False, file_okay=False, dir_okay=True, path_type=Path),
+    default=Path("."),
+)
+@track
+def pull(root: Path) -> None:
+    """Pull remote project files from Studio Web Project.
+
+    This command pulls the remote project files from a UiPath Studio Web project.
+    It downloads files from the source_code and evals folders, maintaining the
+    folder structure locally. Files are compared using hashes before overwriting,
+    and user confirmation is required for differing files.
+
+    Args:
+        root: The root directory to pull files into
+
+    Environment Variables:
+        UIPATH_PROJECT_ID: Required. The ID of the UiPath Studio Web project
+
+    Example:
+        $ uipath pull
+        $ uipath pull /path/to/project
+    """
+    if not (project_id := os.getenv(UIPATH_PROJECT_ID, False)):
+        console.error("UIPATH_PROJECT_ID environment variable not found.")
+
+    default_download_configuration = {
+        "source_code": root,
+        "evals": root / "evals",
+    }
+    asyncio.run(pull_project(project_id, default_download_configuration))

{uipath-2.1.85 → uipath-2.1.86}/testcases/apicalls-testcase/run.sh

@@ -1,4 +1,5 @@
 #!/bin/bash
+set -e
 
 echo "Syncing dependencies..."
 uv sync

{uipath-2.1.85 → uipath-2.1.86}/testcases/basic-testcase/run.sh

@@ -1,4 +1,6 @@
 #!/bin/bash
+set -e
+
 echo "Syncing dependencies..."
 uv sync
 

{uipath-2.1.85 → uipath-2.1.86}/testcases/common/validate_output.sh

@@ -1,7 +1,7 @@
 #!/bin/bash
 
 # Common utility to print UiPath output file
-# Usage: source /app/testcases/common/print_output.sh
+# Usage: source /app/testcases/common/validate_output.sh
 
 debug_print_uipath_output() {
     echo "Printing output file..."
@@ -32,4 +32,4 @@ validate_output() {
     echo "Testcase completed successfully."
 }
 
-validate_output
+validate_output

{uipath-2.1.85 → uipath-2.1.86}/testcases/langchain-cross/run.sh

@@ -1,4 +1,6 @@
 #!/bin/bash
+set -e
+
 echo "Syncing dependencies..."
 uv sync
 

{uipath-2.1.85 → uipath-2.1.86}/testcases/llamaindex-cross/run.sh

@@ -1,4 +1,6 @@
 #!/bin/bash
+set -e
+
 echo "Syncing dependencies..."
 uv sync
 

{uipath-2.1.85 → uipath-2.1.86}/uv.lock

@@ -2146,7 +2146,7 @@ wheels = [
 
 [[package]]
 name = "uipath"
-version = "2.1.85"
+version = "2.1.86"
 source = { editable = "." }
 dependencies = [
     { name = "azure-monitor-opentelemetry" },

uipath-2.1.85/.github/workflows/test-uipath-langchain.yml

@@ -1,184 +0,0 @@
-name: Test UiPath Langchain
-
-on:
-  pull_request:
-    types: [ opened, synchronize, reopened, labeled ]
-
-jobs:
-  test-uipath-langchain:
-    runs-on: ${{ matrix.os }}
-    strategy:
-      matrix:
-        python-version: [ "3.10", "3.11", "3.12", "3.13" ]
-        os: [ ubuntu-latest, windows-latest ]
-
-    permissions:
-      contents: read
-
-    # Only run if PR has the test:uipath-langchain label
-    if: contains(github.event.pull_request.labels.*.name, 'test:uipath-langchain')
-
-    steps:
-      - name: Checkout uipath-python
-        uses: actions/checkout@v4
-        with:
-          path: 'uipath-python'
-
-      - name: Setup uv
-        uses: astral-sh/setup-uv@v5
-
-      - name: Setup Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: ${{ matrix.python-version }}
-
-      - name: Build uipath-python package
-        run: |
-          cd uipath-python
-          uv build
-
-      - name: Checkout uipath-langchain-python
-        uses: actions/checkout@v4
-        with:
-          repository: 'UiPath/uipath-langchain-python'
-          path: 'uipath-langchain-python'
-
-      - name: Update uipath-python version
-        shell: bash
-        run: |
-          cd uipath-langchain-python
-          uv add ../uipath-python/dist/*.whl --dev
-
-      - name: Run uipath-langchain tests
-        run: |
-          cd uipath-langchain-python
-          uv sync
-          uv run pytest
-
-  discover-testcases:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-    needs: [test-uipath-langchain]
-    outputs:
-      testcases: ${{ steps.discover.outputs.testcases }}
-    steps:
-      - name: Checkout uipath-langchain-python
-        uses: actions/checkout@v4
-        with:
-          repository: 'UiPath/uipath-langchain-python'
-          path: 'uipath-langchain-python'
-
-      - name: Discover testcases
-        id: discover
-        run: |
-          cd uipath-langchain-python
-
-          # 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"
-
-          # Convert to JSON array for matrix
-          testcases_json=$(echo "$testcase_dirs" | jq -R -s -c 'split("\n")[:-1]')
-          echo "testcases=$testcases_json" >> $GITHUB_OUTPUT
-
-  run-uipath-langchain-integration-tests:
-    runs-on: ubuntu-latest
-    needs: [discover-testcases]
-    permissions:
-      contents: read
-    strategy:
-      matrix:
-        testcase: ${{ fromJson(needs.discover-testcases.outputs.testcases) }}
-        environment: [alpha, cloud]
-        use_azure_chat: [true, false]
-    steps:
-
-      - name: Checkout uipath-python
-        uses: actions/checkout@v4
-        with:
-          path: 'uipath-python'
-
-      - name: Setup uv
-        uses: astral-sh/setup-uv@v5
-
-      - name: Build uipath-python package
-        run: |
-          cd uipath-python
-          uv build
-
-      - name: Checkout uipath-langchain-python
-        uses: actions/checkout@v4
-        with:
-          repository: 'UiPath/uipath-langchain-python'
-          path: 'uipath-langchain-python'
-
-      - name: Copy wheel to uipath-langchain
-        run: |
-          mkdir -p uipath-langchain-python/wheels
-          cp uipath-python/dist/*.whl uipath-langchain-python/wheels/
-
-      - name: Update uipath-python version
-        shell: bash
-        run: |
-          cd uipath-langchain-python
-          WHL=$(ls wheels/*.whl | head -n1)
-          WHL_NAME=$(basename "$WHL")
-          echo "Using wheel: $WHL_NAME"
-          sed -i "s|uipath>=.*|uipath @ file:///app/wheels/$WHL_NAME\",|" pyproject.toml
-
-          if ! grep -q '\[tool.hatch.metadata\]' pyproject.toml; then
-            echo -e '\n[tool.hatch.metadata]\nallow-direct-references = true' >> pyproject.toml
-          fi
-
-      - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v3
-
-      - name: Build Docker image
-        run: |
-          cd uipath-langchain-python
-          echo "Building Docker image at $(date)"
-          docker build -f testcases/Dockerfile \
-            -t uipath-langchain-testbase:latest .
-          echo "Docker image built at $(date)"
-
-      - name: Run integration test
-        env:
-          ALPHA_TEST_CLIENT_ID: ${{ secrets.ALPHA_TEST_CLIENT_ID }}
-          ALPHA_TEST_CLIENT_SECRET: ${{ secrets.ALPHA_TEST_CLIENT_SECRET }}
-          ALPHA_BASE_URL: ${{ secrets.ALPHA_BASE_URL }}
-          CLOUD_TEST_CLIENT_ID: ${{ secrets.CLOUD_TEST_CLIENT_ID }}
-          CLOUD_TEST_CLIENT_SECRET: ${{ secrets.CLOUD_TEST_CLIENT_SECRET }}
-          CLOUD_BASE_URL: ${{ secrets.CLOUD_BASE_URL }}
-        run: |
-          cd uipath-langchain-python
-
-          testcase="${{ matrix.testcase }}"
-          environment="${{ matrix.environment }}"
-          use_azure_chat="${{ matrix.use_azure_chat }}"
-
-          echo "Running testcase: $testcase"
-          echo "Environment: $environment"
-          echo "LLM: $( [ $use_azure_chat == "true" ] && echo "UiPathAzureChatOpenAI" || echo "UiPathChat" )"
-          echo "USE_AZURE_CHAT: $use_azure_chat"
-
-          if [ "$environment" == "alpha" ]; then
-            CLIENT_ID=$ALPHA_TEST_CLIENT_ID
-            CLIENT_SECRET=$ALPHA_TEST_CLIENT_SECRET
-            BASE_URL=$ALPHA_BASE_URL
-          else
-            CLIENT_ID=$CLOUD_TEST_CLIENT_ID
-            CLIENT_SECRET=$CLOUD_TEST_CLIENT_SECRET
-            BASE_URL=$CLOUD_BASE_URL
-          fi
-
-          docker run --rm \
-            -e CLIENT_ID="$CLIENT_ID" \
-            -e CLIENT_SECRET="$CLIENT_SECRET" \
-            -e BASE_URL="$BASE_URL" \
-            -e USE_AZURE_CHAT="$use_azure_chat" \
-            uipath-langchain-testbase:latest \
-            bash "/app/testcases/$testcase/run.sh"
-