python-taiga

A module for using the Taiga REST API (http://taigaio.github.io/taiga-doc/dist/api.html). Source code on Github: https://github.com/nephila/python-taiga

Getting Started

Getting started with the Taiga API couldn’t be easier. Create a TaigaAPI and you’re ready to go.

API Credentials

The TaigaAPI needs your Taiga credentials. You can pass these directly to the auth method (see the code below).

from taiga import TaigaAPI

api = TaigaAPI()

api.auth(
    username='user',
    password='psw'
)

Alternately, you can pass a token to the constructor TaigaAPI constructor.

from taiga import TaigaAPI

api = TaigaAPI(token='mytoken')

You can also specify a different host if you use Taiga somewhere else

from taiga import TaigaAPI

api = TaigaAPI(
    host='http://taiga.my.host.org'
)

Create a project

new_project = api.projects.create('TEST PROJECT', 'TESTING API')

Create a new user story

userstory = new_project.add_user_story(
    'New Story', description='Blablablabla'
)

You can also create a milestone and pass it to a story

jan_feb_milestone = new_project.add_milestone(
    'MILESTONE 1', '2015-01-26', '2015-02-26'
)

userstory = new_project.add_user_story(
    'New Story', description='Blablablabla',
    milestone=jan_feb_milestone.id
)

To add a task to your user story just run

userstory.add_task(
    'New Task 2',
    new_project.task_statuses[0].id
)

Create an issue

newissue = new_project.add_issue(
    'New Issue',
    new_project.priorities.get(name='High').id,
    new_project.issue_statuses.get(name='New').id,
    new_project.issue_types.get(name='Bug').id,
    new_project.severities.get(name='Minor').id,
    description='Bug #5'
)

List elements

projects = api.projects.list()
stories = api.user_stories.list()

You can also specify filters

tasks = api.tasks.list(project=1)

Attach a file

You can attach files to issues, user stories and tasks

newissue.attach('Read the README in Issue', 'README.md')

Play with instances

Instances can have actions, for example you can star a project just calling

new_project = api.projects.create('TEST PROJECT', 'TESTING API')
new_project.star()

Any instance can be updated and deleted

new_project.name = 'New name for my project'
new_project.update()
new_project.delete()

Search

Search function returns a SearchResult object, containing tasks, user stories and issues

projects = api.projects.list()
search_result = api.search(projects[0].id, 'NEW')
for user_story in search_result.user_stories:
    print (user_story)

History

You can access the history of issues, tasks, userstories and wiki pages:

history = api.history.user_story.get(user_story.id)

We’re working on documentation, you can find a complete example in demo.py (https://github.com/nephila/python-taiga/blob/master/demo.py).

Release files for python-taiga 0.5.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for python-taiga 0.5.0
File	Size	Uploaded
python-taiga-0.5.0.tar.gz	14.5 kB	Aug 5, 2015	Details

Release files / python-taiga-0.5.0.tar.gz

Download URL	python-taiga-0.5.0.tar.gz
Size	14.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`0fc87b5c6c911b177b2d2d6661a6fd50d0d6709ff8cd15e0daa1e9c2d35330f8`
BLAKE2b-256 checksum How to use checksums	`2279aa90d618984d1deaa48b5a18b1973c6e849b901a1a9e85274d2e021d387e`
Upload date	Aug 5, 2015
Uploaded using Trusted Publishing? What is trusted publishing?	No