| gnatsparse |
| ========== |
| |
| Author: Daniel Berlin <dan@dberlin.org> |
| |
| gnatsparse is a simple Python program that imports a GNATS database |
| into a Bugzilla system. It is based on the gnats2bz.pl Perl script |
| but it's a rewrite at the same time. Its parser is based on gnatsweb, |
| which gives a 10 times speed improvement compared to the previous code. |
| |
| Features |
| -------- |
| |
| * Chunks audit trail into separate comments, with the right From's, times, etc. |
| |
| * Handles followup emails that are in the report, with the right From's, times, |
| etc. |
| |
| * Properly handles duplicates, adding the standard bugzilla duplicate message. |
| |
| * Extracts and handles gnatsweb attachments, as well as uuencoded attachments |
| appearing in either followup emails, the how-to-repeat field, etc. Replaces |
| them with a message to look at the attachments list, and adds the standard |
| "Created an attachment" message that bugzilla uses. Handling them includes |
| giving them the right name and mime-type. "attachments" means multiple |
| uuencoded things/gnatsweb attachments are handled properly. |
| |
| * Handles reopened bug reports. |
| |
| * Builds the cc list from the people who have commented on the report, |
| and the reporter. |
| |
| Requirements |
| ------------ |
| |
| It requires python 2.2+, it won't work with 1.5.2 (Linux distributions |
| ship with 2.2+ these days, so that shouldn't be an issue). |
| |
| Documentation |
| ------------- |
| |
| Documentation can be found inside the scripts. The source code is self |
| documenting. |
| |
| Issues for someone trying to use it to convert a gnats install |
| ----------------------------------- |
| |
| 1. We have three custom fields bugzilla doesn't ship with, |
| gcchost, gcctarget, and gccbuild. |
| We removed two bugzilla fields, rep_platform and op_sys. |
| If you use the latter instead of the former, you'll need to |
| update the script to account for this. |
| 2. Because gcc attachments consist of preprocessed source, all attachments |
| inserted into the attachment database are compressed with zlib.compress. |
| This requires associated bugzilla changes to decompress before sending to |
| the browser. |
| Unless you want to make those changes (it's roughly 3 lines), you'll |
| need to remove the zlib.compress call. |
| 3. You will need to come up with your own release to version mapping and |
| install it. |
| 4. Obviously, any extra gnats fields you have added will have to |
| be handled in some manner. |
