~gnarea/wsgi-xsendfile/main

« back to all changes in this revision

Viewing changes to README.txt

  • Committer: Gustavo Narea
  • Date: 2010-05-18 14:23:30 UTC
  • Revision ID: gnarea@tech.2degreesnetwork.com-20100518142330-nl4x7ewpjslhovlo
Renamed project to wsgi-xsendfile

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
*****************************************
2
 
wsgi-auth-token -- Token-based URL access
3
 
*****************************************
4
 
 
5
 
WSGI Auth Token allows you to generate links to static files for a fixed period
6
 
of time; once the link expires, the file is no longer available.
7
 
 
8
 
It's very performant because it doesn't serve the file by itself: It tells the
9
 
server whether the file can be downloaded and where it is, and then the server
10
 
itself serves it.
11
 
 
12
 
It is a light replacement for Apache's mod_auth_token implemented as a Python
13
 
WSGI application but you can use it with your Java/PHP/whatever applications.
 
1
*********************************************************
 
2
wsgi-xsendfile -- ``X-Sendfile`` implementation in Python
 
3
*********************************************************
 
4
 
 
5
``X-Sendfile`` is a feature in Web servers which allow you to tell the Web
 
6
server which static files in the filesystem it should serve. It works like this:
 
7
The Web server gets an HTTP request which is passed on to your application,
 
8
the application returns the path to the file in the filesystem that should be
 
9
served (if any), and finally the Web **itself** serves the file.
 
10
 
 
11
You can use this for a number of things, like controlling access to static
 
12
files, or dispatching them in a custom way.
 
13
 
 
14
This is implemented as a Python WSGI application.
 
15
 
 
16
A replacement for Apache's `mod-auth-token
 
17
<http://code.google.com/p/mod-auth-token/>`_, based on the ``X-Sendfile``
 
18
application is also part of the distribution. It can be used along with any
 
19
Web application, even if it's not written in Python.
14
20
 
15
21
This project is sponsored by 2degrees Limited: http://dev.2degreesnetwork.com/