Skip to main content
Help us improve Python packaging – donate today!

Webserver for robot framework assets

Project Description

# Welcome to Robot Framework Hub

This is a very early version of a server for the robot framework
testing framework. The hub uses flask to provide both a RESTful
interface and a browser-based UI for accessing test assets.

The hub currently provides the following services:

* RESTful API for retrieving the documentation for all available
keywords
* Website for viewing the documentation for all keywords
available on the system

The hub will eventually provide the following services:

* Web-based front-end to the robot test runner (pybot)
* Web-based dashboard for coordinating testing efforts
* Website for browsing test cases
* Website for browsing test results
* RESTful API for all of the above
* Plug-in architecture

## How to install and run the hub

### Download

Eventually the hub will be pip-installable, but in this early release
you will need to download the source from this repository then install
it with setup.py:

```
$ cd /path/to/repository
$ python ./setup.py install
```

It is recommended that you use a virtualenv, though strictly speaking
it's not necessary.

### Dependencies

The hub is dependent on the following packages:

- robotframework
- flask
- watchdog
- sqlite3

### Start the server

To start the server, run the hub module:

```
$ python -m rfhub
```

By default the hub will run on port 7070, but that can be changed with
the --port option.

The hub will serve up all built-in and installed robotframework
libraries that it can find. To include your own keyword libraries and
resource files, include a path to them on the command line.

For example, if you have resource files in /myapp/keywords, include
that on the command line:

```
$ python -m robotframework-hub /myapp/keywords
```

## Accessing the data

Presently, three uris are supported:

- /api - fetch JSON-formatted keyword data
- /doc - UI for viewing keyword documentation
- /dashboard - a fairly useless (for now!) dashboard

### Read keyword documentation

Keyword documentation is available with URls like the following:

- http://localhost:7070/doc/keywords/
- http://localhost:7070/doc/keywords/BuiltIn/
- http://localhost:7070/doc/keywords/BuiltIn/Evaluate
- http://localhost:7070/doc/keywords?patter=Should

### Get JSON data for keywords

JSON data is available on all of the keywords and libraries via
the "/api" url. For example:

- http://localhost:7070/api/keywords/
- http://localhost:7070/api/keywords/BuiltIn
- http://localhost:7070/api/keywords/BuiltIn/Evaluate
- http://localhost:7070/api/keywords?pattern=Should*


## Acknowledgements

A huge thank-you to Echo Global Logistics (echo.com) for supporting
the development of this package.

Release history Release notifications

History Node

0.9

History Node

0.8.3

History Node

0.8.2

History Node

0.7

History Node

0.6

History Node

0.5

History Node

0.4

History Node

0.3

This version
History Node

0.2

History Node

0.1

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
robotframework-hub-0.2.tar.gz (1.5 MB) Copy SHA256 hash SHA256 Source None Jun 16, 2014

Supported by

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