style: Fix flake8 errors and docstrings

Previous testing had ignored greentea source files when running flake8.
As a result, a number of style issues needed to be resolved. Along with
this, docstrings are updated, in google-style.

Author: wernerlewis

setup.py

@@ -2,30 +2,30 @@
 # Copyright (c) 2021 Arm Limited and Contributors. All rights reserved.
 # SPDX-License-Identifier: Apache-2.0
 #
-
-"""
-This module defines the attributes of the
-PyPI package for the Greentea CLI and host-tests runner (htrun)
-"""
-
+"""PyPI Package definition for Greentea CLI and host-tests runner (htrun)."""
 import os
 from io import open
 from distutils.core import setup
 from setuptools import find_packages
 
-DESCRIPTION = "The Greentea CLI and host-tests runner (htrun) is a collection of tools that enable automated testing on Mbed enabled platforms"
+DESCRIPTION = (
+    "The Greentea CLI and host-tests runner (htrun) is a collection of tools "
+    "that enable automated testing on Mbed enabled platforms."
+)
 OWNER_NAMES = "Mbed team"
 OWNER_EMAILS = "[email protected]"
 
 repository_dir = os.path.dirname(__file__)
 
 
 def read(fname):
-    """
-    Utility function to cat in a file (used for the README)
-    @param fname: the name of the file to read,
-    relative to the directory containing this file
-    @return: The string content of the opened file
+    """Read the string content of a file.
+
+    Args:
+        name: the name of the file to read relative to this file's directory.
+
+    Returns:
+        String content of the opened file.
     """
     with open(os.path.join(repository_dir, fname), mode="r") as f:
         return f.read()

src/greentea/__main__.py

@@ -2,6 +2,7 @@
 # Copyright (c) 2021 Arm Limited and Contributors. All rights reserved.
 # SPDX-License-Identifier: Apache-2.0
 #
+"""Main for the package."""
 from greentea.greentea_cli import main
 
 main()