merge markos throttling example

5 files changed, 30 insertions, 1 deletions

diff --git a/examples/permissionsexample/__init__.py b/examples/permissionsexample/__init__.py
new file mode 100644
index 00000000..e69de29b
--- /dev/null
+++ b/examples/permissionsexample/__init__.py
diff --git a/examples/permissionsexample/urls.py b/examples/permissionsexample/urls.py
new file mode 100644
index 00000000..d17f5159
--- /dev/null
+++ b/examples/permissionsexample/urls.py
@@ -0,0 +1,6 @@
+from django.conf.urls.defaults import patterns, url
+from permissionsexample.views import ThrottlingExampleView
+
+urlpatterns = patterns('',
+    url(r'^$',                 ThrottlingExampleView.as_view(), name='throttled-resource'),
+)
diff --git a/examples/permissionsexample/views.py b/examples/permissionsexample/views.py
new file mode 100644
index 00000000..20e7cba7
--- /dev/null
+++ b/examples/permissionsexample/views.py
@@ -0,0 +1,20 @@
+from djangorestframework.views import View
+from djangorestframework.permissions import PerUserThrottling
+
+
+class ThrottlingExampleView(View):
+    """
+    A basic read-only View that has a **per-user throttle** of 10 requests per minute.
+    
+    If a user exceeds the 10 requests limit within a period of one minute, the
+    throttle will be applied until 60 seconds have passed since the first request.
+    """
+    
+    permissions = ( PerUserThrottling, )
+    throttle = '10/min'
+    
+    def get(self, request):
+        """
+        Handle GET requests.
+        """
+        return "Successful response to GET request because throttle is not yet active."
\ No newline at end of file
diff --git a/examples/sandbox/views.py b/examples/sandbox/views.py
index 1c55c28f..1e326f43 100644
--- a/examples/sandbox/views.py
+++ b/examples/sandbox/views.py
@@ -31,4 +31,6 @@ class Sandbox(View):
                 {'name': 'Simple Mixin-only example', 'url': reverse('mixin-view')},
                 {'name': 'Object store API', 'url': reverse('object-store-root')},
                 {'name': 'Code highlighting API', 'url': reverse('pygments-root')},
-                {'name': 'Blog posts API', 'url': reverse('blog-posts-root')}]
+                {'name': 'Blog posts API', 'url': reverse('blog-posts-root')},
+                {'name': 'Permissions example', 'url': reverse('throttled-resource')}
+                ]
diff --git a/examples/urls.py b/examples/urls.py
index cf4d4042..08d97a14 100644
--- a/examples/urls.py
+++ b/examples/urls.py
@@ -10,6 +10,7 @@ urlpatterns = patterns('',
     (r'^object-store/', include('objectstore.urls')),
     (r'^pygments/', include('pygments_api.urls')),
     (r'^blog-post/', include('blogpost.urls')),
+    (r'^permissions-example/', include('permissionsexample.urls')),
 
     (r'^', include('djangorestframework.urls')),
 )