Epimetheus Introduction

Epimetheus offers a dashboard/UI to visualize data from TestArchiver.

Installation

Requirements

1. PostgreSQL database with archived result data
2. Python v3+
3. Node.js v10+

Database

Currently, the only supported database engine is PostgreSQL. It can be local or cloud version.

Backend

If you have multiple python installations on your machine, remember to use the 'python3' postfix, also with pip you might need to use 'pip3' to make sure the requirements get installed with the right python.

cd backend_server
pip install -r requirements.txt
python .\server.py --database dbname --host dbhost --user dbuser --pw dbpasswd --port 5000

Detailed information in backend readme.

Frontend

cd frontend
npm install
npm run start

Detailed information in frontend readme.

Usage

Once you have both frontend and backend running, you can open your browser to http://localhost:3000 and check the front user interface.

Note that there should be some data saved in the database before user interface will show something. For pushing data into database, consult TestArchiver documentation.

Installation with docker

Running project with Docker

Browser Support

Supported browsers are "all modern browsers". This means IE and some mobile browsers are not supported.

Contributing

Contributing guide

Code of Conduct

Code of Conduct

License

Apache 2.0

Release Notes

• 1.2.1 (2022-08-16)

  • Query params read in initial state fixed. Makes sure passing and failing filters are included in the state.
  • BugFix for Issue 212 metadata not displaying
  • Fixes data duplication in simple build results API
  • Common search component for teams view, filters and average time for build series

• 1.2.0 (2021-06-14)

  • Compare page
  • Team Name API
  • Team filter to series and team API
  • Refactoring frontend application state usage
  • Unify different component styles
  • Contribution and release documentation updates
  • Bug fixes:

    • #177 offset button reset

    • #174 Wrong build status when first fails and rerun passes

• 1.1.0 (2021-03-12)

  • Simple build results API
  • Analysis view for a build with keyword analysis table
  • Keyword analysis API
  • Accessibility improvements
  • Style and file name refactoring
  • Dockerhub publishing for new releases
  • Features:

    • #141 Style and refactor the keyword analysis table enhancement

    • #138 Fix various bugs caused by the grid bug

    • #137 Simple single build results API enhancement

    • #135 Keyword execution time analysis tool enhancement

    • #133 Accessibility fix for checkbox bug

    • #131 Check color usage enhancement

• 1.0.1 (2020-10-21)

  • Fixes a bug which prevented the frontend container from starting when using docker-compose
  • Changes the default port of Nginx in Dockerfile-prod container from 80 to 8080. Services in Docker containers are now running as non root user.
  • Layout fixes
  • New default font
  • Queryparams are now properly shown when switching between Overview and History layouts
  • Queryparams are properly removed from state if not needed

• 1.0.0 (2020-09-22)

  • Completely updated layout and colour palette
  • Updated Breadcrumb nav
  • Overview -page for Series and Builds with graphical visualisation
  • Offset buttons to toggle between different builds in Series -view
  • Added metadata to Build- and Suite -view
  • Backend support for latest TestArchiver version
  • Slight data loading optimisation when toggling between different Series -views
  • Translation support