1.4.0

[omry]

1.4.0 (2019-11-19)

Features

• ListConfig now implements + operator (Allowing concatenation with other ListConfigs) (consider implementing + operator for ListConfig #36)
• OmegaConf.save() now takes a resolve flag (defaults False) (add resolve flag to save function #37)
• Add OmegaConf.masked_copy(keys) function that returns a copy of a config with a subset of the keys ([Feature Request] Add ability to get parts (sub-trees) of the config #42)
• Improve built-in env resolver to return properly typed values ("1" -> int, "1.0" -> float etc) (If passing an env var value that can be parsed with yaml, pass it through parsed #44)
• Resolvers can now accept a list of zero or more arguments, for example: "${foo:a,b,..,n}" (Support passing variable number of arguments to resolvers. #46)
• Change semantics of contains check ('x' in conf): Missing mandatory values ('???') are now considered not included and contains test returns false for them (implemented and tested __contains__ (key in cfg) #49)
• Allow assignment of a tuple value into a Config (Support assignment of a tuple #74)

Bug Fixes

• Read-only list can no longer be replaced with command line override (readonly list allow updates when merging from command line #39)
• Fix an error when expanding an empty dictionary in PyCharm debugger (Error expanding an DictConfig in pycharm debugger #40)
• Fix a bug in open_dict causing improper restoration of struct flag in some cases (open_dict change value to the inherited value #47)
• Fix a bug preventing dotlist values from containing '=' (foo=bar=10 -> key: foo, value: bar=10) (Handle dotlist override with values containing = #56)
• Config.merge_with_dotlist() now throws if input is not a list or tuple of strings (merge_with_dotlist wrongly accept a string as input #72)
• Add copy method for DictConfig and improve shallow copy support (OmegaConf object doesn't support a .copy method #82)

Deprecations and Removals

• Deprecated Config.to_container() in favor of OmegaConf.to_container() (Document how to convert to a standard container #41)
• Deprecated config.save(file) in favor of OmegaConf.save(config, file) (Deprecatd config.save() in favor of OmegaConf.save() #66)
• Remove OmegaConf.{empty(), from_string(), from_dict(), from_list()}. Use OmegaConf.create() (deprecated since 1.1.5) (Clean up old deprecated methods (1.2.0 or older). #67)
• Remove Config.merge_from(). Use Config.merge_with() (deprecated since 1.1.0) (Clean up old deprecated methods (1.2.0 or older). #67)
• Remove OmegaConf.from_filename() and OmegaConf.from_file(). Use OmegaConf.load() (deprecated since 1.1.5) (Clean up old deprecated methods (1.2.0 or older). #67)

Miscellaneous changes

• Switch from tox to nox for test automation (tox -> nox #54)
• Formatting code with Black (tox -> nox #54)
• Switch from Travis to CircleCI for CI (tox -> nox #54)