The Orange Button Python Library, also called, pyoblib, provides functions to interact and work with the SunSpec Orange Button Taxonomy and provides capabilities that simplify working with Orange Button data.

Full Documentation can be found at Read the Docs.

NOTE: This library is being actively developed and is not yet ready for production use.

Python 2.7, 3.4 - 3.6. The recommended version is Python 3.6.

A series of Bash (Mac/Linux) shell scripts are available to assist with development and packaging. Their state is preliminary but they can be used to get started.

• cli.sh: Runs the CLI before it is packaged.
• dist-cli.sh: Packages the CLI into a single file executable.
• docs.sh: Creates the documentation (currently requires some manual work).
• setup-dev.sh: Downloads the solar-taxonomy, us-gaap taxonomy, and Units registry.
• tests.sh Runs the python tests.
• tests-cli.sh Runs the CLI test suite.

All scripts must be run from the root core directory (i.e. "scripts/tests.sh" is the correct usage). Run "scripts/setup-dev.sh" before usage of other scripts.

Usage on Windows is a future feature (feel free to add). It should be possible to use on Windows with manual setup at this point in time.

In order to run the tests run:

• tests.sh Runs the python tests.
• tests-cli.sh Runs the CLI test suite.

Upon a pull request Travis will also operate all of the test cases.

All public member functions should have a corresponding test located in a test file in oblib/tests with "test_" being prefixed before the function name. Whenever a new function or method is written please write a test. Also whenever an issue is identified add additional tests so that the issue can be fixed and the issue will not re-occur. Private member function tests are optional although in some cases they may be needed to fix issues.

The CLI tests only test that the CLI completes and returns exit status 0 (success). The CLI tests do not test the functionality of the CLI. This should be sufficient since the functionality is already covered in the Python Test cases.

The project style guide is PEP8. Flake8 is a useful tool to test whether the PEP8 standard has been met (although this has not been automated, nor has a flake8 configuration file been established yet).

Another useful resource is the Google Style Guide which has additional details about writing coding above and beyond what is available in pep8.

The future intent is to deploy to PyPl. This is not implemented yet. PyInstaller is used to build a working CLI.

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests.

Versioning will be established when this reaches its first release. At this point in time this is a development release.

See the list of contributors who have participated in this project.

This project is licensed under the Apache 2.0 License - see the LICENSE.md file for details

We are greatly thankful to the contributors of the Orange Button Python Library for their hard work and dedication.

• The Orange Button Specification was built by several organizations in the Orange Button Implementors Network with guidance by XBRL US.
• Orange Button GitHub and tool accounts are supplied by SunSpec Alliance.
• The procedures and infrastructure for this library are based upon pvlib. For more information see William F. Holmgren, Clifford W. Hansen, and Mark A. Mikofski. "pvlib python: a python package for modeling solar energy systems." Journal of Open Source Software, 3(29), 884, (2018). https://doi.org/10.21105/joss.00884