uipath 2.0.0.dev3__py3-none-any.whl → 2.0.1.dev1__py3-none-any.whl

uipath/_cli/_utils/_parse_ast.py

@@ -0,0 +1,542 @@
+# type: ignore
+
+import ast
+import os
+from dataclasses import dataclass, field
+from typing import Any, Dict, List, Optional
+
+from ..._services import AssetsService, BucketsService, ProcessesService
+from ..._utils import get_inferred_bindings_names
+
+
+@dataclass
+class ServiceMethodCall:
+    """Represents a call to a service method with its parameters."""
+
+    method_name: str
+    args: List[Any] = field(default_factory=list)
+    kwargs: Dict[str, Any] = field(default_factory=dict)
+    line_number: int = 0
+
+    def extract_string_arg(self, index: int = 0) -> Optional[str]:
+        """Extract a string argument at the given position if it exists."""
+        if index < len(self.args):
+            if isinstance(self.args[index], str):
+                return self.args[index]
+            elif isinstance(self.args[index], (int, float, bool)):
+                return str(self.args[index])
+        return None
+
+
+service_name_resource_mapping = {
+    "assets": "asset",
+    "processes": "process",
+    "buckets": "bucket",
+    "connections": "connection",
+}
+
+
+def transform_connector_name(connector_name: str) -> str:
+    """Transform connector name from underscore format to hyphenated format.
+
+    Args:
+        connector_name: Connector name in format "one_two"
+
+    Returns:
+        str: Connector name in format "uipath-one-two"
+
+    Examples:
+        >>> transform_connector_name("google_gmail")
+        'uipath-google-gmail'
+        >>> transform_connector_name("salesforce_sfdc")
+        'uipath-salesforce-sfdc'
+    """
+    if not connector_name:
+        return ""
+    parts = connector_name.split("_")
+    return f"uipath-{'-'.join(parts)}"
+
+
+@dataclass
+class ServiceUsage:
+    """Collects all method calls for a specific service type."""
+
+    service_name: str
+    method_calls: List[ServiceMethodCall] = field(default_factory=list)
+
+    def get_component_info(self) -> List[Dict[str, str]]:
+        """Extract component names and folders based on the service type."""
+        result = []
+
+        if self.service_name == "assets":
+            for call in self.method_calls:
+                inferred_bindings = get_inferred_bindings_names(AssetsService)
+                if call.method_name in inferred_bindings:
+                    name = extract_parameter(
+                        call, inferred_bindings[call.method_name]["name"], 0
+                    )
+                    folder_path = extract_parameter(
+                        call, inferred_bindings[call.method_name]["folder_path"]
+                    )
+                    if name:
+                        result.append(
+                            {
+                                "name": name,
+                                "folder": folder_path or "",
+                                "method": call.method_name,
+                            }
+                        )
+
+        elif self.service_name == "processes":
+            for call in self.method_calls:
+                inferred_bindings = get_inferred_bindings_names(ProcessesService)
+                if call.method_name in inferred_bindings:
+                    name = extract_parameter(
+                        call, inferred_bindings[call.method_name]["name"], 0
+                    )
+                    folder_path = extract_parameter(
+                        call, inferred_bindings[call.method_name]["folder_path"]
+                    )
+                    if name:
+                        result.append(
+                            {
+                                "name": name,
+                                "folder": folder_path or "",
+                                "method": call.method_name,
+                            }
+                        )
+
+        elif self.service_name == "buckets":
+            for call in self.method_calls:
+                inferred_bindings = get_inferred_bindings_names(BucketsService)
+                if call.method_name in inferred_bindings:
+                    name = extract_parameter(
+                        call, inferred_bindings[call.method_name]["name"], 0
+                    )
+                    folder_path = extract_parameter(
+                        call, inferred_bindings[call.method_name]["folder_path"]
+                    )
+                    if name:
+                        result.append(
+                            {
+                                "name": name,
+                                "folder": folder_path or "",
+                                "method": call.method_name,
+                            }
+                        )
+
+        elif self.service_name == "connections":
+            for call in self.method_calls:
+                connection_id = None
+                if len(call.args) > 0:
+                    connection_id = call.args[0]
+                    if connection_id:
+                        result.append(
+                            {
+                                "name": str(connection_id),
+                                "connector": call.method_name,
+                                "method": "connector",
+                            }
+                        )
+
+        return result
+
+
+def extract_parameter(
+    method_call: ServiceMethodCall,
+    param_name: str,
+    position_index: Optional[int] = None,
+) -> Optional[Any]:
+    """Extract a parameter from a method call, checking both keyword and positional arguments.
+
+    Args:
+        method_call: The ServiceMethodCall object
+        param_name: The name of the parameter to extract
+        position_index: Optional position of the parameter if passed as a positional argument
+
+    Returns:
+        The parameter value if found, None otherwise
+    """
+    if param_name in method_call.kwargs:
+        return method_call.kwargs[param_name]
+
+    if position_index is not None and position_index < len(method_call.args):
+        return method_call.args[position_index]
+
+    return None
+
+
+def parse_local_module(
+    module_path: str, base_dir: str
+) -> Dict[str, List[Dict[str, str]]]:
+    """Parse a local module and extract SDK usage.
+
+    Args:
+        module_path: Import path of the module (e.g., 'myapp.utils')
+        base_dir: Base directory to resolve relative imports
+
+    Returns:
+        Dictionary of SDK usage from the module
+    """
+    # Convert module path to file path
+    file_path = os.path.join(base_dir, *module_path.split(".")) + ".py"
+
+    # Check if the file exists
+    if not os.path.exists(file_path):
+        # Try as a package with __init__.py
+        file_path = os.path.join(base_dir, *module_path.split("."), "__init__.py")
+        if not os.path.exists(file_path):
+            return {}
+
+    # Parse the module
+    try:
+        with open(file_path, "r") as f:
+            source_code = f.read()
+        return parse_sdk_usage(source_code, base_dir)
+    except Exception:
+        return {}
+
+
+class UiPathTracker:
+    """Tracks UiPath usage throughout the code."""
+
+    def __init__(self, source_code: str, base_dir: str = ""):
+        self.source_code = source_code
+        self.base_dir = base_dir
+        self.tree = ast.parse(source_code)
+        self.sdk_imports: Dict[str, str] = {}  # Import alias -> original module
+        self.sdk_instances: Dict[str, str] = {}  # Instance name -> class
+        self.local_imports: List[str] = []  # List of local module imports
+        self.service_usage: Dict[str, ServiceUsage] = {
+            "assets": ServiceUsage("assets"),
+            "processes": ServiceUsage("processes"),
+            "buckets": ServiceUsage("buckets"),
+            "actions": ServiceUsage("actions"),
+            "context_grounding": ServiceUsage("context_grounding"),
+            "api_client": ServiceUsage("api_client"),
+            "connections": ServiceUsage("connections"),  # Add connections service
+        }
+
+    def analyze(self) -> None:
+        """Run all analysis steps."""
+        self._find_imports()
+        self._find_instances()
+        self._find_method_calls()
+
+    def _find_imports(self) -> None:
+        """Find all imports of UiPath and local modules."""
+
+        class ImportVisitor(ast.NodeVisitor):
+            def __init__(self):
+                self.imports = {}
+                self.local_imports = []
+
+            def visit_Import(self, node):
+                for alias in node.names:
+                    if alias.name == "uipath":
+                        self.imports[alias.asname or alias.name] = alias.name
+                    elif (
+                        not alias.name.startswith(("__", "builtins", "typing"))
+                        and "." not in alias.name
+                    ):
+                        # Potential local import
+                        self.local_imports.append(alias.name)
+                self.generic_visit(node)
+
+            def visit_ImportFrom(self, node):
+                if node.module == "uipath":
+                    for alias in node.names:
+                        if alias.name == "UiPath":
+                            self.imports[alias.asname or alias.name] = "uipath.UiPath"
+                elif node.module and not node.module.startswith(
+                    ("__", "builtins", "typing")
+                ):
+                    # Potential local import
+                    self.local_imports.append(node.module)
+                self.generic_visit(node)
+
+        visitor = ImportVisitor()
+        visitor.visit(self.tree)
+        self.sdk_imports = visitor.imports
+        self.local_imports = visitor.local_imports
+
+    def _find_instances(self) -> None:
+        """Find all instances created from UiPath."""
+
+        class InstanceVisitor(ast.NodeVisitor):
+            def __init__(self, sdk_imports):
+                self.sdk_imports = sdk_imports
+                self.instances = {}
+
+            def visit_Assign(self, node):
+                if isinstance(node.value, ast.Call):
+                    call = node.value
+                    if (
+                        isinstance(call.func, ast.Name)
+                        and call.func.id in self.sdk_imports
+                    ):
+                        for target in node.targets:
+                            if isinstance(target, ast.Name):
+                                self.instances[target.id] = "UiPath"
+                self.generic_visit(node)
+
+        visitor = InstanceVisitor(self.sdk_imports)
+        visitor.visit(self.tree)
+        self.sdk_instances = visitor.instances
+
+    def _find_method_calls(self) -> None:
+        """Find all method calls on UiPath instances."""
+
+        class MethodCallVisitor(ast.NodeVisitor):
+            def __init__(self, source_code, sdk_instances, service_usage):
+                self.source_code = source_code
+                self.sdk_instances = sdk_instances
+                self.service_usage = service_usage
+
+            def visit_Call(self, node):
+                if isinstance(node.func, ast.Attribute) and isinstance(
+                    node.func.value, ast.Attribute
+                ):
+                    if (
+                        isinstance(node.func.value.value, ast.Name)
+                        and node.func.value.value.id in self.sdk_instances
+                    ):
+                        service_name = node.func.value.attr
+                        method_name = node.func.attr
+
+                        if service_name in self.service_usage:
+                            # Extract arguments
+                            args = []
+                            for arg in node.args:
+                                if isinstance(arg, ast.Constant) and isinstance(
+                                    arg.value, str
+                                ):
+                                    args.append(arg.value)
+                                elif isinstance(arg, ast.Constant):
+                                    # Handle non-string constants normally
+                                    args.append(arg.value)
+                                else:
+                                    # For expressions and variables, prefix with EXPR$
+                                    source_segment = ast.get_source_segment(
+                                        self.source_code, arg
+                                    )
+                                    args.append(f"EXPR${source_segment}")
+
+                            kwargs = {}
+                            for keyword in node.keywords:
+                                if isinstance(keyword.value, ast.Constant):
+                                    kwargs[keyword.arg] = keyword.value.value
+                                else:
+                                    source_segment = ast.get_source_segment(
+                                        self.source_code, keyword.value
+                                    )
+                                    kwargs[keyword.arg] = f"EXPR${source_segment}"
+
+                            method_call = ServiceMethodCall(
+                                method_name=method_name,
+                                args=args,
+                                kwargs=kwargs,
+                                line_number=node.lineno,
+                            )
+                            self.service_usage[service_name].method_calls.append(
+                                method_call
+                            )
+
+                elif isinstance(node.func, ast.Attribute) and isinstance(
+                    node.func.value, ast.Attribute
+                ):
+                    if (
+                        isinstance(node.func.value.value, ast.Name)
+                        and node.func.value.value.id in self.sdk_instances
+                        and node.func.value.attr == "connections"
+                    ):
+                        connector_name = node.func.attr
+
+                        args = []
+                        for arg in node.args:
+                            if isinstance(arg, ast.Constant) and isinstance(
+                                arg.value, (str, int)
+                            ):
+                                args.append(arg.value)
+                            elif isinstance(arg, ast.Constant):
+                                args.append(arg.value)
+                            else:
+                                source_segment = ast.get_source_segment(
+                                    self.source_code, arg
+                                )
+                                args.append(f"EXPR${source_segment}")
+
+                        kwargs = {}
+                        for keyword in node.keywords:
+                            if isinstance(keyword.value, ast.Constant):
+                                kwargs[keyword.arg] = keyword.value.value
+                            else:
+                                source_segment = ast.get_source_segment(
+                                    self.source_code, keyword.value
+                                )
+                                kwargs[keyword.arg] = f"EXPR${source_segment}"
+
+                        method_call = ServiceMethodCall(
+                            method_name=connector_name,
+                            args=args,
+                            kwargs=kwargs,
+                            line_number=node.lineno,
+                        )
+                        self.service_usage["connections"].method_calls.append(
+                            method_call
+                        )
+
+                self.generic_visit(node)
+
+        visitor = MethodCallVisitor(
+            self.source_code, self.sdk_instances, self.service_usage
+        )
+        visitor.visit(self.tree)
+
+    def get_results(self) -> Dict[str, List[Dict[str, str]]]:
+        """Get the analysis results organized by service type."""
+        results = {}
+        for service_name, usage in self.service_usage.items():
+            components = usage.get_component_info()
+            if components:
+                results[service_name] = components
+        return results
+
+
+def parse_sdk_usage(
+    source_code: str, base_dir: str = ""
+) -> Dict[str, List[Dict[str, str]]]:
+    """Parse the source code and return UiPath usage information.
+
+    Args:
+        source_code: The Python source code to analyze
+        base_dir: Base directory to resolve relative imports
+
+    Returns:
+        Dictionary of SDK usage information
+    """
+    tracker = UiPathTracker(source_code, base_dir)
+    tracker.analyze()
+    results = tracker.get_results()
+
+    # Parse local imports recursively
+    if base_dir:
+        for module_path in tracker.local_imports:
+            module_results = parse_local_module(module_path, base_dir)
+
+            # Merge results
+            for service_name, components in module_results.items():
+                if service_name in results:
+                    results[service_name].extend(components)
+                else:
+                    results[service_name] = components
+
+    return results
+
+
+def convert_to_bindings_format(sdk_usage_data):
+    """Convert the output of parse_sdk_usage to a structure similar to bindings_v2.json.
+
+    Args:
+        sdk_usage_data: Dictionary output from parse_sdk_usage
+
+    Returns:
+        Dictionary in bindings_v2.json format
+    """
+    bindings = {"version": "2.0", "resources": []}
+
+    for resource_type, components in sdk_usage_data.items():
+        for component in components:
+            if resource_type == "connections":
+                connection_id = component.get("name", "")
+                connector_name = transform_connector_name(
+                    component.get("connector", "")
+                )
+                is_connection_id_expression = connection_id.startswith("EXPR$")
+                connection_id = connection_id.replace("EXPR$", "")
+                resource_entry = {
+                    "resource": "connection",
+                    "key": connection_id,
+                    "value": {
+                        "ConnectionId": {
+                            "defaultValue": connection_id,
+                            "isExpression": is_connection_id_expression,
+                            "displayName": "Connection",
+                            "description": "The connection to be used",
+                        }
+                    },
+                    "metadata": {
+                        "BindingsVersion": "2.1",
+                        "Connector": connector_name,
+                        "UseConnectionService": "True",
+                    },
+                }
+
+                bindings["resources"].append(resource_entry)
+                continue
+
+            resource_name = component.get("name", "")
+            folder_path = component.get("folder", None)
+            method_name = component.get("method", "Unknown")
+
+            name = resource_name
+
+            is_expression = name.startswith("EXPR$")
+            is_folder_path_expression = folder_path and folder_path.startswith("EXPR$")
+            name = name.replace("EXPR$", "")
+            folder_path = folder_path.replace("EXPR$", "") if folder_path else None
+            key = name
+            if folder_path:
+                key = f"{folder_path}.{name}"
+            resource_entry = {
+                "resource": service_name_resource_mapping[resource_type],
+                "key": key,
+                "value": {
+                    "name": {
+                        "defaultValue": name,
+                        "isExpression": is_expression,
+                        "displayName": "Name",
+                    }
+                },
+                "metadata": {
+                    "ActivityName": method_name,
+                    "BindingsVersion": "2.1",
+                    "DisplayLabel": "FullName",
+                },
+            }
+
+            if folder_path:
+                resource_entry["value"]["folderPath"] = {
+                    "defaultValue": folder_path,
+                    "isExpression": is_folder_path_expression,
+                    "displayName": "Folder Path",
+                }
+
+            bindings["resources"].append(resource_entry)
+
+    return bindings
+
+
+def generate_bindings_json(file_path: str) -> str:
+    """Generate bindings JSON from a Python file.
+
+    Args:
+        file_path: Path to the Python file to analyze
+
+    Returns:
+        JSON string representation of the bindings
+    """
+    try:
+        with open(file_path, "r") as f:
+            source_code = f.read()
+
+        # Get the base directory for resolving imports
+        base_dir = os.path.dirname(os.path.abspath(file_path))
+
+        sdk_usage = parse_sdk_usage(source_code, base_dir)
+        bindings = convert_to_bindings_format(sdk_usage)
+
+        return bindings
+
+    except Exception as e:
+        raise Exception(f"Error generating bindings JSON: {e}") from e

