buildstock-fetch

This library simplifies downloading building characteristics and load curve data from NREL's ResStock and ComStock projects.
Getting start with the project
1. Set Up Your Development Environment
The easiest way to set up the library's dev environment is to use devcontainers. To do so, open up the repo in VSCode or a VSCode fork like Cursor or Positron. The editor will auto-detect the presence of the repo's devcontainer (configured in .devcontainer/devcontainer.json
). Click "Reopen in Container" to launch the devcontainer.
Alternatively, you can install the environment and the pre-commit hooks on your laptop with
make install
You are now ready to start development on the library!
The github action CI/CD pipeline will be triggered when you open a pull request, merge to main, or when you create a new release.
2. Set up PyPI publishing
To finalize the set-up for publishing to PyPI, see here.
3. Activate automatic documentation
For activating the automatic documentation with MkDocs, see here.
Releasing a new version
- Create an API Token on PyPI.
- Add the API Token to your projects secrets with the name
PYPI_TOKEN
by visiting this page.
- Create a new release on Github.
- Create a new tag in the form
*.*.*
.
For more details, see here.
Repository initiated with fpgmaas/cookiecutter-uv.