cli: add devel make-mime subcommand (#518)

* cli: add devel make-mime subcommand

Cloud-init documents an in-source-tree tool, make-mime.py used to
help users create multi-part mime user-data.  This tool is not shipped
in the cloud-init install and unavailable at runtime.  This patch
takes tools/make-mime.py and makes the functionality available via
the devel subcommand.

The primary interface of --attach file:content-type is still present.
The cli now adds:

 -l, --list-types  Print out a list of supported content-types
 -f, --force       Ignore errors for unsupported content-types

The tool will now raise a RunTime error if the supplied content-type
is not supported (or more likely a typo:
  x-shell-script vs.  x-shellscript)

* make-mime: write to stderr and exit 1 instead of raising RuntimeError

* Update example to match docs

* Update docs for make-mime subcommand

* Remove tools/make-mime.py; replaced by cloud-init devel make-mime

Co-authored-by: Rick Harding <rharding@mitechie.com>

1 files changed, 0 insertions, 62 deletions

diff --git a/tools/make-mime.py b/tools/make-mime.py
deleted file mode 100755
index e0022302..00000000
--- a/tools/make-mime.py
+++ /dev/null
@@ -1,62 +0,0 @@
-#!/usr/bin/env python3
-
-import argparse
-import sys
-
-from email.mime.multipart import MIMEMultipart
-from email.mime.text import MIMEText
-
-KNOWN_CONTENT_TYPES = [
-    'text/x-include-once-url',
-    'text/x-include-url',
-    'text/cloud-config-archive',
-    'text/upstart-job',
-    'text/cloud-config',
-    'text/part-handler',
-    'text/x-shellscript',
-    'text/cloud-boothook',
-]
-
-
-def file_content_type(text):
-    try:
-        filename, content_type = text.split(":", 1)
-        return (open(filename, 'r'), filename, content_type.strip())
-    except ValueError:
-        raise argparse.ArgumentError(text, "Invalid value for %r" % (text))
-
-
-def main():
-    parser = argparse.ArgumentParser()
-    parser.add_argument("-a", "--attach",
-                        dest="files",
-                        type=file_content_type,
-                        action='append',
-                        default=[],
-                        required=True,
-                        metavar="<file>:<content-type>",
-                        help="attach the given file in the specified "
-                             "content type")
-    args = parser.parse_args()
-    sub_messages = []
-    for i, (fh, filename, format_type) in enumerate(args.files):
-        contents = fh.read()
-        sub_message = MIMEText(contents, format_type, sys.getdefaultencoding())
-        sub_message.add_header('Content-Disposition',
-                               'attachment; filename="%s"' % (filename))
-        content_type = sub_message.get_content_type().lower()
-        if content_type not in KNOWN_CONTENT_TYPES:
-            sys.stderr.write(("WARNING: content type %r for attachment %s "
-                             "may be incorrect!\n") % (content_type, i + 1))
-        sub_messages.append(sub_message)
-    combined_message = MIMEMultipart()
-    for msg in sub_messages:
-        combined_message.attach(msg)
-    print(combined_message)
-    return 0
-
-
-if __name__ == '__main__':
-    sys.exit(main())
-
-# vi: ts=4 expandtab