forked from googlearchive/appengine-paging-python
-
Notifications
You must be signed in to change notification settings - Fork 0
/
suggest_unique.py
executable file
·162 lines (120 loc) · 5.51 KB
/
suggest_unique.py
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
#!/usr/bin/env python
# Copyright (C) 2010-2012 Google Inc.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
"""Suggestion Box - An example paging application.
A simple Suggestion Box application that demonstrates paging by creating a
unique value for each suggestion. The uniqueness is created by sharding
counters across all the users of the system.
"""
import datetime
import hashlib
from google.appengine.ext import ndb
from google.appengine.api import users
from google.appengine.ext.webapp.util import login_required
import webapp2
from base_handler import BaseHandler
from suggest_cursor import SuggestionByCursor
PAGE_SIZE = 5
TIME_FORMAT = '%Y-%m-%dT%H:%M:%S'
class Contributor(ndb.Model):
"""Model for storing users that contribute suggestions.
Contributors are stored with a key of the users email address. The 'count'
is used as a per user counter that is incremented each time a user adds a
Suggestion and is used to generate a unique property value 'creation_token'
that allows paging over suggestions in creation order.
"""
count = ndb.IntegerProperty(default=0)
@classmethod
@ndb.transactional
def unique_id(cls, email):
"""Increments contributor suggestion count and creates unique ID.
Uses the contributor email and count to create the unique ID; the
resulting string is hashed to keep the user's email address private.
Args:
email: String; The email of the currently logged in user.
Returns:
A hashed unique value based on the user and the associated
incremented Contributor.count.
"""
contributor = cls.get_by_id(email)
if contributor == None:
contributor = cls(id=email)
contributor.count += 1
contributor.put()
md5_hash = hashlib.md5('{}|{:d}'.format(email, contributor.count))
return md5_hash.hexdigest()
class CreationTokenProperty(ndb.StringProperty):
"""Custom string property which adds creation token value if not set."""
def _prepare_for_put(self, entity):
"""A method to augment the current value if not already set.
Args:
entity: The entity possessing this property.
"""
if not self._has_value(entity):
user = users.get_current_user()
# This will fail if there is no signed in user
unique_id = Contributor.unique_id(user.email())
now_as_string = datetime.datetime.now().strftime(TIME_FORMAT)
value = '{}|{}'.format(now_as_string, unique_id)
self._store_value(entity, value)
class Suggestion(SuggestionByCursor):
"""Model for storing suggestions contributed to the application.
We want to display these in the order they were created. The properties
suggestion - StringProperty
created - DateTimeProperty(auto_now_add=True)
are inherited from suggest_cursor.SuggestionByCursor and the class method
populate is as well. This method adds dummy suggestions for demonstration
purposes.
"""
creation_token = CreationTokenProperty()
class SuggestionHandler(BaseHandler):
"""Handles the insert of a suggestion and display of existing suggestions.
The GET handler is intended for general display and paging and the POST
handler is used for inserting new suggestions.
"""
@login_required
def get(self):
"""Handles GET requests to the paging by unique values sub-application.
If there is a bookmark value in the query parameters, uses it to query
for suggestions by limiting to creation tokens less than the bookmark.
Includes up to PAGE_SIZE results and a link to the next page of results
if any more exist.
"""
bookmark = self.request.get('bookmark')
query = Suggestion.query().order(-Suggestion.creation_token)
if bookmark:
query = query.filter(Suggestion.creation_token <= bookmark)
suggestions = query.fetch(PAGE_SIZE + 1)
creation_token = None
if len(suggestions) == PAGE_SIZE + 1:
creation_token = suggestions[-1].creation_token
suggestions = suggestions[:PAGE_SIZE]
self.render_response('suggestion.html', bookmark=creation_token,
suggestions=suggestions)
def post(self):
"""Handles POST requests for inserting a single suggestion."""
Suggestion(suggestion=self.request.get('suggestion')).put()
self.redirect('/unique/')
class SuggestionPopulate(BaseHandler):
"""Populates the datastore with some sample suggestions
Provided so end users can pre-populate with PAGE_SIZE + 1 entities to see
how unique value-based paging works.
"""
def post(self):
"""Handles POST requests and adds sample suggestions."""
Suggestion.populate()
self.redirect('/unique/')
APPLICATION = webapp2.WSGIApplication([('/unique/pop/', SuggestionPopulate),
('/unique/', SuggestionHandler)],
debug=True)