adding OmegaConf.{is_config,is_dict,is_list}

docs/source/usage.rst

@@ -465,8 +465,32 @@ You can temporarily remove the struct flag from a config object:
 Utility functions
 -----------------
 
+OmegaConf.is_missing
+^^^^^^^^^^^^^^^^^^^^
+
+Tests if a key is missing ('???')
+
+.. doctest::
+
+    >>> cfg = OmegaConf.create({"foo" : 10, "bar": "???"})
+    >>> assert not OmegaConf.is_missing(cfg, "foo")
+    >>> assert OmegaConf.is_missing(cfg, "bar")
+
+OmegaConf.{is_config, is_dict, is_list}
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Tests if an object is an OmegaConf object, or if it's representing a list or a dict.
+
+.. doctest::
+
+    >>> list_cfg = OmegaConf.create([1,2,3])
+    >>> dict_cfg = OmegaConf.create({"foo": "bar"})
+    >>> assert OmegaConf.is_config(list_cfg) and OmegaConf.is_config(dict_cfg)
+    >>> assert OmegaConf.is_dict(dict_cfg) and not OmegaConf.is_dict(list_cfg)
+    >>> assert OmegaConf.is_list(list_cfg) and not OmegaConf.is_list(dict_cfg)
+
 OmegaConf.to_container
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+^^^^^^^^^^^^^^^^^^^^^^
 OmegaConf config objects looks very similar to python dict and lists, but in fact are not.
 Use OmegaConf.to_container(cfg, resolve) to convert to a primitive container.
 If resolve is set to True the values will be resolved during conversion.

news/101.feature

@@ -0,0 +1 @@
+Add OmegaConf.{is_config, is_list, is_dict} to test if an Object is an OmegaConf object, and if it's a list or a dict

news/102.feature

@@ -0,0 +1 @@
+Add OmegaConf.is_missing(cfg, key) to test if a key is missing ('???') in a config

omegaconf/__init__.py

@@ -44,5 +44,4 @@
     "MISSING",
     "SI",
     "II",
-    "Config",
 ]

omegaconf/_utils.py

@@ -76,7 +76,7 @@ def _valid_value_annotation_type(type_):
 def _valid_input_value_type(value):
     if isinstance(value, Enum) or (isinstance(value, type) and issubclass(value, Enum)):
         return True
-    return type(value) in (int, float, bool, str, dict, list, tuple, type(None))
+    return type(value) in (dict, list, tuple) or _is_primitive_type(value)
 
 
 def _node_wrap(type_, parent, is_optional, value):

omegaconf/omegaconf.py

@@ -248,6 +248,24 @@ def is_missing(cfg, key):
         except MissingMandatoryValue:
             return True
 
+    @staticmethod
+    def is_list(cfg):
+        from . import ListConfig
+
+        return isinstance(cfg, ListConfig)
+
+    @staticmethod
+    def is_dict(cfg):
+        from . import DictConfig
+
+        return isinstance(cfg, DictConfig)
+
+    @staticmethod
+    def is_config(cfg):
+        from . import Config
+
+        return isinstance(cfg, Config)
+
 
 # register all default resolvers
 register_default_resolvers()

tests/test_base_config.py

@@ -446,3 +446,23 @@ def test_omegaconf_create():
 def test_is_missing(cfg, key, expected):
     cfg = OmegaConf.create(cfg)
     assert OmegaConf.is_missing(cfg, key) == expected
+
+
+@pytest.mark.parametrize(
+    "cfg, is_conf, is_list, is_dict",
+    [
+        (None, False, False, False),
+        ({}, False, False, False),
+        ("aa", False, False, False),
+        (10, False, False, False),
+        (True, False, False, False),
+        (bool, False, False, False),
+        (StringNode("foo"), False, False, False),
+        (OmegaConf.create({}), True, False, True),
+        (OmegaConf.create([]), True, True, False),
+    ],
+)
+def test_is_config(cfg, is_conf, is_list, is_dict):
+    assert OmegaConf.is_config(cfg) == is_conf
+    assert OmegaConf.is_list(cfg) == is_list
+    assert OmegaConf.is_dict(cfg) == is_dict