add simple readme for test vector handlers

Author: mattsb42-aws

test_vector_handlers/README.rst

@@ -0,0 +1,57 @@
+#######################################
+aws-encryption-sdk test vector handlers
+#######################################
+
+There modules provide handlers to be used to process existing, or generate new,
+test vectors based on test vector manifests.
+
+***************
+Getting Started
+***************
+
+Required Prerequisites
+======================
+
+* Python 2.7 or 3.4+
+* aws-encryption-sdk
+
+Use
+===
+
+In addition to direct use of the library, some CLI tools are provided to simplify
+processing of common test manifest types.
+
+Full Message Encrypt
+--------------------
+
+Used to process an AWS Encryption SDK Full Message Encrypt manifest and produce
+a Full Message Decrypt manifest along with all corresponding plaintexts and ciphertexts.
+
+.. code::
+
+    usage: awses-full-message-encrypt [-h] --output OUTPUT --input INPUT [--human]
+
+    Build ciphertexts and decrypt manifest from keys and encrypt manifests
+
+    optional arguments:
+      -h, --help       show this help message and exit
+      --output OUTPUT  Directory in which to store results
+      --input INPUT    Existing full message encrypt manifest
+      --human          Output human-readable JSON
+
+
+Full Message Decrypt
+--------------------
+
+Used to process an AWS Encryption SDK Full Message Decrypt manifest to
+decrypt and verify all referenced ciphertexts.
+
+.. code::
+
+    usage: awses-full-message-decrypt [-h] --input INPUT
+
+    Decrypt ciphertexts generated by awses-full-message-encrypt
+
+    optional arguments:
+      -h, --help     show this help message and exit
+      --input INPUT  Existing full message decrypt manifest