uipath 2.0.32__tar.gz → 2.0.34__tar.gz

{uipath-2.0.32 → uipath-2.0.34}/.github/workflows/build.yml

@@ -46,20 +46,3 @@ jobs:
           uv publish
         env:
           UV_PUBLISH_TOKEN: ${{ secrets.token }}
-
-      - name: Clone plugins
-        if: ${{ steps.check_version.outputs.modified }} == 'true'
-        run: |
-          git clone https://x-access-token:${{ secrets.repo_access }}@github.com/UiPath/uipath-langchain-python plugins/uipath-langchain-python
-
-      - name: Symlink plugin docs
-        if: ${{ steps.check_version.outputs.modified }} == 'true'
-        run: |
-          mkdir -p docs/plugins
-          ln -s ../../plugins/uipath-langchain-python docs/plugins/uipath-langchain-python
-
-      - name: Publish Docs
-        if: ${{ steps.check_version.outputs.modified }} == 'true'
-        run: |
-          ls -la docs
-          uv run mkdocs gh-deploy --force

uipath-2.0.34/.github/workflows/publish-docs.yml

@@ -0,0 +1,38 @@
+name: Publish Docs
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  publish-docs:
+    runs-on: "ubuntu-24.04"
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v5
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version-file: ".python-version"
+
+      - name: Setup venv
+        run: |
+          uv venv
+          uv sync --all-extras
+
+      - name: Clone plugins
+        run: |
+          git clone https://x-access-token:${{ secrets.REPO_ACCESS }}@github.com/UiPath/uipath-langchain-python plugins/uipath-langchain-python
+
+      - name: Symlink plugin docs
+        run: |
+          mkdir -p docs/plugins
+          ln -s ../../plugins/uipath-langchain-python docs/plugins/uipath-langchain-python
+
+      - name: Publish Docs
+        run: |
+          ls -la docs
+          uv run mkdocs gh-deploy --force

{uipath-2.0.32 → uipath-2.0.34}/.gitignore

@@ -23,3 +23,6 @@ wheels/
 **/docs/plugins/.*
 **/docs/quick_start_images/*
 **/docs/quick_start_images/.*
