Add DPMObjectId configuration object

This patch adds a new DPMObjectId configuraiton object and
corresponding type to os-dpm. This new configuration object
represents a DPM object id. It inlcudes validation if the
given config value has the correct object-id format.

It allows upper and lower case values to be defined, however
internally it converts everything to lower case (which is required by
the hmc webservices).

Example for a valid object-id:
  fa1f2466-12df-311a-804c-4ed2cc1d656b

Change-Id: I6b446f9634a018e005e112cf1e3f9cc7f6fb4a1b

os_dpm/config/cfg.py

@@ -0,0 +1,30 @@
+# Copyright 2017 IBM Corp. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from oslo_config import cfg
+
+from os_dpm.config.types import DPMObjectIdType
+
+
+class DPMObjectIdOpt(cfg.Opt):
+    def __init__(self, name, help=None):
+        """Option with DPM Object-Id type
+
+           Option with ``type`` :class:`DPMObjectIdType`
+
+        :param name: the option's name
+        :param help: an explanation of how the option is used
+        """
+        super(DPMObjectIdOpt, self).__init__(name, type=DPMObjectIdType(),
+                                             help=help)

os_dpm/constants.py

@@ -0,0 +1,17 @@
+# Copyright (c) 2017 IBM Corp.
+#
+# All Rights Reserved.
+#
+#    Licensed under the Apache License, Version 2.0 (the "License"); you may
+#    not use this file except in compliance with the License. You may obtain
+#    a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+#    Unless required by applicable law or agreed to in writing, software
+#    distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+#    WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+#    License for the specific language governing permissions and limitations
+#    under the License.
+
+OBJECT_ID_REGEX = "[a-f0-9]{8}-([a-f0-9]{4}-){3}[a-f0-9]{12}"

os_dpm/tests/unit/config/test_cfg.py

@@ -0,0 +1,26 @@
+# Copyright 2017 IBM Corp. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from oslotest import base
+
+from os_dpm.config import cfg
+
+
+class TestDPMObjectIdOpt(base.BaseTestCase):
+    def test_object_id_opt(self):
+        opt = cfg.DPMObjectIdOpt("foo-name", help="foo-help")
+        self.assertEqual("foo-help", opt.help)
+        self.assertEqual("foo-name", opt.name)
+        self.assertEqual(cfg.DPMObjectIdType, type(opt.type))