==============
Project Grumpy
==============

Project Grumpy is a maintainer-oriented set of tools for handling various
developer-related metadata.

Requirements
============

  - Python-2.5+
  - pkgcore
  - SQLAlchemy-0.6
  - Flask
  - Flask-OpenID
  - Flask-SQLAlchemy

Database support
----------------

Although main development is aimed towards use of PostgreSQL, most of the
databases supported by SQLAlchemy should work fine.

Database configuration is defined by specifying the RFC-1738 style uri::

  dialect+driver://username:password@host:port/database


Installation
============

Please note that database configuration is currently hardcoded to use
PostgreSQL database named 'grumpy' on localhost using 'grumpy:grumpy' as
credentials. This will be fixed in future ;)

So the first step you need to do, is to give access to user 'grumpy' using
password 'grumpy' to database called 'grumpy' on your local machine.

To setup the app, you need to populate database with proper schema. So fire
up the python interpreter in the root directory of grumpy project:

  $ python
  >>> from grumpy.models import db
  >>> db.create_all()

If no errors were shown, then schema creation was successful :)

Now in order to populate database with portage data, there's utility inside
'utils' directory called 'grumpy_sync.py'. All you have to do for now is to 
give it a path to portage directory as first argument:

  $ python utils/grumpy_sync.py /usr/portage

And now go and fetch yourself a glass of cold milk because this initial sync
will take a while.