+
+.cache/*
+.cache

{uipath-2.0.32 → uipath-2.0.34}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: uipath
-Version: 2.0.32
+Version: 2.0.34
 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
@@ -35,7 +35,7 @@ Description-Content-Type: text/markdown
 [![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 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 Platform.
+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.
 

{uipath-2.0.32 → uipath-2.0.34}/README.md

@@ -4,7 +4,7 @@
 [![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 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 Platform.
+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.
 

{uipath-2.0.32 → uipath-2.0.34}/docs/core/getting_started.md

@@ -4,28 +4,37 @@
 
 -   Python 3.10 or higher
 -   `pip` or `uv` package manager
--   A UiPath Platform account with appropriate permissions
+-   A UiPath Cloud Platform account with appropriate permissions
 
 ## Getting Started with the CLI
+
 //// tab | Linux, macOS, Windows Bash
+
 <!-- termynal -->
+
 ```shell
 > mkdir example
 > cd example
 ```
+
 ////
 
 //// tab | Windows PowerShell
+
 <!-- termynal -->
+
 ```powershell
 > New-Item -ItemType Directory -Path example
 > Set-Location example
 ```
+
 ////
 
 //// tab | uv
     new: true
+
 <!-- termynal -->
+
 ```shell
 # Initialize a new uv project in the current directory
 > uv init . --python 3.10
@@ -49,10 +58,13 @@ Activate with: source .venv/bin/activate
 > uipath --version
 uipath version 2.0.29
 ```
+
 ////
 
 //// tab | pip
+
 <!-- termynal -->
+
 ```shell
 # Create a new virtual environment
 > python -m venv .venv
@@ -72,6 +84,7 @@ uipath version 2.0.29
 > uipath --version
 uipath version 2.0.29
 ```
+
 ////
 
 ### Authentication
@@ -79,6 +92,7 @@ uipath version 2.0.29
 To debug your script locally and publish your project, you need to authenticate with UiPath:
 
 <!-- termynal -->
+
 ```shell
 > uipath auth
 ⠋ Authenticating with UiPath ...
@@ -132,6 +146,7 @@ def main(input: EchoIn) -> EchoOut:
 To create a UiPath project, run the following command in your terminal:
 
 <!-- termynal -->
+
 ```shell
 > uipath init
 ⠋ Initializing UiPath project ...
@@ -147,6 +162,7 @@ The `uipath init` command executes your `main.py` file to analyze its structure
 This command creates a `uipath.json` file containing the project metadata.
 
 <!-- termynal -->
+
 ```shell
 # Debug your project
 > uipath run main.py '{"message": "test"}'
@@ -164,6 +180,7 @@ authors = [{ name = "Your Name", email = "your.email@uipath.com" }]
 Then, package your project:
 
 <!-- termynal -->
+
 ```shell
 > uipath pack
 ⠋ Packaging project ...
@@ -177,6 +194,7 @@ Authors    : Your Name
 Finally, publish your package:
 
 <!-- termynal -->
+
 ```shell
 > uipath publish
 ⠋ Fetching available package feeds...
@@ -216,6 +234,7 @@ def main():
 ### Verifying the Execution
 
 <!-- termynal -->
+
 ```shell
 > uipath run main.py
 ```
@@ -224,4 +243,4 @@ Open your browser and navigate to UiPath. Go to the specified folder, where you'
 
 ```
 [Echo]: Hello, World! Echo: Hello, World! Echo: Hello, World!
-```
+```

uipath-2.0.34/docs/release_policy.md

@@ -0,0 +1,124 @@
+# Release Policy
+
+The UiPath Python ecosystem is composed of different component packages:
+
+- `uipath`: The core SDK package (version >= 2.0.0)
+- `uipath-langchain`: The LangChain integration package (version >= 0.0.0)
+
+Both packages are under rapid development, following semantic versioning in the format of **X.Y.Z**:
+
+- **X** (major version):
+    - `uipath`: X = 2
+    - `uipath-langchain`: X = 0
+- **Y** (minor version) increases indicate breaking changes for public interfaces not marked as beta
+- **Z** (patch version) increases indicate:
+    - Bug fixes
+    - New features
+    - Changes to private interfaces
+    - Changes to beta features
+
+### Version Number Format
+
+The version format is `X.Y.Z` where:
+
+- For `uipath`: X = 2 (e.g., 2.0.0, 2.1.0)
+- For `uipath-langchain`: X = 0 (e.g., 0.0.0, 0.1.0)
+- Y represents the minor version
+- Z represents the patch version
+
+### Release Candidates
+
+From time to time, we will version packages as release candidates. These are versions that are intended to be released as stable versions, but we want to get feedback from the community before doing so.
+
+Release candidates are versioned as `X.Y.ZrcN`. For example:
+
+- `uipath`: `2.2.0rc1`
+- `uipath-langchain`: `0.1.0rc1`
+
+If no issues are found, the release candidate will be released as a stable version with the same version number. If issues are found, we will release a new release candidate with an incremented N value (e.g., `2.2.0rc2` or `0.1.0rc2`).
+
+When upgrading between minor versions, users should review the list of breaking changes and deprecations.
+
+## Release Cadence
+
+### Minor Releases (X.Y.0)
+
+- Released as needed based on feature development and breaking changes
+- Include breaking changes for public interfaces not marked as beta
+- Require a migration guide for users
+- Preceded by a release candidate (RC) phase
+
+### Patch Releases (X.Y.Z)
+
+- Released as needed based on bug fixes and improvements
+- Include bug fixes, new features, and changes to private interfaces
+- Always maintain backward compatibility for public interfaces
+
+## API Stability
+
+### Public API
+The following components are considered part of the public API:
+
+- All classes and methods in the `src/uipath` directory
+- CLI commands and their interfaces
+
+### Internal API
+Components marked as internal include:
+
+- Methods and classes prefixed with `_`
+- Test utilities and fixtures
+- Build and development tools
+
+## Breaking Changes
+
+Breaking changes are introduced in minor releases (X.Y.0) and follow these guidelines:
+
+1. **Deprecation Period**: Features marked for removal will be deprecated for at least one minor release cycle
+2. **Migration Path**: Breaking changes must provide a clear migration path
+3. **Documentation**: All breaking changes must be documented in the release notes and migration guide
+4. **Beta Features**: Breaking changes to beta features can occur in patch releases
+
+## Deprecation Policy
+
+1. **Announcement**: Features to be deprecated will be announced in release notes
+2. **Warning Period**: Deprecated features will trigger warnings when used
+3. **Removal**: Deprecated features will be removed in the next major release
+
+## Release Process
+
+1. **Development**:
+    - Features and fixes are developed in feature branches
+    - All changes require tests and documentation
+    - Code must pass all CI checks
+
+2. **Release Candidate**:
+    - Minor releases include an RC phase
+    - RCs are versioned as `X.Y.ZrcN`
+    - Community feedback is collected during RC phase
+
+3. **Release**:
+    - Version number is updated in `pyproject.toml`
+    - Release notes are prepared
+    - Package is published to PyPI
+    - Documentation is updated
+
+## Support Policy
+
+- Current major version: Full support
+- Previous major version: Security fixes only
+- Older versions: No official support
+
+## Dependencies
+
+The SDK maintains compatibility with:
+
+- Python 3.10+
+- Key dependencies as specified in `pyproject.toml`
+- Regular updates to dependencies are performed in minor releases
+
+## Documentation
+
+- All public APIs must be documented
+- Documentation follows Google-style docstrings
+- Examples and usage guides are provided for new features
+- Breaking changes are clearly documented in migration guides

{uipath-2.0.32 → uipath-2.0.34}/docs/stylesheets/extra.css

@@ -10,12 +10,17 @@
 :root {
     --md-primary-bg-color: #ffffff;
     --md-primary-fg-color: #182027;
-    --md-typeset-a-color: #0067df;
+    --md-typeset-a-color: #66adff;
 }
 
 
-[data-md-color-scheme=slate] {
+[data-md-color-scheme=default]
+ {
     --md-typeset-a-color: #0067df;
+}
+
+[data-md-color-scheme=slate] {
+    --md-typeset-a-color: #66adff;
 
     .md-header {
         background-color: #182027;
@@ -27,7 +32,6 @@ body[data-md-color-scheme=slate] {
     background-color: #182027 !important;
 }
 
-
 .md-header {
     --md-primary-bg-color: #182027;
     --md-primary-fg-color: #ffffff;
@@ -43,7 +47,7 @@ body[data-md-color-scheme=slate] {
 
         &:hover {
             background-color: #ffffff;
-            border-color: #0067df;
+            border-color: #66adff;
         }
     }
 
@@ -55,7 +59,7 @@ body[data-md-color-scheme=slate] {
 
             &:hover {
                 background-color: #182027;
-                border-color: #0067df;
+                border-color: #66adff;
             }
         }
 

{uipath-2.0.32 → uipath-2.0.34}/mkdocs.yml

@@ -43,6 +43,7 @@ theme:
     - search.suggest
     - toc.follow
   logo: assets/uipath-logo.svg
+  favicon: assets/favicon.png
 
 nav:
   - UiPath Langchain SDK:
@@ -63,6 +64,7 @@ nav:
         - Queues: core/queues.md
         - Processes: core/processes.md
   - How To Contribute: CONTRIBUTING.md
+  - Release Policy: release_policy.md
 
 plugins:
   - search
@@ -74,7 +76,7 @@ plugins:
       prompt_literal_start:
         - "$"
         - ">"
-
+  - social
 markdown_extensions:
   - attr_list
   - md_in_html
@@ -102,5 +104,8 @@ markdown_extensions:
   - pymdownx.inlinehilite
   - pymdownx.magiclink
   - pymdownx.snippets
+  - pymdownx.fancylists
   - pymdownx.tabbed:
       alternate_style: true
+  - toc:
+      title: On this page

{uipath-2.0.32 → uipath-2.0.34}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "uipath"
-version = "2.0.32"
+version = "2.0.34"
 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"
@@ -53,7 +53,7 @@ dev = [
   "pytest-mock>=3.11.1",
   "pre-commit>=4.1.0",
   "mkdocs>=1.6.1",
-  "mkdocs-material>=9.6.7",
+  "mkdocs-material[imaging]>=9.6.7",
   "mkdocstrings>=0.29.0",
   "mkdocstrings-python>=1.16.5",
   "termynal>=0.13.0",

{uipath-2.0.32 → uipath-2.0.34}/src/uipath/_cli/_runtime/_contracts.py

@@ -412,7 +412,7 @@ class UiPathBaseRuntime(ABC):
             raise
         finally:
             # Restore original logging
-            if self.context.job_id and self.logs_interceptor:
+            if self.logs_interceptor:
                 self.logs_interceptor.teardown()
 
             await self.cleanup()

{uipath-2.0.32 → uipath-2.0.34}/src/uipath/_cli/_runtime/_logging.py

@@ -51,8 +51,9 @@ class LogsInterceptor:
         self.original_level = self.root_logger.level
         self.original_handlers = list(self.root_logger.handlers)
 
-        self.original_stdout: Optional[TextIO] = None
-        self.original_stderr: Optional[TextIO] = None
+        # Store system stdout/stderr
+        self.original_stdout = cast(TextIO, sys.stdout)
+        self.original_stderr = cast(TextIO, sys.stderr)
 
         self.log_handler: Union[PersistentLogsHandler, logging.StreamHandler[TextIO]]
 
@@ -74,10 +75,6 @@ class LogsInterceptor:
         self.logger = logging.getLogger("runtime")
         self.patched_loggers: set[str] = set()
 
-        # Store system stdout/stderr
-        self.sys_stdout = cast(TextIO, sys.__stdout__)
-        self.sys_stderr = cast(TextIO, sys.__stderr__)
-
     def _clean_all_handlers(self, logger: logging.Logger) -> None:
         """Remove ALL handlers from a logger except ours."""
         handlers_to_remove = list(logger.handlers)
@@ -111,8 +108,6 @@ class LogsInterceptor:
 
     def _redirect_stdout_stderr(self) -> None:
         """Redirect stdout and stderr to the logging system."""
-        self.original_stdout = sys.stdout
-        self.original_stderr = sys.stderr
 
         class LoggerWriter:
             def __init__(
@@ -129,15 +124,32 @@ class LogsInterceptor:
                 self.sys_file = sys_file  # Store reference to system stdout/stderr
 
             def write(self, message: str) -> None:
-                if message and message.strip() and self.level >= self.min_level:
-                    self.logger.log(self.level, message.rstrip())
+                self.buffer += message
+                while "\n" in self.buffer:
+                    line, self.buffer = self.buffer.split("\n", 1)
+                    # Only log if the message is not empty and the level is sufficient
+                    if line and self.level >= self.min_level:
+                        # Use _log to avoid potential recursive logging if logging methods are overridden
+                        self.logger._log(self.level, line, ())
 
             def flush(self) -> None:
-                pass
+                # Log any remaining content in the buffer on flush
+                if self.buffer and self.level >= self.min_level:
+                    self.logger._log(self.level, self.buffer, ())
+                self.buffer = ""
 
             def fileno(self) -> int:
                 # Return the file descriptor of the original system stdout/stderr
-                return self.sys_file.fileno()
+                try:
+                    return self.sys_file.fileno()
+                except Exception:
+                    return -1
+
+            def isatty(self) -> bool:
+                return hasattr(self.sys_file, "isatty") and self.sys_file.isatty()
+
+            def writable(self) -> bool:
+                return True
 
         # Set up stdout and stderr loggers with propagate=False
         stdout_logger = logging.getLogger("stdout")
@@ -150,10 +162,10 @@ class LogsInterceptor:
 
         # Use the min_level in the LoggerWriter to filter messages
         sys.stdout = LoggerWriter(
-            stdout_logger, logging.INFO, self.numeric_min_level, self.sys_stdout
+            stdout_logger, logging.INFO, self.numeric_min_level, self.original_stdout
         )
         sys.stderr = LoggerWriter(
-            stderr_logger, logging.ERROR, self.numeric_min_level, self.sys_stderr
+            stderr_logger, logging.ERROR, self.numeric_min_level, self.original_stderr
         )
 
     def teardown(self) -> None:
@@ -174,12 +186,12 @@ class LogsInterceptor:
             if handler not in self.root_logger.handlers:
                 self.root_logger.addHandler(handler)
 
+        self.log_handler.close()
+
         if self.original_stdout and self.original_stderr:
             sys.stdout = self.original_stdout
             sys.stderr = self.original_stderr
 
-        self.log_handler.close()
-
     def __enter__(self):
         self.setup()
         return self

{uipath-2.0.32 → uipath-2.0.34}/src/uipath/_cli/cli_new.py

@@ -68,9 +68,8 @@ def new(name: str):
         ctx = click.get_current_context()
         init_cmd = ctx.parent.command.get_command(ctx, "init")
         ctx.invoke(init_cmd)
-        console.hint(
-            """Run project: uipath run main.py '{"message": "Hello World!"}'"""
-        )
+        run_command = """uipath run main.py '{"message": "Hello World!"}'"""
+        console.hint(f"""Run project: {click.style(run_command, fg="cyan")}""")
 
 
 if __name__ == "__main__":

{uipath-2.0.32 → uipath-2.0.34}/src/uipath/_cli/cli_run.py

@@ -1,6 +1,5 @@
 # type: ignore
 import asyncio
-import logging
 import os
 import traceback
 from os import environ as env
@@ -16,9 +15,10 @@ from ._runtime._contracts import (
     UiPathTraceContext,
 )
 from ._runtime._runtime import UiPathRuntime
+from ._utils._console import ConsoleLogger
 from .middlewares import MiddlewareResult, Middlewares
 
-logger = logging.getLogger(__name__)
+console = ConsoleLogger()
 load_dotenv()
 
 
@@ -39,14 +39,14 @@ def python_run_middleware(
         return MiddlewareResult(
             should_continue=False,
             info_message="""Error: No entrypoint specified. Please provide a path to a Python script.
-Usage: `uipath run <entrypoint_path> <input_arguments>`""",
+Usage: `uipath run <entrypoint_path> <input_arguments> [-f <input_json_file_path>]`""",
         )
 
     if not os.path.exists(entrypoint):
         return MiddlewareResult(
             should_continue=False,
             error_message=f"""Error: Script not found at path {entrypoint}.
-Usage: `uipath run <entrypoint_path> <input_arguments>`""",
+Usage: `uipath run <entrypoint_path> <input_arguments> [-f <input_json_file_path>]`""",
         )
 
     try:
@@ -74,7 +74,6 @@ Usage: `uipath run <entrypoint_path> <input_arguments>`""",
                 reference_id=env.get("UIPATH_JOB_KEY") or str(uuid4()),
             )
             context.logs_min_level = env.get("LOG_LEVEL", "INFO")
-
             async with UiPathRuntime.from_context(context) as runtime:
                 await runtime.execute()
 
@@ -91,7 +90,6 @@ Usage: `uipath run <entrypoint_path> <input_arguments>`""",
         )
     except Exception as e:
         # Handle unexpected errors
-        logger.exception("Unexpected error in Python runtime middleware")
         return MiddlewareResult(
             should_continue=False,
             error_message=f"Error: Unexpected error occurred - {str(e)}",
@@ -103,8 +101,23 @@ Usage: `uipath run <entrypoint_path> <input_arguments>`""",
 @click.argument("entrypoint", required=False)
 @click.argument("input", required=False, default="{}")
 @click.option("--resume", is_flag=True, help="Resume execution from a previous state")
-def run(entrypoint: Optional[str], input: Optional[str], resume: bool) -> None:
+@click.option(
+    "-f",
+    "--file",
+    required=False,
+    type=click.Path(exists=True),
+    help="File path for the .json input",
+)
+def run(
+    entrypoint: Optional[str], input: Optional[str], resume: bool, file: Optional[str]
+) -> None:
     """Execute the project."""
+    if file:
+        _, file_extension = os.path.splitext(file)
+        if file_extension != ".json":
+            console.error("Input file extension must be '.json'.")
+        with open(file) as f:
+            input = f.read()
     # Process through middleware chain
     result = Middlewares.next("run", entrypoint, input, resume)
 
@@ -115,18 +128,22 @@ def run(entrypoint: Optional[str], input: Optional[str], resume: bool) -> None:
 
     # Handle result from middleware
     if result.error_message:
-        click.echo(result.error_message, err=True)
+        console.error(result.error_message, include_traceback=True)
         if result.should_include_stacktrace:
-            click.echo(traceback.format_exc(), err=True)
+            console.error(traceback.format_exc())
         click.get_current_context().exit(1)
 
     if result.info_message:
-        click.echo(result.info_message)
+        console.info(result.info_message)
 
     # If middleware chain completed but didn't handle the request
     if result.should_continue:
-        click.echo("Error: Could not process the request with any available handler.")
-        click.get_current_context().exit(1)
+        console.error(
+            "Error: Could not process the request with any available handler."
+        )
+
+    if not result.should_continue and not result.error_message:
+        console.success("Successful execution.")
 
 
 if __name__ == "__main__":