Bug

Differences between revisions 5 and 17 (spanning 12 versions)
⇤ ← Revision 5 as of 2007-07-24 17:31:30 →
Size: 3178
Editor: a89-182-112-118
Comment:
← Revision 17 as of 2008-06-24 07:48:44 → ⇥
Size: 6689
Editor: a89-182-5-105
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
||<tablestyle="float:right; font-size: 0.9em; width:40%; background:#F1F1ED; margin: 0 0 1em 1em;" style="padding:0.5em;">'''Contents'''[[BR]][[TableOfContents]]||
Line 27: Line 29:
'' add a table of all attributes ''
||'''Attribute'''||'''Description'''||'''Example'''||
||.activity||Activity Log of a bugreport (type: list)|| [#activity] ||
||.assignee||Person assigned to a bugreport (type: user)|| [#user] ||
||.attachments||List of attachments|| [#attachments] ||
||.branch||List of bzr branches|| ||
||.bugnumber||Number of a bugreport (type: int)|| ||
||.changed||List of local changes to a bugreport|| [#changed] ||
||.comments||List of comments|| [#comments] ||
||.date|| || ||
||.description|| || ||
||.duplicate_of|| || ||
||.duplicates||List of duplicates of a bug|| ||
||.get_subscriptions_category||Subscribers broken into 'directly', 'notified', and 'duplicates'|| ||
||.importance|| || ||
||.info|| || ||
||.infotable|| || ||
||.milestone|| || ||
||.nickname|| || ||
||.private|| || ||
||.reporter|| || ||
||.security|| || ||
||.sourcepackage|| || ||
||.status|| || ||
||.subscriptions||All subscribers|| ||
||.summary|| || ||
||.tags|| || ||
||.target|| || ||
||.text|| || ||
||.title|| || ||
||.url|| || ||

=== Activity Log ===

[[Anchor(activity)]] Get the Activity Log:

{{{#!python start=5
>>> print b.activity[:3] #slice the list so it's more readable
[<thekorn 2007-06-15 16:29:00 UTC 'bug'>, <thekorn 2007-06-15 18:41:00 UTC 'description'>, <thekorn 2007-07-18 07:38:00 UTC 'name'>]
}}}

Members of this list have the following attributes:
 * .date, datetime object indicating the time of the change
 * .user, lphelper.user object
 * .what, string saying what changed
 * .old_value. of type str
 * .new_value, of type str
 * .message, of type str
Line 30: Line 79:
Get a list of attachments:
[[Anchor(attachments)]] Get a list of attachments:
Line 59: Line 109:
>>> bug.attachments.remove([i for i in bug.attachments.filter(test_filter)]) >>> bug.attachments.remove(test_filter)
Line 88: Line 138:
Get a list of comments: [[Anchor(comments)]] Get a list of comments:
Line 96: Line 146:
>>> comment = Bug.NewComment(text="this is a test comment") >>> comment = Bug.NewComment(text="this is a test comment",subject="test comment")
Line 102: Line 152:
=== User ===

[[Anchor(user)]] User are String-like objects with an additional attribute `.realname`.[[BR]]
{{{#!python
>>> str(bug.assignee)
'thekorn'
>>> repr(bug.assignee)
'<user thekorn (Markus Korn)>'
>>> bug.assignee.realname
'Markus Korn'
}}}
Line 106: Line 168:
{{{#!python start=41 [[Anchor(changed)]] {{{#!python start=41
Line 118: Line 180:

There are two possible arguments to `.commit()`:
 * `force_changes=<bool>`:
  * `False (default)`:
  * `True`: ''Example:'' If a user tries to add a tag `foo` to a bugreport and `foo` s not a tag in this product yet, launchpad will raise an error. If this option is set to `True` `foo` will be added to the list of tags to this project and than added to this bugreport.
 * `ignore_lp_errors=<bool>`:
  * `True (default)`: ignores launchpad processing errors
  * `False`: raises a `ValueError` if launchpad is unable to change a value

== Filing a bug report ==

{{{#!python
bug = Bug.New(product={"name": "python-launchpad-bugs"},
    summary="RFE: Add function to create a new bugreport",
    description="""It would be nice if a user could create a bugreport via a script using python-launchpad-bugs.

Markus""")
}}}

 * product is a dictionary like `{"name": <lpname of the product>, "target": <distribution>}`
  * `product={"name": "python-launchpad-bugs"}` creates a bug in https://bugs.launchpad.net/python-launchpad-bugs/
  * `product={"name": "python-launchpad-bugs", "target": "ubuntu"}` creates a bug in https://bugs.launchpad.net/ubuntu/+source/python-launchpad-bugs/
  * `product={"name": "ubuntu"}` creates a bug in https://bugs.launchpad.net/ubuntu/ (bug in "ubuntu" without a sourcepackage)
 * other optional arguments to `.New()`:
  * tags: list of tags like `["foo", "bar"]`
  * `security_related` (default: `False`)

Bug - tutorial

General workflow

That is the way to use python-launchpad-bugs to get information on a bugreport or to edit a bugreport: 

   1 >>> import launchpadbugs.connector as Connector
   2 >>> Bug = Connector.ConnectBug()
   3 >>> bug = Bug(120593)

It is also possible to get a bugreport by its url: 

   3 >>> bug = Bug(url="https://bugs.launchpad.net/buglog-data/+bug/120593")

If you want to change the bugreport or view private bugs you have to set Bug.authentication: 

   4 >>> Bug.authentication="cookie.txt"

Attributes of a bugreport

Overview

Attribute

Description

Example

.activity

Activity Log of a bugreport (type: list)

[#activity]

.assignee

Person assigned to a bugreport (type: user)

[#user]

.attachments

List of attachments

[#attachments]

.branch

List of bzr branches

.bugnumber

Number of a bugreport (type: int)

.changed

List of local changes to a bugreport

[#changed]

.comments

List of comments

[#comments]

.date

.description

.duplicate_of

.duplicates

List of duplicates of a bug

.get_subscriptions_category

Subscribers broken into 'directly', 'notified', and 'duplicates'

.importance

.info

.infotable

.milestone

.nickname

.private

.reporter

.security

.sourcepackage

.status

.subscriptions

All subscribers

.summary

.tags

.target

.text

.title

.url

Activity Log

Anchor(activity) Get the Activity Log: 

   5 >>> print b.activity[:3] #slice the list so it's more readable
   6 [<thekorn 2007-06-15 16:29:00 UTC 'bug'>, <thekorn 2007-06-15 18:41:00 UTC 'description'>, <thekorn 2007-07-18 07:38:00 UTC 'name'>]

Members of this list have the following attributes:

  • .date, datetime object indicating the time of the change
  • .user, lphelper.user object
  • .what, string saying what changed
  • .old_value. of type str
  • .new_value, of type str
  • .message, of type str

Attachments

Anchor(attachments) Get a list of attachments: 

   5 >>> for a in bug.attachments:
   6 ...     print a
   7 ... 
   8 <Attachment (up: 8554243), (down: <path-to-file>/120593/8554243/79140.patch)>
   9 <Attachment (up: 8558770)>
  10 <Attachment (up: 8554203)>
  11 <Attachment (up: 8541039)>

As you can see there are four files attached to the bug and the first attachment has already been downloaded.

You can for example filter the list of attachments by the filename: 

  12 >>> def test_filter(a):
  13 ...     import re
  14 ...     return re.match("assignee.*", a.lp_filename)
  15 ... 
  16 >>> [i for i in bug.attachments.filter(test_filter)]
  17 [<Attachment (up: 8541039)>]
  18 >>> bug.attachments[8541039].lp_filename
  19 'assignee.patch'

These filtered attachments can be easily removed: 

  20 >>> bug.attachments.remove(test_filter)
  21 True

To add an attachment you have to create an new attachment-object: 

  22 >>> attachment = Bug.NewAttachment(localfilename="<path-to-file>/79140.patch")
  23 >>> attachment.description = "example patch"
  24 >>> attachment.is_patch = True
  25 >>> attachment
  26 <Attachment (down: <path-to-file>/79140.patch)>

Now you have to add this attachment to the bugreport: 

  27 >>> bug.attachments.add(attachment)
  28 >>> for a in bug.attachments:
  29 ...     print a
  30 ... 
  31 <Attachment (up: 8554243), (down: <path-to-file>/120593/8554243/79140.patch)>
  32 <Attachment (up: 8558770)>
  33 <Attachment (up: 8554203)>
  34 <Attachment (down: <path-to-file>/79140.patch)>

Comments

Anchor(comments) Get a list of comments: 

  35 >>> [c for c in bug.comments][0:2]
  36 [<Comment 1 by thekorn on 2007-07-20>, <Comment 2 by thekorn on 2007-07-20>]

Create a new comment and add this comment to the bugreport: 

  37 >>> comment = Bug.NewComment(text="this is a test comment",subject="test comment")
  38 >>> bug.comments.add(comment)
  39 >>> [c for c in bug.comments]
  40 [<Comment 1 by thekorn on 2007-07-20>, <Comment 2 by thekorn on 2007-07-20>, ... , <Comment 'unknown'>]

User

Anchor(user) User are String-like objects with an additional attribute .realname.BR 

   1 >>> str(bug.assignee)
   2 'thekorn'
   3 >>> repr(bug.assignee)
   4 '<user thekorn (Markus Korn)>'
   5 >>> bug.assignee.realname
   6 'Markus Korn'

Commit changes

get a list of changes

Anchor(changed) 

  41 >>> for i in bug.changed:
  42 ...     print i
  43 ... 
  44 (<Attachmentlist> changed: (<Attachment (up: 8541039)> deleted), (<Attachment (down: <path-to-file>/79140.patch)> added))
  45 (<Commentslist> changed: (<Comment 'unknown'> added))

commit changes

  46 >>> bug.commit()

There are two possible arguments to .commit():

  • force_changes=<bool>:

    • False (default):

    • True: Example: If a user tries to add a tag foo to a bugreport and foo s not a tag in this product yet, launchpad will raise an error. If this option is set to True foo will be added to the list of tags to this project and than added to this bugreport.

  • ignore_lp_errors=<bool>:

    • True (default): ignores launchpad processing errors

    • False: raises a ValueError if launchpad is unable to change a value

Filing a bug report

   1 bug = Bug.New(product={"name": "python-launchpad-bugs"},
   2     summary="RFE: Add function to create a new bugreport",
   3     description="""It would be nice if a user could create a bugreport via a script using python-launchpad-bugs.
   4 
   5 Markus""")

BugHelper/Dev/python-launchpad-bugs/Bug (last edited 2008-08-12 22:24:51 by c-24-21-234-111)