File: README.examples

package info (click to toggle)
popularity-contest 0.1-2
  • links: PTS
  • area: main
  • in suites: slink
  • size: 92 kB
  • ctags: 46
  • sloc: python: 195; sh: 105; makefile: 39
file content (34 lines) | stat: -rw-r--r-- 1,464 bytes parent folder | download | duplicates (4)
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

This directory contains some scripts used to post-process popularity-contest
entries.  You should have a lot of submissions from different users (at
least 100 of them, if possible) for these results to be valid.

To collect results, use procmail or some other mail alias to e-mail
submissions to a file called, say, new-popcon-entries.

You should run popcon-process.sh once a day, or so.  It calls prepop.py to
split the mailbox file into a directory (popcon-entries) with one file per
submission, and only one submission per participant.  (Since each
participant makes a submission only once per day, it's very important to
remove duplicates.)

HINT: if you have an account on master.debian.org, you can find a
pre-processed popcon-entries directory in /home/apenwarr.  Feel free to use
these files to generate your own statistics.

Now you can do, for example:

	cat popcon-entries/*/* | popanal.py
	
which creates a bunch of files named results.soemthing-or-other, with one
"results" file per Debian package section.  Output lines look like this:

   <name> <vote> <old> <recent-ctime> <no-files>
   
<name> is the package name;
<vote> is the number of people who use this package regularly;
<old> is the number of people who installed, but don't use this package
	regularly;
<recent-ctime> is the number of people who upgraded this package recently;
<no-files> is the number of people whose entry didn't contain enough
	information (atime and ctime were 0).