isabella232 / tap-asana

Singer.io tap for extracting Asana data

tap-asana

This is a Singer tap that produces JSON-formatted data following the Singer spec.

This tap:

• Pulls raw data from Asana v.1.0 API
• Extracts the following resources:
  • Portfolios with Portfolio Items
    • Only available for Business and Enterprise Subscriptions
  • Projects
  • Sections
  • Stories
  • Tags
  • Tasks
  • Teams
  • Users
  • Workspaces
• Outputs the schema for each resource
• Incrementally pulls data based on the input state

Quick Start

1. Install

$ pip install tap-asana

2. Create the config file

   Create a JSON file called config.json. Its contents should look like:

{
  "client_id": "111",
  "client_secret": "xxx",
  "redirect_uri": "urn:ietf:wg:oauth:2.0:oob",
  "refresh_token": "yyy",
  "start_date" : "2018-02-22T02:06:58.147Z"
}

The start_date specifies the date at which the tap will begin pulling data (for those resources that support this).

The client_id, client_secret, redirect_uri, and refresh_token can be generated following these Asana OAuth instructions.

4. Run the Tap in Discovery Mode

   tap-asana -c config.json -d

   See the Singer docs on discovery mode here.

5. Run the Tap in Sync Mode

   tap-asana -c config.json --catalog catalog-file.json

Development

First, clone this repo. Then, in the directory:

$ mkvirtualenv -p python3 tap-asana
$ make dev

---

Copyright © 2019 Stitch