EnergyPlus Regressions
Overview
This library provides tools for performing regressions between EnergyPlus builds. Developers often propose changes to EnergyPlus for:
- New feature development
- Defect repair
- Refactoring for structure or performance
When a developer proposes these changes, those code changes must be tested prior to accepting them into the main branch. A continuous integration system runs the tests and provides results, but there can be a sometimes lengthy delay waiting on those results, depending on how busy the system is at that time. This set of tools provides a way to run these regressions locally.
Usage
This tool works on all three major platforms: Windows, Mac, and Ubuntu (LTS). GitHub Actions test on multiple platforms, and it is regularly used on all three as well.
To install the tool, simply pip install it into your Python environment (either system or virtual environment)
The project page on PyPi is: https://pypi.org/project/energyplus-regressions/.
- Download using Pip (
pip install energyplus-regressions). - Once installed into the Python install, there will be a binary available to run:
energyplus_regression_runner.
Development
For setting up a development environment to do work on this tool, the steps are pretty minimal:
- Install Python, if needed
- Clone this repository (
git clone https://github.com/NatLabRockies/EnergyPlusRegressionTool) - Install dependencies (
pip3 install -r requirements.txt)
Releasing
Version numbers are bumped with bump2version, configured in .bumpversion.cfg.
To cut a release, run bump2version patch (or minor/major), then git push --follow-tags; pushing the tag triggers the PyPI release workflow.
Documentation
Program documentation, including user guide and typical workflows, are available in the documentation. This documentation is written using RST with Sphinx, and published on ReadTheDocs.
Testing
Exhaustive unit tests have been added to the "underneath the hood" code, like the functions that calculate diffs and run builds. The unit tests are run on Github Actions. The GUI code is not unit tested, but tested routinely on all platforms.
1 maintainer
Metadata
1 maintainer
Release files for energyplus-regressions 2.1.9
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| energyplus_regressions-2.1.9.tar.gz | 126.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| energyplus_regressions-2.1.9-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 258.1 kB
Release files / energyplus_regressions-2.1.9.tar.gz
| Download URL | energyplus_regressions-2.1.9.tar.gz |
|---|---|
| Size | 126.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8f7fbbc08c33632b6eb786b2748b821d26f6a3ad8dd5122483b7d8939991f1e8
|
|
BLAKE2b-256 checksum How to use checksums |
cf08c9e288795be97413d5aa2317f3fa6c9b69ee945404c2b1152de8b8f2a876
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.25
|
Release files / energyplus_regressions-2.1.9-py3-none-any.whl
| Download URL | energyplus_regressions-2.1.9-py3-none-any.whl |
|---|---|
| Size | 131.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
163c71056044ce3ce8c4c5e81bcce837edc7fbcc2306d7a9308c2028c18f52f1
|
|
BLAKE2b-256 checksum How to use checksums |
cbd0a7ab03710c3c0a9c1b3406140755ac223137707ca208d53c4b30e4514022
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.25
|
