Skip to content

Commit ebefefd

Browse files
Merge pull request #264 from UiPath/chore/update-docs-and-langchain
Chore/update docs and langchain
2 parents 418efd2 + f30502b commit ebefefd

File tree

6 files changed

+301
-89
lines changed

6 files changed

+301
-89
lines changed

CONTRIBUTING.md

Lines changed: 41 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -4,19 +4,17 @@
44

55
### Prerequisites
66

7-
1. **Install Python 3.13**:
8-
- Download and install Python 3.13 from the official [Python website](https://www.python.org/downloads/)
7+
1. **Install Python ≥ 3.10**:
8+
- Download and install Python 3.10 from the official [Python website](https://www.python.org/downloads/)
99
- Verify the installation by running:
1010
```sh
11-
python3.13 --version
11+
python3.10 --version
1212
```
1313

1414
Alternative: [mise](https://mise.jdx.dev/lang/python.html)
1515

1616
2. **Install [uv](https://docs.astral.sh/uv/)**:
17-
```sh
18-
pip install uv
19-
```
17+
Follow the official installation instructions for your operating system.
2018

2119
3. **Create a virtual environment in the current working directory**:
2220
```sh
@@ -25,45 +23,61 @@
2523

2624
4. **Install dependencies**:
2725
```sh
28-
uv sync --all-extras
26+
uv sync --all-extras --no-cache
27+
```
28+
29+
For additional commands related to linting, formatting, and building, run `just --list`.
30+
31+
### Using the SDK Locally
32+
33+
1. Create a project directory:
34+
```sh
35+
mkdir project
36+
cd project
2937
```
3038

31-
See `just --list` for linting, formatting and build commands.
39+
2. Initialize the Python project:
40+
```sh
41+
uv init . --python 3.10
42+
```
3243

44+
3. Set the SDK path:
45+
```sh
46+
PATH_TO_SDK=/Users/YOUR_USERNAME/uipath-python
47+
```
3348

34-
### Use SDK Locally
35-
1. Create a folder on your own device `mkdir project; cd project`
36-
2. Initialize the python project `uv` `uv init . --python 3.9`
37-
3. Obtain the project path `PATH_TO_SDK=/Users/YOU_USER/uipath-python`
38-
4. Install the sdk in editable mode `uv add --editable ${PATH_TO_SDK}`
49+
4. Install the SDK in editable mode:
50+
```sh
51+
uv add --editable ${PATH_TO_SDK}
52+
```
3953

40-
:information_source: Instead of cloning the project into `.venv/lib/python3.9/site-packages/uipath`, this mode creates a file named `_uipath.pth` inside `.venv/lib/python3.9/site-packages`. This file contains the value of `PATH_TO_SDK`, which is added to `sys.path`—the list of directories where python searches for packages. (Run `python -c 'import sys; print(sys.path)'` to see the entries.)
54+
> **Note:** Instead of cloning the project into `.venv/lib/python3.10/site-packages/uipath`, this mode creates a file named `_uipath.pth` inside `.venv/lib/python3.10/site-packages`. This file contains the value of `PATH_TO_SDK`, which is added to `sys.path`—the list of directories where Python searches for packages. To view the entries, run `python -c 'import sys; print(sys.path)'`.
4155

4256
## API Style Guide
4357

44-
### General Rule:
45-
- use key instead of ID
58+
### General Rule
59+
- Use `key` instead of `id` for resource identifiers
4660

47-
### Standard Methods & Naming Conventions
61+
### Standard Methods and Naming Conventions
4862

4963
#### Retrieve a Single Resource
50-
- **Method Name:** `retrieve` instead of get
51-
- **Usage:** To obtain a specific resource instance using its unique identifier (using *key* instead of ID).
52-
- **Extended:**
53-
- `retrieve_by_[field_name]` (for fields other than key)
64+
- **Method Name:** `retrieve`
65+
- **Purpose:** Obtain a specific resource instance using its unique identifier (using `key` instead of `id`)
66+
- **Variations:**
67+
- `retrieve_by_[field_name]` (for fields other than `key`)
5468

5569
#### List Multiple Resources
5670
- **Method Name:** `list`
57-
- **Usage:** To fetch a collection of resources, optionally filtered by query parameters.
71+
- **Purpose:** Fetch a collection of resources, optionally filtered by query parameters
5872
- **Example:**
59-
```python
60-
resources = Resource.list(filters={})
61-
```
73+
```python
74+
resources = Resource.list(filters={})
75+
```
6276

6377
#### Create a Resource
6478
- **Method Name:** `create`
65-
- **Usage:** To add a new resource to the system.
79+
- **Purpose:** Add a new resource to the system
6680

6781
#### Update a Resource
6882
- **Method Name:** `update`
69-
- **Usage:** To modify an existing resource.
83+
- **Purpose:** Modify an existing resource

README.md

Lines changed: 46 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -4,29 +4,29 @@
44
[![PyPI - Version](https://img.shields.io/pypi/v/uipath)](https://img.shields.io/pypi/v/uipath)
55
[![Python versions](https://img.shields.io/pypi/pyversions/uipath.svg)](https://pypi.org/project/uipath/)
66

7-
87
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.
98

10-
Use the [UiPath LangChain SDK](https://github.com/UiPath/uipath-langchain-python) to pack and publish LangGraph Agents.
9+
Use the [UiPath LangChain SDK](https://github.com/UiPath/uipath-langchain-python) to pack and publish LangGraph Agents.
10+
1111
## Table of Contents
1212

13-
- [Installation](#installation)
14-
- [Configuration](#configuration)
15-
- [Environment Variables](#environment-variables)
16-
- [Basic Usage](#basic-usage)
17-
- [Available Services](#available-services)
18-
- [Examples](#examples)
19-
- [Buckets Service](#buckets-service)
20-
- [Context Grounding Service](#context-grounding-service)
21-
- [Command Line Interface (CLI)](#command-line-interface-cli)
22-
- [Authentication](#authentication)
23-
- [Initialize a Project](#initialize-a-project)
24-
- [Debug a Project](#debug-a-project)
25-
- [Package a Project](#package-a-project)
26-
- [Publish a Package](#publish-a-package)
27-
- [Project Structure](#project-structure)
28-
- [Development](#development)
29-
- [Setting Up a Development Environment](#setting-up-a-development-environment)
13+
- [Installation](#installation)
14+
- [Configuration](#configuration)
15+
- [Environment Variables](#environment-variables)
16+
- [Basic Usage](#basic-usage)
17+
- [Available Services](#available-services)
18+
- [Examples](#examples)
19+
- [Buckets Service](#buckets-service)
20+
- [Context Grounding Service](#context-grounding-service)
21+
- [Command Line Interface (CLI)](#command-line-interface-cli)
22+
- [Authentication](#authentication)
23+
- [Initialize a Project](#initialize-a-project)
24+
- [Debug a Project](#debug-a-project)
25+
- [Package a Project](#package-a-project)
26+
- [Publish a Package](#publish-a-package)
27+
- [Project Structure](#project-structure)
28+
- [Development](#development)
29+
- [Setting Up a Development Environment](#setting-up-a-development-environment)
3030

3131
## Installation
3232

@@ -69,15 +69,24 @@ asset = sdk.assets.retrieve(name="MyAsset")
6969
## Available Services
7070

7171
The SDK provides access to various UiPath services:
72-
- `sdk.processes` - Manage and execute UiPath automation processes
73-
- `sdk.assets` - Work with assets (variables, credentials) stored in UiPath
74-
- `sdk.buckets` - Manage cloud storage containers for automation files
75-
- `sdk.connections` - Handle connections to external systems
76-
- `sdk.context_grounding` - Work with semantic contexts for AI-enabled automation
77-
- `sdk.jobs` - Monitor and manage automation jobs
78-
- `sdk.queues` - Work with transaction queues
79-
- `sdk.actions` - Work with Action Center
80-
- `sdk.api_client` - Direct access to the API client for custom requests
72+
73+
- `sdk.processes` - Manage and execute UiPath automation processes
74+
75+
- `sdk.assets` - Work with assets (variables, credentials) stored in UiPath
76+
77+
- `sdk.buckets` - Manage cloud storage containers for automation files
78+
79+
- `sdk.connections` - Handle connections to external systems
80+
81+
- `sdk.context_grounding` - Work with semantic contexts for AI-enabled automation
82+
83+
- `sdk.jobs` - Monitor and manage automation jobs
84+
85+
- `sdk.queues` - Work with transaction queues
86+
87+
- `sdk.actions` - Work with Action Center
88+
89+
- `sdk.api_client` - Direct access to the API client for custom requests
8190

8291
## Examples
8392

@@ -140,10 +149,12 @@ uipath pack
140149
Packages your project into a `.nupkg` file that can be deployed to UiPath.
141150

142151
**Note:** Your `pyproject.toml` must include:
143-
- A description field (avoid characters: &, <, >, ", ', ;)
144-
- Author information
152+
153+
- A description field (avoid characters: &, <, >, ", ', ;)
154+
- Author information
145155

146156
Example:
157+
147158
```toml
148159
description = "Your package description"
149160
authors = [{name = "Your Name", email = "your.email@example.com"}]
@@ -160,12 +171,13 @@ Publishes the most recently created package to your UiPath Orchestrator.
160171
## Project Structure
161172

162173
To properly use the CLI for packaging and publishing, your project should include:
163-
- A `pyproject.toml` file with project metadata
164-
- A `uipath.json` file (generated by `uipath init`)
165-
- Any Python files needed for your automation
174+
175+
- A `pyproject.toml` file with project metadata
176+
- A `uipath.json` file (generated by `uipath init`)
177+
- Any Python files needed for your automation
166178

167179
## Development
168180

169181
### Setting Up a Development Environment
170182

171-
Please read our [contribution guidelines](CONTRIBUTING.md) before submitting a pull request.
183+
Please read [CONTRIBUTING.md](https://uipath.github.io/uipath-python/how_to_contribute/) before submitting a pull request.

0 commit comments

Comments
 (0)