Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

This is a command line utility for updating your local `taskwarrior
<http://taskwarrior.org>`_ database from your forge issue trackers.

Getting bugwarrior
-------------

Installing
++++++++++

Installing it from http://pypi.python.org/pypi/bugwarrior is easy with ``pip``::

$ pip install bugwarrior

The Source
++++++++++

You can find the source on github at http://github.com/ralphbean/bugwarrior


Configuring
-----------

Create a ``~/.bugwarriorrc`` file with the following contents.

.. example
::

# Example ~/.bugwarriorrc
#

# General stuff.
[general]
# Here you define a comma separated list of targets. Each of them must have a
# section below determining their properties, how to query them, etc. The name
# is just a symbol, and doesn't have any functional importance.
targets = my_github, my_bitbucket, paj_bitbucket, moksha_trac

# The bitly username and api key are used to shorten URLs to the issues for your
# task list.
bitly.api_user = YOUR_USERNAME
bitly.api_key = YOUR_API_KEY

# This is a github example. It says, "scrape every issue from every repository
# on http://github.com/ralphbean. It doesn't matter if ralphbean owns the issue
# or not."
[my_github]
service = github
username = ralphbean

# This is the same thing, but for bitbucket. Each target entry must have a
# 'service' attribute which must be one of 'github', 'bitbucket', or 'trac'.
[my_bitbucket]
service = bitbucket
username = ralphbean

# Here's another bitbucket one. Here we want to scrape the issues from repos of
# another user, but only include them in the taskwarrior db if they're assigned
# to me.
[paj_bitbucket]
service = bitbucket
username = paj
only_if_assigned = ralphbean

# Here's an example of a trac target. Scrape every ticket and only include them
# if 1) they're owned by me or 2) they're currently unassigned.
# Note -- You must have the trac XML-RPC plugin installed and configured to work
# over HTTP.
[moksha_trac]
service = trac

trac.base_uri = fedorahosted.org/moksha
trac.username = ralph
trac.password = OMG_LULZ

only_if_assigned = ralph
also_unassigned = True


.. example

Using
-----

Just run ``bugwarrior-pull``.

It's ideal to create a cron task like::

0 * * * * /usr/bin/bugwarrior-pull 2>&1 | /usr/bin/logger

Download files

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

Source Distribution

bugwarrior-0.1b.tar.gz (19.8 kB view details)

Uploaded Source

File details

Details for the file bugwarrior-0.1b.tar.gz.

File metadata

  • Download URL: bugwarrior-0.1b.tar.gz
  • Upload date:
  • Size: 19.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for bugwarrior-0.1b.tar.gz
Algorithm Hash digest
SHA256 9ccd0a58e33d52040300ac5db3f803a832bf5cafe483905a7504134b6a5cd639
MD5 252bcae3e9f9b53077509983cea40119
BLAKE2b-256 ef5019438e8acb6e01b8ec62b46b0acc9fae9261d0d30d9e6326fa2bcca29a86

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page