Flask-Limiter

Flask-Limiter provides rate limiting features to flask routes. It has support for a configurable backend for storage with current implementations for in-memory, redis and memcache.

Quickstart

Add the rate limiter to your flask app. The following example uses the default in memory implementation for storage.

from flask import Flask
from flask_limiter import Limiter

app = Flask(__name__)
limiter = Limiter(app, global_limits=["2 per minute", "1 per second"])

@app.route("/slow")
@limiter.limit("1 per day")
def slow():
    return "24"

@app.route("/fast")
def fast():
    return "42"

@app.route("/ping")
@limiter.exempt
def ping():
    return 'PONG'

app.run()

Test it out. The fast endpoint respects the global rate limit while the slow endpoint uses the decorated one. ping has no rate limit associated with it.

$ curl localhost:5000/fast
42
$ curl localhost:5000/fast
42
$ curl localhost:5000/fast
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<title>429 Too Many Requests</title>
<h1>Too Many Requests</h1>
<p>2 per 1 minute</p>
$ curl localhost:5000/slow
24
$ curl localhost:5000/slow
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<title>429 Too Many Requests</title>
<h1>Too Many Requests</h1>
<p>1 per 1 day</p>
$ curl localhost:5000/ping
PONG
$ curl localhost:5000/ping
PONG
$ curl localhost:5000/ping
PONG
$ curl localhost:5000/ping
PONG

Read the docs

Changelog

0.4.4 2014-06-13

Bug fix
- Werkzeug < 0.9 Compatibility (Issue 6.)

0.4.3 2014-06-12

Hotfix : use HTTPException instead of abort to play well with other extensions.

0.4.2 2014-06-12

Allow configuration overrides via extension constructor

0.4.1 2014-06-04

Improved implementation of moving-window X-RateLimit-Reset value.

0.4 2014-05-28

Rate limiting headers

0.3.2 2014-05-26

Bug fix
- Memory leak when using Limiter.storage.MemoryStorage (Issue 4.)
Improved test coverage

0.3.1 2014-02-20

Strict version requirement on six
documentation tweaks

0.3.0 2014-02-19

improved logging support for multiple handlers
allow callables to be passed to Limiter.limit decorator to dynamically load rate limit strings.
add a global kill switch in flask config for all rate limits.
Bug fixes
- default key function for rate limit domain wasn’t accounting for X-Forwarded-For header.

0.2.2 2014-02-18

add new decorator to exempt routes from limiting.
Bug fixes
- versioneer.py wasn’t included in manifest.
- configuration string for strategy was out of sync with docs.

0.2.1 2014-02-15

python 2.6 support via counter backport
source docs.

0.2 2014-02-15

Implemented configurable strategies for rate limiting.
Bug fixes
- better locking for in-memory storage
- multi threading support for memcached storage

0.1.1 2014-02-14

Bug fixes
- fix initializing the extension without an app
- don’t rate limit static files

0.1.0 2014-02-13

first release.

Metadata

Release files for Flask-Limiter 0.4.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for Flask-Limiter 0.4.4
File	Size	Uploaded
Flask-Limiter-0.4.4.tar.gz	82.5 kB	Jun 13, 2014	Details

Built distribution (wheel)

Table of built distributions (wheels) for Flask-Limiter 0.4.4
File	Interpreter	ABI	Platform	Reset
Flask_Limiter-0.4.4-py2.7.egg 56.4 kB Jun 13, 2014	Legacy Egg format	-	-	Details

Total release size: 138.9 kB

Release files / Flask-Limiter-0.4.4.tar.gz

Download URL	Flask-Limiter-0.4.4.tar.gz
Size	82.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`d4121dbaa05de2772b0d816988f95f9cbec74effbc1e7795c2bc78d16aea81a8`
BLAKE2b-256 checksum How to use checksums	`c22ab4ac9fcb906e1a39d31d3120a42d9790ade6b496819cb61facbb905e1753`
Upload date	Jun 13, 2014
Uploaded using Trusted Publishing? What is trusted publishing?	No

Release files / Flask_Limiter-0.4.4-py2.7.egg

Download URL	Flask_Limiter-0.4.4-py2.7.egg
Size	56.4 kB
Tags	Egg
SHA-256 checksum How to use checksums	`45c672f7ae7e63ab285adcec8f3de368b810ce53dac7c5a2e75bc3144f25bc59`
BLAKE2b-256 checksum How to use checksums	`54164341e366305dd2497a144e91a62e603a687880eeede157e1ae24e5c464b0`
Upload date	Jun 13, 2014
Uploaded using Trusted Publishing? What is trusted publishing?	No