added a `permissions` example with just a per-user-throttle which we may want to expand with some auth examples.

3 files changed, 26 insertions, 0 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