feat(install): add install api functionality

Signed-off-by: Chris Snow <[email protected]>

Author: snowch

bin/cli.py

@@ -43,6 +43,7 @@
 from hpecp.cli.datatap import DatatapProxy
 from hpecp.cli.gateway import GatewayProxy
 from hpecp.cli.httpclient import HttpClientProxy
+from hpecp.cli.install import InstallProxy
 from hpecp.cli.k8scluster import K8sClusterProxy
 from hpecp.cli.k8sworker import K8sWorkerProxy
 from hpecp.cli.license import LicenseProxy
@@ -416,6 +417,7 @@ def __init__(self):
         self.configure_cli = configure_cli
         self.catalog = CatalogProxy()
         self.config = ConfigProxy()
+        self.install = InstallProxy()
         self.k8sworker = K8sWorkerProxy()
         self.k8scluster = K8sClusterProxy()
         self.tenant = TenantProxy()

hpecp/cli/install.py

@@ -0,0 +1,100 @@
+# (C) Copyright [2020] Hewlett Packard Enterprise Development LP
+#
+# Permission is hereby granted, free of charge, to any person obtaining a
+# copy of this software and associated documentation files (the "Software"),
+# to deal in the Software without restriction, including without limitation
+# the rights to use, copy, modify, merge, publish, distribute, sublicense,
+# and/or sell copies of the Software, and to permit persons to whom the
+# Software is furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included
+# in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
+# THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+# OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+# ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+# OTHER DEALINGS IN THE SOFTWARE.
+
+"""HPE Container Platform CLI."""
+
+from __future__ import print_function
+
+import json
+import jmespath
+import sys
+import yaml
+from textwrap import dedent
+
+from hpecp.cli import base
+from hpecp.cli_utils import TextOutput
+
+
+class InstallProxy(object):
+    """Proxy object to :py:attr:`<hpecp.client.install>`."""
+
+    def __dir__(self):
+        """Return the CLI method names."""
+        return [
+            # "examples",
+            "get"
+        ]
+
+    @base.intercept_exception
+    def get(self, output="yaml", query=None):
+        """Get the system config.
+
+        :param output: how to display the output '[yaml|json|json-pp]'
+        """
+        if output not in ["yaml", "json", "json-pp", "text"]:
+            print(
+                (
+                    "'output' parameter must be 'yaml', 'json', "
+                    "'json-pp' or 'text'."
+                ),
+                file=sys.stderr,
+            )
+            sys.exit(1)
+
+        if output == "yaml" and query is not None:
+            print(
+                "output=yaml is not supported with the query parameter.",
+                file=sys.stderr,
+            )
+            sys.exit(1)
+
+        response = base.get_client().config.get()
+
+        if output == "yaml":
+            print(
+                yaml.dump(
+                    yaml.load(
+                        json.dumps(response),
+                        Loader=yaml.FullLoader,
+                    )
+                )
+            )
+        else:
+            if query is None:
+                data = response
+            else:
+                data = jmespath.search(str(query), response)
+
+            if output == "json-pp":
+                print(json.dumps(data, indent=4, sort_keys=True))
+            elif output == "text":
+                print(TextOutput.dump(data))
+            else:
+                print(json.dumps(data))
+
+    def examples(self):
+        """Show examples for working with roles."""
+        print(
+            dedent(
+                """\
+
+                """  # noqa:  E501
+            )
+        )

hpecp/client.py

@@ -446,6 +446,7 @@ def __init__(
         # for each module
         self._tenant = TenantController(self)
         self._config = ConfigController(self)
+        self._install = InstallController(self)
         self._gateway = GatewayController(self)
         self._k8s_worker = K8sWorkerController(self)
         self._k8s_cluster = K8sClusterController(self)
@@ -791,6 +792,25 @@ def config(self):
         """  # noqa: E501
         return self._config
 
+    @property
+    def install(self):
+        """Retrieve a reference to `.install.InstallController` object.
+
+        See the class :py:class:`.install.InstallController` for the
+        methods available.
+
+        Example
+        -------
+        This example calls the method
+        :py:meth:`get() <.install.InstallController.get>` in
+        :py:class:`.install.InstallController`.
+
+        >>> client = ContainerPlatformClient(...)
+        >>> client.create_session()
+        >>> client.install.get()
+        """
+        return self._install
+
     @property
     def k8s_cluster(self):
         """Retrieve a reference to `.k8s_cluster.K8sClusterController` object.

hpecp/install.py

@@ -0,0 +1,34 @@
+# (C) Copyright [2020] Hewlett Packard Enterprise Development LP
+#
+# Permission is hereby granted, free of charge, to any person obtaining a
+# copy of this software and associated documentation files (the "Software"),
+# to deal in the Software without restriction, including without limitation
+# the rights to use, copy, modify, merge, publish, distribute, sublicense,
+# and/or sell copies of the Software, and to permit persons to whom the
+# Software is furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included
+# in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
+# THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+# OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+# ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+# OTHER DEALINGS IN THE SOFTWARE.
+
+from __future__ import absolute_import
+
+
+class InstallController:
+    def __init__(self, client):
+        self.client = client
+
+    def get(self):
+        response = self.client._request(
+            url="/api/v1/install",
+            http_method="get",
+            description="install/get",
+        )
+        return response.json()