From 37db771cb97052cdf4890dc47168b995d80ee64e Mon Sep 17 00:00:00 2001
From: markotibold <none@none>
Date: Mon, 20 Jun 2011 01:10:25 +0200
Subject: [PATCH 1/3] added a `permissions` example with just a
 per-user-throttle which we may want to expand with some auth examples.

---
 examples/sandbox/views.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/examples/sandbox/views.py b/examples/sandbox/views.py
index 1c55c28f2..1e326f432 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')}
+                ]

From ef8c286f86027b2f7ebea2232730bd7340f20075 Mon Sep 17 00:00:00 2001
From: markotibold <none@none>
Date: Mon, 20 Jun 2011 01:11:08 +0200
Subject: [PATCH 2/3] added a `permissions` example with just a
 per-user-throttle which we may want to expand with some auth examples.

---
 examples/permissionsexample/__init__.py |  0
 examples/permissionsexample/urls.py     |  6 ++++++
 examples/permissionsexample/views.py    | 20 ++++++++++++++++++++
 3 files changed, 26 insertions(+)
 create mode 100644 examples/permissionsexample/__init__.py
 create mode 100644 examples/permissionsexample/urls.py
 create mode 100644 examples/permissionsexample/views.py

diff --git a/examples/permissionsexample/__init__.py b/examples/permissionsexample/__init__.py
new file mode 100644
index 000000000..e69de29bb
diff --git a/examples/permissionsexample/urls.py b/examples/permissionsexample/urls.py
new file mode 100644
index 000000000..d17f5159a
--- /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 000000000..20e7cba7a
--- /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

From 1692942ec2eaf211777d2dbb30ae6cf9dd52177f Mon Sep 17 00:00:00 2001
From: markotibold <none@none>
Date: Mon, 20 Jun 2011 01:11:45 +0200
Subject: [PATCH 3/3] added a `permissions` example with just a
 per-user-throttle which we may want to expand with some auth examples.

---
 examples/urls.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/examples/urls.py b/examples/urls.py
index cf4d4042c..08d97a14a 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')),
 )