add hpecp/license doc check

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

Author: snowch

.travis.yml

@@ -36,7 +36,7 @@ jobs:
       install:
         - pip3 install flake8 flake8-docstrings flake8-per-file-ignores
       script:
-        - flake8 --exclude hpecp/gateway.py,hpecp/logger.py,hpecp/k8s_cluster.py,hpecp/license.py,hpecp/user.py,hpecp/tenant.py,hpecp/role.py --docstring-convention numpy bin/ hpecp/
+        - flake8 --exclude hpecp/gateway.py,hpecp/logger.py,hpecp/k8s_cluster.py,hpecp/user.py,hpecp/tenant.py,hpecp/role.py --docstring-convention numpy bin/ hpecp/
     - stage: coverage_library
       name: "Code coverage LIBRARY (./hpecp)"
       python: 3.8

hpecp/license.py

@@ -80,18 +80,18 @@ def upload_with_ssh_pass(
         )
 
     def register(self, server_filename):
-        """Register a license that has been uploaded to
-        '/srv/bluedata/license/' on the controller.
-
-        Arguments:
-
-            server_filename: str
-                Filepath to the license on the server, e.g.
-                '/srv/bluedata/license/LICENSE-1.txt'
-
-        Raises:
-
-            APIException
+        """Register a license. The license must have previously been uploaded
+        to '/srv/bluedata/license/' on the controller.
+
+        Parameters
+        ----------
+        server_filename: str
+            Filepath to the license on the server, e.g.
+            '/srv/bluedata/license/LICENSE-1.txt'
+
+        Raises
+        ------
+        APIException
         """
         data = {"hpelicense_file": server_filename}
         return self.client._request(
@@ -102,16 +102,16 @@ def register(self, server_filename):
         )
 
     def delete(self, license_key):
-        """Delete a license by LicenseKey
-
-        Arguments:
-
-            license_key: str
-                The license key, e.g. '1234 1234 ... 1234 "SOMETEXT"'
+        """Delete a license by LicenseKey.
 
-        Raises:
+        Parameters
+        ----------
+        license_key: str
+            The license key, e.g. '1234 1234 ... 1234 "SOMETEXT"'
 
-            APIException
+        Raises
+        ------
+        APIException
         """
 
         try: