Skip to main content

rallf.com Software Development Kit (SDK)

Project description

RALF Python SDK

Website GitHub license GitHub issues PyPI Python Versions Requirements Status

RALLF SDK provides the tools to create tasks for rallf robots (rallf.com) using python3.

Disclaimer! This package is in development stage (unstable), it may be potentially buggy

Installation

Using Python Package Index (PyPI)

pip3 install rallf

From source

git clone https://github.com/RobotUnion/rallf-python-sdk
cd rallf-python-sdk
pip3 install -r requirements.txt
python3 setup.py install

Getting started (hello bot-task)

In order to get started with robot task development, just run python3 -m rallf.cli create-project "hello" and it will create a basic project with the files explained below.

hello.py

# File: hello.py

from rallf import Task

'''
  Hello task opens github and returns the title of the page upon it is loaded.
  To learn more about python selenium api, see https://selenium-python.readthedocs.io/
'''
class Hello(Task):

    # implementing self.run is required for tasks, not for skills
    def run(self, input):
        # Log stuff via the available logger
        self.logger.debug('Hello Bot')

        # get a firefox instance
        browser = self.robot.devices['firefox']
        browser.get('https://github.com')
        return browser.getTitle()

Try it (rallf cli)

To use the cli you can use either the binary included in the package

rallf <args>

or executing directly from python

python3 -m rallf.cli <args>

Run run method using the CLI

rallf run . -f run

Run run method using the jsonrpc api

echo '{"jsonrpc": "2.0", "id": 1, "method": "delegate_local", "params": {"routine": "run", "args": {}}}' | rallf run .

Get help

rallf -h

Extended usage

Task Manifest

Task manifest is mandatory for rallf.com tasks, but not necessary for developing, visit manifest reference to learn more in-deep about task manifests.

/* File manifest.json */
{
  "title": "Hello Task",
  "description": "This tasks logs hello and returns the <title> of github.com",
  "long-description": "@README.md",
  "fqtn": "com.example.hello",
  "type": "task", /* choices: task, skill */
  "main": "hello.Hello",
  "exports": ["run"], /* default: ["run"] */
  "devices": ["firefox"],
  "skills": [],
  "permissions": {
    "uris": ["https://github.com", "https://google.com"],
    "devices": ["firefox", "chrome"],
    "skills": {
      "com.example.facebook": ["likePage", "likePost"],
      "com.example.gmail": ["search", "likePost"]
    },
  }
}

Injected objects

  • self.robot this object is injected in the task creation
  • input this parameter is passed to the run(self, input) function

Inter Task Communication (ITC)

  • Call other tasks from the market (rallf.com)
  • Use robot skills

Task lifecycle callbacks

  • warmup(self) this optional method is executed some time before the task starts to speed-up the rest of calls.
  • run(self, input) this required method handles the work of the task and is triggered at start of the task.
  • cooldown(self) this optional method is called when the task is going to be some time without use.

Task vs Skill

A common question is the difference between Task and Skill inside the RALLF ecosystem, the main difference is that Tasks only have one method called run and the skill can have many, so technically a Task is a subtype of Skill, and also a Skill can implement the run method and can be used as Task too.

Project details


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
rallf-0.1.31-py3-none-any.whl (18.6 kB) Copy SHA256 hash SHA256 Wheel py3
rallf-0.1.31.tar.gz (13.7 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page