Commit | Line | Data |
---|---|---|
f42e49c3 | 1 | # GNU MediaGoblin -- federated, autonomous media hosting |
7f4ebeed | 2 | # Copyright (C) 2011, 2012 MediaGoblin contributors. See AUTHORS. |
f42e49c3 E |
3 | # |
4 | # This program is free software: you can redistribute it and/or modify | |
5 | # it under the terms of the GNU Affero General Public License as published by | |
6 | # the Free Software Foundation, either version 3 of the License, or | |
7 | # (at your option) any later version. | |
8 | # | |
9 | # This program is distributed in the hope that it will be useful, | |
10 | # but WITHOUT ANY WARRANTY; without even the implied warranty of | |
11 | # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
12 | # GNU Affero General Public License for more details. | |
13 | # | |
14 | # You should have received a copy of the GNU Affero General Public License | |
15 | # along with this program. If not, see <http://www.gnu.org/licenses/>. | |
16 | ||
17 | """ | |
18 | This module contains some Mixin classes for the db objects. | |
19 | ||
20 | A bunch of functions on the db objects are really more like | |
21 | "utility functions": They could live outside the classes | |
22 | and be called "by hand" passing the appropiate reference. | |
23 | They usually only use the public API of the object and | |
24 | rarely use database related stuff. | |
25 | ||
26 | These functions now live here and get "mixed in" into the | |
27 | real objects. | |
28 | """ | |
29 | ||
a81082fc | 30 | import uuid |
907bba31 | 31 | import re |
2d7b6bde | 32 | from datetime import datetime |
72bb46c7 | 33 | |
45e687fc | 34 | from pytz import UTC |
5f8b4ae8 SS |
35 | from werkzeug.utils import cached_property |
36 | ||
58a94757 | 37 | from mediagoblin.media_types import FileTypeNotSupported |
17c23e15 | 38 | from mediagoblin.tools import common, licenses |
58a94757 | 39 | from mediagoblin.tools.pluginapi import hook_handle |
e61ab099 | 40 | from mediagoblin.tools.text import cleaned_markdown_conversion |
814334f6 | 41 | from mediagoblin.tools.url import slugify |
ce46470c | 42 | from mediagoblin.tools.translate import pass_to_ugettext as _ |
f42e49c3 | 43 | |
64a456a4 JT |
44 | class CommentingMixin(object): |
45 | """ | |
46 | Mixin that gives classes methods to get and add the comments on/to it | |
47 | ||
48 | This assumes the model has a "comments" class which is a ForeignKey to the | |
49 | Collection model. This will hold a Collection of comments which are | |
50 | associated to this model. It also assumes the model has an "actor" | |
51 | ForeignKey which points to the creator/publisher/etc. of the model. | |
52 | ||
53 | NB: This is NOT the mixin for the Comment Model, this is for | |
54 | other models which support commenting. | |
55 | """ | |
56 | ||
57 | def get_comment_link(self): | |
58 | # Import here to avoid cyclic imports | |
59 | from mediagoblin.db.models import Comment, GenericModelReference | |
60 | ||
61 | gmr = GenericModelReference.query.filter_by( | |
62 | obj_pk=self.id, | |
63 | model_type=self.__tablename__ | |
64 | ).first() | |
65 | ||
66 | if gmr is None: | |
67 | return None | |
68 | ||
69 | link = Comment.query.filter_by(comment_id=gmr.id).first() | |
70 | return link | |
71 | ||
72 | def get_reply_to(self): | |
73 | link = self.get_comment_link() | |
74 | if link is None or link.target_id is None: | |
75 | return None | |
76 | ||
77 | return link.target() | |
78 | ||
79 | def soft_delete(self, *args, **kwargs): | |
80 | link = self.get_comment_link() | |
81 | if link is not None: | |
82 | link.delete() | |
83 | super(CommentingMixin, self).soft_delete(*args, **kwargs) | |
84 | ||
d216d771 JT |
85 | class GeneratePublicIDMixin(object): |
86 | """ | |
87 | Mixin that ensures that a the public_id field is populated. | |
88 | ||
89 | The public_id is the ID that is used in the API, this must be globally | |
90 | unique and dereferencable. This will be the URL for the API view of the | |
91 | object. It's used in several places, not only is it used to give out via | |
92 | the API but it's also vital information stored when a soft_deletion occurs | |
93 | on the `Graveyard.public_id` field, this is needed to follow the spec which | |
94 | says we have to be able to provide a shell of an object and return a 410 | |
95 | (rather than a 404) when a deleted object has been deleted. | |
96 | ||
97 | This requires a the urlgen off the request object (`request.urlgen`) to be | |
98 | provided as it's the ID is a URL. | |
99 | """ | |
100 | ||
101 | def get_public_id(self, urlgen): | |
102 | # Verify that the class this is on actually has a public_id field... | |
103 | if "public_id" not in self.__table__.columns.keys(): | |
104 | raise Exception("Model has no public_id field") | |
105 | ||
106 | # Great! the model has a public id, if it's None, let's create one! | |
107 | if self.public_id is None: | |
108 | # We need the internal ID for this so ensure we've been saved. | |
109 | self.save(commit=False) | |
110 | ||
111 | # Create the URL | |
112 | self.public_id = urlgen( | |
113 | "mediagoblin.api.object", | |
114 | object_type=self.object_type, | |
64a456a4 | 115 | id=str(uuid.uuid4()), |
d216d771 JT |
116 | qualified=True |
117 | ) | |
64a456a4 | 118 | self.save() |
d216d771 | 119 | return self.public_id |
f42e49c3 E |
120 | |
121 | class UserMixin(object): | |
0421fc5e JT |
122 | object_type = "person" |
123 | ||
e61ab099 E |
124 | @property |
125 | def bio_html(self): | |
126 | return cleaned_markdown_conversion(self.bio) | |
127 | ||
de6a313c BP |
128 | def url_for_self(self, urlgen, **kwargs): |
129 | """Generate a URL for this User's home page.""" | |
130 | return urlgen('mediagoblin.user_pages.user_home', | |
d216d771 | 131 | |
de6a313c BP |
132 | user=self.username, **kwargs) |
133 | ||
134 | ||
29c65044 | 135 | class GenerateSlugMixin(object): |
44123853 E |
136 | """ |
137 | Mixin to add a generate_slug method to objects. | |
138 | ||
139 | Depends on: | |
140 | - self.slug | |
141 | - self.title | |
142 | - self.check_slug_used(new_slug) | |
143 | """ | |
814334f6 | 144 | def generate_slug(self): |
88de830f | 145 | """ |
44123853 | 146 | Generate a unique slug for this object. |
98587109 | 147 | |
88de830f CAW |
148 | This one does not *force* slugs, but usually it will probably result |
149 | in a niceish one. | |
150 | ||
98587109 CAW |
151 | The end *result* of the algorithm will result in these resolutions for |
152 | these situations: | |
88de830f CAW |
153 | - If we have a slug, make sure it's clean and sanitized, and if it's |
154 | unique, we'll use that. | |
155 | - If we have a title, slugify it, and if it's unique, we'll use that. | |
156 | - If we can't get any sort of thing that looks like it'll be a useful | |
157 | slug out of a title or an existing slug, bail, and don't set the | |
158 | slug at all. Don't try to create something just because. Make | |
159 | sure we have a reasonable basis for a slug first. | |
160 | - If we have a reasonable basis for a slug (either based on existing | |
161 | slug or slugified title) but it's not unique, first try appending | |
162 | the entry's id, if that exists | |
163 | - If that doesn't result in something unique, tack on some randomly | |
164 | generated bits until it's unique. That'll be a little bit of junk, | |
165 | but at least it has the basis of a nice slug. | |
166 | """ | |
c785f3a0 | 167 | |
66d9f1b2 SS |
168 | #Is already a slug assigned? Check if it is valid |
169 | if self.slug: | |
c785f3a0 | 170 | slug = slugify(self.slug) |
b1126f71 | 171 | |
88de830f | 172 | # otherwise, try to use the title. |
66d9f1b2 | 173 | elif self.title: |
88de830f | 174 | # assign slug based on title |
c785f3a0 | 175 | slug = slugify(self.title) |
b1126f71 | 176 | |
c785f3a0 JT |
177 | else: |
178 | # We don't have any information to set a slug | |
179 | return | |
b0118957 | 180 | |
c785f3a0 JT |
181 | # We don't want any empty string slugs |
182 | if slug == u"": | |
183 | return | |
b1126f71 | 184 | |
88de830f | 185 | # Otherwise, let's see if this is unique. |
c785f3a0 | 186 | if self.check_slug_used(slug): |
88de830f | 187 | # It looks like it's being used... lame. |
b1126f71 | 188 | |
88de830f CAW |
189 | # Can we just append the object's id to the end? |
190 | if self.id: | |
c785f3a0 | 191 | slug_with_id = u"%s-%s" % (slug, self.id) |
29c65044 | 192 | if not self.check_slug_used(slug_with_id): |
88de830f CAW |
193 | self.slug = slug_with_id |
194 | return # success! | |
b1126f71 | 195 | |
88de830f CAW |
196 | # okay, still no success; |
197 | # let's whack junk on there till it's unique. | |
c785f3a0 | 198 | slug += '-' + uuid.uuid4().hex[:4] |
a81082fc | 199 | # keep going if necessary! |
c785f3a0 JT |
200 | while self.check_slug_used(slug): |
201 | slug += uuid.uuid4().hex[:4] | |
202 | ||
203 | # self.check_slug_used(slug) must be False now so we have a slug that | |
204 | # we can use now. | |
205 | self.slug = slug | |
814334f6 | 206 | |
29c65044 | 207 | |
d216d771 | 208 | class MediaEntryMixin(GenerateSlugMixin, GeneratePublicIDMixin): |
29c65044 E |
209 | def check_slug_used(self, slug): |
210 | # import this here due to a cyclic import issue | |
211 | # (db.models -> db.mixin -> db.util -> db.models) | |
212 | from mediagoblin.db.util import check_media_slug_used | |
213 | ||
0f3bf8d4 | 214 | return check_media_slug_used(self.actor, slug, self.id) |
29c65044 | 215 | |
0421fc5e JT |
216 | @property |
217 | def object_type(self): | |
218 | """ Converts media_type to pump-like type - don't use internally """ | |
219 | return self.media_type.split(".")[-1] | |
220 | ||
1e72e075 E |
221 | @property |
222 | def description_html(self): | |
223 | """ | |
224 | Rendered version of the description, run through | |
225 | Markdown and cleaned with our cleaning tool. | |
226 | """ | |
227 | return cleaned_markdown_conversion(self.description) | |
228 | ||
e77df64f CAW |
229 | def get_display_media(self): |
230 | """Find the best media for display. | |
f42e49c3 | 231 | |
53024776 | 232 | We try checking self.media_manager.fetching_order if it exists to |
e77df64f | 233 | pull down the order. |
f42e49c3 E |
234 | |
235 | Returns: | |
ddbf6af1 CAW |
236 | (media_size, media_path) |
237 | or, if not found, None. | |
e77df64f | 238 | |
f42e49c3 | 239 | """ |
e8676fa3 | 240 | fetch_order = self.media_manager.media_fetch_order |
f42e49c3 | 241 | |
ddbf6af1 CAW |
242 | # No fetching order found? well, give up! |
243 | if not fetch_order: | |
244 | return None | |
245 | ||
246 | media_sizes = self.media_files.keys() | |
247 | ||
248 | for media_size in fetch_order: | |
f42e49c3 | 249 | if media_size in media_sizes: |
ddbf6af1 | 250 | return media_size, self.media_files[media_size] |
f42e49c3 | 251 | |
809ebf45 | 252 | def get_all_media(self): |
253 | """ | |
254 | Returns all available qualties of a media | |
255 | """ | |
256 | fetch_order = self.media_manager.media_fetch_order | |
257 | ||
258 | # No fetching order found? well, give up! | |
259 | if not fetch_order: | |
260 | return None | |
261 | ||
262 | media_sizes = self.media_files.keys() | |
263 | ||
264 | all_media_path = [] | |
265 | ||
266 | for media_size in fetch_order: | |
267 | if media_size in media_sizes: | |
268 | file_metadata = self.get_file_metadata(media_size) | |
269 | size = file_metadata['medium_size'] | |
7c5c0cfc | 270 | if media_size != 'webm_video': |
809ebf45 | 271 | all_media_path.append((media_size[5:], size, |
272 | self.media_files[media_size])) | |
273 | else: | |
7c5c0cfc | 274 | all_media_path.append(('default', size, |
809ebf45 | 275 | self.media_files[media_size])) |
276 | ||
277 | return all_media_path | |
278 | ||
f42e49c3 E |
279 | def main_mediafile(self): |
280 | pass | |
281 | ||
3e907d55 E |
282 | @property |
283 | def slug_or_id(self): | |
7de20e52 CAW |
284 | if self.slug: |
285 | return self.slug | |
286 | else: | |
287 | return u'id:%s' % self.id | |
5f8b4ae8 | 288 | |
cb7ae1e4 | 289 | def url_for_self(self, urlgen, **extra_args): |
f42e49c3 E |
290 | """ |
291 | Generate an appropriate url for ourselves | |
292 | ||
5c2b8486 | 293 | Use a slug if we have one, else use our 'id'. |
f42e49c3 | 294 | """ |
0f3bf8d4 | 295 | uploader = self.get_actor |
f42e49c3 | 296 | |
3e907d55 E |
297 | return urlgen( |
298 | 'mediagoblin.user_pages.media_home', | |
299 | user=uploader.username, | |
300 | media=self.slug_or_id, | |
301 | **extra_args) | |
f42e49c3 | 302 | |
2e4ad359 SS |
303 | @property |
304 | def thumb_url(self): | |
305 | """Return the thumbnail URL (for usage in templates) | |
306 | Will return either the real thumbnail or a default fallback icon.""" | |
307 | # TODO: implement generic fallback in case MEDIA_MANAGER does | |
308 | # not specify one? | |
309 | if u'thumb' in self.media_files: | |
ddabf20f | 310 | thumb_url = self._app.public_store.file_url( |
2e4ad359 SS |
311 | self.media_files[u'thumb']) |
312 | else: | |
df1c4976 | 313 | # No thumbnail in media available. Get the media's |
2e4ad359 | 314 | # MEDIA_MANAGER for the fallback icon and return static URL |
5f8b4ae8 SS |
315 | # Raises FileTypeNotSupported in case no such manager is enabled |
316 | manager = self.media_manager | |
ddabf20f | 317 | thumb_url = self._app.staticdirector(manager[u'default_thumb']) |
2e4ad359 SS |
318 | return thumb_url |
319 | ||
5b014a08 JT |
320 | @property |
321 | def original_url(self): | |
322 | """ Returns the URL for the original image | |
323 | will return self.thumb_url if original url doesn't exist""" | |
324 | if u"original" not in self.media_files: | |
325 | return self.thumb_url | |
ce46470c | 326 | |
ddabf20f | 327 | return self._app.public_store.file_url( |
5b014a08 JT |
328 | self.media_files[u"original"] |
329 | ) | |
330 | ||
654d7cf9 BB |
331 | @property |
332 | def icon_url(self): | |
333 | '''Return the icon URL (for usage in templates) if it exists''' | |
334 | try: | |
335 | return self._app.staticdirector( | |
336 | self.media_manager['type_icon']) | |
337 | except AttributeError: | |
338 | return None | |
339 | ||
5f8b4ae8 SS |
340 | @cached_property |
341 | def media_manager(self): | |
342 | """Returns the MEDIA_MANAGER of the media's media_type | |
343 | ||
344 | Raises FileTypeNotSupported in case no such manager is enabled | |
345 | """ | |
6403bc92 | 346 | manager = hook_handle(('media_manager', self.media_type)) |
58a94757 | 347 | if manager: |
4259ad5b CAW |
348 | return manager(self) |
349 | ||
5f8b4ae8 SS |
350 | # Not found? Then raise an error |
351 | raise FileTypeNotSupported( | |
e6991972 RE |
352 | "MediaManager not in enabled types. Check media_type plugins are" |
353 | " enabled in config?") | |
5f8b4ae8 | 354 | |
f42e49c3 E |
355 | def get_fail_exception(self): |
356 | """ | |
357 | Get the exception that's appropriate for this error | |
358 | """ | |
51eb0267 | 359 | if self.fail_error: |
7dcdc2dc BB |
360 | try: |
361 | return common.import_component(self.fail_error) | |
362 | except ImportError: | |
363 | # TODO(breton): fail_error should give some hint about why it | |
364 | # failed. fail_error is used as a path to import(). | |
365 | # Unfortunately, I didn't know about that and put general error | |
366 | # message there. Maybe it's for the best, because for admin, | |
367 | # we could show even some raw python things. Anyway, this | |
368 | # should be properly resolved. Now we are in a freeze, that's | |
369 | # why I simply catch ImportError. | |
5eaf6c11 | 370 | return None |
17c23e15 AW |
371 | |
372 | def get_license_data(self): | |
373 | """Return license dict for requested license""" | |
138a18fd | 374 | return licenses.get_license_by_url(self.license or "") |
feba5c52 | 375 | |
5bad26bc E |
376 | def exif_display_iter(self): |
377 | if not self.media_data: | |
378 | return | |
379 | exif_all = self.media_data.get("exif_all") | |
380 | ||
b3566e1d GS |
381 | for key in exif_all: |
382 | label = re.sub('(.)([A-Z][a-z]+)', r'\1 \2', key) | |
383 | yield label.replace('EXIF', '').replace('Image', ''), exif_all[key] | |
5bad26bc | 384 | |
420e1374 GS |
385 | def exif_display_data_short(self): |
386 | """Display a very short practical version of exif info""" | |
420e1374 GS |
387 | if not self.media_data: |
388 | return | |
907bba31 | 389 | |
420e1374 | 390 | exif_all = self.media_data.get("exif_all") |
907bba31 | 391 | |
14aa2eaa JW |
392 | exif_short = {} |
393 | ||
907bba31 JW |
394 | if 'Image DateTimeOriginal' in exif_all: |
395 | # format date taken | |
196cef38 | 396 | takendate = datetime.strptime( |
907bba31 JW |
397 | exif_all['Image DateTimeOriginal']['printable'], |
398 | '%Y:%m:%d %H:%M:%S').date() | |
399 | taken = takendate.strftime('%B %d %Y') | |
400 | ||
14aa2eaa JW |
401 | exif_short.update({'Date Taken': taken}) |
402 | ||
1b6a2b85 | 403 | aperture = None |
907bba31 JW |
404 | if 'EXIF FNumber' in exif_all: |
405 | fnum = str(exif_all['EXIF FNumber']['printable']).split('/') | |
406 | ||
1b6a2b85 JW |
407 | # calculate aperture |
408 | if len(fnum) == 2: | |
409 | aperture = "f/%.1f" % (float(fnum[0])/float(fnum[1])) | |
410 | elif fnum[0] != 'None': | |
411 | aperture = "f/%s" % (fnum[0]) | |
907bba31 | 412 | |
14aa2eaa JW |
413 | if aperture: |
414 | exif_short.update({'Aperture': aperture}) | |
415 | ||
416 | short_keys = [ | |
417 | ('Camera', 'Image Model', None), | |
418 | ('Exposure', 'EXIF ExposureTime', lambda x: '%s sec' % x), | |
419 | ('ISO Speed', 'EXIF ISOSpeedRatings', None), | |
420 | ('Focal Length', 'EXIF FocalLength', lambda x: '%s mm' % x)] | |
421 | ||
422 | for label, key, fmt_func in short_keys: | |
423 | try: | |
424 | val = fmt_func(exif_all[key]['printable']) if fmt_func \ | |
425 | else exif_all[key]['printable'] | |
426 | exif_short.update({label: val}) | |
427 | except KeyError: | |
428 | pass | |
429 | ||
430 | return exif_short | |
431 | ||
feba5c52 | 432 | |
64a456a4 | 433 | class TextCommentMixin(GeneratePublicIDMixin): |
0421fc5e JT |
434 | object_type = "comment" |
435 | ||
feba5c52 E |
436 | @property |
437 | def content_html(self): | |
438 | """ | |
439 | the actual html-rendered version of the comment displayed. | |
440 | Run through Markdown and the HTML cleaner. | |
441 | """ | |
442 | return cleaned_markdown_conversion(self.content) | |
be5be115 | 443 | |
dc19e98d | 444 | def __unicode__(self): |
0f3bf8d4 | 445 | return u'<{klass} #{id} {actor} "{comment}">'.format( |
2d7b6bde JW |
446 | klass=self.__class__.__name__, |
447 | id=self.id, | |
0f3bf8d4 | 448 | actor=self.get_actor, |
2d7b6bde JW |
449 | comment=self.content) |
450 | ||
dc19e98d | 451 | def __repr__(self): |
0f3bf8d4 | 452 | return '<{klass} #{id} {actor} "{comment}">'.format( |
dc19e98d TB |
453 | klass=self.__class__.__name__, |
454 | id=self.id, | |
0f3bf8d4 | 455 | actor=self.get_actor, |
dc19e98d TB |
456 | comment=self.content) |
457 | ||
d216d771 | 458 | class CollectionMixin(GenerateSlugMixin, GeneratePublicIDMixin): |
0421fc5e JT |
459 | object_type = "collection" |
460 | ||
455fd36f | 461 | def check_slug_used(self, slug): |
be5be115 AW |
462 | # import this here due to a cyclic import issue |
463 | # (db.models -> db.mixin -> db.util -> db.models) | |
464 | from mediagoblin.db.util import check_collection_slug_used | |
465 | ||
0f3bf8d4 | 466 | return check_collection_slug_used(self.actor, slug, self.id) |
be5be115 AW |
467 | |
468 | @property | |
469 | def description_html(self): | |
470 | """ | |
471 | Rendered version of the description, run through | |
472 | Markdown and cleaned with our cleaning tool. | |
473 | """ | |
474 | return cleaned_markdown_conversion(self.description) | |
475 | ||
476 | @property | |
477 | def slug_or_id(self): | |
5c2b8486 | 478 | return (self.slug or self.id) |
be5be115 AW |
479 | |
480 | def url_for_self(self, urlgen, **extra_args): | |
481 | """ | |
482 | Generate an appropriate url for ourselves | |
483 | ||
5c2b8486 | 484 | Use a slug if we have one, else use our 'id'. |
be5be115 | 485 | """ |
0f3bf8d4 | 486 | creator = self.get_actor |
be5be115 AW |
487 | |
488 | return urlgen( | |
256f816f | 489 | 'mediagoblin.user_pages.user_collection', |
be5be115 AW |
490 | user=creator.username, |
491 | collection=self.slug_or_id, | |
492 | **extra_args) | |
493 | ||
64a456a4 JT |
494 | def add_to_collection(self, obj, content=None, commit=True): |
495 | """ Adds an object to the collection """ | |
496 | # It's here to prevent cyclic imports | |
497 | from mediagoblin.db.models import CollectionItem | |
654d7cf9 | 498 | |
64a456a4 JT |
499 | # Need the ID of this collection for this so check we've got one. |
500 | self.save(commit=False) | |
501 | ||
502 | # Create the CollectionItem | |
503 | item = CollectionItem() | |
504 | item.collection = self.id | |
505 | item.get_object = obj | |
654d7cf9 | 506 | |
64a456a4 JT |
507 | if content is not None: |
508 | item.note = content | |
509 | ||
510 | self.num_items = self.num_items + 1 | |
654d7cf9 | 511 | |
64a456a4 JT |
512 | # Save both! |
513 | self.save(commit=commit) | |
514 | item.save(commit=commit) | |
654d7cf9 | 515 | return item |
6d1e55b2 | 516 | |
be5be115 AW |
517 | class CollectionItemMixin(object): |
518 | @property | |
519 | def note_html(self): | |
520 | """ | |
521 | the actual html-rendered version of the note displayed. | |
522 | Run through Markdown and the HTML cleaner. | |
523 | """ | |
524 | return cleaned_markdown_conversion(self.note) | |
ce46470c | 525 | |
d216d771 | 526 | class ActivityMixin(GeneratePublicIDMixin): |
0421fc5e | 527 | object_type = "activity" |
ce46470c JT |
528 | |
529 | VALID_VERBS = ["add", "author", "create", "delete", "dislike", "favorite", | |
530 | "follow", "like", "post", "share", "unfavorite", "unfollow", | |
531 | "unlike", "unshare", "update", "tag"] | |
532 | ||
533 | def get_url(self, request): | |
534 | return request.urlgen( | |
4fd52036 | 535 | "mediagoblin.user_pages.activity_view", |
ce46470c JT |
536 | username=self.get_actor.username, |
537 | id=self.id, | |
538 | qualified=True | |
539 | ) | |
540 | ||
541 | def generate_content(self): | |
542 | """ Produces a HTML content for object """ | |
543 | # some of these have simple and targetted. If self.target it set | |
544 | # it will pick the targetted. If they DON'T have a targetted version | |
545 | # the information in targetted won't be added to the content. | |
546 | verb_to_content = { | |
547 | "add": { | |
548 | "simple" : _("{username} added {object}"), | |
549 | "targetted": _("{username} added {object} to {target}"), | |
550 | }, | |
551 | "author": {"simple": _("{username} authored {object}")}, | |
552 | "create": {"simple": _("{username} created {object}")}, | |
553 | "delete": {"simple": _("{username} deleted {object}")}, | |
554 | "dislike": {"simple": _("{username} disliked {object}")}, | |
555 | "favorite": {"simple": _("{username} favorited {object}")}, | |
556 | "follow": {"simple": _("{username} followed {object}")}, | |
557 | "like": {"simple": _("{username} liked {object}")}, | |
558 | "post": { | |
559 | "simple": _("{username} posted {object}"), | |
2b191618 | 560 | "targetted": _("{username} posted {object} to {target}"), |
ce46470c JT |
561 | }, |
562 | "share": {"simple": _("{username} shared {object}")}, | |
563 | "unfavorite": {"simple": _("{username} unfavorited {object}")}, | |
564 | "unfollow": {"simple": _("{username} stopped following {object}")}, | |
565 | "unlike": {"simple": _("{username} unliked {object}")}, | |
566 | "unshare": {"simple": _("{username} unshared {object}")}, | |
567 | "update": {"simple": _("{username} updated {object}")}, | |
568 | "tag": {"simple": _("{username} tagged {object}")}, | |
569 | } | |
570 | ||
1e0c938c JT |
571 | object_map = { |
572 | "image": _("an image"), | |
573 | "comment": _("a comment"), | |
574 | "collection": _("a collection"), | |
575 | "video": _("a video"), | |
576 | "audio": _("audio"), | |
577 | "person": _("a person"), | |
578 | } | |
b4997540 JT |
579 | obj = self.object() |
580 | target = None if self.target_id is None else self.target() | |
ce46470c JT |
581 | actor = self.get_actor |
582 | content = verb_to_content.get(self.verb, None) | |
583 | ||
2d73983e | 584 | if content is None or self.object is None: |
ce46470c JT |
585 | return |
586 | ||
1e0c938c JT |
587 | # Decide what to fill the object with |
588 | if hasattr(obj, "title") and obj.title.strip(" "): | |
7eac1e6d | 589 | object_value = obj.title |
1e0c938c | 590 | elif obj.object_type in object_map: |
7eac1e6d | 591 | object_value = object_map[obj.object_type] |
1e0c938c | 592 | else: |
7eac1e6d | 593 | object_value = _("an object") |
1e0c938c | 594 | |
7eac1e6d JT |
595 | # Do we want to add a target (indirect object) to content? |
596 | if target is not None and "targetted" in content: | |
597 | if hasattr(target, "title") and target.title.strip(" "): | |
b4997540 | 598 | target_value = target.title |
7eac1e6d JT |
599 | elif target.object_type in object_map: |
600 | target_value = object_map[target.object_type] | |
601 | else: | |
602 | target_value = _("an object") | |
603 | ||
604 | self.content = content["targetted"].format( | |
ce46470c | 605 | username=actor.username, |
7eac1e6d JT |
606 | object=object_value, |
607 | target=target_value | |
ce46470c JT |
608 | ) |
609 | else: | |
7eac1e6d | 610 | self.content = content["simple"].format( |
ce46470c | 611 | username=actor.username, |
7eac1e6d | 612 | object=object_value |
ce46470c JT |
613 | ) |
614 | ||
615 | return self.content | |
616 | ||
617 | def serialize(self, request): | |
9c602458 | 618 | href = request.urlgen( |
4fd52036 | 619 | "mediagoblin.api.object", |
9c602458 JT |
620 | object_type=self.object_type, |
621 | id=self.id, | |
622 | qualified=True | |
623 | ) | |
45e687fc JT |
624 | published = UTC.localize(self.published) |
625 | updated = UTC.localize(self.updated) | |
ce46470c | 626 | obj = { |
9c602458 | 627 | "id": href, |
ce46470c JT |
628 | "actor": self.get_actor.serialize(request), |
629 | "verb": self.verb, | |
45e687fc JT |
630 | "published": published.isoformat(), |
631 | "updated": updated.isoformat(), | |
ce46470c JT |
632 | "content": self.content, |
633 | "url": self.get_url(request), | |
de366f73 | 634 | "object": self.object().serialize(request), |
0421fc5e | 635 | "objectType": self.object_type, |
35885226 JT |
636 | "links": { |
637 | "self": { | |
638 | "href": href, | |
639 | }, | |
640 | }, | |
ce46470c JT |
641 | } |
642 | ||
643 | if self.generator: | |
6d36f75f | 644 | obj["generator"] = self.get_generator.serialize(request) |
ce46470c JT |
645 | |
646 | if self.title: | |
647 | obj["title"] = self.title | |
648 | ||
de366f73 JT |
649 | if self.target_id is not None: |
650 | obj["target"] = self.target().serialize(request) | |
ce46470c JT |
651 | |
652 | return obj | |
653 | ||
654 | def unseralize(self, data): | |
655 | """ | |
656 | Takes data given and set it on this activity. | |
657 | ||
658 | Several pieces of data are not written on because of security | |
659 | reasons. For example changing the author or id of an activity. | |
660 | """ | |
661 | if "verb" in data: | |
662 | self.verb = data["verb"] | |
663 | ||
664 | if "title" in data: | |
665 | self.title = data["title"] | |
666 | ||
667 | if "content" in data: | |
668 | self.content = data["content"] |