uipath/_cli/cli_auth.py

@@ -0,0 +1,97 @@
+# type: ignore
+import json
+import os
+import socket
+import webbrowser
+
+import click
+from dotenv import load_dotenv
+
+from ._auth._auth_server import HTTPSServer
+from ._auth._oidc_utils import get_auth_config, get_auth_url
+from ._auth._portal_service import PortalService, select_tenant
+from ._auth._utils import update_auth_file, update_env_file
+from ._utils._common import environment_options
+
+load_dotenv()
+
+
+def is_port_in_use(port: int) -> bool:
+    with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
+        try:
+            s.bind(("localhost", port))
+            s.close()
+            return False
+        except socket.error:
+            return True
+
+
+def set_port():
+    auth_config = get_auth_config()
+    port = auth_config.get("port", 8104)
+    port_option_one = auth_config.get("portOptionOne", 8104)
+    port_option_two = auth_config.get("portOptionTwo", 8055)
+    port_option_three = auth_config.get("portOptionThree", 42042)
+    if is_port_in_use(port):
+        if is_port_in_use(port_option_one):
+            if is_port_in_use(port_option_two):
+                if is_port_in_use(port_option_three):
+                    raise RuntimeError(
+                        "All configured ports are in use. Please close applications using ports or configure different ports."
+                    )
+                else:
+                    port = port_option_three
+            else:
+                port = port_option_two
+        else:
+            port = port_option_one
+    auth_config["port"] = port
+    with open(
+        os.path.join(os.path.dirname(__file__), "..", "auth_config.json"), "w"
+    ) as f:
+        json.dump(auth_config, f)
+
+
+@click.command()
+@environment_options
+def auth(domain="alpha"):
+    """Authenticate with UiPath Cloud Platform."""
+    portal_service = PortalService(domain)
+    if (
+        os.getenv("UIPATH_URL")
+        and os.getenv("UIPATH_TENANT_ID")
+        and os.getenv("UIPATH_ORGANIZATION_ID")
+    ):
+        try:
+            portal_service.ensure_valid_token()
+            click.echo("Authentication successful")
+            return
+        except Exception:
+            click.echo(
+                "Authentication not found or expired. Please authenticate again."
+            )
+
+    auth_url, code_verifier, state = get_auth_url(domain)
+
+    webbrowser.open(auth_url, 1)
+    auth_config = get_auth_config()
+
+    print(
+        "If a browser window did not open, please open the following URL in your browser:"
+    )
+    print(auth_url)
+    server = HTTPSServer(port=auth_config["port"])
+    token_data = server.start(state, code_verifier, domain)
+    try:
+        if token_data:
+            portal_service.update_token_data(token_data)
+            update_auth_file(token_data)
+            access_token = token_data["access_token"]
+            update_env_file({"UIPATH_ACCESS_TOKEN": access_token})
+
+            tenants_and_organizations = portal_service.get_tenants_and_organizations()
+            select_tenant(domain, tenants_and_organizations)
+        else:
+            click.echo("Authentication failed")
+    except Exception as e:
+        click.echo(f"Authentication failed: {e}")

uipath/_cli/cli_deploy.py

@@ -0,0 +1,13 @@
+# type: ignore
+import click
+
+from .cli_pack import pack
+from .cli_publish import publish
+
+
+@click.command()
+@click.argument("root", type=str, default="./")
+def deploy(root):
+    ctx = click.get_current_context()
+    ctx.invoke(pack, root=root)
+    ctx.invoke(publish)