README


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

DIRS
====

dbgenerator: stuff to generate a pgo.db file
template:    the initial template contributed by cla
web:         web-frontend to the pgo.db file
pkgcore:     pkgcore version in case you don't have one set up 
             and use PYTHONPATH=.
snakeoil:    same as pkgcore, both are taken from post-0.3.1 HEAD

REQUIREMENTS
============

dbgenerator:
------------
- up-to-date portage tree
  (non-unionfs'ed as it might give weird mtimes)
- Python 2.5 with sqlite or Python 2.4 with pysqlite2
- optional: pkgcore and snakeoil (both shipped)

generation time:
at the time of writing, on my box (3ghz p4, udma100 hdd, partly cluttered fs)
db generation takes about 3 minutes

frontend:
---------
CherryPy 3.0.2 or later
Genshi 0.4.3 or later
- Python 2.5 with sqlite or Python 2.4 with pysqlite2

it can be used both standalone or together with mod_python

GETTING IT GOING
================

1) Pick a box to get the db generated
2) cd dbgenerator && python core.py

pick up the resulting pgo.db file 

4) move the db file so that it resides in the dir you run the CherryPy
   controller from, in this example I'd recomment sticking it into
   the dir of this README

5) start CherryPy standalone:
   PYTHONPATH=. python web/controller.py

   this should give you something like
   "HTTP Serving HTTP on http://0.0.0.0:8080/"

6) now point a webbrowser at http://localhost:8080/
   and you should see the packages.gentoo.org site