Skip to content

Python client for Huawei FusionSolar SmartPVMS Northbound Interface

License

Notifications You must be signed in to change notification settings

guillaumeblanc/pyhfs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

FusionSolar Northbound Interface Client

Provides a Python API to access Huawei FusionSolar web service to download SmartPVMS data. To login you need account on Huawei FusionSolar https://eu5.fusionsolar.huawei.com. Queried data are return as-is. Please refer to Huawei SmartPVMS Northbound Interface Reference V6 documentation for more details about data format.

Installation

The package is distributed with pip, and can be installed with the command line:

python3 -m pip install pyhfs

Usage

import pyhfs

try:
    with pyhfs.ClientSession(user='user', password='password') as client:
        plants = client.get_plant_list()
        print(plants)
except pyhfs.LoginFailed:
    print('Login failed. Verify user and password of Northbound API account.')

For more details about how to use the API, please check how_to.py.

Running tests

Testing requires a valid Northbound API account, which can be created from Fusion Solar system/company management interface. Tests will look for two environment variables to get user account (FUSIONSOLAR_USER) and password (FUSIONSOLAR_PASSWORD).

Use the following command from directory root to run the tests:

python3 -m unittest discover

Using CI

In case of a fork, these same variables (FUSIONSOLAR_USER and FUSIONSOLAR_PASSWORD) shall be added to github secrets in order for the CI to work.

About

Python client for Huawei FusionSolar SmartPVMS Northbound Interface

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages