Skip to main content

Thoughtful is a python package by Thoughtful for helping manage automations with helpful packages like supervisor

Project description

thoughtful is a collection of open-source libraries and tools for Robot Process Automation (RPA) development. The goal of this project is to provide a set of for supervising bot execution, and enabling these bots to do more.

PyPi version Main Branch Tests Supported Versions Downloads

This project is:

Links:

thoughtful is available on PyPI and can be installed using pip:

pip install thoughtful

thoughtful officially supports Python 3.7+.


Libraries

Supervisor

Supervisor is a Workflow Engine for Digital Workers that constructs and broadcasts a detailed and structured telemetric log, called the Run Report.

Documentation on how to

from thoughtful.supervisor import step, step_scope, supervise, set_step_status


# using the step decorator
@step("2")
def step_2(name: str) -> bool:
    print(f'Hello {name}')
    return True  # some condition

def main() -> None:
    # using the step_scope context manager
    with step_scope('1') as step_context:
        try:
            print("Getting credentials")
            # ...
        except Exception as e:
            # set step status using method
            step_context.set_status("warning")

    if not step_2():
        # set step status using function
        set_step_status("2", "fail")

if __name__ == '__main__':
    with supervise():
        main()

Screen Recorder

The ScreenRecorder library facilitates the recording of screen activity from a programmatic browser session and generates a video file of the recorded session.

Prerequisites

Ensure you have already downloaded FFmpeg as it is utilized to create the video recording.

https://www.ffmpeg.org/download.html

Installation

Install the optional screen-recorder extras

Poetry

poetry install -E screen-recorder

Pip

pip install thoughtful[screen-recorder]

Usage

WARNING: It is essential that you call end_recording at the end of a recording.

If you do not call end_recording, the recording threads will continue to run until your program ends and a video will not be created.

from thoughtful.screen_recorder import ScreenRecorder, BrowserManager
from RPA.Browser.Selenium import Selenium # This dependency must be installed separately

class YoutubeScraper(ScreenRecorder):
    def __init__(self) -> None:
        self._selenium_instance = Selenium()
        super().__init__(browser_manager=BrowserManager(instance=self._selenium_instance))

youtube_scraper = YoutubeScraper()
try:
    # ... Perform actions here ...
finally:
    if youtube_scraper:
        # We recommend calling `end_recording` in a `finally` block to ensure that
        # video processing occurs and all recording threads are terminated even if the Process fails
        youtube_scraper.end_recording()

Contributing

Contributions to thoughtful are welcome!

To get started, see the contributing guide.


Made with ❤️ by

Thoughtful


This project is open-source and licensed under the terms of the Apache License 2.0.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

thoughtful_temp_test_package-2.8.0.1.tar.gz (37.8 kB view details)

Uploaded Source

Built Distribution

File details

Details for the file thoughtful_temp_test_package-2.8.0.1.tar.gz.

File metadata

File hashes

Hashes for thoughtful_temp_test_package-2.8.0.1.tar.gz
Algorithm Hash digest
SHA256 eda15f5c431ae4e816c764f2f4de3bc1f16fdb767fbed4c75ef618c772e835c8
MD5 2a538f2a91710253429a03070e53afbb
BLAKE2b-256 455ecc3d08cb8913ff60197b677304828e49cf7617ab2be66338e2b3fdfa0a1c

See more details on using hashes here.

File details

Details for the file thoughtful_temp_test_package-2.8.0.1-py3-none-any.whl.

File metadata

File hashes

Hashes for thoughtful_temp_test_package-2.8.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 ba463e8cadb6764f4bcb45049084cbb39129a0f8fe305a851703fd26cd35ffca
MD5 811dd5661bb2553ac2f3bbfa254b190e
BLAKE2b-256 0687f70a5a6bde6f3b8376483d15e32c5cbbac46dd0d03a0baf7181cb45ebe32

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page