chore: clean up and fix test vector handler static analysis checks (#263)

* chore: fix pylint-test configuration

* chore: clean up linting issues in test vector handler

Author: mattsb42-aws

test_vector_handlers/src/awses_test_vectors/__init__.py

@@ -10,4 +10,5 @@
 # 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.
+"""Static test vector handling logic for the AWS Encyrption SDK."""
 __version__ = "1.0.0"

test_vector_handlers/src/awses_test_vectors/commands/__init__.py

@@ -10,3 +10,4 @@
 # 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.
+"""CLI commands."""

test_vector_handlers/src/awses_test_vectors/commands/full_message_decrypt.py

@@ -10,9 +10,7 @@
 # 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.
-"""
-AWS Encryption SDK full message decrypt command.
-"""
+"""AWS Encryption SDK full message decrypt command."""
 import argparse
 
 from awses_test_vectors.manifests.full_message.decrypt import MessageDecryptionManifest

test_vector_handlers/src/awses_test_vectors/commands/full_message_encrypt.py

@@ -10,9 +10,7 @@
 # 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.
-"""
-AWS Encryption SDK full message encrypt command.
-"""
+"""AWS Encryption SDK full message encrypt command."""
 import argparse
 
 from awses_test_vectors.manifests.full_message.encrypt import MessageEncryptionManifest

test_vector_handlers/src/awses_test_vectors/internal/__init__.py

@@ -10,3 +10,9 @@
 # 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.
+"""Internal implementation details.
+
+.. warning::
+    No guarantee is provided on the modules and APIs within this
+    namespace staying consistent. Directly reference at your own risk.
+"""

test_vector_handlers/src/awses_test_vectors/internal/aws_kms.py

@@ -10,9 +10,7 @@
 # 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.
-"""
-Helper utilities for interacting with AWS KMS.
-"""
+"""Helper utilities for interacting with AWS KMS."""
 try:
     from aws_encryption_sdk.identifiers import AlgorithmSuite
 except ImportError:

test_vector_handlers/src/awses_test_vectors/internal/defaults.py

@@ -10,8 +10,6 @@
 # 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.
-"""
-Default values for use in AWS Encryption SDK test vector handlers.
-"""
+"""Default values for use in AWS Encryption SDK test vector handlers."""
 
 ENCODING = "utf-8"

test_vector_handlers/src/awses_test_vectors/internal/mypy_types.py

@@ -10,9 +10,7 @@
 # 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.
-"""
-MyPy types for use in AWS Encryption SDK test vector handlers.
-"""
+"""MyPy types for use in AWS Encryption SDK test vector handlers."""
 # mypy types confuse pylint: disable=invalid-name
 
 try:  # Python 3.5.0 and 3.5.1 have incompatible typing modules

test_vector_handlers/src/awses_test_vectors/internal/util.py

@@ -10,9 +10,7 @@
 # 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.
-"""
-Utility functions for use in AWS Encryption SDK test vector handlers.
-"""
+"""Utility functions for use in AWS Encryption SDK test vector handlers."""
 import os
 import struct
 from binascii import unhexlify
@@ -100,7 +98,7 @@ def membership_validator(allowed):
     def _validate_membership(instance, attribute, value):
         # type: (object, Attribute, Any) -> None
         # pylint: disable=unused-argument
-        """"""
+        """Perform membership check."""
         if value not in allowed:
             raise ValueError(
                 'Unknown "{name}" value "{actual}" not in {expected}'.format(
@@ -178,9 +176,9 @@ def algorithm_suite_from_string_id(string_id):
     return AlgorithmSuite.get_by_id(numeric_id)
 
 
-# TODO: I want to replace these functions with an extensible "URI Handler" class
-#  that will abstract away any file handling. This will vastly simply extending
-#  these handlers to work with files in some non-local location, such as S3.
+# I want to replace these functions with an extensible "URI Handler" class
+# that will abstract away any file handling. This will vastly simply extending
+# these handlers to work with files in some non-local location, such as S3.
 def file_writer(parent_dir):
     # type: (str) -> Callable[[str, bytes], str]
     """Return a caller that will write the requested named data to a file and return
@@ -214,7 +212,7 @@ def _write_file(name, data):
 
 def file_reader(parent_dir):
     # type: (str) -> Callable[[str], bytes]
-    """Returns a callable that accepts a URI identifying a file relative to ``parent_dir``
+    """Return a callable that accepts a URI identifying a file relative to ``parent_dir``
     and returns the binary contents of that file.
 
     :param str parent_dir: Parent directory to use as the relative root for all URIs

test_vector_handlers/src/awses_test_vectors/manifests/__init__.py

@@ -10,3 +10,4 @@
 # 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.
+"""Test vector manifest handlers."""