uipath 2.1.6__py3-none-any.whl → 2.1.7__py3-none-any.whl

uipath/_cli/__init__.py

@@ -10,6 +10,7 @@ from .cli_invoke import invoke as invoke  # type: ignore
 from .cli_new import new as new  # type: ignore
 from .cli_pack import pack as pack  # type: ignore
 from .cli_publish import publish as publish  # type: ignore
+from .cli_pull import pull as pull  # type: ignore
 from .cli_push import push as push  # type: ignore
 from .cli_run import run as run  # type: ignore
 
@@ -65,3 +66,4 @@ cli.add_command(deploy)
 cli.add_command(auth)
 cli.add_command(invoke)
 cli.add_command(push)
+cli.add_command(pull)

uipath/_cli/_utils/_common.py

@@ -1,5 +1,6 @@
 import os
 from typing import Optional
+from urllib.parse import urlparse
 
 import click
 
@@ -29,7 +30,7 @@ def environment_options(function):
     return function
 
 
-def get_env_vars(spinner: Optional[Spinner] = None) -> list[str | None]:
+def get_env_vars(spinner: Optional[Spinner] = None) -> list[str]:
     base_url = os.environ.get("UIPATH_URL")
     token = os.environ.get("UIPATH_ACCESS_TOKEN")
 
@@ -42,7 +43,8 @@ def get_env_vars(spinner: Optional[Spinner] = None) -> list[str | None]:
         click.echo("UIPATH_URL, UIPATH_ACCESS_TOKEN")
         click.get_current_context().exit(1)
 
-    return [base_url, token]
+    # at this step we know for sure that both base_url and token exist. type checking can be disabled
+    return [base_url, token]  # type: ignore
 
 
 def serialize_object(obj):
@@ -69,3 +71,18 @@ def serialize_object(obj):
     # Return primitive types as is
     else:
         return obj
+
+
+def get_org_scoped_url(base_url: str) -> str:
+    """Get organization scoped URL from base URL.
+
+    Args:
+        base_url: The base URL to scope
+
+    Returns:
+        str: The organization scoped URL
+    """
+    parsed = urlparse(base_url)
+    org_name, *_ = parsed.path.strip("/").split("/")
+    org_scoped_url = f"{parsed.scheme}://{parsed.netloc}/{org_name}"
+    return org_scoped_url

uipath/_cli/_utils/_studio_project.py

@@ -1,5 +1,6 @@
-from typing import List, Optional, Union
+from typing import Any, List, Optional, Union
 
+import httpx
 from pydantic import BaseModel, ConfigDict, Field, field_validator
 
 
@@ -136,3 +137,62 @@ class ProjectStructure(BaseModel):
         if isinstance(v, int):
             return str(v)
         return v
+
+
+def get_project_structure(
+    project_id: str,
+    base_url: str,
+    token: str,
+    client: httpx.Client,
+) -> ProjectStructure:
+    """Retrieve the project's file structure from UiPath Cloud.
+
+    Makes an API call to fetch the complete file structure of a project,
+    including all files and folders. The response is validated against
+    the ProjectStructure model.
+
+    Args:
+        project_id: The ID of the project
+        base_url: The base URL for the API
+        token: Authentication token
+        client: HTTP client to use for requests
+
+    Returns:
+        ProjectStructure: The complete project structure
+
+    Raises:
+        httpx.HTTPError: If the API request fails
+    """
+    headers = {"Authorization": f"Bearer {token}"}
+    url = (
+        f"{base_url}/studio_/backend/api/Project/{project_id}/FileOperations/Structure"
+    )
+
+    response = client.get(url, headers=headers)
+    response.raise_for_status()
+    return ProjectStructure.model_validate(response.json())
+
+
+def download_file(base_url: str, file_id: str, client: httpx.Client, token: str) -> Any:
+    file_url = f"{base_url}/File/{file_id}"
+    response = client.get(file_url, headers={"Authorization": f"Bearer {token}"})
+    response.raise_for_status()
+    return response
+
+
+def get_folder_by_name(
+    structure: ProjectStructure, folder_name: str
+) -> Optional[ProjectFolder]:
+    """Get a folder from the project structure by name.
+
+    Args:
+        structure: The project structure
+        folder_name: Name of the folder to find
+
+    Returns:
+        Optional[ProjectFolder]: The found folder or None
+    """
+    for folder in structure.folders:
+        if folder.name == folder_name:
+            return folder
+    return None

