Minor doc fixes.
[wolnelektury.git] / src / api / urls.py
1 # -*- coding: utf-8 -*-
2 # This file is part of Wolnelektury, licensed under GNU Affero GPLv3 or later.
3 # Copyright © Fundacja Nowoczesna Polska. See NOTICE for more information.
4 #
5 from django.conf.urls import url
6 from django.views.decorators.csrf import csrf_exempt
7 from django.views.generic import TemplateView
8 from piston.authentication import OAuthAuthentication, oauth_access_token, oauth_request_token
9 from piston.resource import Resource
10 import catalogue.views
11 from api import handlers
12 from api.helpers import CsrfExemptResource
13 from api.piston_patch import oauth_user_auth
14
15 auth = OAuthAuthentication(realm="Wolne Lektury")
16
17
18 class DjangoAuthentication(object):
19     """
20     Authentication handler that always returns
21     True, so no authentication is needed, nor
22     initiated (`challenge` is missing.)
23     """
24     def is_authenticated(self, request):
25         return request.user.is_authenticated()
26
27     def challenge(self):
28         from django.http import HttpResponse
29         resp = HttpResponse("Authorization Required")
30         resp.status_code = 401
31         return resp
32
33
34 def auth_resource(handler):
35     from django.conf import settings
36     if settings.DEBUG:
37         django_auth = DjangoAuthentication()
38         return CsrfExemptResource(handler=handler, authentication=django_auth)
39     return CsrfExemptResource(handler=handler, authentication=auth)
40
41
42 book_list_resource = auth_resource(handler=handlers.BooksHandler)
43 ebook_list_resource = Resource(handler=handlers.EBooksHandler)
44 # book_list_resource = Resource(handler=handlers.BooksHandler)
45 book_resource = Resource(handler=handlers.BookDetailHandler)
46 filter_book_resource = auth_resource(handler=handlers.FilterBooksHandler)
47 epub_resource = auth_resource(handler=handlers.EpubHandler)
48
49 preview_resource = Resource(handler=handlers.BookPreviewHandler)
50
51 reading_resource = auth_resource(handler=handlers.UserDataHandler)
52 shelf_resource = auth_resource(handler=handlers.UserShelfHandler)
53
54 like_resource = auth_resource(handler=handlers.UserLikeHandler)
55
56 collection_resource = Resource(handler=handlers.CollectionDetailHandler)
57 collection_list_resource = Resource(handler=handlers.CollectionsHandler)
58
59 tag_list_resource = Resource(handler=handlers.TagsHandler)
60 tag_resource = Resource(handler=handlers.TagDetailHandler)
61
62 fragment_resource = Resource(handler=handlers.FragmentDetailHandler)
63 fragment_list_resource = Resource(handler=handlers.FragmentsHandler)
64
65 picture_resource = auth_resource(handler=handlers.PictureHandler)
66
67 blog_resource = Resource(handler=handlers.BlogEntryHandler)
68
69
70 tags_re = r'^(?P<tags>(?:(?:[a-z0-9-]+/){2}){0,6})'
71 paginate_re = r'(?:after/(?P<after>[a-z0-9-]+)/)?(?:count/(?P<count>[0-9]+)/)?$'
72
73
74 urlpatterns = [
75     url(r'^oauth/request_token/$', oauth_request_token),
76     url(r'^oauth/authorize/$', oauth_user_auth, name='oauth_user_auth'),
77     url(r'^oauth/access_token/$', csrf_exempt(oauth_access_token)),
78
79     url(r'^$', TemplateView.as_view(template_name='api/main.html'), name='api'),
80
81     # info boxes (used by mobile app)
82     url(r'book/(?P<book_id>\d*?)/info\.html$', catalogue.views.book_info),
83     url(r'tag/(?P<tag_id>\d*?)/info\.html$', catalogue.views.tag_info),
84
85     # books by collections
86     url(r'^collections/$', collection_list_resource, name="api_collections"),
87     url(r'^collections/(?P<slug>[^/]+)/$', collection_resource, name="api_collection"),
88
89     # epub preview
90     url(r'^epub/(?P<slug>[a-z0-9-]+)/$', epub_resource, name='api_epub'),
91
92     # reading data
93     url(r'^reading/(?P<slug>[a-z0-9-]+)/$', reading_resource, name='api_reading'),
94     url(r'^reading/(?P<slug>[a-z0-9-]+)/(?P<state>[a-z]+)/$', reading_resource, name='api_reading'),
95     url(r'^shelf/(?P<state>[a-z]+)/$', shelf_resource, name='api_shelf'),
96     url(r'^username/$', reading_resource, name='api_username'),
97
98     url(r'^like/(?P<slug>[a-z0-9-]+)/$', like_resource, name='api_like'),
99
100     # objects details
101     url(r'^books/(?P<book>[a-z0-9-]+)/$', book_resource, name="api_book"),
102     url(r'^(?P<category>[a-z0-9-]+)/(?P<slug>[a-z0-9-]+)/$',
103         tag_resource, name="api_tag"),
104     url(r'^books/(?P<book>[a-z0-9-]+)/fragments/(?P<anchor>[a-z0-9-]+)/$',
105         fragment_resource, name="api_fragment"),
106
107     # books by tags
108     url(tags_re + r'books/' + paginate_re,
109         book_list_resource, name='api_book_list'),
110     url(tags_re + r'ebooks/' + paginate_re,
111         ebook_list_resource, name='api_ebook_list'),
112     url(tags_re + r'parent_books/' + paginate_re,
113         book_list_resource, {"top_level": True}, name='api_parent_book_list'),
114     url(tags_re + r'parent_ebooks/' + paginate_re,
115         ebook_list_resource, {"top_level": True}, name='api_parent_ebook_list'),
116     url(tags_re + r'audiobooks/' + paginate_re,
117         book_list_resource, {"audiobooks": True}, name='api_audiobook_list'),
118     url(tags_re + r'daisy/' + paginate_re,
119         book_list_resource, {"daisy": True}, name='api_daisy_list'),
120
121     url(r'^recommended/' + paginate_re, book_list_resource, {"recommended": True}, name='api_recommended_list'),
122     url(r'^newest/$', book_list_resource, {"newest": True, "top_level": True, "count": 20}, name='api_newest_list'),
123     url(r'^filter-books/$', filter_book_resource, name='api_filter_books'),
124
125     url(r'^preview/$', preview_resource, name='api_preview'),
126
127     url(r'^pictures/$', picture_resource),
128
129     url(r'^blog/$', blog_resource),
130
131     # fragments by book, tags, themes
132     # this should be paged
133     url(r'^(?P<tags>(?:(?:[a-z0-9-]+/){2}){1,6})fragments/$', fragment_list_resource),
134
135     # tags by category
136     url(r'^(?P<category>[a-z0-9-]+)/$', tag_list_resource, name='api_tag_list'),
137 ]