[doc] fix some docstrings

Fixes #114

src/hades/bin/dhcp_script.py

@@ -53,6 +53,7 @@ def generate_leasefile_lines(
 ) -> str:
     """
     Generate lines in dnsmasq leasefile format from an iterable.
+
     :param leases: An iterable that yields (ExpiresAt, MAC, IPAddress,
         Hostname, ClientID)-tuples
     :return: An iterable of strings

src/hades/common/cli.py

@@ -88,6 +88,7 @@ def setup_cli_logging(program, args):
 
     Flask and Celery are quite opinionated about logging, so this function
     should probably not be called in their launchers.
+
     :param program: The name of the program
     :param args: The parsed arguments of the program with :data:`parser` or a
     subparser.

src/hades/config/base.py

@@ -136,6 +136,7 @@ def decorate(cls, f):
         Functions are automatically decorated with :class:`classmethod`, if they
         are not already an instance of :class:`classmethod` or
         :class:`staticmethod`.
+
         :param f: The function
         """
         # Ensure that we have a static or class method

src/hades/deputy/dhcp.py

@@ -132,6 +132,7 @@ def send_dhcp_packet(
 
     If no interface or IP address to send the packet from is specified, the
     operating system will choose one.
+
     :param server_ip: IP address of server.
     :param packet: DHCP packet
     :param from_interface: Interface to send the packet from (optional)
@@ -164,6 +165,7 @@ def release_dhcp_lease(
     client_ip and client_mac.
 
     An optional client identifier may also be specified.
+
     :param server_ip: IP address of the DHCP server
     :param client_ip: IP address of the DHCP client
     :param client_mac: MAC address of the DHCP client

src/hades/deputy/server.py

@@ -214,7 +214,10 @@ class HadesDeputyService(object):
     """
     dbus = pkg_resources.resource_string(
         __package__, 'interface.xml').decode('utf-8')
-    """DBus object introspection specification"""
+    """DBus object introspection specification
+
+    :meta hide-value:
+    """
 
     def __init__(self, bus: Bus, config: Config):
         """
@@ -331,6 +334,7 @@ def _release_dhcp_lease(
     ) -> str:
         """
         Release an auth or unauth DHCP lease
+
         :return:
         """
         try:
@@ -349,6 +353,7 @@ def _release_dhcp_lease(
     def ReleaseAuthDhcpLease(self, client_ip: str) -> str:
         """
         Release an auth DHCP lease
+
         :return:
         """
         logger.info("Releasing auth DHCP lease for client %s", client_ip)
@@ -359,6 +364,7 @@ def ReleaseAuthDhcpLease(self, client_ip: str) -> str:
     def ReleaseUnauthDhcpLease(self, client_ip: str) -> str:
         """
         Release an auth DHCP lease
+
         :return:
         """
         logger.info("Releasing unauth DHCP lease for client %s", client_ip)