django-ratelimit 0.1

Cache-based rate-limiting for Django

  Add it to your Download Basket!

 Add it to your Watch List!


Rate it!
send us
an update
BSD License 
James Socol
ROOT \ Internet \ HTTP (WWW)
django-ratelimit is a Django app that provides a decorator to rate-limit views. Limiting can be based on IP address or a field in the request--either a GET or POST variable.

If the rate limit is exceded, either a 403 Forbidden can be sent, or the request can be annotated with a limited attribute, allowing you to take another action like adding a captcha to a form.

Using Django Ratelimit

from ratelimit.decorators import ratelimit is the biggest thing you need to do. The @ratelimit decorator provides several optional arguments with sensible defaults (in italics).
ip: Whether to rate-limit based on the IP. True
block: Whether to block the request instead of annotating. False
method: Which HTTP method(s) to rate-limit. May be a string or a list. all
field: Which HTTP field(s) to use to rate-limit. May be a string or a list. none
rate: The number of requests per unit time allowed. 5/m


def myview(request):
 # Will be true if the same IP makes more than 5 requests/minute.
 was_limited = getattr(request, 'limited', False)
 return HttpResponse()

def myview(request):
 # If the same IP makes >5 reqs/min, will return HttpResponseForbidden
 return HttpResponse()

def login(request):
 # If the same username OR IP is used >5 times/min, this will be True.
 # The `username` value will come from GET or POST, determined by the
 # request method.
 was_limited = getattr(request, 'limited', False)
 return HttpResponse()

def login(request):
 # Only apply rate-limiting to POSTs.
 return HttpResponseRedirect()

@ratelimit(field=['username', 'other_field'])
def login(request):
 # Use multiple field values.
 return HttpResponse()

def slow(request):
 # Allow 4 reqs/hour.
 return HttpResponse()

Last updated on May 23rd, 2011


#Django decorator #rate-limit views #cache rate-limiting #Django #rate-limit #decorator #cache

Add your review!