hydra-zen v0.7.0 released!

[rsokl]

I am excited to announce the release of v0.7.0 of hydra-zen!

What is hydra-zen? It is a library that provides pythonic functions for dynamically generating and crafting Hydra configs, and for launching Hydra jobs.

Some New Features

Native Support for Additional Types

This release includes enhanced native support for types like complex and functools.partial. See that we can convert a partial'd function directly to a structured config or yaml:

>>> from functools import partial
>>> from hydra_zen import to_yaml, just

>>> def f(x): return x**2

>>> partiald_f = partial(f, x=2)

>>> just(partiald_f)  # convert to structured config
PartialBuilds_f(_target_='__main__.f', _partial_=True, x=2)

>>> print(to_yaml(partiald_f))  # convert to yaml
_target_: __main__.f
_partial_: true
x: 2

>>> just(1+2j)
ConfigComplex(real=1.0, imag=2.0, _target_='builtins.complex')

Validated Support for Defaults Lists

Also featured in this release, hydra_zen.builds and hydra_zen.make_config now accept defaults lists via hydra_defaults, and provide some validation on these lists.

from hydra_zen import builds, launch, instantiate
from hydra.conf import ConfigStore

cs = ConfigStore.instance()

ListConfig = builds(list, range(-2, 2))  # structured config; instantiates to `list(range(-2, 2))`
cs.store(group="x", name="simple_list", node=ListConfig)

Conf = builds(dict, x=None, y="hi", hydra_defaults=["_self_", {"x": "simple_list"}])
job = launch(Conf, instantiate)  # launch hydra job with task function: `instantiate(cfg)`

print(job.return_value)
# prints: {'x': [-2, -1, 0, 1], 'y': 'hi'}

Links

Check out the rest of the defaults of the release, including future support for upcoming OmegaConf and Hydra features, here:

• Change log: https://mit-ll-responsible-ai.github.io/hydra-zen/changes.html#v0-7-0
• Docs: https://mit-ll-responsible-ai.github.io/hydra-zen/index.html
• GitHub: https://github.com/mit-ll-responsible-ai/hydra-zen