~jpds/arsenal/css-subscribed

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
                          ---== Arsenal ==---

Arsenal is a framework for tools to interact with the Launchpad bug
tracker.


== Dependencies ==

* launchpadlib

* python-launchpadlib-toolkit:
   + apt-get install python-launchpadlib-toolkit  # Maverick and newer
   ...or...
   + bzr branch lp:~arsenal-devel/arsenal/python-launchpadlib-toolkit
   + cd python-launchpadlib-toolkit && sudo python setup.py install

* Template-Python:
   + svn co svn://svn.tt2.org/tt/Template-Python/trunk Template-Python
   + cd Template-Python && sudo python setup.py install

* bzutils
   + sudo apt-get install python-bzutils

* python-genshi
   + apt-get install python-genshi



Ubuntu Bug Report Kit
=====================

Scripts
-------------------
* reports/cbd - "collect bug data".
        A script which takes a JSON formatted input/configuration file,
        and searches Launchpad for the relevant bugs. The task search
	is done using the LP distribution object.

* reports/cbd-projects
	Exactly the same as cbd above except the task search is done
	using LP project objects.

* reports/reporter
        A script that takes a JSON data file, created by one of the
	cbd scripts mentioned above, and passes that data to a mako
	template file for creating html files.

* reports/cache-lp-resources
	Takes a csv file of project<->team pairs and creates a JSON
	file which is used by the cbd script. The csv file is obtained
	by downloading a google document.

Directories
-------------------

reports/hwe
	The Hardware Enablement teams configuration files. There is
	also a script for generating all the reports.

reports/kernel
	Just a placeholder for now

reports/media
	All the javascript, css and image files that are used on
	the generated web pages.

reports/qa
	The configuration files for the QA teams html reports. There
	is also a Makefile for generating all the reports.

reports/rls-mgr
	The configuration files for the release managers reports.
	There is also a Makefile for generating all the reports.

reports/templates
	The mako templates that are used to generate the different
	reports.

reports/arsenal
	The python modules that are used by the various scripts.


Development
===========
When doing development on Arsenal, create two checkouts in your local
directory:

  arsenal
  arsenal-trunk

Do your work on the arsenal tree and commit all of your changes there.
When you're ready to upload, do this:

  1.  cd arsenal-trunk && bzr pull

  2.  cd ../arsenal && bzr merge ../arsenal-trunk

  3.  cd ../arsenal-trunk && bzr merge ../arsenal

  4.  bzr commit

  5.  bzr push

This way helps preserve the log history.  If you just do bzr merge into
your working tree and then bzr push, the trunk changes you merged in
will have their revision numbers re-numbered, which can cause some
confusion.