Skip to content

Latest commit

 

History

History
74 lines (49 loc) · 2.18 KB

README.md

File metadata and controls

74 lines (49 loc) · 2.18 KB

Overview

Exports Asana projects along with their resources such as tasks, stories and attachments and saves as json in a tree structure making it easy to query with tools like jq and import into other tools like Jira.

Install

From pypi:

sudo apt install python3-pip
pip install asana-exporter

From snap:

sudo snap install asana-exporter

From source:

sudo apt install python3-pip
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python setup.py build
python setup.py install

Usage

The first action is to extract information from Asana using the API. To do this you will need to generate a Personal Access Token from the web UI - see https://developers.asana.com/docs/personal-access-token for instructions on how to do this.

Once you have a token, run this tool as follows to extract data. A team name and workspace are required (see https://developers.asana.com/docs/workspaces - this is usually your organisation name). Projects are extracted in the context of a team. You can extract multiple teams' projects into the same archive by running the tool multiple times with different teams.

If you want to start by getting a list of available teams you can do:

asana-exporter --token TOKEN --workspace WORKSPACE --export-path EXPORT_PATH --list-teams

Now you can choose a team and extract all of its projects:

asana-exporter --token TOKEN --workspace WORKSPACE --export-path EXPORT_PATH --team TEAM

If you do not want all projects you can filter project names:

asana-exporter --token TOKEN --workspace WORKSPACE --export-path EXPORT_PATH --team TEAM --project-filter "My\s+.+roject"

Once complete, your data will be under EXPORT_PATH and you can query it e.g.

List all teams found:

asana-exporter --export-path EXPORT_PATH --list-teams

List all extracted projects for a given team:

asana-exporter --token TOKEN --workspace WORKSPACE --export-path EXPORT_PATH --team "My Team" --list-projects

List all extracted tasks for a given project:

asana-exporter --token TOKEN --workspace WORKSPACE --export-path EXPORT_PATH --team "My Team" --list-project-tasks "My Project"