@main.command(short_help="<STR_LIT>")<EOL>@click.argument('<STR_LIT>', nargs=<NUM_LIT:1>, type=click.Path(exists=True))<EOL>@click.argument('<STR_LIT>',  nargs=<NUM_LIT:1>, type=click.Path())<EOL>@click.option('<STR_LIT>', default=<NUM_LIT:4>, show_default=True, help="<STR_LIT>") <EOL>@click.option('<STR_LIT>', default="<STR_LIT:U+0020>", help="<STR_LIT>")<EOL>@click.option('<STR_LIT>', default='<STR_LIT:">', help="<STR_LIT>") <EOL>@click.option('<STR_LIT>', default='<STR_LIT:\n>', help="<STR_LIT>")<EOL>@click.option('<STR_LIT>', default=True, show_default=True, help="<STR_LIT>") <EOL>@click.option('<STR_LIT>', default=False, show_default=True, help="<STR_LIT>") <EOL>@click.pass_context<EOL>def format(ctx, input_mapfile, output_mapfile, indent, spacer, quote, newlinechar, expand, comments):
quote = codecs.decode(quote, '<STR_LIT>')  <EOL>spacer = codecs.decode(spacer, '<STR_LIT>')  <EOL>newlinechar = codecs.decode(newlinechar, '<STR_LIT>')  <EOL>d = mappyfile.open(input_mapfile, expand_includes=expand, include_comments=comments, include_position=True)<EOL>mappyfile.save(d, output_mapfile, indent=indent, spacer=spacer, quote=quote, newlinechar=newlinechar)<EOL>sys.exit(<NUM_LIT:0>)<EOL>
Format a the input-mapfile and save as output-mapfile. Note output-mapfile will be
overwritten if it already exists.

Example of formatting a single Mapfile:

    mappyfile format C:/Temp/valid.map C:/Temp/valid_formatted.map

Example of formatting a single Mapfile with single quotes and tabs for indentation:

    mappyfile format C:/Temp/valid.map C:/Temp/valid_formatted.map --quote=\\' --indent=1 --spacer=\t

Example of formatting a single Mapfile without expanding includes, but including comments:

    mappyfile format C:/Temp/valid.map C:/Temp/valid_formatted.map --no-expand --comments