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

The export functionality exports configurations from the current project to a remote project. Default value for the current project is the currently working directory. A project can be either a folder or a CPF/ZIP file or even a Carbon webstorage (via ExtAPI).

Examples
--------

**Export a configuration from configuration project folder to a zip file**::

    >cd configproject_root
    >cone export -c configuration_root.confml --remote=exported.zip

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

    >cone export --project=configproject_root --remote=exported.zip -c configuration_root.confml

**Export a configuration from a zip|cpf file to a folder**

The different to the previous example is that the project parameters are turned otherway around. ::

    >cd configproject_root
    >cone export --project exported.zip --remote=. -c configuration_root.confml 

**Export a configuration from a webstorage (carbon) file to a folder**

The Carbon functionality will be released in ConE 1.2 release and is not yet officially available. 
The usage is similar to the previous, but the carbon path is given as http://serverpath/extapi.::

    >cd configproject_root
    >cone export --project http://carbonqa.nokia.com/extapi -r . -c configuration_root.confml 

See the info action for getting a list of available configurations inside Carbon.

**Export a configuration from a folder to webstorage (carbon)**::

    >cd configproject_root
    >cone export --remote http://carbonqa.nokia.com/extapi -c configuration_root.confml 

**Export a configuration and run a action during the export**::
ConE can also run separate actions during the exporting for example to fix model level errors if possible. To run for example the fix step during export you can use --run-action=fix attribute.

    >cd configproject_root
    >cone export -c configuration_root.confml --remote=../export_folder --run-action=fix


Options list
------------
Options:
  --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.
  --print-runtime-info  Print runtime information about ConE.
  -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'
  --log-config=FILE     Location of the used logging configuration file.
                        Default is 'logging.ini'
  --username=USERNAME   Username for webstorage operations. Not needed for
                        filestorage or cpf storage. If the username
                        is not given, the tool will use the logged in
                        username. Example: cone export -p webstorage_url -r .
                        -c sample.confml --username=admin --password=abc123.
  --password=PASSWORD   Password for webstorage operations. Not needed for
                        filestorage or cpf storage. If the password
                        is not given, the tool will prompt for password if
                        needed.
  -c CONFIG, --configuration=CONFIG
                        Defines the name of the configuration for the action,
                        can be specified multiple times to include multiple
                        configurations.
  --config-wildcard=WILDCARD
                        Wildcard pattern for including configurations, e.g.
                        product_langpack_*_root.confml
  --config-regex=REGEX  Regular expression for including configurations, e.g.
                        product_langpack_\d{2}_root.confml
  -p STORAGE, --project=STORAGE
                        defines the location of current project. Default is
                        the current working directory.

  Export options:
    The export action is intended for exporting configurations from one
    project (storage) to another. A project can be a folder, a CPF or ZIP
    file, or a Carbon web storage URL.
    Two different ways of exporting are supported:
    1. Exporting multiple configurations into one new project using
    --remote
    2. Exporting configurations into a number of new projects using
    --export-dir

    -r STORAGE, --remote=STORAGE
                        Defines the location of remote storage. All
                        configurations included using --configuration,
                        --config-wildcard and --config-regex are exported into
                        the storage. If the remote storage location is not
                        given, the default location is determined based on the
                        first included source configuration name. E.g.
                        'example.confml' would be exported into 'example.cpf'
    --export-dir=EXPORT_DIR
                        Defines the directory where each included
                        configuration is exported as a new project.
    --export-format=EXPORT_FORMAT
                        Defines the format into which projects are exported
                        when using --export-dir. Possible values are 'cpf'
                        (the default) and 'dir'.
    -a CONFIG, --add=CONFIG
                        Adds a configuration layer to the given configuration
                        as last element. The add operation can be used several
                        times in a single command and it can create even an
                        empty layer. Example --add foo/root.confml --add bar
                        /root-confml.
    --run-action=PLUGIN
                        Adds a execution of extra step that can manipulate the
                        configuration before it is exported to external
                        storage. The --run-action operation can be used
                        several times in a single command and it will execute
                        the actions in given order.Example --run-action=fix,
                        which would execute fix action during export.
    --exclude-folders   Excludes empty folders from export