add decorator and consistant file comments

Author: Marco DiDomenico

README.rst

@@ -63,6 +63,13 @@ In templates
 
 Note: you can pass `next` query parameter to the authorize view to direct the user to correct page after OAuth flow has completed successfully.  Default will send user to '/'
 
+In views as a decorator: this will kick off the Authorization flow or Refresh request (if token is expired) and will send the user back to the original requested url on completion
+::
+	from replyify_oauth2.decorators import replyify_auth_required
+
+	@replyify_auth_required
+	def my_view_that_needs_replyify(request):
+		...
 
 Using the Replyify API
 ----------------------

README.md renamed to _README.md

@@ -3,9 +3,8 @@
 
 #
 # This file is subject to the terms and conditions defined in
-# file 'LICENSE.md', which is part of this source code package.
+# file 'LICENSE', which is part of this source code package.
 #
-
 from django import VERSION as DJANGO_VERSION
 if DJANGO_VERSION >= (1, 7):
     default_app_config = 'replyify_oauth2.apps.ReplyifyOAuth2Config'

replyify_oauth2/__init__.py

@@ -3,9 +3,8 @@
 
 #
 # This file is subject to the terms and conditions defined in
-# file 'LICENSE.md', which is part of this source code package.
+# file 'LICENSE', which is part of this source code package.
 #
-
 from django.contrib import admin
 from django.contrib.auth import get_user_model
 from . import settings

replyify_oauth2/admin.py

@@ -3,9 +3,8 @@
 
 #
 # This file is subject to the terms and conditions defined in
-# file 'LICENSE.md', which is part of this source code package.
+# file 'LICENSE', which is part of this source code package.
 #
-
 from __future__ import unicode_literals
 from django import VERSION as DJANGO_VERSION
 

replyify_oauth2/apps.py

@@ -0,0 +1,24 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+#
+# This file is subject to the terms and conditions defined in
+# file 'LICENSE', which is part of this source code package.
+#
+from functools import wraps
+from django.core.urlresolvers import reverse
+from django.shortcuts import redirect
+from .models import Credentials
+
+
+def replyify_auth_required(func):
+    def decorator(func):
+        def inner_decorator(request, *args, **kwargs):
+            try:
+                if Credentials.objects.get(user=request.user).is_valid():
+                    return func(request, *args, **kwargs)
+            except Credentials.DoesNotExsit:
+                return redirect(reverse('replyfy:authorize') + '?next=' + request.GET.get('next', request.path))
+            return redirect(reverse('replyfy:refresh') + '?next=' + request.GET.get('next', request.path))
+        return wraps(func)(inner_decorator)
+    return decorator(func)

replyify_oauth2/decorators.py

@@ -1,5 +1,10 @@
+#!/usr/bin/env python
 # -*- coding: utf-8 -*-
-# Generated by Django 1.11 on 2017-04-11 21:18
+
+#
+# This file is subject to the terms and conditions defined in
+# file 'LICENSE', which is part of this source code package.
+#
 from __future__ import unicode_literals
 
 from django.conf import settings

replyify_oauth2/migrations/0001_initial.py

@@ -3,5 +3,5 @@
 
 #
 # This file is subject to the terms and conditions defined in
-# file 'LICENSE.md', which is part of this source code package.
+# file 'LICENSE', which is part of this source code package.
 #

replyify_oauth2/migrations/__init__.py

@@ -3,9 +3,8 @@
 
 #
 # This file is subject to the terms and conditions defined in
-# file 'LICENSE.md', which is part of this source code package.
+# file 'LICENSE', which is part of this source code package.
 #
-
 from __future__ import unicode_literals
 from django.conf import settings
 from django.db import models
@@ -22,10 +21,13 @@ class Credentials(models.Model):
     updated = models.DateTimeField(auto_now=True)
     created = models.DateTimeField(auto_now_add=True)
 
-    def expired(self):
+    def is_expired(self):
         if timezone.now() > self.expires:
             return True
         return False
 
+    def is_valid(self):
+        return not self.is_expired()
+
     def __unicode__(self):
         return '<Replyify Creds: {}>'.format(self.access_token)

replyify_oauth2/models.py

@@ -3,7 +3,7 @@
 
 #
 # This file is subject to the terms and conditions defined in
-# file 'LICENSE.md', which is part of this source code package.
+# file 'LICENSE', which is part of this source code package.
 #
 from django.conf import settings