status-report-scripts parseBZbugList,1.28,1.29

[Christian Iseli (c4chris)]

Author: c4chris

Update of /cvs/fedora/status-report-scripts
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv4617

Modified Files:
	parseBZbugList 
Log Message:
Added usage doc.


Index: parseBZbugList
===================================================================
RCS file: /cvs/fedora/status-report-scripts/parseBZbugList,v
retrieving revision 1.28
retrieving revision 1.29
diff -u -r1.28 -r1.29
--- parseBZbugList	19 Apr 2006 10:17:11 -0000	1.28
+++ parseBZbugList	19 Apr 2006 10:18:01 -0000	1.29
@@ -1,11 +1,70 @@
 #!/usr/bin/env perl
 # $Id$
 
+# This script parses a CSV formatted Bug List and extract info on various
+# aspects of package review tickets. FE-ACCEPT blockers are checked to
+# determine whether closed tickets have their corresponding package in the
+# development repo and in the owners file, and whether still open ticket could
+# be closed. FE-NEW and FE-REVIEW blockers are checked to verify they are not
+# closed.
+#
+# To run this script, you will need the following data:
+#
+#   * one or more CSV formatted files containing the bug lists with the
+#     following columns:
+#    1.  ID
+#    2.  Open Date
+#    3.  Changed Date
+#    4.  Assignee
+#    5.  Reporter
+#    6.  Status
+#    7.  Resolution
+#    8.  Blocked By
+#    9.  Summary
+#   * the URL of packages available in the FE development repo (defaults to
+#     http://mirrors.kernel.org/fedora/extras/development/SRPMS/)
+#   * the URL of packages available in the FE release repo (defaults to
+#     http://mirrors.kernel.org/fedora/extras/5/SRPMS/)
+#   * the URL of packages available in the FC development repo (defaults to
+#     http://mirrors.kernel.org/fedora/core/development/SRPMS/)
+#   * the URL of packages available in the FC release repo (defaults to
+#     http://mirrors.kernel.org/fedora/core/5/source/SRPMS/)
+#   * the URL to a short list linking BZ ticket numbers with package names,
+#     used when the script can't deduce the package name automatically from
+#     the summary. (defaults to bzId_pkg.txt)
+#   * the owners.list file
+#   * the URL to a wiki page containing the list of migrated/retired packages
+#     (defaults to Extras/PackagesNoLongerInDevel)
+#   * a full CVS checkout of Fedora Extras packages
+
 # Grab BZ tickets through:
 # https://bugzilla.redhat.com/bugzilla/showdependencytree.cgi?id=FE-NEW
 # https://bugzilla.redhat.com/bugzilla/showdependencytree.cgi?id=FE-REVIEW
 # https://bugzilla.redhat.com/bugzilla/showdependencytree.cgi?id=FE-ACCEPT
 
+# Getting a CSV file from the above 3 URLs is not too hard:
+#  - once the page is loaded, select the "view as bug list" link
+#  - ensure you have the proper selection of columns to display, as detailed
+#    above, and if not adjust the selection through the "Change Columns" link
+#    at the bottom of the page
+#  - select the "CSV" link at the bottom of the page
+
+# Obtaining the list of open tickets is slightly more complex:
+#  - go to the advanced search page and select:
+#   product:    "Fedora Extras"
+#   version:    4 + 5 + devel
+#   component:  leave blank
+#   status:     NEW + ASSIGNED + REOPENED + MODIFIED
+#   resolution: leave blank
+#   severity:   select all except "enhancement"
+#   priority:   leave blank
+#   platform:   leave blank
+#  - in the "Advanced Searching Using Boolean Charts" section, add:
+#   Component is equal to Package Review, and select the "negated" box
+#  - perform the search and save the CSV as above (you can also save the query
+#    itself)
+
+
 # TODO stuff
 #  See why count in "Inactive maintainers with open bug reports" is strange.
 #  Check contents of comps.xml file (missing packages,