`autohelp update` can create the flags file

If the flagmappings file doesn't exist the function will create it,
with all the sections set to Unknown. This mimics the behavior of the
`create`, not needed anymore.

Change-Id: I7a920300b784aa8fca6412c292d807beb4d5c8e5

autogenerate_config_docs/README.rst

@@ -51,16 +51,6 @@ names as arguments:
     $ ./autohelp-wrapper rst cinder heat
 
 
-Creating mappings for a new project
------------------------------------
-
-Run the wrapper with the create subcommand:
-
-.. code-block:: console
-
-    $ ./autohelp-wrapper create zaqar
-
-
 Flagmappings files
 ------------------
 

autogenerate_config_docs/autohelp-wrapper

@@ -29,11 +29,10 @@ FAST=0
 usage() {
     echo "Wrapper for autohelp.py"
     echo "Usage:"
-    echo "  $(basename $0) [ OPTIONS ] create|update|docbook|rst|setup [ project1 ... ]"
+    echo "  $(basename $0) [ OPTIONS ] update|docbook|rst|setup [ project1 ... ]"
     echo
     echo "Subcommands:"
-    echo "  create:     Create an initial flagmapping file"
-    echo "  update:     Update the flagmapping files"
+    echo "  update:     Update or create the flagmapping files"
     echo "  docbook:    Generate the options tables in docbook format"
     echo "  rst:        Generate the options tables in RST format"
     echo "  setup:      Install the environment only"
@@ -140,7 +139,7 @@ ACTION=$1
 shift
 
 case $ACTION in
-    create|update|docbook|rst|setup) ;;
+    update|docbook|rst|setup) ;;
     *)
         usage
         exit 1
@@ -230,15 +229,6 @@ for project in $PROJECTS; do
     cd $MANUALSREPO/tools/autogenerate-config-flagmappings
 
     case $ACTION in
-    create)
-        [ "$project" = "swift" ] && continue
-        file=$MANUALSREPO/tools/autogenerate-config-flagmappings/$project.flagmappings
-        if [ -e $file ]; then
-            echo "$project.flagmappings already exists, ignoring."
-            continue
-        fi
-        $AUTOHELP create $project -i $SOURCESDIR/$project/$project $AUTOOPT
-        ;;
     update)
         [ "$project" = "swift" ] && continue
         $AUTOHELP update $project -i $SOURCESDIR/$project/$project $extra_flags $AUTOOPT

autogenerate_config_docs/autohelp.py

@@ -459,17 +459,6 @@ def write_files(package_name, options, target, output_format):
             fd.write(output)
 
 
-def create_flagmappings(package_name, options, verbose=0):
-    """Create a flagmappings file.
-
-    Create a flagmappings file. This will create a new file called
-    $package_name.flagmappings with all the categories set to Unknown.
-    """
-    with open(package_name + '.flagmappings', 'w') as f:
-        for opt in options.get_option_names():
-            f.write(opt + ' Unknown\n')
-
-
 def update_flagmappings(package_name, options, verbose=0):
     """Update flagmappings file.
 
@@ -478,14 +467,18 @@ def update_flagmappings(package_name, options, verbose=0):
     category information merged from the existing $package_name.flagmappings.
     """
     original_flags = {}
-    with open(package_name + '.flagmappings') as f:
-        for line in f:
-            try:
-                flag, category = line.split(' ', 1)
-            except ValueError:
-                flag = line.strip()
-                category = "Unknown"
-            original_flags.setdefault(flag, []).append(category.strip())
+    try:
+        with open(package_name + '.flagmappings') as f:
+            for line in f:
+                try:
+                    flag, category = line.split(' ', 1)
+                except ValueError:
+                    flag = line.strip()
+                    category = "Unknown"
+                original_flags.setdefault(flag, []).append(category.strip())
+    except IOError:
+        # If the flags file doesn't exist we'll create it
+        pass
 
     updated_flags = []
     for opt in options.get_option_names():
@@ -519,8 +512,8 @@ def main():
         description='Manage flag files, to aid in updating documentation.',
         usage='%(prog)s <cmd> <package> [options]')
     parser.add_argument('subcommand',
-                        help='Action (create, update, verify, dump).',
-                        choices=['create', 'update', 'docbook', 'rst', 'dump'])
+                        help='Action (update, docbook, rst, dump).',
+                        choices=['update', 'docbook', 'rst', 'dump'])
     parser.add_argument('package',
                         help='Name of the top-level package.')
     parser.add_argument('-v', '--verbose',
@@ -572,10 +565,7 @@ def main():
         print("%s options imported from package %s." % (len(options),
                                                         str(package_name)))
 
-    if args.subcommand == 'create':
-        create_flagmappings(args.package, options, verbose=args.verbose)
-
-    elif args.subcommand == 'update':
+    if args.subcommand == 'update':
         update_flagmappings(args.package, options, verbose=args.verbose)
 
     elif args.subcommand in ('docbook', 'rst'):

autogenerate_config_docs/releasenotes/notes/update-can-create-097dd0790567eeb5.yaml

@@ -0,0 +1,3 @@
+---
+other:
+  - ``autohelp.py update`` will create the flagmappings file if it doesn't exist yet.