alfalfa-client 0.1.0.dev7

A standalone client for the NREL Alfalfa application

Alfalfa Client

The purpose of this repository is to provide a standalone client for use with the Alfalfa application. It additionally includes a Historian to quickly/easily enable saving of results from Alfalfa simulations.

Usage

This repo is packaged and hosted on PyPI here.

pip install alfalfa-client

import alfalfa_client.alfalfa_client as ac
import alfalfa_client.historian as ah

client = ac.AlfalfaClient
historian = ah.Historian

Setup and Testing

This repository is setup to use:

• pyenv for managing python versions
• poetry for managing environment
• pre-commit for managing code styling
• tox for running tests in isolated build environments. See the expected python versions in tox.ini

Assuming poetry is installed and the necessary python versions are installed, the following should exit cleanly:

git clone https://github.com/NREL/alfalfa-client.git
cd alfalfa-client
poetry run tox

This may take some time resolving on the initial run, but subsequent runs should be faster.

See this gist for additional info.

History

• The implemented client is previously referred to as Boptest, from the alfalfa/client/boptest.py implementation. It has been ported as a standalone package for easier usage across projects.

Releasing

See release info here