Skip to main content

Webserver for robot framework and python assets documentation

Project description

rfhub2

Build Status codecov image image image Docker Cloud Automated build Docker Cloud Build Status

Introduction

RfHub2 is an opensource project aimed to provide nice and easy way of collecting, browsing and sharing documentation of existing keywords written in RobotFramework and python. Built with Material-UI and FastAPI, served by Uvicorn.
Project is inspired by robotframework-hub created by Bryan Oakley and can be treated as its spiritual successor.

RfHub2 is hosted on GitHub, where sourcecode, current issues and additional documentation can be found.

Installation

As python package

latest version can be installed from PyPi:

pip install rfhub2

or directly from source code:

python setup.py install

With docker

pull docker image with SQLite:

docker pull pbylicki/rfhub2

or PostgreSQL:

docker pull pbylicki/rfhub2:postgres

Starting application

Run application (web server)

To run with default (SQLite) database:

rfhub2

To run with PostgreSQL database:

RFHUB_DB_URI=postgresql://postgres:postgres@localhost:5432/postgres rfhub2

To run application using docker image with default (SQLite) database:

docker run -it -p 8000:8000 pbylicki/rfhub2

To run application using docker image with Postgres database:

docker run -it -p 8000:8000 --network=host -e RFHUB_DB_URI="postgresql://postgres:postgres@localhost:5432/postgres" pbylicki/rfhub2:postgres

Populate application with keywords documentation

To populate application running on localhost:

rfhub2-cli ../your_repo ../your_other_repo

To populate app running on another host, with non-default credentials:

rfhub2-cli -a http://your_host:8000 -u user -p password ../your_repo ../your_other_repo

To populate app but to skip loading RFWK installed libraries:

rfhub2-cli --no-installed-keywords ../your_repo ../your_other_repo
Rfhub2-cli for keywords documentation can be run in three load-modes:
  • insert, default mode, that will clean up existing collections app and load all collections found in provided paths
    rfhub2-cli --load-mode=insert ../your_repo ../your_other_repo
  • append, which will only add collections form provided paths
    rfhub2-cli --load-mode=append ../your_repo ../your_other_repo
  • update, which will compare existing collections with newly found ones, and update existing, remove obsolete and add new ones
    rfhub2-cli --load-mode=update ../your_repo ../your_other_repo

Populate application with keywords execution statistics

To gather keywords execution statistics:
rfhub2-cli --mode=statistics ../your_execution_dir ../your_other_execution_dir

Since execution statistics from specific run does not change over time, there is no load-mode needed. Application will scan all of the executions and try to send aggregated data from each run to application. rfhub2-cli will complain that there are existing statistics for particular timestamp, and will proceed with next ones.

License

RfHub2 is an open source software provided under 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.

Files for rfhub2, version 0.22
Filename, size File type Python version Upload date Hashes
Filename, size rfhub2-0.22-py3-none-any.whl (632.1 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size rfhub2-0.22.tar.gz (600.2 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page