blob: 4e52a8bb4f8e8118dd391438a9bab054299eb772 [file] [log] [blame] [view] [edit]
# webkitbugspy
Provides a shared API for various bug trackers.
## Requirements
- webkitcorepy
## Usage
The `webkitbugspy` library implements a generic issue tracker API compatible with multiple bug and issue trackers. To interact with an `Issue`, first instantiate a tracker:
```
from webkitbugspy import github
tracker = github.Tracker('https://github.com/WebKit/WebKit')
issue = tracker.issue(1)
```
You should register all trackers your project interacts with so that an `Issue` in one tracker can cross-reference issues in other trackers:
```
from webkitbugspy import bugzilla, github
Tracker.register(bugzilla.Tracker('https://bugs.webkit.org', res=[
re.compile(r'\Ahttps?://webkit.org/b/(?P<id>\d+)\Z'),
re.compile(r'\Awebkit.org/b/(?P<id>\d+)\Z'),
]))
Tracker.register(github.Tracker('https://github.com/WebKit/WebKit'))
print(Tracker.from_string('https://github.com/WebKit/WebKit/issues/47').references)
```