CW RPA Library

1.2.2 · active · verified Sun Apr 12

The `cw-rpa` package is a Python library providing reusable functions and common utilities specifically designed for developing Robotic Process Automation (RPA) bots. It offers modules for handling user inputs, logging, and interacting with web services. The current version is 1.2.2, released on October 12, 2025, and appears to have a regular release cadence based on the PyPI history.

Warnings

gotcha RPA bots, including those built with `cw-rpa`, can be brittle and prone to breaking when target application user interfaces (UIs) change. Traditional RPA often relies on screen scraping or specific element locators, which can become invalid with UI updates. This requires frequent maintenance and adaptation of bot scripts.
Fix: Prioritize robust element selectors (e.g., by ID, unique attributes rather than XPath/CSS that are highly dependent on structure) if possible. Implement comprehensive error handling and regular monitoring of bots in production. Design bots to be modular and easily adaptable to UI changes, isolating parts that interact with potentially unstable UI elements.
gotcha When using the `HttpClient` module, ensure proper handling of authentication tokens and validation of request payloads. Mistakes in managing tokens or providing incorrect payload structures can lead to failed API calls and security vulnerabilities.
Fix: Leverage the `HttpClient`'s mechanisms for managing authentication tokens. Utilize `http_client.validate_payload()` to ensure request bodies contain all necessary fields before sending. Implement secure storage and retrieval practices for sensitive credentials.
breaking While not specifically documented for `cw-rpa`, other related RPA frameworks (like `rpaframework`) have experienced breaking changes where general keywords for 'Set Asset' and 'Get Asset' were replaced by more specific ones (e.g., `Set Text Asset`, `Get Text Asset`). Developers should be aware that similar shifts in API design might occur in the broader RPA ecosystem, potentially affecting how assets or work item data are handled.
Fix: Refer to official release notes and documentation with each major version upgrade. Adopt a modular approach to bot development, isolating data handling logic to simplify future migrations or adaptations to API changes.

Install

pip install cw-rpa Install latest version

Imports

Input
```
from cw_rpa import Input
```
Logger
```
from cw_rpa import Logger
```
HttpClient
```
from cw_rpa import HttpClient
```
The module is imported as `httpclient` (lowercase) but the class is `HttpClient` (camel case). Ensure you import the class directly for proper instantiation.

Quickstart

This quickstart demonstrates the usage of the `Input`, `Logger`, and `HttpClient` modules. It shows how to retrieve an input value (simulated via an environment variable), log informational and error messages, and make a simple HTTP GET request using the `HttpClient` for web service interaction.

from cw_rpa import Input, Logger, HttpClient
import os

# Initialize modules
input_handler = Input()
logger = Logger()
http_client = HttpClient()

# Example: Get an input value (simulating environment variable or form data)
username = os.environ.get('RPA_USERNAME', 'default_user')
logger.info(f"Retrieved username: {username}")

# Example: Send an HTTP GET request (replace with a real endpoint)
try:
    # Using a placeholder URL for demonstration
    test_url = "https://jsonplaceholder.typicode.com/posts/1"
    response = http_client.third_party_integration("example_integration").get(url=test_url)
    logger.info(f"HTTP GET Response Status: {response.status_code}")
    logger.info(f"HTTP GET Response Body: {response.json()}")
except Exception as e:
    logger.error(f"Error during HTTP request: {e}")

# Example: Log an error message
logger.error("This is an example error log.")

# Example: Log an exception (simulated)
try:
    1 / 0
except ZeroDivisionError as e:
    logger.exception(f"Caught an exception: {e}")

view raw JSON →