Skip to main content

Python Client for asana.com

Project description

Python Asana
============

.. image:: https://travis-ci.org/caseydunham/python-asana.png?branch=master
:target: https://travis-ci.org/caseydunham/python-asana

A python wrapper around the Asana (asana.com) API

Introduction
------------

This library provides a pure python interface for the Asana restful API.

Currently not all operations are supported. All of the operations that are currently supported are read only.

With this initial version, the following functionality is working:

* Retrieving workspaces
* Retrieving projects
* Retrieving users
* Retrieving tasks
* Retrieving stories

Documentation
-------------
Forthcoming.

Using
-----

The library provides a python wrapper around the Asana API and data model.

*Model:*

The various API methods in the pyasana.API class return instances of the following
classes

.. code-block:: pycon
pyasana.User
pyasana.Workspace
pyasana.Project
pyasana.Task
pyasana.Story

*API:*

All interaction with the Asana API is done through the pyasana.Api class.

All Asana API calls require an Integrator Key.

To create an instance of the pyasana.Api class:

>>> import pyasana
>>> api = pyasana.Api("YOUR ASANA INTEGERATOR KEY")

To retrieve a list of all the workspaces:

>>> workspaces = api.get_workspaces()
>>> print ["%s:%s" % (w.id, w.name) for w in workspaces]
[u'193074061952:Shiny New Workspace', u'652052755897:Sandbox']

To retrieve a list of all projects in a workspace:

>>> workspace = 193074061952
>>> projects = api.get_projects(workspace)
>>> print ["%s:%s" % (p.id, p.name) for p in projects]
[u'983421735560:Asana Python Client', u'992461725871:Test Project']

To retrieve a list of all tasks in a project:

>>> project = 983421735560
>>> tasks = api.get_tasks(project=project)
>>> print ["%s:%s % (t.id, t.name) for t in tasks]
[u'953421755459:fix task detail issue', u'953341245215:documentation']

More examples forthcoming...

.. _`the repository`: http://github.com/caseydunham/python-asana
.. _AUTHORS: https://github.com/caseydunham/python-asana/blob/master/AUTHORS.rst


.. :changelog:

History
-------

0.0.3 (2013-02-10)
++++++++++++++++++

* package release
* create projects

0.0.2 (2012-12-03)
++++++++++++++++++

* added assignee to task object
* throttle support

0.0.1 (2012-06-12)
++++++++++++++++++

* inception

Project details


Release history Release notifications

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
pyasana-0.0.3.win-amd64.exe (232.6 kB) Copy SHA256 hash SHA256 Windows Installer any
pyasana-0.0.3.zip (14.4 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page