File: README.examples

package info (click to toggle)
popularity-contest 1.41
  • links: PTS
  • area: main
  • in suites: etch, etch-m68k
  • size: 440 kB
  • ctags: 78
  • sloc: perl: 858; python: 299; sh: 209; makefile: 41
file content (33 lines) | stat: -rw-r--r-- 1,403 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

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.pl 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 popcon.debian.org, you can find a pre-processed
popcon-entries directory in /org/popcon.debian.org/popcon-mail.  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 file named results.  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).