getting-started

Differences between revisions 1 and 18 (spanning 17 versions)
Revision 1 as of 2007-02-12 19:05:33
Size: 3307
Editor: 81
Comment: created
Revision 18 as of 2007-06-15 17:40:03
Size: 3513
Editor: c-134-232-252
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
## page was renamed from BugHelper/doc
Line 5: Line 6:
== On a Feisty Fawn system == === Since 7.04 (Feisty Fawn) ===
Line 9: Line 10:
run {{{
sudo apt-get install bughelper}}}
{{{sudo apt-get install bughelper
}}}
Line 12: Line 13:
== On other systems == === On other systems ===
Line 14: Line 15:
These instructions assume that you have a [https://launchpad.net launchpad] account and that you have {{{bzr}}} [http://doc.bazaar-vcs.org/bzr.dev/tutorial.htm installed and configured]. You need to have bazaar installed: "sudo apt-get install bzr". Then proceed as follows.
Line 16: Line 17:
Get the `bughelper` source from launchpad: {{{
bzr checkout sftp://YOUR-LAUNCHPAD-ID@bazaar.launchpad.net/~bugsquad/bughelper/bughelper.main}}}

This is also the best option if you want to participate in bughelper development, or just test the bleeding edge.
Get the `bughelper` source from Launchpad: {{{
bzr co http://bazaar.launchpad.net/~bughelper-dev/bughelper/main
bzr co http://bazaar.launchpad.net/~bughelper-dev/python-launchpad-bugs/main python-launchpad-bugs
cd bughelper.main
ln -s ../python-launchpad-bugs/launchpadBugs}}}
Line 22: Line 24:
= Initial configuration = === Initial configuration ===
Line 24: Line 26:
When you run {{{bughelper}}} for the first time it will create a ~/.bughelper/ directory and a ~/.bughelper/config file. It will also check out a copy of the latest shared clue files from the bughelper project on Launchpad. You are now ready to search for bugs!
When you run {{{bughelper}}} for the first time it will create a ~/.bughelper/ directory and a ~/.bughelper/config file. It will also check out a copy of the latest shared clue files from the bughelper project on Launchpad.
Line 38: Line 39:
However, sometimes you may be approaching the problem form the other direction. You are working with a given bug and you want to look for similar bugs, either pen or closed. In that case you'll want to define your own search terms: However, sometimes you may be approaching the problem form the other direction. You are working with a given bug and you want to look for similar bugs, either open or closed. In that case you'll want to define your own search terms:
Line 54: Line 55:
{{{
<?xml version="1.0"?>
{{{<?xml version="1.0"?>
Line 66: Line 66:
Note: creating clues with bugxml requires that you have added a local package directory to your ~/.bughelper/config file. ''Note: creating clues with bugxml requires that you have added a local package directory to your ~/.bughelper/config file.''
Line 68: Line 68:
Once a clue file has been created, bughelper will include the information it contains in future searches. The above example represents just a simple search string, but you can get more targeted searches by adding more conditions to your clue files. Read [:BugHelper/Dev/ClueFiles:Dev/ClueFiles] for further information on file structure and sharing the search data with others. Once a clue file has been created, bughelper will include the information it contains in future searches. The above example represents just a simple search string, but you can get more targeted searches by adding more conditions to your clue files. Read [:BugHelper/doc/writing-clue-files:doc/writing-clue-files] for further information on file structure and sharing the search data with others.

= Further reading =

 1. '''[:BugHelper/doc/options]''' - Command line options explained
 1. '''[:BugHelper/doc/writing-clue-files]''' - Help on writing your own clues
 1. '''[:BugHelper/doc/components]''' - O
veriew of component applications of bughelper
Line 71: Line 77:
Go back to '''[:BugHelper/Dev]'''.[[BR]] Go back to '''[:BugHelper]'''.[[BR]]

Installing

Since 7.04 (Feisty Fawn)

It's packaged in universe, so installing is easy:

{{{sudo apt-get install bughelper }}}

On other systems

You need to have bazaar installed: "sudo apt-get install bzr". Then proceed as follows.

Get the bughelper source from Launchpad:

bzr co http://bazaar.launchpad.net/~bughelper-dev/bughelper/main
bzr co http://bazaar.launchpad.net/~bughelper-dev/python-launchpad-bugs/main python-launchpad-bugs
cd bughelper.main
ln -s ../python-launchpad-bugs/launchpadBugs

Initial configuration

When you run bughelper for the first time it will create a ~/.bughelper/ directory and a ~/.bughelper/config file. It will also check out a copy of the latest shared clue files from the bughelper project on Launchpad.

A simple search

When you've downloaded the shared clue files you are ready to start searching for bugs fitting certain pre-defined patterns.

Try it first with a small package:

{{{$ bughelper -p vino }}}

The result should be a listing of vino bugs with their status and a suggestion of how they may be related to other known bugs. This type of search, looking for known patterns in open bugs, can be useful in finding new instances of known duplicates.

However, sometimes you may be approaching the problem form the other direction. You are working with a given bug and you want to look for similar bugs, either open or closed. In that case you'll want to define your own search terms:

{{{bughelper -T vino "crash" "A CRASHER BUG" -p vino }}}

Where the first entry in quotes is the string you want to search for and the second is the information that bughelper presents on finding it. By changing the search string you can explore the bug reports filed against a given package for common traits. Note that on larger packages each search will take some time.

Clue files

Once you have found a useful search pattern, you'll probably want to store it for future use, and for that we use clue files. To store the search you have just completed, use bugxml:

{{{bugxml -a vino "crash" "A CRASHER BUG" }}}

This will create a new XML file with the simple clue defined by the search string and text output, like:

{{{<?xml version="1.0"?> <clues version="0.1">

  • <clue>

    • <contains>

      • <op>crash</op>

      </contains> <info>A CRASHER BUG</info>

    </clue>

</clues> }}}

Note: creating clues with bugxml requires that you have added a local package directory to your ~/.bughelper/config file.

Once a clue file has been created, bughelper will include the information it contains in future searches. The above example represents just a simple search string, but you can get more targeted searches by adding more conditions to your clue files. Read [:BugHelper/doc/writing-clue-files:doc/writing-clue-files] for further information on file structure and sharing the search data with others.

Further reading

  1. [:BugHelper/doc/options] - Command line options explained

  2. [:BugHelper/doc/writing-clue-files] - Help on writing your own clues

  3. [:BugHelper/doc/components] - Overiew of component applications of bughelper


Go back to [:BugHelper].BR CategoryBugSquad

BugHelper/doc/getting-started (last edited 2010-01-25 21:19:35 by 39)