Web server
==========

Software
--------

I use Apache with mod_wsgi, both from Debian repository (in apache2 package).

Configuration
-------------

This is a sample configuration you can edit to fit your own needs, available
under CC-0 licence.

<VirtualHost *:80>
	ServerName freetorrent

	DocumentRoot /home/progval/workspace/Freetorrent
	<Directory "/home/progval/workspace/Freetorrent">
		Options Indexes MultiViews FollowSymLinks +ExecCGI
		Order allow,deny
		Allow from all
	</Directory>
	<Location />
		Options Indexes MultiViews FollowSymLinks +ExecCGI
		SetHandler wsgi-script
		Order allow,deny
		Allow from all
	</Location>
	<Location '/static'>
		SetHandler None
	</Location>

	TransferLog /var/log/apache2/freetorrent.log
</VirtualHost>

Database
========

Engines
-------

This software was designed, at the early start, to use SQLite database, but
MySQL appears to be better for our needs; that's why MySQL is used as main
database, and SQLite only stores cache (in RAM).

Configuration
-------------

All configuration is in common/db.py file. As this software is not
designed to be distributed (but distributed because libre software is
the Good), there is no real configuration file.

Required softwares
==================

This software are not embedded in Freetorrent source, either because they
are enough famous to be package, or because they are easily installable,
or because of licensing issue.

Postmarkup
----------

The BBCode parser Freetorrent uses is Postmarkup, available under the new
BSD license. It can be found at http://code.google.com/p/postmarkup/

Pygments
--------

As Postmarkup provides the [code] tag, that colors code, Pygment (also
distributed under BSD license) can be install to render [code].
Pygments can be found at http://pygments.org/ and is available in repository
of most of GNU/Linux distributions.

Unidecode
---------

The module used to remove accents, in order to get titles without special
characters is Unidecode (Perl license). It can be found at
http://pypi.python.org/pypi/Unidecode. note that the
libtext-unidecode-perl Debian package is for Perl and not for Python, so
it is not compatible.

Library embedded in Freetorrent source
======================================

The fellowing software are embedded in Freetorrent source, either because they
are not installable, or Freetorrent doesn't need all the library, or they must
be edited.

Pesto
-----

The Cookie lib of Pesto library is used for cookies handling, and is
embedded in Freetorrent source (common/lib/pesto/cookie.py)

HunnyB
------

This library provides Bencode encoder/decoder and is avaiblable under MIT
license.
Two lines has been removed, to disable unwanted exception raising.