addons-server/apps/api/urls.py

from django.conf import settings
from django.conf.urls import include, patterns, url

from piston.resource import Resource

from addons.urls import ADDON_ID
from api import authentication, handlers, views

API_CACHE_TIMEOUT = getattr(settings, 'API_CACHE_TIMEOUT', 500)


# Wrap class views in a lambda call so we get an fresh instance of the class
# for thread-safety.
def class_view(cls):
    inner = lambda *args, **kw: cls()(*args, **kw)
    return inner


# Regular expressions that we use in our urls.
type_regexp = '/(?P<addon_type>[^/]*)'
limit_regexp = '/(?P<limit>\d*)'
platform_regexp = '/(?P<platform>\w*)'
version_regexp = '/(?P<version>[^/]*)'
compat_mode = '(?:/(?P<compat_mode>(?:strict|normal|ignore)))?'


def build_urls(base, appendages):
    """
    Many of our urls build off each other:
    e.g.
    /search/:query
    /search/:query/:type
    .
    .
    /search/:query/:type/:limit/:platform/:version
    /search/:query/:type/:limit/:platform/:version/:compatMode
    """
    urls = [base]
    for i in range(len(appendages)):
        urls.append(base + ''.join(appendages[:i + 1]))

    return urls


base_search_regexp = r'search/(?P<query>[^/]+)'
appendages = [type_regexp, limit_regexp, platform_regexp, version_regexp,
              compat_mode]
search_regexps = build_urls(base_search_regexp, appendages)

base_list_regexp = r'list'
appendages.insert(0, '/(?P<list_type>[^/]+)')
list_regexps = build_urls(base_list_regexp, appendages)


api_patterns = patterns('',
    # Addon_details
    url('addon/%s$' % ADDON_ID, class_view(views.AddonDetailView),
        name='api.addon_detail'),
    url(r'^get_language_packs$', class_view(views.LanguageView),
        name='api.language'),)

for regexp in search_regexps:
    api_patterns += patterns('',
        url(regexp + '/?$', class_view(views.SearchView), name='api.search'))

for regexp in list_regexps:
    api_patterns += patterns('',
            url(regexp + '/?$', class_view(views.ListView), name='api.list'))

ad = {'authentication': authentication.AMOOAuthAuthentication(two_legged=True)}
user_resource = Resource(handler=handlers.UserHandler, **ad)
addons_resource = Resource(handler=handlers.AddonsHandler, **ad)
apps_resource = Resource(handler=handlers.AppsHandler, **ad)
version_resource = Resource(handler=handlers.VersionsHandler, **ad)

piston_patterns = patterns('',
    url(r'^user/$', user_resource, name='api.user'),
    url(r'^addons/$', addons_resource, name='api.addons'),
    url(r'^addon/%s$' % ADDON_ID, addons_resource, name='api.addon'),
    url(r'^addon/%s/versions$' % ADDON_ID, version_resource,
        name='api.versions'),
    url(r'^addon/%s/version/(?P<version_id>\d+)$' % ADDON_ID,
        version_resource, name='api.version'),
    url(r'^apps/$', apps_resource, name='api.apps'),
    url(r'^app/%s$' % ADDON_ID, apps_resource, name='api.app'),
)

urlpatterns = patterns('',
    # Redirect api requests without versions
    url('^((?:addon|search|list)/.*)$', views.redirect_view),

    # Piston
    url(r'^2/', include(piston_patterns)),
    url(r'^2/performance/add$', views.performance_add,
        name='api.performance.add'),

    # Append api_version to the real api views
    url(r'^(?P<api_version>\d+|\d+.\d+)/search/guid:(?P<guids>.*)',
        views.guid_search),
    url(r'^(?P<api_version>\d+|\d+.\d+)/', include(api_patterns)),
)