tap-mavenlink

Author: Drew Banin (drew@fishtownanalytics.com)

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

It:

• Generates a catalog of available data in Mavenlink
• Extracts the following resources:
  • Account Memberships
  • Assignments
  • Estimates
  • Estimates Resources
  • Estimates Scenarios
  • Expenses
  • Expense Categories
  • Invoices
  • Posts
  • Stories
  • Time Entries
  • Users
  • Workspaces
  • Workspace Allocations
  • Workspace Groups

Quick Start

1. Install

git clone git@github.com:fishtown-analytics/tap-mavenlink.git
cd tap-mavenlink
pip install .

2. Get an API key

Create a Mavenlink oauth2 application. After receiving an API token keep it somewhere safe, as you'll need it to authenticate requests. See "Create the config file" below for more information on using this API Token,

3. Create the config file.

There is a template you can use at config.json.example, just copy it to config.json in the repo root and insert your token

4. Run the application to generate a catalog.

tap-mavenlink -c config.json --discover > catalog.json

5. Select the tables you'd like to replicate

Step 4 generates a a file called catalog.json that specifies all the available endpoints and fields. You'll need to open the file and select the ones you'd like to replicate. See the Singer guide on Catalog Format for more information on how tables are selected.

6. Run it!

tap-mavenlink -c config.json --catalog catalog.json

Copyright © 2019 Stitch