Skip to content

durandtibo/hya

hya

CI Nightly Tests Nightly Package Tests
Documentation Documentation
Codecov
Code style: black Doc style: google Ruff Doc style: google
PYPI version Python BSD-3-Clause
Downloads Monthly downloads

Overview

hya is a library of custom OmegaConf resolvers. hya is designed to be used with Hydra. The resolvers can be easily registered in your python project by adding the following lines:

from hya import register_resolvers

register_resolvers()

Installation

We highly recommend installing a virtual environment. hya can be installed from pip using the following command:

pip install hya

To make the package as slim as possible, only the minimal packages required to use hya are installed. To include all the packages, you can use the following command:

pip install hya[all]

Please check the get started page to see how to install only some specific packages or other alternatives to install the library. The following is the corresponding hya versions and tested dependencies.

hya omegaconf braceexpand* numpy* torch* python
main >=2.1,<3.0 >=0.1.7,<0.2.0 >=1.21,<2.0 >=1.10,<2.2 >=3.9,<3.13
0.2.0 >=2.1,<3.0 >=0.1.7,<0.2.0 >=1.21,<2.0 >=1.10,<3.0 >=3.9,<3.13
0.1.3 >=2.1,<3.0 >=0.1.7,<0.2.0 >=1.10,<2.2 >=3.9,<3.13
0.1.2 >=2.1,<3.0 >=0.1.7,<0.2.0 >=1.10,<2.2 >=3.9,<3.13
0.1.1 >=2.1,<3.0 >=0.1.7,<0.2.0 >=1.10,<2.2 >=3.9,<3.12
0.1.0 >=2.1,<3.0 >=0.1.7,<0.2.0 >=1.10,<2.2 >=3.9,<3.12

* indicates an optional dependency

older versions
hya omegaconf braceexpand* torch* python
0.0.14 >=2.1,<3.0 >=0.1.7,<0.2.0 >=1.10,<2.2 >=3.9,<3.12
0.0.13 >=2.1,<3.0 >=1.10,<2.1 >=3.9,<3.12
0.0.12 >=2.1,<3.0 >=1.10,<2.1 >=3.9,<3.12

Contributing

Please check the instructions in CONTRIBUTING.md.

API stability

⚠️ While hya is in development stage, no API is guaranteed to be stable from one release to the next. In fact, it is very likely that the API will change multiple times before a stable 1.0.0 release. In practice, this means that upgrading hya to a new version will possibly break any code that was using the old version of hya.

License

hya is licensed under BSD 3-Clause "New" or "Revised" license available in LICENSE file.