tahrir

tahrir is Arabic for Liberation.

tahrir is also a Pyramid app for issuing your own Open Badges.

The name is total overkill.

Installing

$ sudo pip install tahrir

Building a configuration file

Get a sample configuration file:

$ wget https://raw.github.com/ralphbean/tahrir/master/production.ini -O tahrir.ini

And edit it to your liking. In particular you will need to change the following values under the [server:main] section:

• host = yoursite.com
• port = 80

And the following values under the [app:pyramid] section:

• tahrir.salt = "whatever you want"
• tahrir.admin = "some super secret string used to login as admin"
• tahrir.title = "just badgin' around"
• tahrir.pngs.uri = /home/user/badges/pngs
• tahrir.base_url = "yoursite.com"

Setting up the DB

$ initialize_tahrir_db tahrir.ini

Running

$ pserve tahrir.ini

Reporting Bugs

If you find bugs in Tahrir or have ideas for enhancements, please report them at http://github.com/ralphbean/tahrir/issues.

Hacking

If you'd like to contribute to tahrir or just poke at the code, you can use the following instructions to set up a development environment.

$ sudo yum -y install python-virtualenvwrapper
$ git clone git://github.com/ralphbean/tahrir.git
$ cd tahrir
$ mkvirtualenv tahrir
(tahrir)$ python setup.py develop
(tahrir)$ initialize_tahrir_db development.ini
(tahrir)% pserve --reload development.ini