ConE generate action
====================
Running action generate
Usage: cone generate [options]

The generate action is intended to generate output files with different implementation plugins. The
implementation files can be filtered by different mechanism, via the command line options. 

Examples
--------

**Generate all files of a configurations**::

    >cd configproject_root
    >cone generate -c configuration_root.confml

or use the option -p|--project to point to the configuration project root::

    >cone generate --project=configproject_root -c configuration_root.confml

**Generate by filtering with values in last layer**

The data can be located in different layers in configuration project. Quite a common use case is to 
generate only output files that have been changed in the last layer.::

    >cd configproject_root
    >cone generate -c configuration_root.confml --layer=-1

This will read data value definitions on the last configuration layer (last included confml 
file in the root file), and run generate only to implementation files that use one of these
data values.

Options list
------------
  --version             show program's version number and exit
  -h, --help            show this help message and exit
  --print-settings      Print all the default settings from the current
                        setting container.
  --print-supported-impls
                        Print all supported ImplML XML namespaces and file
                        extensions.
  -v LEVEL, --verbose=LEVEL
                        Print error, warning and information on system out.
                        Possible choices: Default is 3.
                        NONE (all)    0
                        CRITICAL      1
                        ERROR         2
                        WARNING       3
                        INFO          4
                        DEBUG         5
  --log-file=FILE       Location of the used log file. Default is 'cone.log'
  -c CONFIG, --configuration=CONFIG
                        defines the name of the configuration for the action
  -p STORAGE, --project=STORAGE
                        defines the location of current project. Default is
                        the current working directory.

  Generate options:
    The generate function will create target files from a specific
    configuration.The generate will always work with read-only mode of the
    project, so no changes are saved to project

    -o FOLDER, --output=FOLDER
                        defines the target folder where the files are is
                        generated or copied
    -l LAYER, --layer=LAYER
                        define layers of the configuration that are included
                        to the output. The layer operation can be used several
                        times in a single command.Example -l -1 --layer=-2,
                        which would append a layers -1 and -2 to the layers =>
                        layers = -1,-2
    --all-layers        Include all layers in generation. This switch
                        overrides all other layer configurations (iMaker API
                        and using the --layer parameter)
    -i IMPLS, --impl=IMPLS
                        Define a Python regular expression filter for actual
                        ImplML plugin(s) that needs to be executed. The whole
                        path to ImplML filename is used in the regexp
                        matching. The impl operation can be used several times
                        in a single command.
                        Example1 --impl crml => matches for any ImplML file
                        that has a CrML string in the path. Example2 --impl
                        makeml$ => matches for ImplML file that has ends with
                        MakeML string.
    --impl-tag=TAG      define a tag for the implementations that are included
                        to the output. A tag is name value pair and has the
                        following format: name:value, e.g.
                        target:rofs3.Example --impl-tag=target:uda --impl-
                        tag=target:content, which would include impls include
                        both tags.
    --impl-tag-policy=TAGS_POLICY
                        Policy for implementation tags. May have one of the
                        following values: --impl-tag-policy=AND, --impl-tag-
                        policy=OR. Default is OR.
    -s SET, --set=SET   Override a ConfML reference in the execution.The set
                        operation can be used several times in a single
                        command.Example -s foo.bar=10 -s foo.fea='test'.
    --add=CONF          Add a given configuration to the given configuration
                        as last element.The add operation can be used several
                        times in a single command.Example --add
                        foo/root.confml --add bar/root-confml.
    -r FILE, --report=FILE
                        Generates a report about settings that are properly
                        generated.Example -r report.html.
    -t FILE, --template=FILE
                        Template used in report generation.Example -t
                        report_template.html.
    --report-data-output=FILE
                        Specifies a file where intermediary report data is
                        generated.
    -n, --dryrun        Executes generation without generation output.
    --add-setting-file=FILE
                        Generate specific settings in ini format.Example -o
                        my_generate_settings.cfg.