merge markos throttling example

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'),
+)

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."

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')}
+                ]

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')),
 )