English
资源说明：show top downloads in a certain period of time in redis
downloads-redis
===============
使用redis存储并且获取站点资源下载数量在一段时间内 (每天/周/月) 的统计数据。
show top downloads in a certain period of time in redis
安装
--------
* 安装pip(如果没有安装过的话)： `easy_install pip`
* 安装downloads-redis： `pip install -e git://github.com/fengli/downloads-redis.git`
快速使用
--------
使用非常简单，当然你需要首先启动redis
```bash
redis-server
```
之后你就可以这样使用downloads模块：
```python
import downloads
md = downloads.Download ()
# 每当有一次下载的时候，你需要使用incr纪录这次下载。downloads模块会
# 自动加上下载的时间标签
md.incr ('item1') #increase the download count for 'item1'
md.incr ('item2') #increase the download count for 'item2'
md.incr ('item2') #increase the download count for 'item2'
#get the top 50 most downloads today
items = md.most_downloads_today (50)
print items
[('item2',2.0), ('item1', 1.0)]
items = md.most_downloads_in_past_week (100)
items = md.most_downloads_all_time (50)
```
就是这么简单!
详细的接口描述：
------------
```python
def most_downloads_today (self, n=50)
"""
返回今天top n的下载, default n=50
"""
def most_downloads_all_time (self, n=50):
"""
返回所有时间内的top n下载, default n=50
"""
def most_downloads_in_past_week (self, n=50):
"""
返回最近7天内的top n下载, default n=50
"""
def most_downloads_in_past_month (self, n=50):
"""
返回最近31天内的top n下载，default n=50
"""
def most_downloads_in_past_week_complex (self, n=50):
"""
返回最近7天内的top n下载，并且返回top n下载最近7天内每天的下载量
"""
def most_downloads_in_past_month_complex (self, n=50):
"""
返回最近30天内top n下载，并且返回top n下载最近7天内每天的下载量
"""
def delete_all_keys (self):
"""
删除redis中所有的跟downloads关联的key.
"""
def __init__ (self, modelname='item', redisaddr="localhost", db=5, cache=True):
"""
modelname 使得你可以使用downloads模块跟踪多个不同类型的下载量
cache 是否cache最近7天/30天的统计数据 (5分钟后expire), default=True
"""
```
pull request
-----------------
开源最美好的事情就是大家可以共同的修改并且随时保持更新，所以如果你觉得
需要添加某个feature，可以随时向我们发起pull request.
Bring to you by:
--------------------
* 爱看豆: http://ikandou.com
本源码包内暂不包含可直接显示的源代码文件，请下载源码包。
