supybot/plugins/Judd/README

   1 Judd: A supybot plugin to view into the Ultimate Debian Database
   2 ===============================================================
   3
   4 Data
   5 ====
   6 * Ultimate Debian Database -- packages, sources, bugs
   7   Running on same host with permanent db connection from bot to db.
   8   Data is updated from cron:
   9     - packages and sources information loaded into the db by the gatherers
  10     - bugs data loaded from SQL snapshot of udd.debian.org
  11 * Contents files
  12   Files from mirror searched using zgrep.
  13   Data is updated by udd cron jobs.
  14 * Alternatives list
  15   Snapshot generated periodically by Jakub Wilk.
  16     - wget http://people.debian.org/~jwilk/alternatives/Contents -O- |
  17         gzip -c > supybot/data/judd/debian-sid/main/Contents-alt.gz
  18
  19
  20 Maintenance notes for UDD
  21 =========================
  22
  23 udd oldstable removal actions:
  24 * update cron job (~/bin/udd-update-stable)
  25 * stop importing oldstable (config-judd/Makefile)
  26 * delete oldoldstable data from database:
  27   psql
  28     => SELECT count(*) FROM packages WHERE release LIKE 'lenny%';
  29     num archs * num packages (200k?)
  30     => DELETE FROM packages WHERE release LIKE 'lenny%';
  31     => SELECT count(*) FROM sources WHERE release LIKE 'lenny%';
  32     num src packages (15k?)
  33     => DELETE FROM sources WHERE release LIKE 'lenny%';
  34 * delete oldoldstable data from disk cache
  35     /srv/mirrors/debian/dists/lenny /srv/mirrors/debian-backports/dists/lenny-backports /srv/mirrors/debian-backports/dists/lenny-backports-sloppy /srv/mirrors/debian-security/lenny /srv/mirrors/debian-multimedia.org/dists/lenny /srv/mirrors/debian-volatile
  36 * add oldoldstable to the list of old timestamps to ignore in udd-check-updates
  37
  38 udd release actions:
  39 * update cron jobs (~/bin/udd-update-{stable,changing})
  40 * update archs with release architectures (config-judd/archlist)
  41 * check components (volatile vs updates, backports-sloppy etc:
  42   config-judd/config-generic-release.yaml)
  43
  44 udd new testing actions:
  45 * add new testing (config-judd/Makefile)
  46 * update cron jobs (~/bin/udd-update-changing)
  47 * update archs (config-judd/archlist)
  48
  49
  50 Maintenance notes for Judd
  51 ==========================
  52
  53 judd oldstable removal:
  54 * shift/remove oldstable alias in uddcache/data.py
  55 * fix tests that no longer work :(
  56 * delete unneeded contents links from supybot/data/judd
  57
  58 judd release actions:
  59 * add new -backports, -backports-sloppy, -updates etc in uddcache/data.py
  60 * shift stable alias in uddcache/data.py
  61
  62 judd new testing actions
  63 * add new (testing) release to plugin.py
  64 * shift testing alias
  65 * mkcontentslinks
  66
  67
  68 Miscellaneous configuration options for the bot
  69 ===============================================
  70
  71 The following commands are highly recommended for the bot:
  72
  73 load Alias
  74 defaultcapability add -Alias.add
  75 defaultcapability add -Alias.remove
  76 alias add whatprovides rprovides $*
  77 alias add source src $*
  78 alias add maintainer maint $*
  79 alias add uploader maint $*
  80 alias add changer maint $*
  81 alias add arches archs $*
  82 alias add version versions $*
  83 alias add v versions $*
  84 alias add i info $*
  85
  86 alias add find file $*
  87 alias add alternatives alternative $*
  88
  89 alias add rfs bug rfs $*
  90 alias add wnpp bug wnpp $*
  91
  92 defaultplugin source Alias
  93 defaultplugin version Alias
  94
  95 alias add bot echo No, I'm not a bot, I'm a frontend to a database.
  96
  97 In #debian-next:
  98 ----------------
  99 config channel supybot.plugins.Judd.default_release testing
 100
 101 In #debian-mentors:
 102 -------------------
 103 config channel supybot.plugins.Judd.default_release sid
 104
 105