Python tool to extract data from Asana.
Project description
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
pip install -r requirements.txt
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"
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for asana-exporter-1.0.0.post1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 18bb1af6f0c7ad1f0d5c195973260174fac51c05079f2bcf72be28a328ed3914 |
|
MD5 | 655a8dcc70b5e51b05ed9ec12cd2fee7 |
|
BLAKE2b-256 | 419b7def2fdeda1daef50207c3a9c3adf20d0528d6fb631aef3e0a4b340aeb91 |
Hashes for asana_exporter-1.0.0.post1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b81aa0898293c40d7dc43f4b3159c45bf92b4f46a7b48ad0c3a6b1f8c8bd564b |
|
MD5 | 58f84d4c4453e9a626f5ead8293fbd07 |
|
BLAKE2b-256 | 3cfeda72456e07ce58ab1359577056b37d7ea5313b184f434198c73bd15e40d7 |