Skip to content

PDXCapstoneF/SPECtate

Repository files navigation

Service Master Development
CI Status Build Status Build Status

SPECtate

SPECtate is a configuration tool that interfaces with the benchmarking software SPECjbb®2015. SPECtate is designed to to be a more user-friendly alternative for configuring and invoking the SPECjbb®2015 benchmarking software, providing:

Interfaces:

  • a graphical-user-interface (GUI)
  • a command-line-interface (CLI)

Configuration:

  • processes human-readable configuration files (HJSON, JSON, YAML)

Invocation:

  • a python-equivalent of SPECjbb®2015's run.sh file

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See usage for notes on how to use the project on a live system.

Prerequisites

Setup

$ git clone https://github.com/PDXCapstoneF/SPECtate.git
$ cd SPECtate/
$ python -m unittest discover -s .

This project uses pipenv to manage dependencies. A suggested python manager is pyenv.

Example CLI Usage

  • Generate configurations, including run-type, java options, ... (example session)
$ 
  • Invoke SPECjbb using json/hjson/yaml file ... (example session)
$ 

Documentation

  • SPECtate documentation can be found on the project wiki page and in the Python scripts themselves. Documentation of SPECtate can be generated by using Python's standard library pydoc.

Example:

$ cd SPECtate/
$ pydoc -w dialogue; open dialogue.html

The -w flag in the above command will "Write out the HTML documentation for a module to a file in the current directory."

Testing

  • Unittests

  • Travis-CI for Continuous integration testing during development

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contact