uipath/_cli/cli_pack.py

@@ -276,7 +276,9 @@ def display_project_info(config):
 
 
 @click.command()
-@click.argument("root", type=str, default="./")
+@click.argument(
+    "root", type=click.Path(exists=True, file_okay=False, dir_okay=True), default="."
+)
 @click.option(
     "--nolock",
     is_flag=True,

uipath/_cli/cli_pull.py

@@ -0,0 +1,215 @@
+# 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 hashlib
+import json
+import os
+from typing import Dict, Set
+
+import click
+import httpx
+from dotenv import load_dotenv
+
+from .._utils._ssl_context import get_httpx_client_kwargs
+from ..telemetry import track
+from ._utils._common import get_env_vars, get_org_scoped_url
+from ._utils._console import ConsoleLogger
+from ._utils._studio_project import (
+    ProjectFile,
+    ProjectFolder,
+    download_file,
+    get_folder_by_name,
+    get_project_structure,
+)
+
+console = ConsoleLogger()
+load_dotenv(override=True)
+
+
+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)
+
+
+def download_folder_files(
+    folder: ProjectFolder,
+    base_path: str,
+    base_url: str,
+    token: str,
+    client: httpx.Client,
+    processed_files: Set[str],
+) -> None:
+    """Download files from a folder recursively.
+
+    Args:
+        folder: The folder to download files from
+        base_path: Base path for local file storage
+        base_url: Base URL for API requests
+        token: Authentication token
+        client: HTTP client
+        processed_files: Set to track processed files
+    """
+    files_dict: Dict[str, ProjectFile] = {}
+    collect_files_from_folder(folder, "", files_dict)
+
+    for file_path, remote_file in files_dict.items():
+        local_path = os.path.join(base_path, file_path)
+        local_dir = os.path.dirname(local_path)
+
+        # Create directory if it doesn't exist
+        if not os.path.exists(local_dir):
+            os.makedirs(local_dir)
+
+        # Download remote file
+        response = download_file(base_url, remote_file.id, client, token)
+        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 override 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')}")
+
+        processed_files.add(file_path)
+
+
+@click.command()
+@click.argument(
+    "root", type=click.Path(exists=True, file_okay=False, dir_okay=True), default="."
+)
+@track
+def pull(root: str) -> 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 os.getenv("UIPATH_PROJECT_ID", False):
+        console.error("UIPATH_PROJECT_ID environment variable not found.")
+
+    [base_url, token] = get_env_vars()
+    base_api_url = f"{get_org_scoped_url(base_url)}/studio_/backend/api/Project/{os.getenv('UIPATH_PROJECT_ID')}/FileOperations"
+
+    with console.spinner("Pulling UiPath project files..."):
+        try:
+            with httpx.Client(**get_httpx_client_kwargs()) as client:
+                # Get project structure
+                structure = get_project_structure(
+                    os.getenv("UIPATH_PROJECT_ID"),  # type: ignore
+                    get_org_scoped_url(base_url),
+                    token,
+                    client,
+                )
+
+                processed_files: Set[str] = set()
+
+                # Process source_code folder
+                source_code_folder = get_folder_by_name(structure, "source_code")
+                if source_code_folder:
+                    download_folder_files(
+                        source_code_folder,
+                        root,
+                        base_api_url,
+                        token,
+                        client,
+                        processed_files,
+                    )
+                else:
+                    console.warning("No source_code folder found in remote project")
+
+                # Process evals folder
+                evals_folder = get_folder_by_name(structure, "evals")
+                if evals_folder:
+                    evals_path = os.path.join(root, "evals")
+                    download_folder_files(
+                        evals_folder,
+                        evals_path,
+                        base_api_url,
+                        token,
+                        client,
+                        processed_files,
+                    )
+                else:
+                    console.warning("No evals folder found in remote project")
+
+        except Exception as e:
+            console.error(f"Failed to pull UiPath project: {str(e)}")

uipath/_cli/cli_push.py

