Mon projet d'écriture de la n-ième version 2 de Freetorrent... en Python
Python
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
about
common
forum
root
static
torrents
user
.gitignore
.htaccess
README
index.py
upgrade_db.sql

README

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.