NAME

    Datahub::Factory - A conveyor belt which transforms data from an input
    format to an output format before pushing it to a Datahub instance.

SYNOPSIS

        Datahub::Factory consists of two elements: a library (C<Datahub::FactoryC<) and a conversion script (C<dh-factory.plC<).

DESCRIPTION

    Datahub::Factory is a conveyor belt which does two things:

    Data is converted from an input format to an output format leveraging
    Catmandu.

    The output is pushed to an instance of the Datahub.

    Internally, Datahub::Factory uses Catmandu modules.

USAGE

    Invoke the perl script in bin.

      perl bin/dh-factory.pl \
        --importer=Adlib \
        --fixes=/path/to/catmandufixfile.fix \
        --oimport file_name=/path/to/importfile.xml \
        --ostore datahub_url="http://www.datahub.app" \
        --ostore oauth_client_id=client_id \
        --ostore oauth_client_secret=client_secret \
        --ostore oauth_username=user \
        --ostore oauth_password=password

 CLI

  Options

    --importer: select the importer to use. Supported importers are in
    liband are of the form $importer_name::Import.pm. You only have to
    provide $importer_name By default Adlibis the only supported importer.

    --fixes: location (path) of the file containing the fixes that have to
    be applied.

    --exporter: select the exporter to use. Uses the same format as
    --importer, but only supports Lido Optional, if it isn't set, the
    default internal store is used. If it is set, the store isn't used.

    --oimport: set --importeroptions like --oimport _option_=_value_
    Options are specific to the importer used (see below).

    --ostore: set options for the default Datahub store. Uses the same
    syntax as --oimport.

    --oexport: set options for --exporterusing the same syntax as
    --oimport, but is only required if --exporteris used.

  Specific options

   Importer

    file_name: path of the XML dump that the --importerwill import from.

   Exporter

    file_name: path of the file the --exporterwill write to.

   Store

    datahub_url. URL of the datahub (e.g. _http://www.datahub.app_).

    oauth_client_id. OAuth2 client_id.

    oauth_client_secret. OAuth2 client_secret.

    oauth_username. OAuth2 username.

    oauth_password. OAuth2 password.

AUTHOR

    Pieter De Praetere <pieter@packed.be>

    Matthias Vandermaesen <matthias.vandermaesen@vlaamsekunstcollectie.be>

COPYRIGHT

    Copyright 2016 - PACKED vzw

LICENSE

    This library is free software; you can redistribute it and/or modify it
    under the terms of the GPLv3.