@@ -492,7 +492,9 @@ def upload_source_files_to_project(
 
 
 @click.command()
-@click.argument("root", type=str, default="./")
+@click.argument(
+    "root", type=click.Path(exists=True, file_okay=False, dir_okay=True), default="."
+)
 @click.option(
     "--nolock",
     is_flag=True,

{uipath-2.1.6.dist-info → uipath-2.1.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: uipath
-Version: 2.1.6
+Version: 2.1.7
 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.6.dist-info → uipath-2.1.7.dist-info}/RECORD

@@ -5,15 +5,16 @@ uipath/_folder_context.py,sha256=UMMoU1VWEfYHAZW3Td2SIFYhw5dYsmaaKFhW_JEm6oc,192
 uipath/_uipath.py,sha256=ZfEcqpY7NRSm6rB2OPgyVXBl9DCnn750ikq8VzzTO_s,4146
 uipath/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 uipath/_cli/README.md,sha256=GLtCfbeIKZKNnGTCsfSVqRQ27V1btT1i2bSAyW_xZl4,474
-uipath/_cli/__init__.py,sha256=VKcdFaQtoGiyPhxBCx74EMz-sGC3957D21g1DMGXJ7w,1958
+uipath/_cli/__init__.py,sha256=4CYDwTNPVCTCrjCElbNyu1AlKWn-WKxQCJtqg4y1KjA,2031
 uipath/_cli/cli_auth.py,sha256=RUSBHfmqhBtITrx52FeXMlVCuNyo8vrjTdjEhmM1Khw,6734
 uipath/_cli/cli_deploy.py,sha256=KPCmQ0c_NYD5JofSDao5r6QYxHshVCRxlWDVnQvlp5w,645
 uipath/_cli/cli_init.py,sha256=SmB7VplpXRSa5sgqgzojNsZDw0zfsEi2TfkMx3eQpTo,5132
 uipath/_cli/cli_invoke.py,sha256=FurosrZNGlmANIrplKWhw3EQ1b46ph5Z2rPwVaYJgmc,4001
 uipath/_cli/cli_new.py,sha256=9378NYUBc9j-qKVXV7oja-jahfJhXBg8zKVyaon7ctY,2102
-uipath/_cli/cli_pack.py,sha256=D1sIk91Ka1_dMWAOFuHemeqwUvlgPZKDuvfasoTyAE0,10557
+uipath/_cli/cli_pack.py,sha256=JN5BBw-R7jZJ479YtaLOVa3SmraxxPM3wBdG3iDnPTs,10614
 uipath/_cli/cli_publish.py,sha256=QT17JTClAyLve6ZjB-WvQaJ-j4DdmNneV_eDRyXjeeQ,6578
-uipath/_cli/cli_push.py,sha256=YfATg8auLii0IUQJLWPSA_M_iHNylNE2aIQUtDBMdzQ,18836
+uipath/_cli/cli_pull.py,sha256=zVcLciXyccaUUJX75rkUvihYAO4-yCsIz4c4Dcly3aw,7535
+uipath/_cli/cli_push.py,sha256=PP6smnwMjxFbfb2IuD8cZHCoYifEsz5o-1r5ilNVUD0,18893
 uipath/_cli/cli_run.py,sha256=cTZYWJkGk2ruk6RRJBXII9J6VjpgGmysv_KlKI1JMHo,6446
 uipath/_cli/middlewares.py,sha256=CN-QqV69zZPI-hvizvEIb-zTcNh9WjsZIYCF3_nHSio,4915
 uipath/_cli/spinner.py,sha256=bS-U_HA5yne11ejUERu7CQoXmWdabUD2bm62EfEdV8M,1107
@@ -37,7 +38,7 @@ uipath/_cli/_templates/.rels.template,sha256=-fTcw7OA1AcymHr0LzBqbMAAtzZTRXLTNa_
 uipath/_cli/_templates/[Content_Types].xml.template,sha256=bYsKDz31PkIF9QksjgAY_bqm57YC8U_owsZeNZAiBxQ,584
 uipath/_cli/_templates/main.py.template,sha256=QB62qX5HKDbW4lFskxj7h9uuxBITnTWqu_DE6asCwcU,476
 uipath/_cli/_templates/package.nuspec.template,sha256=YZyLc-u_EsmIoKf42JsLQ55OGeFmb8VkIU2VF7DFbtw,359
-uipath/_cli/_utils/_common.py,sha256=wQ0a_lGj0bsuNvwxUfnLwg6T3IdatdfkrPcZMoufJNU,2058
+uipath/_cli/_utils/_common.py,sha256=EwtNvcSgjK1dZcQhwR1ZOue7E4Uj7AD7m4Vr5twdx7I,2595
 uipath/_cli/_utils/_console.py,sha256=rj4V3yeR1wnJzFTHnaE6wcY9OoJV-PiIQnLg_p62ClQ,6664
 uipath/_cli/_utils/_constants.py,sha256=AXeVidtHUFiODrkB2BCX_bqDL-bUzRg-Ieh1-2cCrGA,1374
 uipath/_cli/_utils/_debug.py,sha256=zamzIR4VgbdKADAE4gbmjxDsbgF7wvdr7C5Dqp744Oc,1739
@@ -46,7 +47,7 @@ uipath/_cli/_utils/_input_args.py,sha256=pyQhEcQXHdFHYTVNzvfWp439aii5StojoptnmCv
 uipath/_cli/_utils/_parse_ast.py,sha256=A-QToBIf-oP7yP2DQTHO6blkk6ik5z_IeaIwtEWO4e0,19516
 uipath/_cli/_utils/_processes.py,sha256=q7DfEKHISDWf3pngci5za_z0Pbnf_shWiYEcTOTCiyk,1855
 uipath/_cli/_utils/_project_files.py,sha256=noGulQh95d4aqwoa-moK2kXGpIG_1Wqy7rcNmNpjaWs,12192
-uipath/_cli/_utils/_studio_project.py,sha256=_gED64JeVc0u2i0L0Exr-pfnArdlDVPJzAD738YLr24,4443
+uipath/_cli/_utils/_studio_project.py,sha256=TkYZLMfsBrZ03mBePXKyiHJqbznPIElxrrfaO5kSyyM,6185
 uipath/_cli/_utils/_tracing.py,sha256=2igb03j3EHjF_A406UhtCKkPfudVfFPjUq5tXUEG4oo,1541
 uipath/_cli/_utils/_uv_helpers.py,sha256=6SvoLnZPoKIxW0sjMvD1-ENV_HOXDYzH34GjBqwT138,3450
 uipath/_services/__init__.py,sha256=10xtw3ENC30yR9CCq_b94RMZ3YrUeyfHV33yWYUd8tU,896
@@ -99,8 +100,8 @@ uipath/tracing/_traced.py,sha256=qeVDrds2OUnpdUIA0RhtF0kg2dlAZhyC1RRkI-qivTM,185
 uipath/tracing/_utils.py,sha256=ZeensQexnw69jVcsVrGyED7mPlAU-L1agDGm6_1A3oc,10388
 uipath/utils/__init__.py,sha256=VD-KXFpF_oWexFg6zyiWMkxl2HM4hYJMIUDZ1UEtGx0,105
 uipath/utils/_endpoints_manager.py,sha256=hiGEu6vyfQJoeiiql6w21TNiG6tADUfXlVBimxPU1-Q,4160
-uipath-2.1.6.dist-info/METADATA,sha256=kc-2b_9OI9fOEfr3hnwPnnM8B4QAQjeiHM3-HZQgT-0,6366
-uipath-2.1.6.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-uipath-2.1.6.dist-info/entry_points.txt,sha256=9C2_29U6Oq1ExFu7usihR-dnfIVNSKc-0EFbh0rskB4,43
-uipath-2.1.6.dist-info/licenses/LICENSE,sha256=-KBavWXepyDjimmzH5fVAsi-6jNVpIKFc2kZs0Ri4ng,1058
-uipath-2.1.6.dist-info/RECORD,,
+uipath-2.1.7.dist-info/METADATA,sha256=M-StRFIry6ZalMHNl0-x479VUK0-e5qIUEE8RFY8Cs0,6366
+uipath-2.1.7.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+uipath-2.1.7.dist-info/entry_points.txt,sha256=9C2_29U6Oq1ExFu7usihR-dnfIVNSKc-0EFbh0rskB4,43
+uipath-2.1.7.dist-info/licenses/LICENSE,sha256=-KBavWXepyDjimmzH5fVAsi-6jNVpIKFc2kZs0Ri4ng,1058
+uipath-2.1.7.dist-info/RECORD,,