Metadata-Version: 2.1
Name: target-datadotworld
Version: 1.0.1
Summary: Singer target for data.world
Home-page: http://github.com/datadotworld/target-datadotworld
Author: data.world
Author-email: help@data.world
License: Apache 2.0
Keywords: data.world dataset singer target
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Database :: Database Engines/Servers
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Requires-Dist: backoff (<2.0a,>=1.3.0)
Requires-Dist: click (<7.0a,>=6.7)
Requires-Dist: jsonschema (<3.0a,>=2.6.0)
Requires-Dist: pyjwt (<2.0a,>=1.5.3)
Requires-Dist: requests (<3.0a,>=2.4.0)
Requires-Dist: singer-python (<6.0a,>=5.0.4)

===================
target-datadotworld
===================

A `Singer <https://singer.io>`_ target that writes data to `data.world <https://data.world>`_

How to use it
=============

``target-datadotworld`` works together with any other `Singer Tap <https://www.singer.io/#taps>`_ to store on data.world
data extracted from sources like `SalesForce <https://github.com/singer-io/tap-salesforce>`_, `HubSpot <https://github.com/singer-io/tap-hubspot>`_, `Marketo <https://github.com/singer-io/tap-marketo>`_, `MySQL <https://github.com/singer-io/tap-mysql>`_  and `more <https://github.com/search?p=3&q=org%3Asinger-io+tap-&type=Repositories>`_.

Install and Run
---------------

First, make sure Python 3.6 is installed on your system.

``target-datadotworld`` can be run with any Singer Tap, but we'll use
`tap-fixerio <https://github.com/singer-io/tap-fixerio>`_ which pulls currency exchange rate data - as an example.

These commands will install ``tap-fixerio`` and ``target-datadotworld`` with pip,
and then run them together, piping the output of ``tap-fixerio`` to
``target-datadotworld``::

  ? pip install target-datadotworld tap-fixerio 
  ? tap-fixerio | target-datadotworld -c config.json
  INFO Replicating the latest exchange rate data from fixer.io
  INFO Tap exiting normally

The data will be written to the dataset specified in ``config.json``. In this specific case, under a stream named ``exchange-rates``.

If you're using a different Tap, substitute ``tap-fixerio`` in the final
command above with the command used to run your Tap.

Configuration
-------------

`target-datadotworld` requires configuration file that is used to store your data.world API token and dataset information.

The following attributes are required:

* ``api_token``: Your data.world `API token <https://data.world/settings/advanced>`_
* ``dataset_id``: The title of the dataset where the data is to be stored. Must only contain lowercase letters, numbers, and dashes.

Additionally, the following optional attributes can be provided.

* ``dataset_owner``: If not the same as the owner of the API token (e.g. if the dataset is to be accessed/created under an organization account, as opposed to the user's own)

Example:

.. code-block:: json

    {
        "api_token": "your_token",
        "dataset_id": "fixerio-data",
        "dataset_owner": "my-company",
    }


