├── .dockerignore
├── .env
├── .gitignore
├── Dockerfile
├── LICENSE
├── README.md
├── ac_mediator
    ├── __init__.py
    ├── celery.py
    ├── exceptions.py
    ├── settings.py
    ├── urls.py
    ├── views.py
    └── wsgi.py
├── accounts
    ├── __init__.py
    ├── admin.py
    ├── apps.py
    ├── forms.py
    ├── management
    │   ├── __init__.py
    │   └── commands
    │   │   ├── __init__.py
    │   │   └── renew_access_tokens.py
    ├── migrations
    │   ├── 0001_initial.py
    │   ├── 0002_auto_20161025_1607.py
    │   ├── 0003_auto_20161025_1641.py
    │   ├── 0004_account_accepted_tos.py
    │   ├── 0005_servicecredentials_created.py
    │   ├── 0006_auto_20161027_1627.py
    │   ├── 0007_servicecredentials_modified.py
    │   ├── 0008_auto_20161027_1650.py
    │   ├── 0009_auto_20161027_1651.py
    │   └── __init__.py
    ├── models.py
    ├── templatetags
    │   ├── __init__.py
    │   └── absurl.py
    ├── tests.py
    ├── urls.py
    └── views.py
├── api
    ├── __init__.py
    ├── admin.py
    ├── apps.py
    ├── constants.py
    ├── forms.py
    ├── management
    │   ├── __init__.py
    │   └── commands
    │   │   ├── __init__.py
    │   │   └── clean_old_responses.py
    ├── migrations
    │   ├── 0001_initial.py
    │   ├── 0002_auto_20161025_1721.py
    │   ├── 0003_apiclient_created.py
    │   ├── 0004_apiclient_password_grant_is_allowed.py
    │   └── __init__.py
    ├── models.py
    ├── oauth2_urls.py
    ├── request_distributor.py
    ├── response_aggregator.py
    ├── tests.py
    ├── urls.py
    ├── utils.py
    └── views.py
├── developers
    ├── __init__.py
    ├── admin.py
    ├── apps.py
    ├── migrations
    │   └── __init__.py
    ├── models.py
    ├── tests.py
    ├── urls.py
    └── views.py
├── docker-compose.yml
├── docker
    ├── flower
    │   ├── Dockerfile
    │   └── requirements.txt
    ├── nginx
    │   ├── ac_mediator.conf
    │   └── ssl_certificates
    │   │   ├── server.crt
    │   │   └── server.key
    └── redmon
    │   └── Dockerfile
├── docs
    ├── .gitignore
    ├── Makefile
    ├── _static
    │   ├── ac_services_diagram.svg
    │   └── project_logo_h.png
    ├── _themes
    │   └── ac_sphinx_rtd_theme
    │   │   ├── __init__.py
    │   │   ├── breadcrumbs.html
    │   │   ├── footer.html
    │   │   ├── layout.html
    │   │   ├── layout_old.html
    │   │   ├── search.html
    │   │   ├── searchbox.html
    │   │   ├── static
    │   │       ├── css
    │   │       │   ├── badge_only.css
    │   │       │   ├── badge_only.css.map
    │   │       │   ├── theme.css
    │   │       │   └── theme.css.map
    │   │       ├── fonts
    │   │       │   ├── FontAwesome.otf
    │   │       │   ├── Inconsolata-Bold.ttf
    │   │       │   ├── Inconsolata-Regular.ttf
    │   │       │   ├── Lato-Bold.ttf
    │   │       │   ├── Lato-Regular.ttf
    │   │       │   ├── RobotoSlab-Bold.ttf
    │   │       │   ├── RobotoSlab-Regular.ttf
    │   │       │   ├── fontawesome-webfont.eot
    │   │       │   ├── fontawesome-webfont.svg
    │   │       │   ├── fontawesome-webfont.ttf
    │   │       │   └── fontawesome-webfont.woff
    │   │       └── js
    │   │       │   ├── modernizr.min.js
    │   │       │   └── theme.js
    │   │   ├── theme.conf
    │   │   └── versions.html
    ├── acservice.rst
    ├── api.rst
    ├── api_authentication.rst
    ├── api_endpoints.rst
    ├── api_overview.rst
    ├── api_tos.rst
    ├── conf.py
    ├── index.rst
    └── services.rst
├── manage.py
├── pip.conf.example
├── requirements.txt
├── services
    ├── 3rd_party
    │   ├── __init__.py
    │   ├── europeana.py
    │   ├── freesound.py
    │   └── jamendo.py
    ├── __init__.py
    ├── acservice
    │   ├── __init__.py
    │   ├── auth.py
    │   ├── base.py
    │   ├── constants.py
    │   ├── download.py
    │   ├── licensing.py
    │   ├── search.py
    │   └── utils.py
    ├── apps.py
    ├── management
    │   ├── __init__.py
    │   └── commands
    │   │   ├── __init__.py
    │   │   └── test_service.py
    ├── mgmt.py
    ├── models.py
    ├── services_conf.example.cfg
    ├── test_services.cfg
    └── tests.py
├── static
    ├── css
    │   ├── admin_extra.css
    │   └── main.css
    ├── img
    │   ├── logo-icon.svg
    │   ├── logo.svg
    │   └── project_logo_h.png
    └── js
    │   └── all.js
├── templates
    ├── accounts
    │   ├── about.html
    │   ├── activate.html
    │   ├── authorize_client.html
    │   ├── authorized-token-delete.html
    │   ├── authorized-tokens.html
    │   ├── home.html
    │   ├── link_service_callback.html
    │   ├── link_services.html
    │   ├── login.html
    │   ├── password_reset_complete.html
    │   ├── password_reset_confirm.html
    │   ├── password_reset_done.html
    │   ├── password_reset_form.html
    │   ├── registration.html
    │   └── resend_activation.html
    ├── admin
    │   ├── base_site.html
    │   └── monitor.html
    ├── base.html
    ├── developers
    │   ├── application_confirm_delete.html
    │   ├── application_detail.html
    │   ├── application_form.html
    │   ├── application_list.html
    │   ├── application_monitor.html
    │   └── application_registration_form.html
    ├── emails
    │   ├── account_activation.txt
    │   ├── email_base.txt
    │   ├── password_reset.txt
    │   └── password_reset_subject.txt
    └── services
    │   └── test_service.html
├── utils
    ├── __init__.py
    ├── encryption.py
    └── mail.py
└── uwsgi.ini


/.dockerignore:
--------------------------------------------------------------------------------
1 | services/services_conf.cfg
2 | .env
3 | 


--------------------------------------------------------------------------------
/.env:
--------------------------------------------------------------------------------
 1 | # This file is used by docker-compose.yml to do variable substitution in Docker Compose and also to pass it to some
 2 | # Docker containers which need some of the variables defined here. It can't be renamed to something else than '.env'
 3 | # because otherwise it won't be used for variable substitution in docker-compose.yml (see
 4 | # https://docs.docker.com/compose/compose-file/compose-file-v2/#variable-substitution)
 5 | 
 6 | # db
 7 | POSTGRES_USER=postgres
 8 | POSTGRES_PASSWORD=postgres
 9 | POSTGRES_DB=ac_mediator
10 | 
11 | # web, celery
12 | DJANGO_DATABASE_URL=postgres://postgres:postgres@db/ac_mediator
13 | DJANGO_BASE_URL=https://localhost
14 | DJANGO_SECRET_KEY=090d2#wtg&q2@o+l%cvc&4)r4x5fr9o#r^qz3%0bemyecshn31
15 | CELERY_CONCURRENCY=10
16 | 
17 | # flower
18 | FLOWER_BASIC_AUTH=a_user:a_pass
19 | 
20 | # redmon
21 | REDMON_BASIC_AUTH=a_user:a_pass


--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
 1 | .DS_Store
 2 | __pycache__
 3 | .idea/*
 4 | services_conf.cfg
 5 | mail
 6 | celerybeat.pid
 7 | celerybeat-schedule
 8 | pip.conf
 9 | out_test_*
10 | logs
11 | logs/*


--------------------------------------------------------------------------------
/Dockerfile:
--------------------------------------------------------------------------------
 1 | FROM python:3.6
 2 | ENV PYTHONUNBUFFERED 1
 3 | 
 4 | RUN mkdir /code
 5 | WORKDIR /code
 6 | 
 7 | # The following line copies a PIP configuration file to the container (if it exists).
 8 | # We use an internal PyPy mirror at the MTG and configure that at this step.
 9 | # Ideally we'd like to use some sort of "conditional ADD" statement here but Docker does not support that.
10 | # As a workaround we use the wildcard so the file is added only if it is found.
11 | ADD pip.* /etc/
12 | 
13 | ADD requirements.txt /code/
14 | RUN pip install --no-cache-dir -r requirements.txt
15 | ADD . /code/
16 | RUN python manage.py collectstatic --no-input
17 | WORKDIR /code/docs
18 | RUN make clean html
19 | WORKDIR /code
20 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | # Audio Commons mediator
 2 | 
 3 | Mediator component of the Audio Commons Ecosystem.
 4 | 
 5 | 
 6 | # Development
 7 | 
 8 | The Audio Commons mediator is a web service written in Python 3 using
 9 | the Django framework. We use the PostgreSQL database backend with the
10 | JSON fields (PostgreSQL >= 9.2), and also use a Redis store for managing
11 | async operations.
12 | 
13 | The easiest way to set up a local development version is to use Docker
14 | container definitions provided in this repository. When using Docker, the
15 | development environment includes PostgreSQL, an Nginx web server, the Redis
16 | data store and the Django application running behind Gunicorn.
17 | It also includes custom SSL certificates to be able to properly test the
18 | API via https. Below you'll find instructions for setting up the development
19 | environment using Docker. You can also set up the development environment
20 | manually by installing all dependencies (including PostgreSQL and Redis).
21 | This works like a standard Django application but you'll have to manually
22 | connect all components. We do not provide instructions for manuall installation,
23 | but it should not be too complicated.
24 | 
25 | ## Setting up dev environment
26 | 
27 | Before starting make sure you have [Docker](https://www.docker.com/products/overview)
28 | (with `docker-compose`) installed.
29 | 
30 | - Clone repository and cd into it
31 | ```
32 | git clone git@github.com:AudioCommons/ac-mediator.git
33 | cd ac_mediator
34 | ```
35 | 
36 | - Build and run Docker containers for required services
37 | ```
38 | docker-compose up
39 | ```
40 | 
41 | - If it's the first time you run the mediator or there are Django migrations unapplied to your database, you'll also need to run migrate command:
42 | ```
43 | docker-compose run --rm web python manage.py migrate
44 | ```
45 | 
46 | - You'll probably want to create a superuser too:
47 | ```
48 | docker-compose run --rm web python manage.py createsuperuser
49 | ```
50 | 
51 | Now you should be able to access your server at `https://localhost`
52 | 
53 | 
54 | **Note on API development:** to facilitate API development, unauthenticated
55 | requests to the API are allowed when running ac-mediator locally. 
56 | This behaviour can be changed editing the `ALLOW_UNAUTHENTICATED_API_REQUESTS_ON_DEBUG`
57 | setting in `ac_mediator/settings.py`.
58 | 
59 | 
60 | ### Configuring third-party services
61 | 
62 | The Audio Commons mediator has to interact with third party services and needs
63 | to be configured to do so. This is done via a configuration file that stores
64 | API credentials and some other relevant information for each service. An example of such
65 | file is found in [/services/services_conf.example.cfg](https://github.com/AudioCommons/ac-mediator/blob/master/services/services_conf.example.cfg).
66 | 
67 | To be able to use such services in local development you'll need to request API keys
68 | for the different servies and fill up this configuration file (in development, you can 
69 | use any invented id for `AUDIO_COMMONS_SERVICE_ID` field). If a service can't load
70 | any configuration parameters from this file, the service won't be enabled.
71 | 
72 | 
73 | # Documentation
74 | 
75 | Documentation is located in the `docs` folder and can generated using Sphinx:
76 | ```
77 | cd docs
78 | make clean html
79 | ```
80 | 
81 | If you're using Docker you'll need to run these commands from the container:
82 | ```
83 | docker-compose run --rm web bash -c "cd docs && make clean html"
84 | ```
85 | 
86 | 
87 | For the documentation style we use a customized version of the
88 | [Read the Docs sphinx theme](https://github.com/snide/sphinx_rtd_theme/blob/master/README.rst).
89 | The customized theme is already bundled with this repository in
90 | [docs/_themes/ac_sphinx_rtd_theme](https://github.com/AudioCommons/ac-mediator/tree/master/docs/_themes/ac_sphinx_rtd_theme),
91 | but if you want to edit it, you'll need to get the source from
92 | [https://github.com/AudioCommons/sphinx_rtd_theme](https://github.com/AudioCommons/sphinx_rtd_theme)
93 | and follow instructions in there.
94 | 
95 | 
96 | # License
97 | Apache License 2.0
98 | 


--------------------------------------------------------------------------------
/ac_mediator/__init__.py:
--------------------------------------------------------------------------------
1 | from __future__ import absolute_import, unicode_literals
2 | 
3 | # This will make sure the app is always imported when
4 | # Django starts so that shared_task will use this app.
5 | from .celery import app as celery_app
6 | 
7 | __all__ = ['celery_app']
8 | 


--------------------------------------------------------------------------------
/ac_mediator/celery.py:
--------------------------------------------------------------------------------
 1 | from __future__ import absolute_import, unicode_literals
 2 | import os
 3 | from celery import Celery
 4 | from django.core import management
 5 | from celery.schedules import crontab
 6 | 
 7 | 
 8 | # set the default Django settings module for the 'celery' program.
 9 | os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'ac_mediator.settings')
10 | 
11 | app = Celery('ac_mediator')
12 | 
13 | # Using a string here means the worker don't have to serialize
14 | # the configuration object to child processes.
15 | # - namespace='CELERY' means all celery-related configuration keys
16 | #   should have a `CELERY_` prefix.
17 | app.config_from_object('django.conf:settings', namespace='CELERY')
18 | 
19 | # Load task modules from all registered Django app configs.
20 | app.autodiscover_tasks()
21 | app.autodiscover_tasks('api', related_name='requests_distributor')
22 | 
23 | 
24 | @app.task(bind=True)
25 | def debug_task(self):
26 |     print('Request: {0!r}'.format(self.request))
27 | 
28 | 
29 | @app.task(bind=True)
30 | def run_django_management_command(self, command, *args, **kwargs):
31 |     management.call_command(command, *args, **kwargs)
32 | 
33 | 
34 | # Configure periodic tasks here
35 | @app.on_after_configure.connect
36 | def setup_periodic_tasks(sender, **kwargs):
37 |     sender.add_periodic_task(
38 |         crontab(hour=6, minute=0),  # Every day at 6 am
39 |         run_django_management_command.s('renew_access_tokens'),
40 |         name='Renew expired tokens')
41 | 
42 | 


--------------------------------------------------------------------------------
/ac_mediator/exceptions.py:
--------------------------------------------------------------------------------
  1 | from rest_framework.exceptions import APIException
  2 | from rest_framework import status
  3 | 
  4 | 
  5 | # AC Service exceptions
  6 | 
  7 | class ACException(Exception):
  8 |     msg = None
  9 |     status = None
 10 | 
 11 |     def __init__(self, msg=None, status=None):
 12 | 
 13 |         # Set defaults (if not set in subclass)
 14 |         if self.msg is None:
 15 |             self.msg = ""
 16 |         if self.status is None:
 17 |             self.msg = -1
 18 | 
 19 |         # Override with arguments (if any)
 20 |         if msg is not None:
 21 |             self.msg = msg
 22 |         if status is not None:
 23 |             self.status = status
 24 | 
 25 |     def __repr__(self):
 26 |         return self.msg
 27 | 
 28 | 
 29 | class ImproperlyConfiguredACService(ACException):
 30 |     pass
 31 | 
 32 | 
 33 | class ACServiceDoesNotExist(ACException):
 34 |     pass
 35 | 
 36 | 
 37 | class ACFieldTranslateException(ACException):
 38 |     pass
 39 | 
 40 | 
 41 | class ACFilterParsingException(ACException):
 42 |     pass
 43 | 
 44 | 
 45 | # AC API Exceptions
 46 | 
 47 | class ACAPIException(APIException):
 48 | 
 49 |     @property
 50 |     def msg(self):
 51 |         return self.detail or self.default_detail
 52 | 
 53 |     @property
 54 |     def status(self):
 55 |         return self.status_code
 56 | 
 57 | 
 58 | class ACAPIInvalidUrl(ACAPIException):
 59 |     status_code = status.HTTP_400_BAD_REQUEST
 60 |     default_detail = 'Invalid URL.'
 61 |     default_code = 'invalid_url'
 62 | 
 63 | 
 64 | class ACAPIServiceDoesNotExist(ACAPIException):
 65 |     status_code = status.HTTP_404_NOT_FOUND
 66 |     default_detail = 'Requested service does not exist.'
 67 |     default_code = 'service_does_not_exist'
 68 | 
 69 | 
 70 | class ACAPINoServiceAvailable(ACAPIException):
 71 |     status_code = status.HTTP_400_BAD_REQUEST
 72 |     default_detail = 'No service is able to answer your request.'
 73 |     default_code = 'no_service_available'
 74 | 
 75 | 
 76 | class ACAPIPageNotFound(ACAPIException):
 77 |     status_code = status.HTTP_404_NOT_FOUND
 78 |     default_detail = 'Page not found.'
 79 |     default_code = 'page_not_found'
 80 | 
 81 | 
 82 | class ACAPIResourceDoesNotExist(ACAPIException):
 83 |     status_code = status.HTTP_404_NOT_FOUND
 84 |     default_detail = 'Requested resource does not exist.'
 85 |     default_code = 'resource_not_found'
 86 | 
 87 | 
 88 | class ACAPIResponseDoesNotExist(ACAPIException):
 89 |     status_code = status.HTTP_404_NOT_FOUND
 90 |     default_detail = 'Requested response does not exist.'
 91 |     default_code = 'response_not_found'
 92 | 
 93 | 
 94 | class ACAPIInvalidACID(ACAPIException):
 95 |     status_code = status.HTTP_400_BAD_REQUEST
 96 |     default_detail = 'Invalid Audio Commons Unique Identifier.'
 97 |     default_code = 'invalid_acid'
 98 | 
 99 | 
100 | class ACAPIInvalidCredentialsForService(ACAPIException):
101 |     status_code = status.HTTP_401_UNAUTHORIZED
102 |     default_detail = 'Credentials to access third party service are invalid or have expired.'
103 |     default_code = 'invalid_credentials_for_service'
104 | 
105 | 
106 | class ACAPIBadRequest(ACAPIException):
107 |     status_code = status.HTTP_400_BAD_REQUEST
108 |     default_detail = 'Bad request.'
109 |     default_code = 'bad_request'
110 | 
111 | 
112 | class ACAPIUnsupportedFormat(ACAPIException):
113 |     status_code = status.HTTP_400_BAD_REQUEST
114 |     default_detail = 'Unsupported response format.'
115 |     default_code = 'bad_request'
116 | 


--------------------------------------------------------------------------------
/ac_mediator/urls.py:
--------------------------------------------------------------------------------
 1 | from django.conf import settings
 2 | from django.conf.urls import include, url
 3 | from django.contrib import admin
 4 | from django.contrib.auth import views as auth_views
 5 | from accounts.views import registration, activate_account, resend_activation_emmil
 6 | from ac_mediator.views import monitor, crash_me
 7 | from django.contrib.staticfiles.urls import staticfiles_urlpatterns
 8 | 
 9 | 
10 | # Auth urls
11 | # https://stackoverflow.com/questions/6930982/how-to-use-a-variable-inside-a-regular-expression
12 | # domainPrefix = "authenticate/"
13 | domainPrefix = ""
14 | 
15 | urlpatterns = [
16 |     url(r'^%scrash/$' % domainPrefix, crash_me, name='crash_me'),
17 |     url(r'^%sregister/$' % domainPrefix, registration, name='registration'),
18 |     url(r'^%sactivate/(?P<username>[^\/]+)/(?P<uid_hash>[^\/]+)/.*$' % domainPrefix, activate_account, name="accounts-activate"),
19 |     url(r'^%sreactivate/$' % domainPrefix, resend_activation_emmil, name="accounts-resend-activation"),
20 |     url(r'^%slogin/$' % domainPrefix, auth_views.login, {'template_name': 'accounts/login.html'}, name='login'),
21 |     url(r'^%slogout/$' % domainPrefix, auth_views.logout, {'next_page': settings.LOGOUT_URL}, name='logout'),
22 |     url(r'^%spassword_reset/$' % domainPrefix, auth_views.password_reset, dict(
23 |             template_name='accounts/password_reset_form.html',
24 |             subject_template_name='emails/password_reset_subject.txt',
25 |             email_template_name='emails/password_reset.txt',
26 |         ), name='password_reset'),
27 |     url(r'^%spassword_reset/done/$' % domainPrefix, auth_views.password_reset_done, dict(
28 |             template_name='accounts/password_reset_done.html'
29 |         ), name='password_reset_done'),
30 |     url(r'^%sreset/(?P<uidb64>[0-9A-Za-z_\-]+)/(?P<token>[0-9A-Za-z]{1,13}-[0-9A-Za-z]{1,20})/$' % domainPrefix,
31 |         auth_views.password_reset_confirm, dict(
32 |             template_name='accounts/password_reset_confirm.html'
33 |         ), name='password_reset_confirm'),
34 |     url(r'^%sreset/done/$' % domainPrefix, auth_views.password_reset_complete, dict(
35 |             template_name='accounts/password_reset_complete.html'
36 |         ), name='password_reset_complete'),
37 | 
38 |     # Accounts
39 |     url(r'^%s' % domainPrefix, include('accounts.urls')),
40 | 
41 |     # Developers
42 |     url(r'^developers/', include('developers.urls')),
43 | 
44 |     # Api
45 |     url(r'^%sapi/' % domainPrefix, include('api.urls')),
46 | 
47 |     # Admin
48 |     url(r'^admin/monitor/$', monitor, name="admin-monitor"),
49 |     url(r'^admin/', admin.site.urls),
50 | 
51 |     # Documentation
52 |     url(r'^docs/', include('docs.urls')),
53 | ]
54 | 
55 | if settings.DEBUG:
56 |     # We need to explicitly add staticfiles urls because we don't use runserver
57 |     # https://docs.djangoproject.com/en/1.10/ref/contrib/staticfiles/#django.contrib.staticfiles.urls.staticfiles_urlpatterns
58 |     urlpatterns += staticfiles_urlpatterns()
59 | 


--------------------------------------------------------------------------------
/ac_mediator/views.py:
--------------------------------------------------------------------------------
 1 | import os
 2 | from django.shortcuts import render
 3 | from django.contrib.auth.decorators import login_required, user_passes_test
 4 | 
 5 | 
 6 | @login_required
 7 | @user_passes_test(lambda u: u.is_staff, login_url='/')
 8 | def crash_me(request):
 9 |     raise Exception('Everything is under control')
10 | 
11 | 
12 | @login_required
13 | def monitor(request):
14 |     flower_auth = os.getenv('FLOWER_BASIC_AUTH', ':').split(':')
15 |     redmon_auth = os.getenv('FLOWER_BASIC_AUTH', ':').split(':')
16 |     return render(request, 'admin/monitor.html', {
17 |         'flower_auth': flower_auth,
18 |         'redmon_auth': redmon_auth,
19 |     })
20 | 


--------------------------------------------------------------------------------
/ac_mediator/wsgi.py:
--------------------------------------------------------------------------------
 1 | """
 2 | WSGI config for ac_mediator project.
 3 | 
 4 | It exposes the WSGI callable as a module-level variable named ``application``.
 5 | 
 6 | For more information on this file, see
 7 | https://docs.djangoproject.com/en/1.10/howto/deployment/wsgi/
 8 | """
 9 | 
10 | import os
11 | 
12 | from django.core.wsgi import get_wsgi_application
13 | 
14 | os.environ.setdefault("DJANGO_SETTINGS_MODULE", "ac_mediator.settings")
15 | 
16 | application = get_wsgi_application()
17 | 


--------------------------------------------------------------------------------
/accounts/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AudioCommons/ac-mediator/3201c12865d986fd945a1108b00ad9e85d459827/accounts/__init__.py


--------------------------------------------------------------------------------
/accounts/admin.py:
--------------------------------------------------------------------------------
1 | from django.contrib import admin
2 | from django.contrib.auth.models import Group
3 | from accounts.models import Account, ServiceCredentials
4 | 
5 | admin.site.register(Account)
6 | admin.site.register(ServiceCredentials)
7 | admin.site.unregister(Group)  # Remove 'Groups' from admin
8 | 


--------------------------------------------------------------------------------
/accounts/apps.py:
--------------------------------------------------------------------------------
1 | from django.apps import AppConfig
2 | 
3 | 
4 | class UsersConfig(AppConfig):
5 |     name = 'accounts'
6 | 


--------------------------------------------------------------------------------
/accounts/forms.py:
--------------------------------------------------------------------------------
 1 | from django import forms
 2 | from accounts.models import Account
 3 | from django.utils.translation import ugettext as _
 4 | 
 5 | 
 6 | class RegistrationForm(forms.Form):
 7 |     username = forms.RegexField(
 8 |         label=_("Username"),
 9 |         min_length=3,
10 |         max_length=30,
11 |         regex=r'^\w+$',
12 |         help_text=_("Required. 30 characters or fewer. Alphanumeric characters only (letters, digits and underscores)."),
13 |         error_messages={'only_letters': _("This value must contain only letters, numbers and underscores.")}
14 |     )
15 |     email1 = forms.EmailField(label=_("Email"), help_text=_("We will send you a confirmation/activation email, so make "
16 |                                                             "sure this is correct!."))
17 |     email2 = forms.EmailField(label=_("Email confirmation"))
18 |     password1 = forms.CharField(label=_("Password"), widget=forms.PasswordInput)
19 |     password2 = forms.CharField(label=_("Password confirmation"), widget=forms.PasswordInput)
20 |     accepted_tos = forms.BooleanField(
21 |         label='',
22 |         help_text=_('Check this box to accept the <a href="/docs/api_tos.html" target="_blank">terms of service and '
23 |                     'privacy policy</a>'),
24 |         required=True,
25 |         error_messages={'required': _('You must accept the terms of use in order to register.')}
26 |     )
27 | 
28 |     def clean_username(self):
29 |         username = self.cleaned_data["username"]
30 |         try:
31 |             Account.objects.get(username__iexact=username)
32 |         except Account.DoesNotExist:
33 |             return username
34 |         raise forms.ValidationError(_("A user with that username already exists."))
35 | 
36 |     def clean_password2(self):
37 |         password1 = self.cleaned_data.get("password1", "")
38 |         password2 = self.cleaned_data["password2"]
39 |         if password1 != password2:
40 |             raise forms.ValidationError(_("The two password fields didn't match."))
41 |         return password2
42 | 
43 |     def clean_email2(self):
44 |         email1 = self.cleaned_data.get("email1", "")
45 |         email2 = self.cleaned_data["email2"]
46 |         if email1 != email2:
47 |             raise forms.ValidationError(_("The two email fields didn't match."))
48 |         try:
49 |             Account.objects.get(email__iexact=email2)
50 |             raise forms.ValidationError(_("A user using that email address already exists."))
51 |         except Account.DoesNotExist:
52 |             pass
53 |         return email2
54 | 
55 |     def save(self):
56 |         username = self.cleaned_data["username"]
57 |         email = self.cleaned_data["email2"]
58 |         password = self.cleaned_data["password2"]
59 |         accepted_tos = self.cleaned_data.get("accepted_tos", False)
60 | 
61 |         account = Account(username=username,
62 |                           email=email,
63 |                           accepted_tos=accepted_tos)
64 |         account.set_password(password)
65 |         account.save()
66 |         return account
67 | 
68 | 
69 | class ReactivationForm(forms.Form):
70 |     account = forms.CharField(label="The username or email you signed up with")
71 | 
72 |     def clean_account(self):
73 |         username_or_email = self.cleaned_data["account"]
74 |         try:
75 |             return Account.objects.get(email__iexact=username_or_email, is_active=False)
76 |         except Account.DoesNotExist:
77 |             pass
78 |         try:
79 |             return Account.objects.get(username__iexact=username_or_email, is_active=False)
80 |         except Account.DoesNotExist:
81 |             pass
82 |         raise forms.ValidationError(_("No non-active user with such email or username exists."))
83 | 


--------------------------------------------------------------------------------
/accounts/management/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AudioCommons/ac-mediator/3201c12865d986fd945a1108b00ad9e85d459827/accounts/management/__init__.py


--------------------------------------------------------------------------------
/accounts/management/commands/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AudioCommons/ac-mediator/3201c12865d986fd945a1108b00ad9e85d459827/accounts/management/commands/__init__.py


--------------------------------------------------------------------------------
/accounts/management/commands/renew_access_tokens.py:
--------------------------------------------------------------------------------
 1 | from django.core.management.base import BaseCommand
 2 | from accounts.models import ServiceCredentials
 3 | from services.mgmt import get_service_by_id
 4 | from ac_mediator.exceptions import ACServiceDoesNotExist
 5 | import logging
 6 | logger = logging.getLogger('management')
 7 | 
 8 | 
 9 | class Command(BaseCommand):
10 |     help = 'Renew access tokens to 3rd party services whose refresh tokens are about to expire. ' \
11 |            'Use as `python manage.py renew_access_tokens`.'
12 | 
13 |     def add_arguments(self, parser):
14 |         pass
15 | 
16 |     def handle(self, *args, **options):
17 |         """
18 |         When users link their accounts with third party services, these typically return an access token
19 |         together with a refresh token. Both types of tokens do expire at some point (refresh tokens have
20 |         a longer lifetime). If the access token expires but the refresh token is still valid, the Audio Commons
21 |         mediator can easily get a renewed pair using the refresh token. However if the refresh token expires,
22 |         then there is no way the mediator can renew the token without user intervention and the user will need to
23 |         manually link his account again.
24 |         
25 |         This account will iterate over user accounts and their linked services, and renew access/refresh token
26 |         pairs in the cases when refresh token is about to expire.
27 |         
28 |         More info: https://github.com/AudioCommons/ac-mediator/issues/4
29 |         """
30 | 
31 |         n_success = 0
32 |         n_failed = 0
33 | 
34 |         for service_credentials in ServiceCredentials.objects.all():
35 |             try:
36 |                 service = get_service_by_id(service_credentials.service_id)
37 |             except ACServiceDoesNotExist:
38 |                 n_failed += 1
39 |                 continue  # If service does not exist, don't try to renew credentials
40 | 
41 |             if service.check_credentials_should_be_renewed_background(service_credentials.credentials):
42 |                 success, received_credentials = service.renew_credentials(service_credentials.credentials)
43 |                 if success:
44 |                     # Store credentials (replace existing ones if needed)
45 |                     service_credentials, is_new = ServiceCredentials.objects.get_or_create(
46 |                         account=service_credentials.account, service_id=service.id)
47 |                     service_credentials.credentials = received_credentials
48 |                     service_credentials.save()
49 |                     n_success += 1
50 |                 else:
51 |                     # If credentials can't be renewed, then users will need to renew them manually
52 |                     n_failed += 1
53 | 
54 |         logger.info('Renewed {0} service credentials ({0} failed renewal)'.format(n_success, n_failed))
55 | 


--------------------------------------------------------------------------------
/accounts/migrations/0001_initial.py:
--------------------------------------------------------------------------------
 1 | # -*- coding: utf-8 -*-
 2 | # Generated by Django 1.10.2 on 2016-10-25 13:43
 3 | from __future__ import unicode_literals
 4 | 
 5 | import django.contrib.auth.models
 6 | import django.contrib.auth.validators
 7 | from django.db import migrations, models
 8 | import django.utils.timezone
 9 | 
10 | 
11 | class Migration(migrations.Migration):
12 | 
13 |     initial = True
14 | 
15 |     dependencies = [
16 |         ('auth', '0008_alter_user_username_max_length'),
17 |     ]
18 | 
19 |     operations = [
20 |         migrations.CreateModel(
21 |             name='Account',
22 |             fields=[
23 |                 ('id', models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
24 |                 ('password', models.CharField(max_length=128, verbose_name='password')),
25 |                 ('last_login', models.DateTimeField(blank=True, null=True, verbose_name='last login')),
26 |                 ('is_superuser', models.BooleanField(default=False, help_text='Designates that this user has all permissions without explicitly assigning them.', verbose_name='superuser status')),
27 |                 ('username', models.CharField(error_messages={'unique': 'A user with that username already exists.'}, help_text='Required. 150 characters or fewer. Letters, digits and @/./+/-/_ only.', max_length=150, unique=True, validators=[django.contrib.auth.validators.UnicodeUsernameValidator()], verbose_name='username')),
28 |                 ('first_name', models.CharField(blank=True, max_length=30, verbose_name='first name')),
29 |                 ('last_name', models.CharField(blank=True, max_length=30, verbose_name='last name')),
30 |                 ('email', models.EmailField(blank=True, max_length=254, verbose_name='email address')),
31 |                 ('is_staff', models.BooleanField(default=False, help_text='Designates whether the user can log into this admin site.', verbose_name='staff status')),
32 |                 ('is_active', models.BooleanField(default=True, help_text='Designates whether this user should be treated as active. Unselect this instead of deleting accounts.', verbose_name='active')),
33 |                 ('date_joined', models.DateTimeField(default=django.utils.timezone.now, verbose_name='date joined')),
34 |                 ('is_developer', models.BooleanField(default=False)),
35 |                 ('groups', models.ManyToManyField(blank=True, help_text='The groups this user belongs to. A user will get all permissions granted to each of their groups.', related_name='user_set', related_query_name='user', to='auth.Group', verbose_name='groups')),
36 |                 ('user_permissions', models.ManyToManyField(blank=True, help_text='Specific permissions for this user.', related_name='user_set', related_query_name='user', to='auth.Permission', verbose_name='user permissions')),
37 |             ],
38 |             options={
39 |                 'verbose_name': 'user',
40 |                 'abstract': False,
41 |                 'verbose_name_plural': 'users',
42 |             },
43 |             managers=[
44 |                 ('objects', django.contrib.auth.models.UserManager()),
45 |             ],
46 |         ),
47 |     ]
48 | 


--------------------------------------------------------------------------------
/accounts/migrations/0002_auto_20161025_1607.py:
--------------------------------------------------------------------------------
 1 | # -*- coding: utf-8 -*-
 2 | # Generated by Django 1.10.2 on 2016-10-25 14:07
 3 | from __future__ import unicode_literals
 4 | 
 5 | from django.conf import settings
 6 | import django.contrib.postgres.fields.jsonb
 7 | from django.db import migrations, models
 8 | import django.db.models.deletion
 9 | 
10 | 
11 | class Migration(migrations.Migration):
12 | 
13 |     dependencies = [
14 |         ('accounts', '0001_initial'),
15 |     ]
16 | 
17 |     operations = [
18 |         migrations.CreateModel(
19 |             name='ServiceCredentials',
20 |             fields=[
21 |                 ('id', models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
22 |                 ('service_id', models.CharField(max_length=64)),
23 |                 ('credentials', django.contrib.postgres.fields.jsonb.JSONField()),
24 |             ],
25 |         ),
26 |         migrations.AlterModelOptions(
27 |             name='account',
28 |             options={'verbose_name': 'account', 'verbose_name_plural': 'accounts'},
29 |         ),
30 |         migrations.AddField(
31 |             model_name='servicecredentials',
32 |             name='account',
33 |             field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='service_credentials', to=settings.AUTH_USER_MODEL),
34 |         ),
35 |     ]
36 | 


--------------------------------------------------------------------------------
/accounts/migrations/0003_auto_20161025_1641.py:
--------------------------------------------------------------------------------
 1 | # -*- coding: utf-8 -*-
 2 | # Generated by Django 1.10.2 on 2016-10-25 14:41
 3 | from __future__ import unicode_literals
 4 | 
 5 | from django.db import migrations
 6 | 
 7 | 
 8 | class Migration(migrations.Migration):
 9 | 
10 |     dependencies = [
11 |         ('accounts', '0002_auto_20161025_1607'),
12 |     ]
13 | 
14 |     operations = [
15 |         migrations.AlterModelOptions(
16 |             name='servicecredentials',
17 |             options={'verbose_name': 'service credentials', 'verbose_name_plural': 'service credentials'},
18 |         ),
19 |     ]
20 | 


--------------------------------------------------------------------------------
/accounts/migrations/0004_account_accepted_tos.py:
--------------------------------------------------------------------------------
 1 | # -*- coding: utf-8 -*-
 2 | # Generated by Django 1.10.2 on 2016-10-26 10:58
 3 | from __future__ import unicode_literals
 4 | 
 5 | from django.db import migrations, models
 6 | 
 7 | 
 8 | class Migration(migrations.Migration):
 9 | 
10 |     dependencies = [
11 |         ('accounts', '0003_auto_20161025_1641'),
12 |     ]
13 | 
14 |     operations = [
15 |         migrations.AddField(
16 |             model_name='account',
17 |             name='accepted_tos',
18 |             field=models.BooleanField(default=False),
19 |         ),
20 |     ]
21 | 


--------------------------------------------------------------------------------
/accounts/migrations/0005_servicecredentials_created.py:
--------------------------------------------------------------------------------
 1 | # -*- coding: utf-8 -*-
 2 | # Generated by Django 1.10.2 on 2016-10-27 08:51
 3 | from __future__ import unicode_literals
 4 | 
 5 | from django.db import migrations, models
 6 | import django.utils.timezone
 7 | 
 8 | 
 9 | class Migration(migrations.Migration):
10 | 
11 |     dependencies = [
12 |         ('accounts', '0004_account_accepted_tos'),
13 |     ]
14 | 
15 |     operations = [
16 |         migrations.AddField(
17 |             model_name='servicecredentials',
18 |             name='created',
19 |             field=models.DateTimeField(auto_now_add=True, default=django.utils.timezone.now),
20 |             preserve_default=False,
21 |         ),
22 |     ]
23 | 


--------------------------------------------------------------------------------
/accounts/migrations/0006_auto_20161027_1627.py:
--------------------------------------------------------------------------------
 1 | # -*- coding: utf-8 -*-
 2 | # Generated by Django 1.10.2 on 2016-10-27 14:27
 3 | from __future__ import unicode_literals
 4 | 
 5 | from django.db import migrations
 6 | 
 7 | 
 8 | class Migration(migrations.Migration):
 9 | 
10 |     dependencies = [
11 |         ('accounts', '0005_servicecredentials_created'),
12 |     ]
13 | 
14 |     operations = [
15 |         migrations.AlterUniqueTogether(
16 |             name='servicecredentials',
17 |             unique_together=set([('account', 'service_id')]),
18 |         ),
19 |     ]
20 | 


--------------------------------------------------------------------------------
/accounts/migrations/0007_servicecredentials_modified.py:
--------------------------------------------------------------------------------
 1 | # -*- coding: utf-8 -*-
 2 | # Generated by Django 1.10.2 on 2016-10-27 14:31
 3 | from __future__ import unicode_literals
 4 | 
 5 | from django.db import migrations, models
 6 | 
 7 | 
 8 | class Migration(migrations.Migration):
 9 | 
10 |     dependencies = [
11 |         ('accounts', '0006_auto_20161027_1627'),
12 |     ]
13 | 
14 |     operations = [
15 |         migrations.AddField(
16 |             model_name='servicecredentials',
17 |             name='modified',
18 |             field=models.DateTimeField(auto_now=True),
19 |         ),
20 |     ]
21 | 


--------------------------------------------------------------------------------
/accounts/migrations/0008_auto_20161027_1650.py:
--------------------------------------------------------------------------------
 1 | # -*- coding: utf-8 -*-
 2 | # Generated by Django 1.10.2 on 2016-10-27 14:50
 3 | from __future__ import unicode_literals
 4 | 
 5 | import django.contrib.postgres.fields.jsonb
 6 | from django.db import migrations
 7 | 
 8 | 
 9 | class Migration(migrations.Migration):
10 | 
11 |     dependencies = [
12 |         ('accounts', '0007_servicecredentials_modified'),
13 |     ]
14 | 
15 |     operations = [
16 |         migrations.AlterField(
17 |             model_name='servicecredentials',
18 |             name='credentials',
19 |             field=django.contrib.postgres.fields.jsonb.JSONField(blank=True, default=None),
20 |         ),
21 |     ]
22 | 


--------------------------------------------------------------------------------
/accounts/migrations/0009_auto_20161027_1651.py:
--------------------------------------------------------------------------------
 1 | # -*- coding: utf-8 -*-
 2 | # Generated by Django 1.10.2 on 2016-10-27 14:51
 3 | from __future__ import unicode_literals
 4 | 
 5 | import django.contrib.postgres.fields.jsonb
 6 | from django.db import migrations
 7 | 
 8 | 
 9 | class Migration(migrations.Migration):
10 | 
11 |     dependencies = [
12 |         ('accounts', '0008_auto_20161027_1650'),
13 |     ]
14 | 
15 |     operations = [
16 |         migrations.AlterField(
17 |             model_name='servicecredentials',
18 |             name='credentials',
19 |             field=django.contrib.postgres.fields.jsonb.JSONField(default={}),
20 |         ),
21 |     ]
22 | 


--------------------------------------------------------------------------------
/accounts/migrations/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AudioCommons/ac-mediator/3201c12865d986fd945a1108b00ad9e85d459827/accounts/migrations/__init__.py


--------------------------------------------------------------------------------
/accounts/models.py:
--------------------------------------------------------------------------------
 1 | from django.db import models
 2 | from django.contrib.auth.models import AbstractUser
 3 | from django.contrib.postgres.fields import JSONField
 4 | from django.utils.translation import ugettext_lazy as _
 5 | from utils.mail import send_mail
 6 | from utils.encryption import create_hash
 7 | 
 8 | 
 9 | class Account(AbstractUser):
10 |     """
11 |     This is our custom 'User' model.
12 |     """
13 | 
14 |     is_developer = models.BooleanField(default=False, blank=False)
15 |     accepted_tos = models.BooleanField(default=False, blank=False)
16 |     #  Add more custom fields here like avatar...
17 | 
18 |     def send_activation_email(self):
19 |         tvars = {
20 |             'user': self,
21 |             'username': self.username,
22 |             'hash': create_hash(self.id)
23 |         }
24 |         send_mail(self.email, subject='Activate your Audio Commons user account',
25 |                   template='emails/account_activation.txt', context=tvars)
26 | 
27 |     class Meta:
28 |         verbose_name = _('account')
29 |         verbose_name_plural = _('accounts')
30 | 
31 | 
32 | class ServiceCredentials(models.Model):
33 |     """
34 |     This model is intended to store the credentials returned by a service after
35 |     an Audio Commons account is linked with it. Credentials are intentionally
36 |     stored in a JSONField to accommodate different types of credentials returned
37 |     by services. The ACServiceBase authentication methods will be in charge of
38 |     interpreting the contests of the 'credentials' field.
39 |     """
40 | 
41 |     account = models.ForeignKey(Account, related_name='service_credentials')
42 |     service_id = models.CharField(max_length=64)
43 |     credentials = JSONField(null=False, default={})
44 |     created = models.DateTimeField(auto_now_add=True)
45 |     modified = models.DateTimeField(auto_now=True)
46 | 
47 |     class Meta:
48 |         verbose_name = _('service credentials')
49 |         verbose_name_plural = _('service credentials')
50 |         unique_together = (('account', 'service_id'),)
51 | 
52 |     def __str__(self):
53 |         return 'ServiceCredentials for {0} and {1}'.format(self.account.username, self.service_id)
54 | 


--------------------------------------------------------------------------------
/accounts/templatetags/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AudioCommons/ac-mediator/3201c12865d986fd945a1108b00ad9e85d459827/accounts/templatetags/__init__.py


--------------------------------------------------------------------------------
/accounts/templatetags/absurl.py:
--------------------------------------------------------------------------------
 1 | from urllib.parse import urljoin
 2 | from django.template import Library
 3 | from django.template.defaulttags import URLNode, url
 4 | from django.conf import settings
 5 | 
 6 | register = Library()
 7 | 
 8 | 
 9 | class AbsoluteURLNode(URLNode):
10 |     def render(self, context):
11 |         path = super(AbsoluteURLNode, self).render(context)
12 |         domain = settings.BASE_URL
13 |         return urljoin(domain, path)
14 | 
15 | 
16 | def absurl(parser, token, node_cls=AbsoluteURLNode):
17 |     """Just like {% url %} but ads the domain of the current site."""
18 |     node_instance = url(parser, token)
19 |     return node_cls(view_name=node_instance.view_name,
20 |                     args=node_instance.args,
21 |                     kwargs=node_instance.kwargs,
22 |                     asvar=node_instance.asvar)
23 | 
24 | absurl = register.tag(absurl)
25 | 


--------------------------------------------------------------------------------
/accounts/tests.py:
--------------------------------------------------------------------------------
 1 | from django.test import TestCase, override_settings
 2 | from accounts.models import Account
 3 | from django.core.urlresolvers import reverse
 4 | from django.core import mail
 5 | from django.conf import settings
 6 | 
 7 | 
 8 | @override_settings(EMAIL_BACKEND='django.core.mail.backends.locmem.EmailBackend')
 9 | class AccountRegistrationTestCase(TestCase):
10 | 
11 |     def test_user_registration(self):
12 | 
13 |         # Register new account
14 |         post_data = {
15 |             'password1': '123456',
16 |             'password2': '123456',
17 |             'accepted_tos': 'on',
18 |             'username': 'test_username',
19 |             'email1': 'example@email.com',
20 |             'email2': 'example@email.com',
21 |         }
22 |         resp = self.client.post(reverse('registration'), data=post_data)
23 |         self.assertEquals(resp.status_code, 200)
24 | 
25 |         # Check that a user object has been created with that user name but it is still inactive
26 |         account = Account.objects.get(username='test_username')
27 |         self.assertEquals(account.is_active, False)
28 | 
29 |         # Check that an email was sent
30 |         self.assertEquals(len(mail.outbox), 1)
31 | 
32 |         # Try to activate user with wrong username
33 |         resp = self.client.get(reverse('accounts-activate', args=['fake_username', 'fake_hash']))
34 |         self.assertEquals(resp.status_code, 200)
35 |         self.assertEquals('the user you are trying to activate does not exist' in resp.content.decode("utf-8"), True)
36 | 
37 |         # Try to activate user with fake hash
38 |         resp = self.client.get(reverse('accounts-activate', args=[account.username, 'fake_hash']))
39 |         self.assertEquals(resp.status_code, 200)
40 |         self.assertEquals("we can't find that activation key" in resp.content.decode("utf-8"), True)
41 | 
42 |         # Extract hash from email and activate user
43 |         email_body = mail.outbox[0].body
44 |         activation_url = [line for line in email_body.split('\n') if line.startswith(settings.BASE_URL)][0]
45 |         uid_hash = activation_url.split('/')[-2]
46 |         resp = self.client.get(reverse('accounts-activate', args=[account.username, uid_hash]))
47 |         self.assertEquals(resp.status_code, 200)
48 |         self.assertEquals('Activation succeeded...' in resp.content.decode("utf-8"), True)
49 | 
50 |         # Check that user is now active
51 |         account = Account.objects.get(username='test_username')
52 |         self.assertEquals(account.is_active, True)
53 | 


--------------------------------------------------------------------------------
/accounts/urls.py:
--------------------------------------------------------------------------------
 1 | from django.conf.urls import url
 2 | from django.core.urlresolvers import reverse_lazy
 3 | from accounts import views
 4 | from oauth2_provider.views.token import AuthorizedTokenDeleteView, AuthorizedTokensListView
 5 | from accounts.views import home
 6 | 
 7 | 
 8 | # Auth urls
 9 | # https://stackoverflow.com/questions/6930982/how-to-use-a-variable-inside-a-regular-expression
10 | # domainPrefix = "authenticate/"
11 | domainPrefix = ""
12 | urlpatterns = [
13 |     # Home
14 |     url(r'^%s$' % domainPrefix, home, name='home'),
15 |     url(r'^%sabout/$' % domainPrefix, views.about, name='about'),
16 | 
17 |     # Link services
18 |     url(r'^%slink_services/$' % domainPrefix, views.link_services, name='link_services'),
19 |     url(r'^%slink_service/(?P<service_id>[^\/]+)/$' % domainPrefix, views.link_service_callback, name='link_service_callback'),
20 |     url(r'^%slink_service_get_token/(?P<service_id>[^\/]+)/$' % domainPrefix, views.link_service_get_token, name='link_service_get_token'),
21 |     url(r'^%sunlink_service/(?P<service_id>[^\/]+)/$' % domainPrefix, views.unlink_service, name='unlink_service'),
22 | 
23 |     # Manage given api credentials
24 |     url(r'^%sauthorized_clients/$' % domainPrefix, AuthorizedTokensListView.as_view(
25 |         template_name='accounts/authorized-tokens.html',
26 |     ), name="authorized-token-list"),
27 |     url(r'^%sauthorized_clients/(?P<pk>\d+)/delete/$' % domainPrefix, AuthorizedTokenDeleteView.as_view(
28 |         template_name='accounts/authorized-token-delete.html',
29 |         success_url=reverse_lazy('authorized-token-list'),
30 |     ), name="authorized-token-delete"),
31 | ]
32 | 


--------------------------------------------------------------------------------
/accounts/views.py:
--------------------------------------------------------------------------------
  1 | from django.shortcuts import render
  2 | from django.contrib.auth.decorators import login_required
  3 | from django.core.urlresolvers import reverse
  4 | from django.http import HttpResponseRedirect
  5 | from accounts.forms import RegistrationForm, ReactivationForm
  6 | from accounts.models import ServiceCredentials, Account
  7 | from services.mgmt import get_available_services, get_service_by_id
  8 | from services.acservice.constants import ENDUSER_AUTH_METHOD
  9 | from ac_mediator.exceptions import *
 10 | from utils.encryption import create_hash
 11 | 
 12 | 
 13 | def registration(request):
 14 |     if request.user.is_authenticated():
 15 |         return HttpResponseRedirect(reverse('home'))
 16 |     if request.method == 'POST':
 17 |         form = RegistrationForm(request.POST)
 18 |         if form.is_valid():
 19 |             account = form.save()
 20 |             account.is_active = False
 21 |             account.save()
 22 |             account.send_activation_email()
 23 |             return render(request, 'accounts/registration.html', {'form': None})
 24 |     else:
 25 |         form = RegistrationForm()
 26 |     return render(request, 'accounts/registration.html', {'form': form})
 27 | 
 28 | 
 29 | def activate_account(request, username, uid_hash):
 30 |     if request.user.is_authenticated:
 31 |         return HttpResponseRedirect(reverse('home'))
 32 | 
 33 |     try:
 34 |         account = Account.objects.get(username__iexact=username)
 35 |     except Account.DoesNotExist:
 36 |         return render(request, 'accounts/activate.html', {'user_does_not_exist': True})
 37 | 
 38 |     new_hash = create_hash(account.id)
 39 |     if new_hash != uid_hash:
 40 |         return render(request, 'accounts/activate.html', {'decode_error': True})
 41 | 
 42 |     account.is_active = True
 43 |     account.save()
 44 |     return render(request, 'accounts/activate.html', {'all_ok': True})
 45 | 
 46 | 
 47 | def resend_activation_emmil(request):
 48 |     if request.user.is_authenticated:
 49 |         return HttpResponseRedirect(reverse('home'))
 50 | 
 51 |     if request.method == 'POST':
 52 |         form = ReactivationForm(request.POST)
 53 |         if form.is_valid():
 54 |             account = form.cleaned_data['account']
 55 |             account.send_activation_email()
 56 |             return render(request, 'accounts/resend_activation.html', {'form': None})
 57 |     else:
 58 |         form = ReactivationForm()
 59 |     return render(request, 'accounts/resend_activation.html', {'form': form})
 60 | 
 61 | 
 62 | @login_required
 63 | def home(request):
 64 |     return render(request, 'accounts/home.html')
 65 | 
 66 | 
 67 | @login_required
 68 | def about(request):
 69 |     return render(request, 'accounts/about.html')
 70 | 
 71 | 
 72 | @login_required
 73 | def link_services(request):
 74 |     linkable_services_info = list()
 75 |     non_linkable_services_info = list()
 76 |     for service in get_available_services():
 77 |         if service.supports_auth(ENDUSER_AUTH_METHOD):
 78 |             is_linked = False
 79 |             try:
 80 |                 service.get_enduser_token(request.user)
 81 |                 is_linked = True
 82 |             except (ACException, ACAPIException):
 83 |                 pass
 84 |             linkable_services_info.append((
 85 |                 service,
 86 |                 is_linked,
 87 |             ))
 88 |         else:
 89 |             non_linkable_services_info.append(service)
 90 |     tvars = {'linkable_services_info': linkable_services_info,
 91 |              'non_linkable_services_info': non_linkable_services_info}
 92 |     return render(request, 'accounts/link_services.html', tvars)
 93 | 
 94 | 
 95 | @login_required
 96 | def link_service_callback(request, service_id):
 97 |     try:
 98 |         service = get_service_by_id(service_id)
 99 |     except ACServiceDoesNotExist:
100 |         service = None
101 |     code = request.GET.get('code', None)
102 |     if code is None:
103 |         print('There were errors in the redirect from service: {0}'.format(request.GET.get('error', 'unknown')))
104 |     tvars = {
105 |         'errors': service is None or code is None,
106 |         'service_id': service.id if service is not None else None,
107 |         'code': request.GET.get('code'),
108 |         'complete': False,
109 |     }
110 |     return render(request, 'accounts/link_service_callback.html', tvars)
111 | 
112 | 
113 | def store_service_credentials_helper(credentials, account, service_id):
114 |     # Store credentials (replace existing ones if needed)
115 |     service_credentials, is_new = ServiceCredentials.objects.get_or_create(
116 |         account=account, service_id=service_id)
117 |     service_credentials.credentials = credentials
118 |     service_credentials.save()
119 | 
120 | 
121 | @login_required
122 | def link_service_get_token(request, service_id):
123 |     service = get_service_by_id(service_id)  # No need to check as is called after link_service_callback
124 |     # Request credentials
125 |     success, credentials = service.request_credentials(request.GET.get('code'))
126 |     if success:
127 |         store_service_credentials_helper(credentials, request.user, service.id)
128 |     else:
129 |         # Delete credentials (if existing)
130 |         ServiceCredentials.objects.filter(account=request.user, service_id=service_id).delete()
131 |     tvars = {
132 |         'errors': not success,
133 |         'complete': True,
134 |     }
135 |     return render(request, 'accounts/link_service_callback.html', tvars)
136 | 
137 | 
138 | @login_required
139 | def unlink_service(request, service_id):
140 |     ServiceCredentials.objects.filter(account=request.user, service_id=service_id).delete()
141 |     return HttpResponseRedirect(reverse('link_services'))
142 | 


--------------------------------------------------------------------------------
/api/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AudioCommons/ac-mediator/3201c12865d986fd945a1108b00ad9e85d459827/api/__init__.py


--------------------------------------------------------------------------------
/api/admin.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AudioCommons/ac-mediator/3201c12865d986fd945a1108b00ad9e85d459827/api/admin.py


--------------------------------------------------------------------------------
/api/apps.py:
--------------------------------------------------------------------------------
1 | from django.apps import AppConfig
2 | 
3 | 
4 | class ApiConfig(AppConfig):
5 |     name = 'api'
6 | 


--------------------------------------------------------------------------------
/api/constants.py:
--------------------------------------------------------------------------------
 1 | QUERY_PARAM_QUERY = 'q'
 2 | QUERY_PARAM_SORT = 's'
 3 | QUERY_PARAM_FILTER = 'f'
 4 | QUERY_PARAM_SIZE = 'size'
 5 | QUERY_PARAM_PAGE = 'page'
 6 | QUERY_PARAM_FIELDS = 'fields'
 7 | QUERY_PARAM_OFFSET = 'offset'
 8 | QUERY_PARAM_INCLUDE = 'include'
 9 | QUERY_PARAM_EXCLUDE = 'exclude'
10 | QUERY_PARAM_WAIT_UNTIL_COMPLETE = 'wuc'
11 | QUERY_PARAM_FORMAT = 'format'
12 | 


--------------------------------------------------------------------------------
/api/forms.py:
--------------------------------------------------------------------------------
  1 | from django import forms
  2 | from django.forms import ModelForm
  3 | from django.forms.fields import Field
  4 | from django.utils.text import mark_safe
  5 | from django.forms.widgets import HiddenInput
  6 | from api.models import ApiClient
  7 | setattr(Field, 'is_checkbox', lambda self: isinstance(self.widget, forms.CheckboxInput))  # Used in the template
  8 | 
  9 | 
 10 | class ApiClientForm(ModelForm):
 11 | 
 12 |     # We define a number of predefined combinations of client type and authorization grant type
 13 |     # from which developers can choose when registering a new API client
 14 |     PUBLIC_IMPLICIT = 'public_implicit'
 15 |     PUBLIC_PASSWORD = 'public_password'
 16 |     CONFIDENTIAL_AUTHORIZATION_CODE = 'confidential_authorization-code'
 17 |     APPLICATION_TYPES = (
 18 |         (PUBLIC_IMPLICIT, 'Public client with implicit grant'),
 19 |         (CONFIDENTIAL_AUTHORIZATION_CODE, 'Confidential client with authorization code grant'),
 20 |         (PUBLIC_PASSWORD, 'Public client with password grant'),
 21 |     )
 22 |     application_type = forms.ChoiceField(
 23 |         choices=APPLICATION_TYPES,
 24 |         help_text=mark_safe('Please read the documentation on '
 25 |                             '<a href="/docs/api_authentication.html" target="_blank">'
 26 |                             'choosing the application type</a> before selecting an option.'),
 27 |     )
 28 | 
 29 |     class Meta:
 30 |         model = ApiClient
 31 |         fields = ['name', 'agree_tos', 'application_type', 'authorization_grant_type', 'client_type', 'redirect_uris']
 32 |         labels = {
 33 |             'name': 'Name of your application',
 34 |             'agree_tos': 'Terms of service',
 35 |             'redirect_uris': 'Redirect URIs',
 36 |         }
 37 |         help_texts = {
 38 |             'agree_tos': 'I agree with the Audio Commons API terms of service',
 39 |             'redirect_uris': mark_safe('URIs allowed for the OAuth2 redirect step ' +
 40 |                                        '(not required for password grant). ' +
 41 |                                        '<br>Separate URIs using spaces.'),
 42 |         }
 43 |         widgets = {
 44 |             'authorization_grant_type': HiddenInput(),
 45 |             'client_type': HiddenInput(),
 46 |         }
 47 | 
 48 |     def __init__(self, *args, **kwargs):
 49 |         super().__init__(*args, **kwargs)
 50 |         # Set authorization_grant_type and client_type to not required (we automatically fill them at clean time)
 51 |         self.fields['authorization_grant_type'].required = False
 52 |         self.fields['client_type'].required = False
 53 | 
 54 |         # Preload application_type if authorization_grant_type and client_type are set (i.e. when editing application)
 55 |         instance = kwargs.get('instance', None)
 56 |         if instance:
 57 |             application_type = '{0}_{1}'.format(instance.client_type, instance.authorization_grant_type)
 58 |             self.initial['application_type'] = application_type
 59 | 
 60 |     def clean_name(self):
 61 |         name = self.cleaned_data['name']
 62 |         if not name.strip():
 63 |             raise forms.ValidationError("This field is required")
 64 |         return name
 65 | 
 66 |     def clean_agree_tos(self):
 67 |         agree_tos = self.cleaned_data['agree_tos']
 68 |         if not agree_tos:
 69 |             raise forms.ValidationError("To use the Audio Commons API you must agree with the terms of service")
 70 |         return agree_tos
 71 | 
 72 |     def clean_redirect_uris(self):
 73 |         redirect_uris = self.cleaned_data['redirect_uris']
 74 |         application_type = self.cleaned_data['application_type']
 75 |         if not redirect_uris \
 76 |                 and application_type in (self.PUBLIC_IMPLICIT, self.CONFIDENTIAL_AUTHORIZATION_CODE):
 77 |             raise forms.ValidationError('This field is required when using implicit or authorization code grants')
 78 |         return redirect_uris
 79 | 
 80 |     def clean_authorization_grant_type(self):
 81 |         # Set authorization grant time according to application_type
 82 |         application_type = self.cleaned_data['application_type']
 83 |         if ApiClient.GRANT_IMPLICIT in application_type:
 84 |             authorization_grant_type = ApiClient.GRANT_IMPLICIT
 85 |         elif ApiClient.GRANT_AUTHORIZATION_CODE in application_type:
 86 |             authorization_grant_type = ApiClient.GRANT_AUTHORIZATION_CODE
 87 |         elif ApiClient.GRANT_PASSWORD in application_type:
 88 |             authorization_grant_type = ApiClient.GRANT_PASSWORD
 89 |         else:
 90 |             authorization_grant_type = ApiClient.GRANT_IMPLICIT  # Use implicit by default
 91 |         self.cleaned_data['authorization_grant_type'] = authorization_grant_type
 92 |         return authorization_grant_type
 93 | 
 94 |     def clean_client_type(self):
 95 |         # Set authorization grant time according to application_type
 96 |         application_type = self.cleaned_data['application_type']
 97 |         if ApiClient.CLIENT_PUBLIC in application_type:
 98 |             client_type = ApiClient.CLIENT_PUBLIC
 99 |         else:
100 |             client_type = ApiClient.CLIENT_CONFIDENTIAL
101 |         self.cleaned_data['client_type'] = client_type
102 |         return client_type
103 | 


--------------------------------------------------------------------------------
/api/management/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AudioCommons/ac-mediator/3201c12865d986fd945a1108b00ad9e85d459827/api/management/__init__.py


--------------------------------------------------------------------------------
/api/management/commands/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AudioCommons/ac-mediator/3201c12865d986fd945a1108b00ad9e85d459827/api/management/commands/__init__.py


--------------------------------------------------------------------------------
/api/management/commands/clean_old_responses.py:
--------------------------------------------------------------------------------
 1 | from django.core.management.base import BaseCommand
 2 | from django.conf import settings
 3 | from api.response_aggregator import get_response_aggregator
 4 | import datetime
 5 | import logging
 6 | 
 7 | 
 8 | logger = logging.getLogger('management')
 9 | 
10 | 
11 | class Command(BaseCommand):
12 |     help = 'Clean response objects in the store which are older than `N` days.'
13 | 
14 |     def add_arguments(self, parser):
15 |         pass
16 | 
17 |     def handle(self, *args, **options):
18 |         """
19 |         Every time a new request is made to the endpoints of the Audio Commons API (e.g. search), a response 
20 |         dictionary is created and stored in a shared key-value store (we use a Redis backend). This 
21 |         dictionary is updated as soon as new responses from 3rd party services are received and can be 
22 |         consumed by clients using the /collect endpoint of the Audio Commons API. 
23 |         
24 |         To avoid collapsing our store with unneeded response objects, this commands deletes response objects 
25 |         which are older than a particular number of days. It should be run periodically.
26 |         
27 |         More info: https://github.com/AudioCommons/ac-mediator/issues/8
28 |         """
29 | 
30 |         n_deleted_responses = 0
31 |         n_responses = 0
32 |         response_aggregator = get_response_aggregator()
33 |         store = response_aggregator.store
34 | 
35 |         for key in store.get_all_response_keys():
36 |             response = store.get_response(key)
37 |             if response:
38 |                 try:
39 |                     timestamp = datetime.datetime.strptime(response['meta']['sent_timestamp'], '%Y-%m-%d %H:%M:%S.%f')
40 |                     n_responses += 1
41 |                     if (datetime.datetime.now() - timestamp).total_seconds() > settings.RESPONSE_EXPIRY_TIME:
42 |                         store.delete_response(key)
43 |                         n_deleted_responses += 1
44 | 
45 |                 except KeyError:
46 |                     # If object has no timestamp information, continue with the next response
47 |                     # This could be because the object does not really correspond to an API response
48 |                     pass
49 | 
50 |         logger.info('Removed {0} responses from store (currently has {1} responses)'
51 |                     .format(n_deleted_responses, n_responses - n_deleted_responses))
52 | 


--------------------------------------------------------------------------------
/api/migrations/0001_initial.py:
--------------------------------------------------------------------------------
 1 | # -*- coding: utf-8 -*-
 2 | # Generated by Django 1.10.2 on 2016-10-25 14:41
 3 | from __future__ import unicode_literals
 4 | 
 5 | from django.conf import settings
 6 | from django.db import migrations, models
 7 | import django.db.models.deletion
 8 | import oauth2_provider.generators
 9 | import oauth2_provider.validators
10 | 
11 | 
12 | class Migration(migrations.Migration):
13 | 
14 |     initial = True
15 | 
16 |     dependencies = [
17 |         migrations.swappable_dependency(settings.AUTH_USER_MODEL),
18 |     ]
19 | 
20 |     operations = [
21 |         migrations.CreateModel(
22 |             name='ApiClient',
23 |             fields=[
24 |                 ('id', models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
25 |                 ('client_id', models.CharField(db_index=True, default=oauth2_provider.generators.generate_client_id, max_length=100, unique=True)),
26 |                 ('redirect_uris', models.TextField(blank=True, help_text='Allowed URIs list, space separated', validators=[oauth2_provider.validators.validate_uris])),
27 |                 ('client_type', models.CharField(choices=[('confidential', 'Confidential'), ('public', 'Public')], max_length=32)),
28 |                 ('authorization_grant_type', models.CharField(choices=[('authorization-code', 'Authorization code'), ('implicit', 'Implicit'), ('password', 'Resource owner password-based'), ('client-credentials', 'Client credentials')], max_length=32)),
29 |                 ('client_secret', models.CharField(blank=True, db_index=True, default=oauth2_provider.generators.generate_client_secret, max_length=255)),
30 |                 ('name', models.CharField(blank=True, max_length=255)),
31 |                 ('skip_authorization', models.BooleanField(default=False)),
32 |                 ('agree_tos', models.BooleanField()),
33 |                 ('user', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='api_apiclient', to=settings.AUTH_USER_MODEL)),
34 |             ],
35 |             options={
36 |                 'abstract': False,
37 |             },
38 |         ),
39 |     ]
40 | 


--------------------------------------------------------------------------------
/api/migrations/0002_auto_20161025_1721.py:
--------------------------------------------------------------------------------
 1 | # -*- coding: utf-8 -*-
 2 | # Generated by Django 1.10.2 on 2016-10-25 15:21
 3 | from __future__ import unicode_literals
 4 | 
 5 | from django.db import migrations, models
 6 | 
 7 | 
 8 | class Migration(migrations.Migration):
 9 | 
10 |     dependencies = [
11 |         ('api', '0001_initial'),
12 |     ]
13 | 
14 |     operations = [
15 |         migrations.AlterField(
16 |             model_name='apiclient',
17 |             name='agree_tos',
18 |             field=models.BooleanField(default=False),
19 |         ),
20 |     ]
21 | 


--------------------------------------------------------------------------------
/api/migrations/0003_apiclient_created.py:
--------------------------------------------------------------------------------
 1 | # -*- coding: utf-8 -*-
 2 | # Generated by Django 1.10.2 on 2016-10-27 08:51
 3 | from __future__ import unicode_literals
 4 | 
 5 | from django.db import migrations, models
 6 | import django.utils.timezone
 7 | 
 8 | 
 9 | class Migration(migrations.Migration):
10 | 
11 |     dependencies = [
12 |         ('api', '0002_auto_20161025_1721'),
13 |     ]
14 | 
15 |     operations = [
16 |         migrations.AddField(
17 |             model_name='apiclient',
18 |             name='created',
19 |             field=models.DateTimeField(auto_now_add=True, default=django.utils.timezone.now),
20 |             preserve_default=False,
21 |         ),
22 |     ]
23 | 


--------------------------------------------------------------------------------
/api/migrations/0004_apiclient_password_grant_is_allowed.py:
--------------------------------------------------------------------------------
 1 | # -*- coding: utf-8 -*-
 2 | # Generated by Django 1.10.2 on 2016-11-30 09:04
 3 | from __future__ import unicode_literals
 4 | 
 5 | from django.db import migrations, models
 6 | 
 7 | 
 8 | class Migration(migrations.Migration):
 9 | 
10 |     dependencies = [
11 |         ('api', '0003_apiclient_created'),
12 |     ]
13 | 
14 |     operations = [
15 |         migrations.AddField(
16 |             model_name='apiclient',
17 |             name='password_grant_is_allowed',
18 |             field=models.BooleanField(default=False),
19 |         ),
20 |     ]
21 | 


--------------------------------------------------------------------------------
/api/migrations/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AudioCommons/ac-mediator/3201c12865d986fd945a1108b00ad9e85d459827/api/migrations/__init__.py


--------------------------------------------------------------------------------
/api/models.py:
--------------------------------------------------------------------------------
 1 | from django.db import models
 2 | from django.core.urlresolvers import reverse
 3 | from oauth2_provider.models import AbstractApplication
 4 | 
 5 | 
 6 | class ApiClient(AbstractApplication):
 7 |     """
 8 |     This is our custom 'Application' model for Oauth authentication.
 9 |     """
10 | 
11 |     agree_tos = models.BooleanField(default=False)
12 |     password_grant_is_allowed = models.BooleanField(default=False)  # Enable password grant in OAuth2 authentication
13 |     created = models.DateTimeField(auto_now_add=True)
14 |     #  Add more custom fields here like description, logo, preferred services...
15 | 
16 |     def get_absolute_url(self):
17 |         return reverse('developers-app-detail', args=[self.id])
18 | 
19 |     def clean(self):
20 |         """
21 |         The AbstractApplication model includes a clean method that raises a ValidationError
22 |         if the redirect_uri is empty and is required by the authorization_grant_type. We have
23 |         implemented a custom version of this check (with a custom message) in api.forms.ApiClientForm
24 |         therefore we don't need model's clean method to do anything.
25 |         """
26 |         pass
27 | 


--------------------------------------------------------------------------------
/api/oauth2_urls.py:
--------------------------------------------------------------------------------
 1 | from django.conf.urls import url
 2 | from oauth2_provider import views
 3 | 
 4 | urlpatterns = (
 5 |     url(r'^authorize/?$', views.AuthorizationView.as_view(
 6 |         template_name='accounts/authorize_client.html',
 7 |     ), name="authorize"),
 8 |     url(r'^token/?$', views.TokenView.as_view(), name="token"),
 9 |     url(r'^revoke_token/?$', views.RevokeTokenView.as_view(), name="revoke-token"),
10 | )
11 | 


--------------------------------------------------------------------------------
/api/request_distributor.py:
--------------------------------------------------------------------------------
  1 | from django.conf import settings
  2 | from ac_mediator.exceptions import *
  3 | from services.acservice.constants import *
  4 | from services.mgmt import get_available_services, get_service_by_id
  5 | from api.response_aggregator import get_response_aggregator
  6 | from celery import shared_task
  7 | 
  8 | response_aggregator = get_response_aggregator()
  9 | 
 10 | 
 11 | @shared_task
 12 | def perform_request_and_aggregate(request, response_id, service_id):
 13 |     service = get_service_by_id(service_id)
 14 |     try:
 15 |         print('Requesting response from {0} ({1})'.format(service.name, response_id))
 16 |         service.clear_response_warnings()
 17 |         service_response = getattr(service, request['method'])(request['context'], **request['kwargs'])
 18 |         warnings = service.collect_response_warnings()
 19 |         response_aggregator.aggregate_response(response_id, service.name, service_response, warnings=warnings)
 20 |     except (ACException, ACAPIException) as e:
 21 |         # Aggregate error response in response aggregator and continue with next service
 22 |         response_aggregator.aggregate_response(response_id, service.name, e)
 23 | 
 24 | 
 25 | class RequestDistributor(object):
 26 | 
 27 |     @staticmethod
 28 |     def process_request(request, wait_until_complete=False, include=None, exclude=None, acid_domain=None):
 29 |         """
 30 |         Process incoming request, and propagate it to corresponding services.
 31 |         Requests to 3rd party services are made asynchronously. We send requests to all 3rd
 32 |         party services and as soon as a response is received it is added to a response object
 33 |         which aggregates the responses from all services.
 34 |         In the normal functioning mode (wait_until_complete=False) this method will immediately
 35 |         return a response right after all requests have been sent. This response will mainly
 36 |         include a response_id parameter that can be later used to pull the actual responses
 37 |         from the 3rd party services (see ResponseAggregator.collect_response).
 38 |         If wait_until_complete is set to False, then this method will wait untill a response is
 39 |         received for all requests and only then will return an aggregated response including the
 40 |         contents of all 3rd party services individual responses.
 41 | 
 42 |         :param request: incoming request object
 43 |         :param wait_until_complete: whether to return immediately after all requests are sent or wait untill all responses are received
 44 |         :param include: list of service names to include when getting available services
 45 |         :param include: list of service names to exclude when getting available services
 46 |         :param acid_domain: domain of Audio Commons Unique Identifiers to be considered for matching available services
 47 |         :return: dictionary with response (as returned by ResponseAggregator.collect_response)
 48 |         """
 49 | 
 50 |         # Get available services for the given component (e.g. services that do `text search')
 51 |         services = get_available_services(component=request['component'], include=include, exclude=exclude)
 52 | 
 53 |         # Filter by ACID domain (e.g. select only services that support the requested ACID domain)
 54 |         if acid_domain is not None:
 55 |             services = [
 56 |                 service for service in services if
 57 |                 acid_domain in service.get_service_description()[request['component']].get(
 58 |                     ACID_DOMAINS_DESCRIPTION_KEYWORD, list())
 59 |             ]
 60 | 
 61 |         if not services:
 62 |             # If no services have been found for the requested component or combination of component
 63 |             # and acid domain, we raise an exception
 64 |             raise ACAPINoServiceAvailable
 65 | 
 66 |         # Create object to store responses from services
 67 |         response_id = response_aggregator.create_response(len(services))
 68 |         if not services:
 69 |             # No services will be queries, response can be set to finished
 70 |             response_aggregator.set_response_to_finished(response_id)
 71 |         else:
 72 |             response_aggregator.set_response_to_processing(response_id)
 73 | 
 74 |         if not settings.DEBUG or settings.USE_CELERY_IN_DEBUG_MODE:
 75 |             # Iterate over services, perform requests and aggregate responses
 76 |             async_response_objects = list()
 77 |             for service in services:
 78 |                 # Requests are performed asynchronously in Celery workers
 79 |                 async_response_objects.append(
 80 |                     perform_request_and_aggregate.delay(request, response_id, service.id)
 81 |                 )
 82 | 
 83 |             # Wait until all responses are received (only if wait_until_complete == True)
 84 |             if wait_until_complete:
 85 |                 # We wait until we get a response for all the requests we sent
 86 |                 # We do that by continuously iterating over all async_response_objetcs in a while
 87 |                 # loop and only exit when all of them have been flagged as ready
 88 |                 # TODO: we should add some control over timeouts, etc as this operation is blocking
 89 |                 while True:
 90 |                     if all([item.ready() for item in async_response_objects]):
 91 |                         break
 92 |         else:
 93 |             # When in debug mode AND not settings.USE_CELERY_IN_DEBUG_MODE
 94 |             # wait_until_complete is ignored as web server does not do the requests asynchronously
 95 |             async_response_objects = list()
 96 |             for service in services:
 97 |                 # Requests are performed synchronously in the web server
 98 |                 async_response_objects.append(
 99 |                     perform_request_and_aggregate(request, response_id, service.id)
100 |                 )
101 | 
102 |         # Return object including responses received so far (if wait_until_complete == False the
103 |         # response returned here will almost only contain the response_id field which can be later
104 |         # used to retrieve further responses.
105 |         return response_aggregator.collect_response(response_id, format=request['context']['format'])
106 | 
107 | 
108 | request_distributor = RequestDistributor()
109 | 
110 | 
111 | def get_request_distributor():
112 |     return request_distributor
113 | 


--------------------------------------------------------------------------------
/api/response_aggregator.py:
--------------------------------------------------------------------------------
  1 | import uuid
  2 | import redis
  3 | import json
  4 | import datetime
  5 | from ac_mediator.exceptions import *
  6 | from django.conf import settings
  7 | from django.urls import reverse
  8 | 
  9 | 
 10 | RESPONSE_STATUS_FINISHED = 'FI'
 11 | RESPONSE_STATUS_PROCESSING = 'PR'
 12 | RESPONSE_STATUS_NEW = 'NEW'
 13 | 
 14 | 
 15 | class RedisStoreBackend(object):
 16 |     """
 17 |     Redis-bases backend for storing current (ongoing) responses. See ResponseAggregator for more info.
 18 |     """
 19 | 
 20 |     r = None
 21 | 
 22 |     def __init__(self):
 23 |         self.r = redis.StrictRedis(host=settings.REDIS_HOST, port=settings.REDIS_PORT, db=0)
 24 | 
 25 |     def new_response(self, init_response_contents):
 26 |         response_id = uuid.uuid4()
 27 |         self.r.set(response_id, json.dumps(init_response_contents), ex=settings.RESPONSE_EXPIRY_TIME)
 28 |         return response_id
 29 | 
 30 |     def get_response(self, response_id):
 31 |         try:
 32 |             response = self.r.get(response_id)
 33 |         except redis.exceptions.ResponseError:
 34 |             # Can happen if we're trying to get a response from a key whose contents are not from an API response
 35 |             return None
 36 |         if response is None:
 37 |             return None
 38 |         try:
 39 |             return json.loads(response.decode("utf-8"))
 40 |         except json.decoder.JSONDecodeError:
 41 |             # Can happen if we're trying to get a response from a key whose contents are not from an API response
 42 |             return None
 43 | 
 44 |     def set_response(self, response_id, response_contents):
 45 |         self.r.set(response_id, json.dumps(response_contents), ex=settings.RESPONSE_EXPIRY_TIME)
 46 | 
 47 |     def delete_response(self, response_id):
 48 |         self.r.delete(response_id)
 49 | 
 50 |     def get_all_response_keys(self):
 51 |         return self.r.keys('*')
 52 | 
 53 | 
 54 | class ResponseAggregator(object):
 55 |     """
 56 |     The response aggregator is in charge of maintaining a pool of request responses and keep on aggregating
 57 |     responses from different services at the moment these are received. It uses a redis-based store
 58 |     (RedisStoreBackend) to share response data within all ac_mediator processes and celery workers.
 59 |     The ReponseAggregator implement a ResponseAggregator.collect_response method which is given
 60 |     a 'response_id' object and will return the current responses that have been aggregated for the
 61 |     given response_id at the time of calling the method. This is used for the /api/collect endpoint
 62 |     and this is how API clients can iterativelly pull results as soon as these are received (NOTE: this
 63 |     only makes sense when wait_until_complete=False in the RequestDistributor)
 64 |     """
 65 | 
 66 |     def __init__(self, store_backend=RedisStoreBackend):
 67 |         self.store = store_backend()
 68 | 
 69 |     def create_response(self, n_expected_responses):
 70 |         response_id = self.store.new_response({
 71 |             'meta': {
 72 |                 'response_id': None,  # Will be filled in self.collect_response
 73 |                 'status': RESPONSE_STATUS_NEW,
 74 |                 'n_expected_responses': n_expected_responses,
 75 |                 'n_received_responses': 0,
 76 |                 'sent_timestamp': str(datetime.datetime.now())
 77 |             },
 78 |             'contents': dict(),
 79 |             'warnings': dict(),
 80 |             'errors': dict(),
 81 |         })
 82 |         return response_id
 83 | 
 84 |     def set_response_to_processing(self, response_id):
 85 |         response = self.store.get_response(response_id)
 86 |         response['meta']['status'] = RESPONSE_STATUS_PROCESSING
 87 |         self.store.set_response(response_id, response)
 88 | 
 89 |     def set_response_to_finished(self, response_id):
 90 |         response = self.store.get_response(response_id)
 91 |         response['meta']['status'] = RESPONSE_STATUS_FINISHED
 92 |         self.store.set_response(response_id, response)
 93 | 
 94 |     def aggregate_response(self, response_id, service_name, response_contents, warnings=None):
 95 |         response = self.store.get_response(response_id)
 96 |         response['meta']['n_received_responses'] += 1
 97 |         if isinstance(response_contents, ACException) or isinstance(response_contents, ACAPIException):
 98 |             # If response content is error, add to errors dict
 99 |             response['errors'][service_name] = {
100 |                 'status_code': response_contents.status,
101 |                 'type': response_contents.__class__.__name__,
102 |                 'detail': response_contents.msg,
103 |             }
104 |         else:
105 |             # If response content is ok, add to contents dict
106 |             response['contents'][service_name] = response_contents
107 |             # If response content has warnings, add them to the warnings dict
108 |             if warnings:
109 |                 response['warnings'][service_name] = warnings
110 |         if response['meta']['n_received_responses'] == response['meta']['n_expected_responses']:
111 |             response['meta']['status'] = RESPONSE_STATUS_FINISHED
112 |         self.store.set_response(response_id, response)
113 | 
114 |     def collect_response(self, response_id, format='json'):
115 |         response = self.store.get_response(response_id)
116 |         to_return = None
117 |         if response is None:
118 |             return to_return
119 |         if format == settings.JSON_FORMAT_KEY or format == settings.JSON_LD_FORMAT_KEY:
120 |             # Currently we do the same for JSON and JSON_LD because changes in the response are only at the individual
121 |             # result level and this is done in the acservice code. This if statement might be split in two if the
122 |             # structure of the JSON_LD response needs a different treatment.
123 |             to_return = response.copy()
124 |             to_return['meta']['response_id'] = response_id  # Add response_id to returned dictionary
125 |             to_return['meta']['collect_url'] = \
126 |                 settings.BASE_URL + '{0}?rid={1}'.format(reverse('api-collect'),
127 |                                                          response_id)  # Add collect url for convenience
128 |             to_return['meta']['current_timestamp'] = str(datetime.datetime.now())
129 |             if response['meta']['status'] == RESPONSE_STATUS_FINISHED and settings.DELETE_RESPONSES_AFTER_CONSUMED:
130 |                 self.store.delete_response(response_id)  # If response has been all loaded, delete it from pool
131 |         else:
132 |             raise ACAPIUnsupportedFormat()
133 | 
134 |         return to_return
135 | 
136 | 
137 | response_aggregator = ResponseAggregator()
138 | 
139 | 
140 | def get_response_aggregator():
141 |     return response_aggregator
142 | 


--------------------------------------------------------------------------------
/api/urls.py:
--------------------------------------------------------------------------------
 1 | from django.conf.urls import include, url
 2 | from api import views
 3 | 
 4 | urlpatterns = [
 5 |     url(r'^v1/services/$', views.services, name='api-services'),
 6 |     url(r'^v1/collect/$', views.collect_response, name='api-collect'),
 7 |     url(r'^v1/search/text/$', views.text_search, name='api-text-search'),
 8 |     url(r'^v1/license/$', views.licensing, name='api-licensing'),
 9 |     url(r'^v1/download/$', views.download, name='api-download'),
10 |     url(r'^v1/me/$', views.me, name='api-me'),
11 | 
12 |     # Oauth2 urls
13 |     url(r'^o/', include('api.oauth2_urls', namespace='oauth2_provider')),
14 | 
15 |     # Invalid url
16 |     url(r'$', views.invalid_url),
17 | ]
18 | 


--------------------------------------------------------------------------------
/api/utils.py:
--------------------------------------------------------------------------------
 1 | from oauth2_provider.oauth2_validators import OAuth2Validator
 2 | from oauth2_provider.models import AbstractApplication
 3 | from rest_framework.views import exception_handler
 4 | from rest_framework.compat import set_rollback
 5 | from rest_framework.response import Response
 6 | from rest_framework import status
 7 | 
 8 | 
 9 | class ACOAuth2Validator(OAuth2Validator):
10 |     """
11 |     We use a custom OAuth2Validator class so that we can introduce an extra validation check
12 |     for clients trying to authenticate using the password grant. Only clients we trust and to
13 |     whom we've given permission to use password grant can use it.
14 |     """
15 | 
16 |     def validate_grant_type(self, client_id, grant_type, client, request, *args, **kwargs):
17 |         # In case the requested grant_type is 'password', make sure that the API client
18 |         # has password grant enabled (see api.models.ApiClient).
19 |         if grant_type == AbstractApplication.GRANT_PASSWORD and not client.password_grant_is_allowed:
20 |             return False
21 |         # In either case perform validation as implemented in OAuth2Validator
22 |         return super().validate_grant_type(client_id, grant_type, client, request, *args, **kwargs)
23 | 
24 | 
25 | def custom_exception_handler(exc, context):
26 |     """
27 |     Custom django rest framework exception handler that includes 'status_code' field in the
28 |     responses.
29 |     """
30 |     # Call REST framework's default exception handler first
31 |     response = exception_handler(exc, context)
32 | 
33 |     # Catch unexpected exceptions
34 |     if response is None:
35 |         if isinstance(exc, Exception):
36 |             print('\n\nUnhandled Exception\n')
37 |             print(exc)
38 |             print('\n')
39 |             data = {'detail': 'A server error occurred.'}
40 |             set_rollback()
41 |             response = Response(data, status=status.HTTP_500_INTERNAL_SERVER_ERROR)
42 | 
43 |     # Now add the HTTP status code to the response.
44 |     if response is not None:
45 |         response.data['status_code'] = response.status_code
46 |     return response
47 | 


--------------------------------------------------------------------------------
/developers/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AudioCommons/ac-mediator/3201c12865d986fd945a1108b00ad9e85d459827/developers/__init__.py


--------------------------------------------------------------------------------
/developers/admin.py:
--------------------------------------------------------------------------------
1 | from django.contrib import admin
2 | 
3 | # Register your models here.
4 | 


--------------------------------------------------------------------------------
/developers/apps.py:
--------------------------------------------------------------------------------
1 | from django.apps import AppConfig
2 | 
3 | 
4 | class DevelopersConfig(AppConfig):
5 |     name = 'developers'
6 | 


--------------------------------------------------------------------------------
/developers/migrations/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AudioCommons/ac-mediator/3201c12865d986fd945a1108b00ad9e85d459827/developers/migrations/__init__.py


--------------------------------------------------------------------------------
/developers/models.py:
--------------------------------------------------------------------------------
1 | from django.db import models
2 | 
3 | # Create your models here.
4 | 


--------------------------------------------------------------------------------
/developers/tests.py:
--------------------------------------------------------------------------------
1 | from django.test import TestCase
2 | 
3 | # Create your tests here.
4 | 


--------------------------------------------------------------------------------
/developers/urls.py:
--------------------------------------------------------------------------------
 1 | from django.conf.urls import url
 2 | from developers import views as dev_views
 3 | 
 4 | urlpatterns = [
 5 |     url(r'^clients/$', dev_views.ApplicationList.as_view(),
 6 |         name="developers-app-list"),
 7 |     url(r'^clients/register/$', dev_views.ApplicationRegistration.as_view(),
 8 |         name="developers-app-register"),
 9 |     url(r'^clients/(?P<pk>\d+)/$', dev_views.ApplicationDetail.as_view(),
10 |         name="developers-app-detail"),
11 |     url(r'^clients/(?P<pk>\d+)/delete/$', dev_views.ApplicationDelete.as_view(),
12 |         name="developers-app-delete"),
13 |     url(r'^clients/(?P<pk>\d+)/update/$', dev_views.ApplicationUpdate.as_view(),
14 |         name="developers-app-update"),
15 |     url(r'^clients/(?P<pk>\d+)/monitor/$', dev_views.application_monitor,
16 |         name="developers-app-monitor"),
17 |     url(r'^clients/(?P<pk>\d+)/monitor/data/$', dev_views.get_application_monitor_data,
18 |         name="developers-app-monitor-data"),
19 | ]
20 | 


--------------------------------------------------------------------------------
/developers/views.py:
--------------------------------------------------------------------------------
 1 | from oauth2_provider.views.application import ApplicationRegistration as ProviderApplicationRegistration
 2 | from oauth2_provider.views.application import ApplicationDetail as ProviderApplicationDetail
 3 | from oauth2_provider.views.application import ApplicationList as ProviderApplicationList
 4 | from oauth2_provider.views.application import ApplicationDelete as ProviderApplicationDelete
 5 | from oauth2_provider.views.application import ApplicationUpdate as ProviderApplicationUpdate
 6 | from django.core.urlresolvers import reverse_lazy
 7 | from django.shortcuts import render, get_object_or_404
 8 | from django.contrib.auth.decorators import login_required
 9 | from django.http import JsonResponse
10 | from api.forms import ApiClientForm
11 | from api.models import ApiClient
12 | from services.mgmt import get_available_services
13 | import datetime
14 | 
15 | 
16 | class ApplicationRegistration(ProviderApplicationRegistration):
17 |     template_name = "developers/application_registration_form.html"
18 |     success_url = reverse_lazy('developers-app-list')
19 | 
20 |     def get_form_class(self):
21 |         return ApiClientForm
22 | 
23 | 
24 | class ApplicationDetail(ProviderApplicationDetail):
25 |     template_name = "developers/application_detail.html"
26 | 
27 | 
28 | class ApplicationList(ProviderApplicationList):
29 |     template_name = "developers/application_list.html"
30 | 
31 | 
32 | class ApplicationDelete(ProviderApplicationDelete):
33 |     success_url = reverse_lazy('developers-app-list')
34 |     template_name = "developers/application_confirm_delete.html"
35 | 
36 | 
37 | class ApplicationUpdate(ProviderApplicationUpdate):
38 |     template_name = "developers/application_form.html"
39 | 
40 |     def get_form_class(self):
41 |         return ApiClientForm
42 | 
43 | 
44 | @login_required
45 | def application_monitor(request, pk):
46 |     application = get_object_or_404(ApiClient, pk=pk)
47 |     tvars = {'application': application}
48 |     return render(request, 'developers/application_monitor.html', tvars)
49 | 
50 | 
51 | @login_required
52 | def get_application_monitor_data(request, pk):
53 |     """
54 |     Returns API client usage data to be shown in the monitor page.
55 |     This view should return a JSON response with a 'data' field including a list of API usage event.
56 |     Each event should include a 'date' field with the timestamp as returned by Pythons Datetime.timestamp() object
57 |     (https://docs.python.org/3/library/datetime.html#datetime.datetime.timestamp) and with a 'service' property
58 |     with the service name (to which a request was forwarded).
59 |     """
60 |     #application = get_object_or_404(ApiClient, pk=pk)
61 |     fake_data_points = list()
62 |     today = datetime.datetime.today()
63 |     services = get_available_services()
64 |     import random
65 |     N_FAKE_POINTS = 1000
66 |     DAYS_SPAN = 60
67 |     for i in range(0, N_FAKE_POINTS):
68 |         fake_data_points.append({
69 |             'date': (today - datetime.timedelta(minutes=random.randint(0, 60*24*DAYS_SPAN))).timestamp(),
70 |             'service': random.choice(services).name,
71 |         })
72 |     return JsonResponse({'data': fake_data_points})
73 | 


--------------------------------------------------------------------------------
/docker-compose.yml:
--------------------------------------------------------------------------------
 1 | version: '3.7'
 2 | volumes:
 3 |   dbvolume:
 4 | services:
 5 |   db:
 6 |     image: postgres:9.6
 7 |     env_file:
 8 |       - .env
 9 |     volumes:
10 |       - dbvolume:/var/lib/postgresql/data/
11 |   nginx:
12 |     image: nginx
13 |     ports:
14 |       - "80:80"
15 |       - "443:443"
16 |     volumes:
17 |       - ./docker/nginx/ac_mediator.conf:/etc/nginx/conf.d/default.conf
18 |       - ./docker/nginx/ssl_certificates:/ssl
19 |     depends_on:
20 |       - web
21 |       - flower
22 |       #- redmon
23 |   redis:
24 |     image: redis
25 |   web:
26 |     build: .
27 |     env_file:
28 |       - .env
29 |     volumes:
30 |       - .:/code
31 |       - /static/
32 |       - ./services/services_conf.cfg:/code/services/services_conf.cfg
33 |     command: python manage.py runserver 0.0.0.0:8000
34 |     depends_on:
35 |       - db
36 |       - redis
37 |   celery:
38 |     build: .
39 |     env_file:
40 |       - .env
41 |     volumes:
42 |       - .:/code
43 |       - /static/
44 |       - ./services/services_conf.cfg:/code/services/services_conf.cfg
45 |     command: celery worker -A ac_mediator --concurrency=${CELERY_CONCURRENCY}
46 |     depends_on:
47 |       - redis
48 |   celery_beat:
49 |     build: .
50 |     env_file:
51 |       - .env
52 |     volumes:
53 |       - .:/code
54 |       - /static/
55 |       - ./services/services_conf.cfg:/code/services/services_conf.cfg
56 |     command: celery beat -A ac_mediator
57 |     depends_on:
58 |       - redis
59 |   flower:  #  Django app to monitor Celery status
60 |     build: ./docker/flower/
61 |     env_file:
62 |       - .env
63 |     command: flower --address=0.0.0.0 --port=5555 --broker=redis://redis --url_prefix=flower
64 |     depends_on:
65 |       - celery
66 | 


--------------------------------------------------------------------------------
/docker/flower/Dockerfile:
--------------------------------------------------------------------------------
 1 | FROM python:3.6
 2 | ENV PYTHONUNBUFFERED 1
 3 | 
 4 | RUN wget -O /usr/local/bin/dumb-init https://github.com/Yelp/dumb-init/releases/download/v1.2.0/dumb-init_1.2.0_amd64 && chmod +x /usr/local/bin/dumb-init
 5 | 
 6 | RUN mkdir /code
 7 | WORKDIR /code
 8 | ADD requirements.txt /code/
 9 | RUN pip install -r requirements.txt
10 | 


--------------------------------------------------------------------------------
/docker/flower/requirements.txt:
--------------------------------------------------------------------------------
1 | redis
2 | flower


--------------------------------------------------------------------------------
/docker/nginx/ac_mediator.conf:
--------------------------------------------------------------------------------
 1 | server {
 2 |     # Redirect all http traffic to https
 3 | 	listen 80 default_server;
 4 | 	listen [::]:80 default_server;
 5 | 	server_name _;
 6 | 
 7 | 	location /api {
 8 |         default_type application/json;
 9 |         return 403 '{"detail": "Secure connection required. Please use HTTPS.", "status_code": 403}';
10 | 	}
11 | 
12 | 	location / {
13 | 	    return 301 https://$host$request_uri;
14 | 	}
15 | }
16 | 
17 | server {
18 |     listen 443 ssl;
19 |     server_name example.org;
20 |     ssl_certificate     /ssl/server.crt;
21 |     ssl_certificate_key /ssl/server.key;
22 |     charset utf-8;
23 | 
24 |     location /flower {
25 |         rewrite ^/flower/(.*)$ /$1 break;
26 |         proxy_pass http://flower:5555;
27 |         proxy_set_header Host $host;
28 |     }
29 | 
30 |     #location /redmon {
31 |     #    proxy_pass http://redmon:4567;
32 |     #    proxy_set_header Host $host;
33 |     #}
34 | 
35 |     location / {
36 |         proxy_pass http://web:8000;
37 |         proxy_set_header Host $host;
38 |     }
39 | 
40 | }


--------------------------------------------------------------------------------
/docker/nginx/ssl_certificates/server.crt:
--------------------------------------------------------------------------------
 1 | -----BEGIN CERTIFICATE-----
 2 | MIICJzCCAZACCQD/AUhb1xAdujANBgkqhkiG9w0BAQUFADBYMQswCQYDVQQGEwJT
 3 | UDESMBAGA1UECBMJQmFyY2Vsb25hMRIwEAYDVQQHEwlCYXJjZWxvbmExITAfBgNV
 4 | BAoTGEF1ZGlvIENvbW1vbnMgQ29uc29ydGl1bTAeFw0xNjExMTAxMjM0MzBaFw0x
 5 | NzExMTAxMjM0MzBaMFgxCzAJBgNVBAYTAlNQMRIwEAYDVQQIEwlCYXJjZWxvbmEx
 6 | EjAQBgNVBAcTCUJhcmNlbG9uYTEhMB8GA1UEChMYQXVkaW8gQ29tbW9ucyBDb25z
 7 | b3J0aXVtMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDUciOOZtPa0E8ezCRI
 8 | 7NyWD71+i7ChZC70Pe/p2OYm5K98uxaB12yeItTE3Vjn/5lWUGRGXGM016/kcusU
 9 | NnaSukahcpNRwhv6X5Vft2lYqzGxpSCwB0gx33FsBfnUFN8ZF/m8ZBUi/ZRGEq+6
10 | Kwan/ZL1tJw+Gh8qZqhqI7xyjwIDAQABMA0GCSqGSIb3DQEBBQUAA4GBABacKNiM
11 | QZ9euYNKkoNHutJjFHdZ9MXt4VwtGqFpbL0YCxHe6IB11Wf2AM2D+M1++AmJd/+g
12 | AUfc7ZoNT3qU0+tOzreGy3TFUyqRHT684fG+ST9SH0CkZTlwg1uK7Cj9xwab8EjA
13 | IGm0AgO4eA5HDTSCUUU8VCLvc0VugIWtTmcc
14 | -----END CERTIFICATE-----
15 | 


--------------------------------------------------------------------------------
/docker/nginx/ssl_certificates/server.key:
--------------------------------------------------------------------------------
 1 | -----BEGIN RSA PRIVATE KEY-----
 2 | MIICXAIBAAKBgQDUciOOZtPa0E8ezCRI7NyWD71+i7ChZC70Pe/p2OYm5K98uxaB
 3 | 12yeItTE3Vjn/5lWUGRGXGM016/kcusUNnaSukahcpNRwhv6X5Vft2lYqzGxpSCw
 4 | B0gx33FsBfnUFN8ZF/m8ZBUi/ZRGEq+6Kwan/ZL1tJw+Gh8qZqhqI7xyjwIDAQAB
 5 | AoGAC24Qp6q0n0Mx3pBRK3NC8vfp1BMj76r6M73ZWJWI3HLVVjqinV2/xEpPdEAM
 6 | dn7z+wbcPkTeOYuZNQtRxoafnnAuDdUCWhZUR2btQMDS3pBWMkI0ZBiZkuaLQVPs
 7 | 4u/Y84QmR8YjyeXo1ZEk6Sb2bN20JT7J+D+Zj4PeTpZhLYECQQD4hweHD3Pv4N6u
 8 | hC0h5K2cnaSf+N6TMRqmZ8mha++nvua6MdymoXLZhu5d0vMFzJfpGGc7zuutlKms
 9 | u2GqGZRvAkEA2tVhpc1oJ3DaslOUl95zWubrvRXvlagwVcb+Xkt4VsWiPbRr+sLS
10 | uNYOhhIxTQtRjxrw/+bNlz7qCvbfxG9T4QJARN2lyFcP2TiGe/VETFABi5RjObDM
11 | fBzvNY0s4f32upS7eny2l7XFDWHGS1lY3hKDRaPtdzUvOTooiiSiO3A7IQJAENh+
12 | RNo0G10nqLSgarR4ItZF7W9j2xxwZBoGeNHMeLmMDL331fzrZcksowuBehHV/HMx
13 | fDGTQAJa1+87OI7tYQJBAPcjWC+a/l9MxZ1Zv5cztCbujMiDGe2AduVZAeo0lT0p
14 | 4ocTmcyqKtxdp28h4Z55s1IF3kGjX2ZwElTDeezBfAM=
15 | -----END RSA PRIVATE KEY-----
16 | 


--------------------------------------------------------------------------------
/docker/redmon/Dockerfile:
--------------------------------------------------------------------------------
1 | FROM ruby:2.3
2 | 
3 | RUN wget -O /usr/local/bin/dumb-init https://github.com/Yelp/dumb-init/releases/download/v1.2.0/dumb-init_1.2.0_amd64 && chmod +x /usr/local/bin/dumb-init
4 | 
5 | RUN mkdir /code
6 | WORKDIR /code
7 | RUN gem install redmon
8 | 


--------------------------------------------------------------------------------
/docs/.gitignore:
--------------------------------------------------------------------------------
1 | _build


--------------------------------------------------------------------------------
/docs/_static/project_logo_h.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AudioCommons/ac-mediator/3201c12865d986fd945a1108b00ad9e85d459827/docs/_static/project_logo_h.png


--------------------------------------------------------------------------------
/docs/_themes/ac_sphinx_rtd_theme/__init__.py:
--------------------------------------------------------------------------------
 1 | """Sphinx ReadTheDocs theme.
 2 | 
 3 | From https://github.com/ryan-roemer/sphinx-bootstrap-theme.
 4 | 
 5 | """
 6 | import os
 7 | 
 8 | __version__ = '0.1.10-alpha'
 9 | __version_full__ = __version__
10 | 
11 | 
12 | def get_html_theme_path():
13 |     """Return list of HTML theme paths."""
14 |     cur_dir = os.path.abspath(os.path.dirname(os.path.dirname(__file__)))
15 |     return cur_dir
16 | 


--------------------------------------------------------------------------------
/docs/_themes/ac_sphinx_rtd_theme/breadcrumbs.html:
--------------------------------------------------------------------------------
 1 | {# Support for Sphinx 1.3+ page_source_suffix, but don't break old builds. #}
 2 | 
 3 | {% if page_source_suffix %}
 4 | {% set suffix = page_source_suffix %}
 5 | {% else %}
 6 | {% set suffix = source_suffix %}
 7 | {% endif %}
 8 | 
 9 | {% if meta is defined and meta is not none %}
10 | {% set check_meta = True %}
11 | {% else %}
12 | {% set check_meta = False %}
13 | {% endif %}
14 | 
15 | {% if check_meta and 'github_url' in meta %}
16 | {% set display_github = True %}
17 | {% endif %}
18 | 
19 | {% if check_meta and 'bitbucket_url' in meta %}
20 | {% set display_bitbucket = True %}
21 | {% endif %}
22 | 
23 | <div role="navigation" aria-label="breadcrumbs navigation">
24 | 
25 |   <ul class="wy-breadcrumbs">
26 |     {% block breadcrumbs %}
27 |       <li><a href="{{ pathto(master_doc) }}">Docs</a> &raquo;</li>
28 |         {% for doc in parents %}
29 |           <li><a href="{{ doc.link|e }}">{{ doc.title }}</a> &raquo;</li>
30 |         {% endfor %}
31 |       <li>{{ title }}</li>
32 |     {% endblock %}
33 |     {% block breadcrumbs_aside %}
34 |       <li class="wy-breadcrumbs-aside">
35 |         {% if pagename != "search" %}
36 |             {% if display_github %}
37 |             {% if check_meta and 'github_url' in meta %}
38 |               <!-- User defined GitHub URL -->
39 |               <a href="{{ meta['github_url'] }}" class="fa fa-github"> Edit on GitHub</a>
40 |             {% else %}
41 |               <a href="https://{{ github_host|default("github.com") }}/{{ github_user }}/{{ github_repo }}/blob/{{ github_version }}{{ conf_py_path }}{{ pagename }}{{ suffix }}" class="fa fa-github"> Edit on GitHub</a>
42 |             {% endif %}
43 |           {% elif display_bitbucket %}
44 |             {% if check_meta and 'bitbucket_url' in meta %}
45 |               <!-- User defined Bitbucket URL -->
46 |               <a href="{{ meta['bitbucket_url'] }}" class="fa fa-bitbucket"> Edit on Bitbucket</a>
47 |             {% else %}
48 |               <a href="https://bitbucket.org/{{ bitbucket_user }}/{{ bitbucket_repo }}/src/{{ bitbucket_version}}{{ conf_py_path }}{{ pagename }}{{ suffix }}" class="fa fa-bitbucket"> Edit on Bitbucket</a>
49 |             {% endif %}
50 |           {% elif show_source and source_url_prefix %}
51 |             <a href="{{ source_url_prefix }}{{ pagename }}{{ suffix }}">View page source</a>
52 |           {% elif show_source and has_source and sourcename %}
53 |             <a href="{{ pathto('_sources/' + sourcename, true)|e }}" rel="nofollow"> View page source</a>
54 |           {% endif %}
55 |         {% endif %}
56 |       </li>
57 |     {% endblock %}
58 |   </ul>
59 | 
60 |   {% if (theme_prev_next_buttons_location == 'top' or theme_prev_next_buttons_location == 'both') and (next or prev) %}
61 |   <div class="rst-breadcrumbs-buttons" role="navigation" aria-label="breadcrumb navigation">
62 |       {% if next %}
63 |         <a href="{{ next.link|e }}" class="btn btn-neutral float-right" title="{{ next.title|striptags|e }}" accesskey="n">Next <span class="fa fa-arrow-circle-right"></span></a>
64 |       {% endif %}
65 |       {% if prev %}
66 |         <a href="{{ prev.link|e }}" class="btn btn-neutral" title="{{ prev.title|striptags|e }}" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous</a>
67 |       {% endif %}
68 |   </div>
69 |   {% endif %}
70 |   <hr/>
71 | </div>
72 | 


--------------------------------------------------------------------------------
/docs/_themes/ac_sphinx_rtd_theme/footer.html:
--------------------------------------------------------------------------------
 1 | <footer>
 2 |   {% if (theme_prev_next_buttons_location == 'bottom' or theme_prev_next_buttons_location == 'both') and (next or prev) %}
 3 |     <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
 4 |       {% if next %}
 5 |         <a href="{{ next.link|e }}" class="btn btn-neutral float-right" title="{{ next.title|striptags|e }}" accesskey="n">Next <span class="fa fa-arrow-circle-right"></span></a>
 6 |       {% endif %}
 7 |       {% if prev %}
 8 |         <a href="{{ prev.link|e }}" class="btn btn-neutral" title="{{ prev.title|striptags|e }}" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous</a>
 9 |       {% endif %}
10 |     </div>
11 |   {% endif %}
12 | 
13 |   <hr/>
14 | 
15 |   <div role="contentinfo">
16 |     <p>
17 |     {%- if show_copyright %}
18 |       {%- if hasdoc('copyright') %}
19 |         {% trans path=pathto('copyright'), copyright=copyright|e %}&copy; <a href="{{ path }}">Copyright</a> {{ copyright }}.{% endtrans %}
20 |       {%- else %}
21 |         {% trans copyright=copyright|e %}&copy; Copyright {{ copyright }}.{% endtrans %}
22 |       {%- endif %}
23 |     {%- endif %}
24 | 
25 |     {%- if build_id and build_url %}
26 |       {% trans build_url=build_url, build_id=build_id %}
27 |         <span class="build">
28 |           Build
29 |           <a href="{{ build_url }}">{{ build_id }}</a>.
30 |         </span>
31 |       {% endtrans %}
32 |     {%- elif commit %}
33 |       {% trans commit=commit %}
34 |         <span class="commit">
35 |           Revision <code>{{ commit }}</code>.
36 |         </span>
37 |       {% endtrans %}
38 |     {%- elif last_updated %}
39 |       {% trans last_updated=last_updated|e %}Last updated on {{ last_updated }}.{% endtrans %}
40 |     {%- endif %}
41 | 
42 |     </p>
43 |   </div>
44 | 
45 |   {%- if show_sphinx %}
46 |   {% trans %}Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>{% endtrans %}.
47 |   {%- endif %}
48 | 
49 |   {%- block extrafooter %} {% endblock %}
50 | 
51 | </footer>
52 | 
53 | 


--------------------------------------------------------------------------------
/docs/_themes/ac_sphinx_rtd_theme/layout.html:
--------------------------------------------------------------------------------
  1 | {# TEMPLATE VAR SETTINGS #}
  2 | {%- set url_root = pathto('', 1) %}
  3 | {%- if url_root == '#' %}{% set url_root = '' %}{% endif %}
  4 | {%- if not embedded and docstitle %}
  5 |   {%- set titlesuffix = " &mdash; "|safe + docstitle|e %}
  6 | {%- else %}
  7 |   {%- set titlesuffix = "" %}
  8 | {%- endif %}
  9 | 
 10 | <!DOCTYPE html>
 11 | <!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
 12 | <!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
 13 | <head>
 14 |   <meta charset="utf-8">
 15 |   {{ metatags }}
 16 |   <meta name="viewport" content="width=device-width, initial-scale=1.0">
 17 |   {% block htmltitle %}
 18 |   <title>{{ title|striptags|e }}{{ titlesuffix }}</title>
 19 |   {% endblock %}
 20 | 
 21 |   {# FAVICON #}
 22 |   {% if favicon %}
 23 |     <link rel="shortcut icon" href="{{ pathto('_static/' + favicon, 1) }}"/>
 24 |   {% endif %}
 25 | 
 26 |   {# CSS #}
 27 | 
 28 |   {# OPENSEARCH #}
 29 |   {% if not embedded %}
 30 |     {% if use_opensearch %}
 31 |       <link rel="search" type="application/opensearchdescription+xml" title="{% trans docstitle=docstitle|e %}Search within {{ docstitle }}{% endtrans %}" href="{{ pathto('_static/opensearch.xml', 1) }}"/>
 32 |     {% endif %}
 33 | 
 34 |   {% endif %}
 35 | 
 36 |   {# RTD hosts this file, so just load on non RTD builds #}
 37 |   {% if not READTHEDOCS %}
 38 |     <link rel="stylesheet" href="{{ pathto('_static/' + style, 1) }}" type="text/css" />
 39 |   {% endif %}
 40 | 
 41 |   {% for cssfile in css_files %}
 42 |     <link rel="stylesheet" href="{{ pathto(cssfile, 1) }}" type="text/css" />
 43 |   {% endfor %}
 44 | 
 45 |   {% for cssfile in extra_css_files %}
 46 |     <link rel="stylesheet" href="{{ pathto(cssfile, 1) }}" type="text/css" />
 47 |   {% endfor %}
 48 | 
 49 |   {%- block linktags %}
 50 |     {%- if hasdoc('about') %}
 51 |         <link rel="author" title="{{ _('About these documents') }}"
 52 |               href="{{ pathto('about') }}"/>
 53 |     {%- endif %}
 54 |     {%- if hasdoc('genindex') %}
 55 |         <link rel="index" title="{{ _('Index') }}"
 56 |               href="{{ pathto('genindex') }}"/>
 57 |     {%- endif %}
 58 |     {%- if hasdoc('search') %}
 59 |         <link rel="search" title="{{ _('Search') }}" href="{{ pathto('search') }}"/>
 60 |     {%- endif %}
 61 |     {%- if hasdoc('copyright') %}
 62 |         <link rel="copyright" title="{{ _('Copyright') }}" href="{{ pathto('copyright') }}"/>
 63 |     {%- endif %}
 64 |     <link rel="top" title="{{ docstitle|e }}" href="{{ pathto('index') }}"/>
 65 |     {%- if parents %}
 66 |         <link rel="up" title="{{ parents[-1].title|striptags|e }}" href="{{ parents[-1].link|e }}"/>
 67 |     {%- endif %}
 68 |     {%- if next %}
 69 |         <link rel="next" title="{{ next.title|striptags|e }}" href="{{ next.link|e }}"/>
 70 |     {%- endif %}
 71 |     {%- if prev %}
 72 |         <link rel="prev" title="{{ prev.title|striptags|e }}" href="{{ prev.link|e }}"/>
 73 |     {%- endif %}
 74 |   {%- endblock %}
 75 |   {%- block extrahead %} {% endblock %}
 76 | 
 77 |   {# Keep modernizr in head - http://modernizr.com/docs/#installing #}
 78 |   <script src="{{ pathto('_static/js/modernizr.min.js', 1) }}"></script>
 79 | 
 80 | </head>
 81 | 
 82 | <body class="wy-body-for-nav" role="document">
 83 | 
 84 |   {% block extrabody %} {% endblock %}
 85 |   <div class="wy-grid-for-nav">
 86 | 
 87 |     {# SIDE NAV, TOGGLES ON MOBILE #}
 88 |     <nav data-toggle="wy-nav-shift" class="wy-nav-side">
 89 |       <div class="wy-side-scroll">
 90 |         <div class="wy-side-nav-search">
 91 |           {% block sidebartitle %}
 92 | 
 93 |           {% if logo and theme_logo_only %}
 94 |             <a href="{{ pathto(master_doc) }}">
 95 |           {% else %}
 96 |             <a href="{{ pathto(master_doc) }}" class="icon icon-home"> {{ project }}
 97 |           {% endif %}
 98 | 
 99 |           {% if logo %}
100 |             {# Not strictly valid HTML, but it's the only way to display/scale it properly, without weird scripting or heaps of work #}
101 |             <img src="{{ pathto('_static/' + logo, 1) }}" class="logo" />
102 |             Services and API documentation
103 |           {% endif %}
104 |           </a>
105 | 
106 |           {% if theme_display_version %}
107 |             {%- set nav_version = version %}
108 |             {% if READTHEDOCS and current_version %}
109 |               {%- set nav_version = current_version %}
110 |             {% endif %}
111 |             {% if nav_version %}
112 |               <div class="version">
113 |                 {{ nav_version }}
114 |               </div>
115 |             {% endif %}
116 |           {% endif %}
117 | 
118 |           {% include "searchbox.html" %}
119 | 
120 |           {% endblock %}
121 |         </div>
122 | 
123 |         <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
124 |           {% block menu %}
125 |             {% set toctree = toctree(maxdepth=theme_navigation_depth, collapse=theme_collapse_navigation, includehidden=True) %}
126 |             {% if toctree %}
127 |                 {{ toctree }}
128 |             {% else %}
129 |                 <!-- Local TOC -->
130 |                 <div class="local-toc">{{ toc }}</div>
131 |             {% endif %}
132 |           {% endblock %}
133 |         </div>
134 |       </div>
135 |     </nav>
136 | 
137 |     <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
138 | 
139 |       {# MOBILE NAV, TRIGGLES SIDE NAV ON TOGGLE #}
140 |       <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
141 |         {% block mobile_nav %}
142 |           <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
143 |           <a href="{{ pathto(master_doc) }}">{{ project }}</a>
144 |         {% endblock %}
145 |       </nav>
146 | 
147 | 
148 |       {# PAGE CONTENT #}
149 |       <div class="wy-nav-content">
150 |         <div class="rst-content">
151 |           {% include "breadcrumbs.html" %}
152 |           <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
153 |            <div itemprop="articleBody">
154 |             {% block body %}{% endblock %}
155 |            </div>
156 |           </div>
157 |           {% include "footer.html" %}
158 |         </div>
159 |       </div>
160 | 
161 |     </section>
162 | 
163 |   </div>
164 |   {% include "versions.html" %}
165 | 
166 |   {% if not embedded %}
167 | 
168 |     <script type="text/javascript">
169 |         var DOCUMENTATION_OPTIONS = {
170 |             URL_ROOT:'{{ url_root }}',
171 |             VERSION:'{{ release|e }}',
172 |             COLLAPSE_INDEX:false,
173 |             FILE_SUFFIX:'{{ '' if no_search_suffix else file_suffix }}',
174 |             HAS_SOURCE:  {{ has_source|lower }}
175 |         };
176 |     </script>
177 |     {%- for scriptfile in script_files %}
178 |       <script type="text/javascript" src="{{ pathto(scriptfile, 1) }}"></script>
179 |     {%- endfor %}
180 | 
181 |   {% endif %}
182 | 
183 |   {# RTD hosts this file, so just load on non RTD builds #}
184 |   {% if not READTHEDOCS %}
185 |     <script type="text/javascript" src="{{ pathto('_static/js/theme.js', 1) }}"></script>
186 |   {% endif %}
187 | 
188 |   {# STICKY NAVIGATION #}
189 |   {% if theme_sticky_navigation %}
190 |   <script type="text/javascript">
191 |       jQuery(function () {
192 |           SphinxRtdTheme.StickyNav.enable();
193 |       });
194 |   </script>
195 |   {% endif %}
196 | 
197 |   {%- block footer %} {% endblock %}
198 | 
199 | </body>
200 | </html>
201 | 


--------------------------------------------------------------------------------
/docs/_themes/ac_sphinx_rtd_theme/search.html:
--------------------------------------------------------------------------------
 1 | {#
 2 |     basic/search.html
 3 |     ~~~~~~~~~~~~~~~~~
 4 | 
 5 |     Template for the search page.
 6 | 
 7 |     :copyright: Copyright 2007-2013 by the Sphinx team, see AUTHORS.
 8 |     :license: BSD, see LICENSE for details.
 9 | #}
10 | {%- extends "layout.html" %}
11 | {% set title = _('Search') %}
12 | {% set script_files = script_files + ['_static/searchtools.js'] %}
13 | {% block footer %}
14 |   <script type="text/javascript">
15 |     jQuery(function() { Search.loadIndex("{{ pathto('searchindex.js', 1) }}"); });
16 |   </script>
17 |   {# this is used when loading the search index using $.ajax fails,
18 |      such as on Chrome for documents on localhost #}
19 |   <script type="text/javascript" id="searchindexloader"></script>
20 |   {{ super() }}
21 | {% endblock %}
22 | {% block body %}
23 |   <noscript>
24 |   <div id="fallback" class="admonition warning">
25 |     <p class="last">
26 |       {% trans %}Please activate JavaScript to enable the search
27 |       functionality.{% endtrans %}
28 |     </p>
29 |   </div>
30 |   </noscript>
31 | 
32 |   {% if search_performed %}
33 |     <h2>{{ _('Search Results') }}</h2>
34 |     {% if not search_results %}
35 |       <p>{{ _('Your search did not match any documents. Please make sure that all words are spelled correctly and that you\'ve selected enough categories.') }}</p>
36 |     {% endif %}
37 |   {% endif %}
38 |   <div id="search-results">
39 |   {% if search_results %}
40 |     <ul>
41 |     {% for href, caption, context in search_results %}
42 |       <li>
43 |         <a href="{{ pathto(item.href) }}">{{ caption }}</a>
44 |         <p class="context">{{ context|e }}</p>
45 |       </li>
46 |     {% endfor %}
47 |     </ul>
48 |   {% endif %}
49 |   </div>
50 | {% endblock %}
51 | 


--------------------------------------------------------------------------------
/docs/_themes/ac_sphinx_rtd_theme/searchbox.html:
--------------------------------------------------------------------------------
 1 | {%- if builder != 'singlehtml' %}
 2 | <div role="search">
 3 |   <form id="rtd-search-form" class="wy-form" action="{{ pathto('search') }}" method="get">
 4 |     <input type="text" name="q" placeholder="Search docs" />
 5 |     <input type="hidden" name="check_keywords" value="yes" />
 6 |     <input type="hidden" name="area" value="default" />
 7 |   </form>
 8 | </div>
 9 | {%- endif %}
10 | 


--------------------------------------------------------------------------------
/docs/_themes/ac_sphinx_rtd_theme/static/css/badge_only.css:
--------------------------------------------------------------------------------
  1 | @charset "UTF-8";
  2 | @import url(https://fonts.googleapis.com/css?family=Rajdhani:400,700);
  3 | @import url(https://fonts.googleapis.com/css?family=Roboto:300,500);
  4 | body {
  5 |   font-weight: 300 !important;
  6 | }
  7 | 
  8 | section a {
  9 |   color: #0F783C !important;
 10 | }
 11 | 
 12 | h1 {
 13 |   font-size: 200% !important;
 14 |   color: #1E5055 !important;
 15 |   text-transform: uppercase;
 16 | }
 17 | 
 18 | h2 {
 19 |   font-size: 170% !important;
 20 |   color: #991933 !important;
 21 |   font-weight: 400 !important;
 22 | }
 23 | 
 24 | h3 {
 25 |   font-size: 150% !important;
 26 |   color: gray !important;
 27 |   font-weight: 300 !important;
 28 | }
 29 | 
 30 | h4 {
 31 |   font-size: 125% !important;
 32 |   font-weight: 300 !important;
 33 | }
 34 | 
 35 | .wy-nav-top {
 36 |   background-color: #1E5055 !important;
 37 | }
 38 | 
 39 | .wy-nav-top a {
 40 |   color: white !important;
 41 | }
 42 | 
 43 | .fa:before {
 44 |   -webkit-font-smoothing: antialiased;
 45 | }
 46 | 
 47 | .clearfix {
 48 |   *zoom: 1;
 49 | }
 50 | .clearfix:before, .clearfix:after {
 51 |   display: table;
 52 |   content: "";
 53 | }
 54 | .clearfix:after {
 55 |   clear: both;
 56 | }
 57 | 
 58 | @font-face {
 59 |   font-family: FontAwesome;
 60 |   font-weight: normal;
 61 |   font-style: normal;
 62 |   src: url("../font/fontawesome_webfont.eot");
 63 |   src: url("../font/fontawesome_webfont.eot?#iefix") format("embedded-opentype"), url("../font/fontawesome_webfont.woff") format("woff"), url("../font/fontawesome_webfont.ttf") format("truetype"), url("../font/fontawesome_webfont.svg#FontAwesome") format("svg");
 64 | }
 65 | .fa:before {
 66 |   display: inline-block;
 67 |   font-family: FontAwesome;
 68 |   font-style: normal;
 69 |   font-weight: normal;
 70 |   line-height: 1;
 71 |   text-decoration: inherit;
 72 | }
 73 | 
 74 | a .fa {
 75 |   display: inline-block;
 76 |   text-decoration: inherit;
 77 | }
 78 | 
 79 | li .fa {
 80 |   display: inline-block;
 81 | }
 82 | li .fa-large:before,
 83 | li .fa-large:before {
 84 |   /* 1.5 increased font size for fa-large * 1.25 width */
 85 |   width: 1.875em;
 86 | }
 87 | 
 88 | ul.fas {
 89 |   list-style-type: none;
 90 |   margin-left: 2em;
 91 |   text-indent: -0.8em;
 92 | }
 93 | ul.fas li .fa {
 94 |   width: 0.8em;
 95 | }
 96 | ul.fas li .fa-large:before,
 97 | ul.fas li .fa-large:before {
 98 |   /* 1.5 increased font size for fa-large * 1.25 width */
 99 |   vertical-align: baseline;
100 | }
101 | 
102 | .fa-book:before {
103 |   content: "";
104 | }
105 | 
106 | .icon-book:before {
107 |   content: "";
108 | }
109 | 
110 | .fa-caret-down:before {
111 |   content: "";
112 | }
113 | 
114 | .icon-caret-down:before {
115 |   content: "";
116 | }
117 | 
118 | .fa-caret-up:before {
119 |   content: "";
120 | }
121 | 
122 | .icon-caret-up:before {
123 |   content: "";
124 | }
125 | 
126 | .fa-caret-left:before {
127 |   content: "";
128 | }
129 | 
130 | .icon-caret-left:before {
131 |   content: "";
132 | }
133 | 
134 | .fa-caret-right:before {
135 |   content: "";
136 | }
137 | 
138 | .icon-caret-right:before {
139 |   content: "";
140 | }
141 | 
142 | .rst-versions {
143 |   position: fixed;
144 |   bottom: 0;
145 |   left: 0;
146 |   width: 300px;
147 |   color: #fcfcfc;
148 |   background: #1f1d1d;
149 |   border-top: solid 10px #343131;
150 |   font-family: "Roboto", sans-serif;
151 |   z-index: 400;
152 | }
153 | .rst-versions a {
154 |   color: #2980B9;
155 |   text-decoration: none;
156 | }
157 | .rst-versions .rst-badge-small {
158 |   display: none;
159 | }
160 | .rst-versions .rst-current-version {
161 |   padding: 12px;
162 |   background-color: #272525;
163 |   display: block;
164 |   text-align: right;
165 |   font-size: 90%;
166 |   cursor: pointer;
167 |   color: #0F783C;
168 |   *zoom: 1;
169 | }
170 | .rst-versions .rst-current-version:before, .rst-versions .rst-current-version:after {
171 |   display: table;
172 |   content: "";
173 | }
174 | .rst-versions .rst-current-version:after {
175 |   clear: both;
176 | }
177 | .rst-versions .rst-current-version .fa {
178 |   color: #fcfcfc;
179 | }
180 | .rst-versions .rst-current-version .fa-book {
181 |   float: left;
182 | }
183 | .rst-versions .rst-current-version .icon-book {
184 |   float: left;
185 | }
186 | .rst-versions .rst-current-version.rst-out-of-date {
187 |   background-color: #991933;
188 |   color: #fff;
189 | }
190 | .rst-versions .rst-current-version.rst-active-old-version {
191 |   background-color: #F1C40F;
192 |   color: #000;
193 | }
194 | .rst-versions.shift-up .rst-other-versions {
195 |   display: block;
196 | }
197 | .rst-versions .rst-other-versions {
198 |   font-size: 90%;
199 |   padding: 12px;
200 |   color: gray;
201 |   display: none;
202 | }
203 | .rst-versions .rst-other-versions hr {
204 |   display: block;
205 |   height: 1px;
206 |   border: 0;
207 |   margin: 20px 0;
208 |   padding: 0;
209 |   border-top: solid 1px #413d3d;
210 | }
211 | .rst-versions .rst-other-versions dd {
212 |   display: inline-block;
213 |   margin: 0;
214 | }
215 | .rst-versions .rst-other-versions dd a {
216 |   display: inline-block;
217 |   padding: 6px;
218 |   color: #fcfcfc;
219 | }
220 | .rst-versions.rst-badge {
221 |   width: auto;
222 |   bottom: 20px;
223 |   right: 20px;
224 |   left: auto;
225 |   border: none;
226 |   max-width: 300px;
227 | }
228 | .rst-versions.rst-badge .icon-book {
229 |   float: none;
230 | }
231 | .rst-versions.rst-badge .fa-book {
232 |   float: none;
233 | }
234 | .rst-versions.rst-badge.shift-up .rst-current-version {
235 |   text-align: right;
236 | }
237 | .rst-versions.rst-badge.shift-up .rst-current-version .fa-book {
238 |   float: left;
239 | }
240 | .rst-versions.rst-badge.shift-up .rst-current-version .icon-book {
241 |   float: left;
242 | }
243 | .rst-versions.rst-badge .rst-current-version {
244 |   width: auto;
245 |   height: 30px;
246 |   line-height: 30px;
247 |   padding: 0 6px;
248 |   display: block;
249 |   text-align: center;
250 | }
251 | 
252 | @media screen and (max-width: 768px) {
253 |   .rst-versions {
254 |     width: 85%;
255 |     display: none;
256 |   }
257 |   .rst-versions.shift {
258 |     display: block;
259 |   }
260 | 
261 |   img {
262 |     width: 100%;
263 |     height: auto;
264 |   }
265 | }
266 | 
267 | /*# sourceMappingURL=badge_only.css.map */
268 | 


--------------------------------------------------------------------------------
/docs/_themes/ac_sphinx_rtd_theme/static/css/badge_only.css.map:
--------------------------------------------------------------------------------
1 | {
2 | "version": 3,
3 | "mappings": ";AA8DQ,qEAA6D;AAC7D,mEAA2D;AAWnE,IAAI;EACF,WAAW,EAAE,cAAc;;;AAG3B,SAAC;EACC,KAAK,EAAE,kBAAoB;;;AAE/B,EAAE;EACA,SAAS,EAAE,eAAe;EAC1B,KAAK,EAAE,kBAAmB;EAC1B,cAAc,EAAE,SAAS;;;AAE3B,EAAE;EACA,SAAS,EAAE,eAAe;EAC1B,KAAK,EAAE,kBAAkB;EACzB,WAAW,EAAE,cAAc;;;AAE7B,EAAE;EACA,SAAS,EAAE,eAAe;EAC1B,KAAK,EAAE,eAA4B;EACnC,WAAW,EAAE,cAAc;;;AAE7B,EAAE;EACA,SAAS,EAAE,eAAe;EAC1B,WAAW,EAAE,cAAc;;;AAE7B,WAAW;EACT,gBAAgB,EAAE,kBAAmB;;;AAEvC,aAAa;EACX,KAAK,EAAE,gBAAgB;;;AC/CzB,UAAY;EACV,sBAAsB,EAAE,WAAW;;;AAqDrC,SAAS;EARP,KAAK,EAAE,CAAC;;AACR,iCAAS;EAEP,OAAO,EAAE,KAAK;EACd,OAAO,EAAE,EAAE;;AACb,eAAO;EACL,KAAK,EAAE,IAAI;;;AC1Gb,UAkBC;EAjBC,WAAW,ECFJ,WAAW;EDGlB,WAAW,EAHqC,MAAM;EAItD,UAAU,EAJsD,MAAM;EAapE,GAAG,EAAE,sCAAwB;EAC7B,GAAG,EAAE,8PAG2D;;ACftE,UAAU;EACR,OAAO,EAAE,YAAY;EACrB,WAAW,EAAE,WAAW;EACxB,UAAU,EAAE,MAAM;EAClB,WAAW,EAAE,MAAM;EACnB,WAAW,EAAE,CAAC;EACd,eAAe,EAAE,OAAO;;;AAG1B,KAAK;EACH,OAAO,EAAE,YAAY;EACrB,eAAe,EAAE,OAAO;;;AAIxB,MAAG;EACD,OAAO,EAAE,YAAY;;AACvB;mBAAiB;;EAGf,KAAK,EAAE,OAAY;;;AAEvB,MAAM;EACJ,eAAe,EAAE,IAAI;EACrB,WAAW,EAAE,GAAG;EAChB,WAAW,EAAE,MAAM;;AAEjB,aAAG;EACD,KAAK,EAAE,KAAI;;AACb;0BAAiB;;EAGf,cAAc,EAAE,QAAQ;;;AAG9B,eAAe;EACb,OAAO,EAAE,GAAO;;;AAElB,iBAAiB;EACf,OAAO,EAAE,GAAO;;;AAElB,qBAAqB;EACnB,OAAO,EAAE,GAAO;;;AAElB,uBAAuB;EACrB,OAAO,EAAE,GAAO;;;AAElB,mBAAmB;EACjB,OAAO,EAAE,GAAO;;;AAElB,qBAAqB;EACnB,OAAO,EAAE,GAAO;;;AAElB,qBAAqB;EACnB,OAAO,EAAE,GAAO;;;AAElB,uBAAuB;EACrB,OAAO,EAAE,GAAO;;;AAElB,sBAAsB;EACpB,OAAO,EAAE,GAAO;;;AAElB,wBAAwB;EACtB,OAAO,EAAE,GAAO;;;ACnElB,aAAa;EACX,QAAQ,EAAE,KAAK;EACf,MAAM,EAAE,CAAC;EACT,IAAI,EAAE,CAAC;EACP,KAAK,EC6E+B,KAAK;ED5EzC,KAAK,EJ2C+B,OAAyB;EI1C7D,UAAU,EAAE,OAAkC;EAC9C,UAAU,EAAE,kBAAiC;EAC7C,WAAW,EJwDyB,oBAAoB;EIvDxD,OAAO,EC+E6B,GAAG;;AD9EvC,eAAC;EACC,KAAK,ECqE6B,OAAW;EDpE7C,eAAe,EAAE,IAAI;;AACvB,8BAAgB;EACd,OAAO,EAAE,IAAI;;AACf,kCAAoB;EAClB,OAAO,EAAE,IAAqB;EAC9B,gBAAgB,EAAE,OAAkC;EACpD,OAAO,EAAE,KAAK;EACd,UAAU,EAAE,KAAK;EACjB,SAAS,EAAE,GAAG;EACd,MAAM,EAAE,OAAO;EACf,KAAK,EJiDD,OAAS;ECgCf,KAAK,EAAE,CAAC;;AACR,mFAAS;EAEP,OAAO,EAAE,KAAK;EACd,OAAO,EAAE,EAAE;;AACb,wCAAO;EACL,KAAK,EAAE,IAAI;;AGrFX,sCAAG;EACD,KAAK,EJuB2B,OAAyB;;AItB3D,2CAAQ;EACN,KAAK,EAAE,IAAI;;AACb,6CAAU;EACR,KAAK,EAAE,IAAI;;AACb,kDAAiB;EACf,gBAAgB,EJuChB,OAAO;EItCP,KAAK,EJW2B,IAAM;;AIVxC,yDAAwB;EACtB,gBAAgB,ECXgB,OAAO;EDYvC,KAAK,ECzB2B,IAAI;;AD0BxC,0CAA8B;EAC5B,OAAO,EAAE,KAAK;;AAChB,iCAAmB;EACjB,SAAS,EAAE,GAAG;EACd,OAAO,EAAE,IAAqB;EAC9B,KAAK,EJA6B,IAAY;EIC9C,OAAO,EAAE,IAAI;;AACb,oCAAE;EACA,OAAO,EAAE,KAAK;EACd,MAAM,EAAE,GAAG;EACX,MAAM,EAAE,CAAC;EACT,MAAM,EAAE,MAAM;EACd,OAAO,EAAE,CAAC;EACV,UAAU,EAAE,iBAA6C;;AAC3D,oCAAE;EACA,OAAO,EAAE,YAAY;EACrB,MAAM,EAAE,CAAC;;AACT,sCAAC;EACC,OAAO,EAAE,YAAY;EACrB,OAAO,EAAE,GAAqB;EAC9B,KAAK,EJRyB,OAAyB;;AIS7D,uBAAW;EACT,KAAK,EAAE,IAAI;EACX,MAAM,EAAE,IAAI;EACZ,KAAK,EAAE,IAAI;EACX,IAAI,EAAE,IAAI;EACV,MAAM,EAAE,IAAI;EACZ,SAAS,ECkByB,KAAK;;ADjBvC,kCAAU;EACR,KAAK,EAAE,IAAI;;AACb,gCAAQ;EACN,KAAK,EAAE,IAAI;;AACb,qDAA+B;EAC7B,UAAU,EAAE,KAAK;;AACjB,8DAAQ;EACN,KAAK,EAAE,IAAI;;AACb,gEAAU;EACR,KAAK,EAAE,IAAI;;AACf,4CAAoB;EAClB,KAAK,EAAE,IAAI;EACX,MAAM,EAAE,IAAI;EACZ,WAAW,EAAE,IAAI;EACjB,OAAO,EAAE,KAAuB;EAChC,OAAO,EAAE,KAAK;EACd,UAAU,EAAE,MAAM;;;AEhDpB,oCAAsB;EFmDxB,aAAa;IACX,KAAK,EAAE,GAAG;IACV,OAAO,EAAE,IAAI;;EACb,mBAAO;IACL,OAAO,EAAE,KAAK;;;EAClB,GAAG;IACD,KAAK,EAAE,IAAI;IACX,MAAM,EAAE,IAAI",
4 | "sources": ["../../../sass/_theme_variables.sass","../../../bower_components/wyrm/sass/wyrm_core/_mixin.sass","../../../bower_components/bourbon/dist/css3/_font-face.scss","../../../sass/_theme_badge_fa.sass","../../../sass/_theme_badge.sass","../../../bower_components/wyrm/sass/wyrm_core/_wy_variables.sass","../../../bower_components/neat/app/assets/stylesheets/grid/_media.scss"],
5 | "names": [],
6 | "file": "badge_only.css"
7 | }
8 | 


--------------------------------------------------------------------------------
/docs/_themes/ac_sphinx_rtd_theme/static/fonts/FontAwesome.otf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AudioCommons/ac-mediator/3201c12865d986fd945a1108b00ad9e85d459827/docs/_themes/ac_sphinx_rtd_theme/static/fonts/FontAwesome.otf


--------------------------------------------------------------------------------
/docs/_themes/ac_sphinx_rtd_theme/static/fonts/Inconsolata-Bold.ttf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AudioCommons/ac-mediator/3201c12865d986fd945a1108b00ad9e85d459827/docs/_themes/ac_sphinx_rtd_theme/static/fonts/Inconsolata-Bold.ttf


--------------------------------------------------------------------------------
/docs/_themes/ac_sphinx_rtd_theme/static/fonts/Inconsolata-Regular.ttf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AudioCommons/ac-mediator/3201c12865d986fd945a1108b00ad9e85d459827/docs/_themes/ac_sphinx_rtd_theme/static/fonts/Inconsolata-Regular.ttf


--------------------------------------------------------------------------------
/docs/_themes/ac_sphinx_rtd_theme/static/fonts/Lato-Bold.ttf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AudioCommons/ac-mediator/3201c12865d986fd945a1108b00ad9e85d459827/docs/_themes/ac_sphinx_rtd_theme/static/fonts/Lato-Bold.ttf


--------------------------------------------------------------------------------
/docs/_themes/ac_sphinx_rtd_theme/static/fonts/Lato-Regular.ttf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AudioCommons/ac-mediator/3201c12865d986fd945a1108b00ad9e85d459827/docs/_themes/ac_sphinx_rtd_theme/static/fonts/Lato-Regular.ttf


--------------------------------------------------------------------------------
/docs/_themes/ac_sphinx_rtd_theme/static/fonts/RobotoSlab-Bold.ttf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AudioCommons/ac-mediator/3201c12865d986fd945a1108b00ad9e85d459827/docs/_themes/ac_sphinx_rtd_theme/static/fonts/RobotoSlab-Bold.ttf


--------------------------------------------------------------------------------
/docs/_themes/ac_sphinx_rtd_theme/static/fonts/RobotoSlab-Regular.ttf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AudioCommons/ac-mediator/3201c12865d986fd945a1108b00ad9e85d459827/docs/_themes/ac_sphinx_rtd_theme/static/fonts/RobotoSlab-Regular.ttf


--------------------------------------------------------------------------------
/docs/_themes/ac_sphinx_rtd_theme/static/fonts/fontawesome-webfont.eot:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AudioCommons/ac-mediator/3201c12865d986fd945a1108b00ad9e85d459827/docs/_themes/ac_sphinx_rtd_theme/static/fonts/fontawesome-webfont.eot


--------------------------------------------------------------------------------
/docs/_themes/ac_sphinx_rtd_theme/static/fonts/fontawesome-webfont.ttf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AudioCommons/ac-mediator/3201c12865d986fd945a1108b00ad9e85d459827/docs/_themes/ac_sphinx_rtd_theme/static/fonts/fontawesome-webfont.ttf


--------------------------------------------------------------------------------
/docs/_themes/ac_sphinx_rtd_theme/static/fonts/fontawesome-webfont.woff:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AudioCommons/ac-mediator/3201c12865d986fd945a1108b00ad9e85d459827/docs/_themes/ac_sphinx_rtd_theme/static/fonts/fontawesome-webfont.woff


--------------------------------------------------------------------------------
/docs/_themes/ac_sphinx_rtd_theme/static/js/theme.js:
--------------------------------------------------------------------------------
  1 | require=(function e(t,n,r){function s(o,u){if(!n[o]){if(!t[o]){var a=typeof require=="function"&&require;if(!u&&a)return a(o,!0);if(i)return i(o,!0);var f=new Error("Cannot find module '"+o+"'");throw f.code="MODULE_NOT_FOUND",f}var l=n[o]={exports:{}};t[o][0].call(l.exports,function(e){var n=t[o][1][e];return s(n?n:e)},l,l.exports,e,t,n,r)}return n[o].exports}var i=typeof require=="function"&&require;for(var o=0;o<r.length;o++)s(r[o]);return s})({"sphinx-rtd-theme":[function(require,module,exports){
  2 | var jQuery = (typeof(window) != 'undefined') ? window.jQuery : require('jquery');
  3 | 
  4 | // Sphinx theme nav state
  5 | function ThemeNav () {
  6 | 
  7 |     var nav = {
  8 |         navBar: null,
  9 |         win: null,
 10 |         winScroll: false,
 11 |         winResize: false,
 12 |         linkScroll: false,
 13 |         winPosition: 0,
 14 |         winHeight: null,
 15 |         docHeight: null,
 16 |         isRunning: false
 17 |     };
 18 | 
 19 |     nav.enable = function () {
 20 |         var self = this;
 21 | 
 22 |         if (!self.isRunning) {
 23 |             self.isRunning = true;
 24 |             jQuery(function ($) {
 25 |                 self.init($);
 26 | 
 27 |                 self.reset();
 28 |                 self.win.on('hashchange', self.reset);
 29 | 
 30 |                 // Set scroll monitor
 31 |                 self.win.on('scroll', function () {
 32 |                     if (!self.linkScroll) {
 33 |                         self.winScroll = true;
 34 |                     }
 35 |                 });
 36 |                 setInterval(function () { if (self.winScroll) self.onScroll(); }, 25);
 37 | 
 38 |                 // Set resize monitor
 39 |                 self.win.on('resize', function () {
 40 |                     self.winResize = true;
 41 |                 });
 42 |                 setInterval(function () { if (self.winResize) self.onResize(); }, 25);
 43 |                 self.onResize();
 44 |             });
 45 |         };
 46 |     };
 47 | 
 48 |     nav.init = function ($) {
 49 |         var doc = $(document),
 50 |             self = this;
 51 | 
 52 |         this.navBar = $('div.wy-side-scroll:first');
 53 |         this.win = $(window);
 54 | 
 55 |         // Set up javascript UX bits
 56 |         $(document)
 57 |             // Shift nav in mobile when clicking the menu.
 58 |             .on('click', "[data-toggle='wy-nav-top']", function() {
 59 |                 $("[data-toggle='wy-nav-shift']").toggleClass("shift");
 60 |                 $("[data-toggle='rst-versions']").toggleClass("shift");
 61 |             })
 62 | 
 63 |             // Nav menu link click operations
 64 |             .on('click', ".wy-menu-vertical .current ul li a", function() {
 65 |                 var target = $(this);
 66 |                 // Close menu when you click a link.
 67 |                 $("[data-toggle='wy-nav-shift']").removeClass("shift");
 68 |                 $("[data-toggle='rst-versions']").toggleClass("shift");
 69 |                 // Handle dynamic display of l3 and l4 nav lists
 70 |                 self.toggleCurrent(target);
 71 |                 self.hashChange();
 72 |             })
 73 |             .on('click', "[data-toggle='rst-current-version']", function() {
 74 |                 $("[data-toggle='rst-versions']").toggleClass("shift-up");
 75 |             })
 76 | 
 77 |         // Make tables responsive
 78 |         $("table.docutils:not(.field-list)")
 79 |             .wrap("<div class='wy-table-responsive'></div>");
 80 | 
 81 |         // Add expand links to all parents of nested ul
 82 |         $('.wy-menu-vertical ul').not('.simple').siblings('a').each(function () {
 83 |             var link = $(this);
 84 |                 expand = $('<span class="toctree-expand"></span>');
 85 |             expand.on('click', function (ev) {
 86 |                 self.toggleCurrent(link);
 87 |                 ev.stopPropagation();
 88 |                 return false;
 89 |             });
 90 |             link.prepend(expand);
 91 |         });
 92 |     };
 93 | 
 94 |     nav.reset = function () {
 95 |         // Get anchor from URL and open up nested nav
 96 |         var anchor = encodeURI(window.location.hash);
 97 |         if (anchor) {
 98 |             try {
 99 |                 var link = $('.wy-menu-vertical')
100 |                     .find('[href="' + anchor + '"]');
101 |                 $('.wy-menu-vertical li.toctree-l1 li.current')
102 |                     .removeClass('current');
103 |                 link.closest('li.toctree-l2').addClass('current');
104 |                 link.closest('li.toctree-l3').addClass('current');
105 |                 link.closest('li.toctree-l4').addClass('current');
106 |             }
107 |             catch (err) {
108 |                 console.log("Error expanding nav for anchor", err);
109 |             }
110 |         }
111 |     };
112 | 
113 |     nav.onScroll = function () {
114 |         this.winScroll = false;
115 |         var newWinPosition = this.win.scrollTop(),
116 |             winBottom = newWinPosition + this.winHeight,
117 |             navPosition = this.navBar.scrollTop(),
118 |             newNavPosition = navPosition + (newWinPosition - this.winPosition);
119 |         if (newWinPosition < 0 || winBottom > this.docHeight) {
120 |             return;
121 |         }
122 |         this.navBar.scrollTop(newNavPosition);
123 |         this.winPosition = newWinPosition;
124 |     };
125 | 
126 |     nav.onResize = function () {
127 |         this.winResize = false;
128 |         this.winHeight = this.win.height();
129 |         this.docHeight = $(document).height();
130 |     };
131 | 
132 |     nav.hashChange = function () {
133 |         this.linkScroll = true;
134 |         this.win.one('hashchange', function () {
135 |             this.linkScroll = false;
136 |         });
137 |     };
138 | 
139 |     nav.toggleCurrent = function (elem) {
140 |         var parent_li = elem.closest('li');
141 |         parent_li.siblings('li.current').removeClass('current');
142 |         parent_li.siblings().find('li.current').removeClass('current');
143 |         parent_li.find('> ul li.current').removeClass('current');
144 |         parent_li.toggleClass('current');
145 |     }
146 | 
147 |     return nav;
148 | };
149 | 
150 | module.exports.ThemeNav = ThemeNav();
151 | 
152 | if (typeof(window) != 'undefined') {
153 |     window.SphinxRtdTheme = { StickyNav: module.exports.ThemeNav };
154 | }
155 | 
156 | },{"jquery":"jquery"}]},{},["sphinx-rtd-theme"]);
157 | 


--------------------------------------------------------------------------------
/docs/_themes/ac_sphinx_rtd_theme/theme.conf:
--------------------------------------------------------------------------------
 1 | [theme]
 2 | inherit = basic
 3 | stylesheet = css/theme.css
 4 | 
 5 | [options]
 6 | typekit_id = hiw1hhg
 7 | analytics_id = 
 8 | sticky_navigation = False
 9 | logo_only =
10 | collapse_navigation = False
11 | display_version = True
12 | navigation_depth = 4
13 | prev_next_buttons_location = bottom
14 | 


--------------------------------------------------------------------------------
/docs/_themes/ac_sphinx_rtd_theme/versions.html:
--------------------------------------------------------------------------------
 1 | {% if READTHEDOCS %}
 2 | {# Add rst-badge after rst-versions for small badge style. #}
 3 |   <div class="rst-versions" data-toggle="rst-versions" role="note" aria-label="versions">
 4 |     <span class="rst-current-version" data-toggle="rst-current-version">
 5 |       <span class="fa fa-book"> Read the Docs</span>
 6 |       v: {{ current_version }}
 7 |       <span class="fa fa-caret-down"></span>
 8 |     </span>
 9 |     <div class="rst-other-versions">
10 |       <dl>
11 |         <dt>Versions</dt>
12 |         {% for slug, url in versions %}
13 |           <dd><a href="{{ url }}">{{ slug }}</a></dd>
14 |         {% endfor %}
15 |       </dl>
16 |       <dl>
17 |         <dt>Downloads</dt>
18 |         {% for type, url in downloads %}
19 |           <dd><a href="{{ url }}">{{ type }}</a></dd>
20 |         {% endfor %}
21 |       </dl>
22 |       <dl>
23 |         <dt>On Read the Docs</dt>
24 |           <dd>
25 |             <a href="//{{ PRODUCTION_DOMAIN }}/projects/{{ slug }}/?fromdocs={{ slug }}">Project Home</a>
26 |           </dd>
27 |           <dd>
28 |             <a href="//{{ PRODUCTION_DOMAIN }}/builds/{{ slug }}/?fromdocs={{ slug }}">Builds</a>
29 |           </dd>
30 |       </dl>
31 |       <hr/>
32 |       Free document hosting provided by <a href="http://www.readthedocs.org">Read the Docs</a>.
33 | 
34 |     </div>
35 |   </div>
36 | {% endif %}
37 | 
38 | 


--------------------------------------------------------------------------------
/docs/acservice.rst:
--------------------------------------------------------------------------------
 1 | acservice package documentation
 2 | ===============================
 3 | 
 4 | 
 5 | Base class
 6 | ----------
 7 | 
 8 | .. automodule:: acservice.base
 9 |     :members:
10 |     :undoc-members:
11 |     :show-inheritance:
12 | 
13 | 
14 | Authentication mixin
15 | --------------------
16 | 
17 | .. automodule:: acservice.auth
18 |     :members:
19 |     :undoc-members:
20 |     :show-inheritance:
21 | 
22 | 
23 | Licensing mixin
24 | ---------------
25 | 
26 | .. automodule:: acservice.licensing
27 |     :members:
28 |     :undoc-members:
29 |     :show-inheritance:
30 | 
31 | 
32 | Search mixins
33 | -------------
34 | 
35 | .. automodule:: acservice.search
36 |     :members:
37 |     :undoc-members:
38 |     :show-inheritance:
39 | 
40 | 
41 | Util functions
42 | --------------
43 | 
44 | .. automodule:: acservice.utils
45 |     :members:
46 |     :undoc-members:
47 |     :show-inheritance:
48 | 


--------------------------------------------------------------------------------
/docs/api.rst:
--------------------------------------------------------------------------------
 1 | Audio Commons API documentation
 2 | ===============================
 3 | 
 4 | The Audio Commons mediator provides a web API for interacting with Audio Commons services.
 5 | 
 6 | .. warning::
 7 |     The Audio Commons services, mediator and API are in a **prototyping** state. Performance might not be optimal
 8 |     and some errors and inconsistencies might appear here and there. You can report bugs and provide general feedback
 9 |     by opening issues in the `source code repository <http://github.com/AudioCommons/ac-mediator/issues>`_.
10 | 
11 | 
12 | 
13 | 
14 | .. toctree::
15 |    :maxdepth: 3
16 | 
17 |    api_overview
18 | 
19 | .. toctree::
20 |    :maxdepth: 3
21 | 
22 |    api_tos
23 | 
24 | 
25 | .. toctree::
26 |    :maxdepth: 3
27 | 
28 |    api_authentication
29 | 
30 | 
31 | .. toctree::
32 |    :maxdepth: 3
33 | 
34 |    api_endpoints


--------------------------------------------------------------------------------
/docs/api_endpoints.rst:
--------------------------------------------------------------------------------
 1 | .. _endpoints-documentation:
 2 | 
 3 | Endpoints documentation
 4 | =======================
 5 | 
 6 | .. important::
 7 |     Point your API requests to the following base URL: ``https://m.audiocommons.org/api/v1``.
 8 |     Note that all requests should be made over **HTTPS**.
 9 | 
10 | 
11 | .. _collect-response-endpoint:
12 | 
13 | Collect response endpoint
14 | -------------------------
15 | 
16 | .. autoapiview:: api.views.collect_response
17 | 
18 | 
19 | Service discovery endpoints
20 | ---------------------------
21 | 
22 | .. autoapiview:: api.views.services
23 | 
24 | 
25 | Search endpoints
26 | ----------------
27 | 
28 | .. autoapiview:: api.views.text_search
29 | 
30 | 
31 | Download endpoints
32 | ------------------
33 | 
34 | .. autoapiview:: api.views.download
35 | 
36 | 
37 | Licensing endpoints
38 | -------------------
39 | 
40 | .. autoapiview:: api.views.licensing
41 | 
42 | 
43 | Other endpoints
44 | ---------------
45 | 
46 | .. autoapiview:: api.views.me
47 | 


--------------------------------------------------------------------------------
/docs/api_tos.rst:
--------------------------------------------------------------------------------
  1 | Terms of service and Privacy Policy
  2 | ===================================
  3 | 
  4 | The following Terms of Service and Privacy Policy apply to the Audio Commons Mediator/API. By using this services,
  5 | you agree to the following Terms of Service and Privacy Policy.
  6 | 
  7 | 
  8 | * `Terms of Service <#id1>`_
  9 | * `Privacy Policy <#id2>`_
 10 | 
 11 | 
 12 | Terms of Service
 13 | ----------------
 14 | 
 15 | 
 16 | 1. Terms
 17 | ********
 18 | 
 19 |   By accessing the website at https://m.audiocommons.org, you are agreeing to be bound by these terms of service,
 20 |   all applicable laws and regulations, and agree that you are responsible for compliance with any applicable local
 21 |   laws. If you do not agree with any of these terms, you are prohibited from using or accessing this site. The
 22 |   materials contained in this website are protected by applicable copyright and trademark law.
 23 | 
 24 | 2. Use License
 25 | **************
 26 | 
 27 |     i. Permission is granted to temporarily download one copy of the materials (information or software) on Audio
 28 |     Commons Mediator's website for personal, non-commercial transitory viewing only. This is the grant of a license,
 29 |     not a transfer of title, and under this license you may not:
 30 | 
 31 |        a. modify or copy the materials;
 32 | 
 33 |        b. use the materials for any commercial purpose, or for any public display (commercial or non-commercial);
 34 | 
 35 |        c. remove any copyright or other proprietary notations from the materials; or
 36 | 
 37 |        d. transfer the materials to another person or "mirror" the materials on any other server.
 38 | 
 39 |     ii. This license shall automatically terminate if you violate any of these restrictions and may be terminated by
 40 |     Audio Commons Mediator at any time. Upon terminating your viewing of these materials or upon the termination of
 41 |     this license, you must destroy any downloaded materials in your possession whether in electronic or printed format.
 42 | 
 43 | 3. Disclaimer
 44 | *************
 45 | 
 46 |     i. The materials on Audio Commons Mediator's website are provided on an 'as is' basis. Audio Commons Mediator
 47 |     makes no warranties, expressed or implied, and hereby disclaims and negates all other warranties including,
 48 |     without limitation, implied warranties or conditions of merchantability, fitness for a particular purpose, or
 49 |     non-infringement of intellectual property or other violation of rights.
 50 | 
 51 |     ii. Further, Audio Commons Mediator does not warrant or make any representations concerning the accuracy,
 52 |     likely results, or reliability of the use of the materials on its website or otherwise relating to such materials
 53 |     or on any sites linked to this site.
 54 | 
 55 | 4. Limitations
 56 | **************
 57 | 
 58 |   In no event shall Audio Commons Mediator or its suppliers be liable for any damages (including, without limitation,
 59 |   damages for loss of data or profit, or due to business interruption) arising out of the use or inability to use the
 60 |   materials on Audio Commons Mediator's website, even if Audio Commons Mediator or a Audio Commons Mediator authorized
 61 |   representative has been notified orally or in writing of the possibility of such damage. Because some jurisdictions
 62 |   do not allow limitations on implied warranties, or limitations of liability for consequential or incidental damages,
 63 |   these limitations may not apply to you.
 64 | 
 65 | 5. Accuracy of materials
 66 | ************************
 67 | 
 68 |   The materials appearing on Audio Commons Mediator's website could include technical, typographical, or photographic
 69 |   errors. Audio Commons Mediator does not warrant that any of the materials on its website are accurate, complete or
 70 |   current. Audio Commons Mediator may make changes to the materials contained on its website at any time without
 71 |   notice. However Audio Commons Mediator does not make any commitment to update the materials.
 72 | 
 73 | 6. Links
 74 | ********
 75 | 
 76 |   Audio Commons Mediator has not reviewed all of the sites linked to its website and is not responsible for the
 77 |   contents of any such linked site. The inclusion of any link does not imply endorsement by Audio Commons Mediator
 78 |   of the site. Use of any such linked website is at the user's own risk.
 79 | 
 80 | 7. Modifications
 81 | ****************
 82 | 
 83 |   Audio Commons Mediator may revise these terms of service for its website at any time without notice. By using this
 84 |   website you are agreeing to be bound by the then current version of these terms of service.
 85 | 
 86 | 8. Governing Law
 87 | ****************
 88 | 
 89 |   These terms and conditions are governed by and construed in accordance with the laws of Spain and you irrevocably
 90 |   submit to the exclusive jurisdiction of the courts in that State or location.
 91 | 
 92 | 
 93 | 
 94 | Privacy Policy
 95 | --------------
 96 | 
 97 | Your privacy is important to us. It is Audio Commons Mediator's policy to respect your privacy regarding any
 98 | information we may collect from you across our website, https://m.audiocommons.org.
 99 | 
100 | We only ask for personal information when we truly need it to provide a service to you. We collect it by fair and
101 | lawful means, with your knowledge and consent. See `The information we collect <#id3>`_ section
102 | below for a listing of the information we collect and how we use it.
103 | 
104 | We only retain collected information for as long as necessary to provide you with your requested service. What data
105 | we store, we’ll protect within commercially acceptable means to prevent loss and theft, as well as unauthorised
106 | access, disclosure, copying, use or modification.
107 | 
108 | We don’t share any personally identifying information publicly or with third-parties, except when required to by law.
109 | 
110 | Our website may link to external sites that are not operated by us. Please be aware that we have no control over
111 | the content and practices of these sites, and cannot accept responsibility or liability for their respective
112 | privacy policies.
113 | 
114 | You are free to refuse our request for your personal information, with the understanding that we may be unable
115 | to provide you with some of your desired services.
116 | 
117 | Your continued use of our website will be regarded as acceptance of our practices around privacy and personal
118 | information. If you have any questions about how we handle user data and personal information, feel free to contact us.
119 | 
120 | This policy is effective as of 1 January 2019.
121 | 
122 | 
123 | The information we collect
124 | **************************
125 | 
126 | 
127 | When using the Audio Commons Mediator/API, the following personal information is collected:
128 | 
129 | * User account credentials for being able to login to the service and provide personalized service as well as enabling
130 |   ourselves to track and log service usage.
131 | 
132 | * OAuth2 tokes for accessing third party service on behalf of Audio Commons users when these have been provied by the
133 |   user through the `Link service accounts <https://m.audiocommons.org/link_services/>`_ feature of our portal.
134 | 
135 | 
136 | 
137 | **NOTE:** These terms of service and privacy policy have been automatically generated with https://getterms.io and
138 | further adapted for its applicability to Audio Commons Mediator and API.


--------------------------------------------------------------------------------
/docs/index.rst:
--------------------------------------------------------------------------------
 1 | Services and API documentation
 2 | ==============================
 3 | 
 4 | Welcome to the Audio Commons Services and API documentation!
 5 | 
 6 | Here you will find guidelines on how to access Audio Commons content and services within your application
 7 | and on how to make your services available in the **Audio Commons Ecosystem**.
 8 | 
 9 | 
10 | I'm a service provider
11 | ----------------------
12 | 
13 | If you are a service provider and want to make your services available in the Audio Commons Ecosystem
14 | please check the **Audio Commons Services** documentation.
15 | 
16 | .. toctree::
17 |    :maxdepth: 2
18 | 
19 |    services
20 | 
21 | 
22 | 
23 | I'm an app developer
24 | --------------------
25 | 
26 | If you are developing an application, tool or any program that wants to consume Audio Commons content
27 | and/or access its services please check the **Audio Commons API** documentation.
28 | 
29 | .. toctree::
30 |    :maxdepth: 2
31 | 
32 |    api
33 | 


--------------------------------------------------------------------------------
/docs/services.rst:
--------------------------------------------------------------------------------
 1 | Audio Commons Services documentation
 2 | ====================================
 3 | 
 4 | Here you'll find documentation and guidelines for making your existing online audio services available in the
 5 | **Audio Commons Ecosystem** (ACE).
 6 | 
 7 | .. figure:: _static/ac_services_diagram.svg
 8 |     :figwidth: 270px
 9 |     :align: right
10 | 
11 | In the ACE, *all* accesses to your service (and to any other third party service) will be done thorough the
12 | **Audio Commons Mediator**. The applications that use Audio Commons services will interact with the mediator using
13 | the **Audio Commons API**, and the mediator will then interact with the services and deliver results back to the
14 | application (see diagram on the right).
15 | 
16 | To be able to do that, the Audio Commons Mediator needs to know some details about third party services so that
17 | incoming requests can be **interpreted and properly distributed** across the range of available services.
18 | 
19 | For some specific functionalities like audio **download** and **upload**, applications will directly connect with
20 | services without passing through the mediator (see dotted arrow in the diagram on the right), but the mediator will
21 | still provide instruction on how to access the services.
22 | 
23 | In order to make service available in the ACE you'll have to implement the Audio Commons Mediator component that will
24 | deal with the **translation of requests and interpretation responses** of your specific service API to make it
25 | compatible with the Audio Commons API. In order for this component to be plugged into the Audio Commons Mediator,
26 | it must be implemented in Python using the ``acservice`` package that we provide.
27 | 
28 | 
29 | 
30 | Using the ``acservice`` package
31 | -------------------------------
32 | 
33 | Checkout the `Guidelines for implementing a new service component <https://www.audiocommons.org/assets/files/AC-WP2-UPF-D2.6%20Service%20Integration%20Draft%20Guidelines.pdf>`_
34 | which describe how to implement a service using the ``acservice`` package. What's provided next is the source code
35 | documentation of ``acservice`` package.
36 | 
37 | 
38 | .. toctree::
39 |    :maxdepth: 2
40 | 
41 |    acservice
42 | 
43 | 
44 | .. tip:: For a quick overview of how it works, check out the `example implementation for the Freesound <https://github.com/AudioCommons/ac-mediator/blob/master/services/3rd_party/freesound.py>`_ service.


--------------------------------------------------------------------------------
/manage.py:
--------------------------------------------------------------------------------
 1 | #!/usr/bin/env python
 2 | import os
 3 | import sys
 4 | 
 5 | if __name__ == "__main__":
 6 |     os.environ.setdefault("DJANGO_SETTINGS_MODULE", "ac_mediator.settings")
 7 |     try:
 8 |         from django.core.management import execute_from_command_line
 9 |     except ImportError:
10 |         # The above import may fail for some other reason. Ensure that the
11 |         # issue is really that Django is missing to avoid masking other
12 |         # exceptions on Python 2.
13 |         try:
14 |             import django
15 |         except ImportError:
16 |             raise ImportError(
17 |                 "Couldn't import Django. Are you sure it's installed and "
18 |                 "available on your PYTHONPATH environment variable? Did you "
19 |                 "forget to activate a virtual environment?"
20 |             )
21 |         raise
22 |     execute_from_command_line(sys.argv)
23 | 


--------------------------------------------------------------------------------
/pip.conf.example:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AudioCommons/ac-mediator/3201c12865d986fd945a1108b00ad9e85d459827/pip.conf.example


--------------------------------------------------------------------------------
/requirements.txt:
--------------------------------------------------------------------------------
 1 | Django==1.11.28
 2 | docutils==0.12
 3 | djangorestframework==3.5.1
 4 | django-oauth-toolkit==0.10.0
 5 | django-extensions==1.7.4
 6 | django-docs==0.2.1
 7 | dj-database-url==0.4.1
 8 | psycopg2-binary==2.8.4
 9 | requests==2.21.0
10 | Sphinx==1.4
11 | Pygments==2.1.3
12 | sphinxcontrib-httpdomain==1.4.0
13 | redis==2.10.5
14 | kombu==4.0.2  # Needed to avoid problems with celery
15 | celery==4.0.2
16 | uwsgi==2.0.17.1
17 | raven==5.32.0
18 | graypy==0.2.14
19 | pyparsing==2.2.0
20 | 


--------------------------------------------------------------------------------
/services/3rd_party/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AudioCommons/ac-mediator/3201c12865d986fd945a1108b00ad9e85d459827/services/3rd_party/__init__.py


--------------------------------------------------------------------------------
/services/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AudioCommons/ac-mediator/3201c12865d986fd945a1108b00ad9e85d459827/services/__init__.py


--------------------------------------------------------------------------------
/services/acservice/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AudioCommons/ac-mediator/3201c12865d986fd945a1108b00ad9e85d459827/services/acservice/__init__.py


--------------------------------------------------------------------------------
/services/acservice/constants.py:
--------------------------------------------------------------------------------
  1 | from api.constants import *
  2 | 
  3 | # String used to be the base of ACIDs
  4 | # Param substitution will be used to provide a service-specific prefix to the id
  5 | ACID_SEPARATOR_CHAR = ':'
  6 | 
  7 | # Some of these concept definitions should be linked with the ontology (or be loaded from it)
  8 | AUDIOCOMMONS_ONTOLOGY_PREFIX = 'ac:'
  9 | 
 10 | # Component names
 11 | SEARCH_TEXT_COMPONENT = 'text_search'
 12 | LICENSING_COMPONENT = 'licensing'
 13 | DOWNLOAD_COMPONENT = 'download'
 14 | 
 15 | # Service description keywords
 16 | ACID_DOMAINS_DESCRIPTION_KEYWORD = 'acid_domains'
 17 | SUPPORTED_FIELDS_DESCRIPTION_KEYWORD = 'supported_fields'
 18 | SUPPORTED_FILTERS_DESCRIPTION_KEYWORD = 'supported_filters'
 19 | SUPPORTED_SORT_OPTIONS_DESCRIPTION_KEYWORD = 'supported_sort_options'
 20 | 
 21 | # Authentication
 22 | APIKEY_AUTH_METHOD = 'apikey_auth'
 23 | ENDUSER_AUTH_METHOD = 'enduser_auth'
 24 | 
 25 | # Resource fields (just using fake names here)
 26 | FIELD_ID = AUDIOCOMMONS_ONTOLOGY_PREFIX + 'id'
 27 | FIELD_URL = AUDIOCOMMONS_ONTOLOGY_PREFIX + 'url'
 28 | FIELD_NAME = AUDIOCOMMONS_ONTOLOGY_PREFIX + 'name'
 29 | FIELD_AUTHOR_NAME = AUDIOCOMMONS_ONTOLOGY_PREFIX + 'author'
 30 | FIELD_AUTHOR_URL = AUDIOCOMMONS_ONTOLOGY_PREFIX + 'author_url'
 31 | FIELD_COLLECTION_NAME = AUDIOCOMMONS_ONTOLOGY_PREFIX + 'collection'
 32 | FIELD_COLLECTION_URL = AUDIOCOMMONS_ONTOLOGY_PREFIX + 'collection_url'
 33 | FIELD_TAGS = AUDIOCOMMONS_ONTOLOGY_PREFIX + 'tags'
 34 | FIELD_TAG = AUDIOCOMMONS_ONTOLOGY_PREFIX + 'tag'  # Used for filtering a single tag, singular form reads better
 35 | FIELD_DESCRIPTION = AUDIOCOMMONS_ONTOLOGY_PREFIX + 'description'
 36 | FIELD_TIMESTAMP = AUDIOCOMMONS_ONTOLOGY_PREFIX + 'timestamp'  # Use AUDIOCOMMONS_STRING_TIME_FORMAT (see below)
 37 | FIELD_LICENSE = AUDIOCOMMONS_ONTOLOGY_PREFIX + 'license'  # See Licenses section below, should be one of these
 38 | FIELD_LICENSE_DEED_URL = AUDIOCOMMONS_ONTOLOGY_PREFIX + 'license_deed_url'
 39 | 
 40 | FIELD_IMAGE = AUDIOCOMMONS_ONTOLOGY_PREFIX + 'image'
 41 | FIELD_WAVEFORM_PEAKS = AUDIOCOMMONS_ONTOLOGY_PREFIX + 'waveform_peaks'
 42 | 
 43 | FIELD_DURATION = AUDIOCOMMONS_ONTOLOGY_PREFIX + 'duration'  # In seconds
 44 | FIELD_FORMAT = AUDIOCOMMONS_ONTOLOGY_PREFIX + 'format' # TODO: should he define a list of formats?
 45 | FIELD_FILESIZE = AUDIOCOMMONS_ONTOLOGY_PREFIX + 'filesize'  # In bytes
 46 | FIELD_CHANNELS = AUDIOCOMMONS_ONTOLOGY_PREFIX + 'channels'  # Integer
 47 | FIELD_BITRATE = AUDIOCOMMONS_ONTOLOGY_PREFIX + 'bitrate'  # Integer
 48 | FIELD_BITDEPTH = AUDIOCOMMONS_ONTOLOGY_PREFIX + 'bitdepth'  # Integer
 49 | FIELD_SAMPLERATE = AUDIOCOMMONS_ONTOLOGY_PREFIX + 'samplerate'  # Integer
 50 | 
 51 | FIELD_PREVIEW = AUDIOCOMMONS_ONTOLOGY_PREFIX + 'preview_url'
 52 | 
 53 | FIELD_BRIGHTNESS = AUDIOCOMMONS_ONTOLOGY_PREFIX + 'brightness'
 54 | FIELD_ROUGHNESS = AUDIOCOMMONS_ONTOLOGY_PREFIX + 'roughness'
 55 | FIELD_HARDNESS = AUDIOCOMMONS_ONTOLOGY_PREFIX + 'hardness'
 56 | FIELD_DEPTH = AUDIOCOMMONS_ONTOLOGY_PREFIX + 'depth'
 57 | FIELD_SHARPNESS = AUDIOCOMMONS_ONTOLOGY_PREFIX + 'sharpness'
 58 | FIELD_WARMTH = AUDIOCOMMONS_ONTOLOGY_PREFIX + 'warmth'
 59 | FIELD_BOOMING = AUDIOCOMMONS_ONTOLOGY_PREFIX + 'booming'
 60 | 
 61 | FIELD_TEMPO = AUDIOCOMMONS_ONTOLOGY_PREFIX + 'tempo'
 62 | FIELD_TEMPO_CONFIDENCE = AUDIOCOMMONS_ONTOLOGY_PREFIX + 'tempo_confidence'
 63 | FIELD_NOTE = AUDIOCOMMONS_ONTOLOGY_PREFIX + 'note'
 64 | FIELD_NOTE_MIDI = AUDIOCOMMONS_ONTOLOGY_PREFIX + 'note_midi'
 65 | FIELD_NOTE_CONFIDENCE = AUDIOCOMMONS_ONTOLOGY_PREFIX + 'note_confidence'
 66 | FIELD_TONALITY = AUDIOCOMMONS_ONTOLOGY_PREFIX + 'tonality'
 67 | FIELD_TONALITY_CONFIDENCE = AUDIOCOMMONS_ONTOLOGY_PREFIX + 'tonality_confidence'
 68 | 
 69 | FIELD_LOUDNESS = AUDIOCOMMONS_ONTOLOGY_PREFIX + 'loudness'
 70 | FIELD_SINGLE_EVENT = AUDIOCOMMONS_ONTOLOGY_PREFIX + 'single_event'
 71 | FIELD_LOOP = AUDIOCOMMONS_ONTOLOGY_PREFIX + 'loop'
 72 | 
 73 | 
 74 | MINIMUM_RESOURCE_DESCRIPTION_FIELDS = [
 75 |     FIELD_ID,
 76 |     FIELD_URL,
 77 |     FIELD_NAME,
 78 |     FIELD_AUTHOR_NAME,
 79 |     FIELD_LICENSE,
 80 |     FIELD_PREVIEW,
 81 | ]
 82 | ALL_RESOURCE_DESCRIPTION_FIELDS = [globals()[item] for item in dir() if item.startswith('FIELD_')]
 83 | 
 84 | # Time format
 85 | AUDIOCOMMONS_STRING_TIME_FORMAT = '%Y-%m-%d %H:%M:%S'  # E.g. "2017-09-27 10:01:22"
 86 | 
 87 | # Search results parameters
 88 | NEXT_PAGE_PROP = 'next'
 89 | PREV_PAGE_PROP = 'prev'
 90 | NUM_RESULTS_PROP = 'num_results'
 91 | RESULTS_LIST = 'results'
 92 | 
 93 | # Sort options
 94 | SORT_OPTION_RELEVANCE = 'relevance'
 95 | SORT_OPTION_POPULARITY = 'popularity'
 96 | SORT_OPTION_DURATION = 'duration'
 97 | SORT_OPTION_DOWNLOADS = 'downloads'
 98 | SORT_OPTION_CREATED = 'created'
 99 | 
100 | SORT_OPTIONS = [
101 |     SORT_OPTION_RELEVANCE,
102 |     SORT_OPTION_POPULARITY,
103 |     SORT_OPTION_DURATION,
104 |     SORT_OPTION_DOWNLOADS,
105 |     SORT_OPTION_CREATED,
106 | ]
107 | 
108 | # Licenses
109 | LICENSE_UNKNOWN = 'Unknown'
110 | LICENSE_CC0 = 'CC0'
111 | LICENSE_CC_BY = 'BY'
112 | LICENSE_CC_BY_SA = 'BY-SA'
113 | LICENSE_CC_BY_NC = 'BY-NC'
114 | LICENSE_CC_BY_ND = 'BY-ND'
115 | LICENSE_CC_BY_NC_SA = 'BY-NC-SA'
116 | LICENSE_CC_BY_NC_ND = 'BY-NC-ND'
117 | LICENSE_CC_SAMPLING_PLUS = 'SamplingPlus'
118 | 


--------------------------------------------------------------------------------
/services/acservice/download.py:
--------------------------------------------------------------------------------
 1 | from services.acservice.constants import *
 2 | 
 3 | 
 4 | class ACDownloadMixin(object):
 5 |     """
 6 |     Mixin that defines methods to allow downloading (retrieval) of Audio Commons content.
 7 |     To download content, the Audio Commons API must be able to provide the client with a url
 8 |     where content can be downloaded without the need of any authentication. In this way the
 9 |     client can download from the service without transferring data through the mediator and
10 |     without knowing anything about the third party service.
11 |     Services are expected to override methods to adapt them to their own APIs.
12 |     """
13 |     DOWNLOAD_ACID_DOMAINS = list()
14 | 
15 |     def conf_download(self, conf):
16 |         self.implemented_components.append(DOWNLOAD_COMPONENT)
17 | 
18 |     def describe_download(self):
19 |         """
20 |         Returns structured representation of component capabilities
21 |         Component capabilities include a list of `acid_domains` which indicate for which
22 |         domain of resources the service provides licensing for (i.e., 'Jamendo' domain means all
23 |         resources identified by Jamendo:xxx)
24 |         :return: tuple with (component name, dictionary with component capabilities)
25 |         """
26 |         return DOWNLOAD_COMPONENT, {
27 |             ACID_DOMAINS_DESCRIPTION_KEYWORD: self.DOWNLOAD_ACID_DOMAINS,
28 |         }
29 | 
30 |     def get_download_url(self, context, acid, *args, **kwargs):
31 |         """
32 |         Given an Audio Commons unique resource identifier (acid), this function returns a url
33 |         where the resource can be downloaded by the client without the need of extra authentication.
34 |         If the 3rd party service can't provide a link to download that resource or some other errors
35 |         occur during the collection of the url, an AC exceptions should be raised.
36 |         Individual services can extend this method with extra parameters to make it more suitable to their
37 |         needs (e.g., to call the method given an already retrieved resource and avoid in this way an
38 |         extra request).
39 |         :param context: Dict with context information for the request (see api.views.get_request_context)
40 |         :param acid: Audio Commons unique resource identifier
41 |         :return: url to download the input resource (string)
42 |         """
43 |         raise NotImplementedError("Service must implement method ACLicensingMixin.get_download_url")
44 | 
45 |     def download(self, context, acid, *args, **kwargs):
46 |         """
47 |         This endpoint returns a download url and raises warnings that might contain relevant
48 |         information for the application. To get the URL, it uses 'get_download_url' method, therefore
49 |         'get_download_url' is the main method that should be overwritten by third party services.
50 |         Raise warnings using the BaseACService.add_response_warning method.
51 |         :param context: Dict with context information for the request (see api.views.get_request_context)
52 |         :param acid: Audio Commons unique resource identifier
53 |         :return: url where to download the resource
54 |         """
55 |         return {'download_url': self.get_download_url(context, acid, *args, **kwargs)}
56 | 


--------------------------------------------------------------------------------
/services/acservice/licensing.py:
--------------------------------------------------------------------------------
 1 | from services.acservice.constants import *
 2 | 
 3 | 
 4 | class ACLicensingMixin(object):
 5 |     """
 6 |     Mixin that defines methods to allow licensing of Audio Commons content.
 7 |     Services are expected to override methods to adapt them to their own APIs.
 8 |     """
 9 |     LICENSING_ACID_DOMAINS = list()
10 | 
11 |     def conf_licensing(self, conf):
12 |         self.implemented_components.append(LICENSING_COMPONENT)
13 | 
14 |     def describe_licensing(self):
15 |         """
16 |         Returns structured representation of component capabilities
17 |         Component capabilities include a list of `acid_domains` which indicate for which
18 |         domain of resources the service provides licensing for (i.e., 'Jamendo' domain means all
19 |         resources identified by Jamendo:xxx)
20 |         :return: tuple with (component name, dictionary with component capabilities)
21 |         """
22 |         return LICENSING_COMPONENT, {
23 |             ACID_DOMAINS_DESCRIPTION_KEYWORD: self.LICENSING_ACID_DOMAINS,
24 |         }
25 | 
26 |     def get_licensing_url(self, context, acid, *args, **kwargs):
27 |         """
28 |         Given an Audio Commons unique resource identifier (acid), this function returns a url
29 |         where the resource can be licensed. If the 3rd party service can't license that resource or
30 |         some other errors occur during the collection of the url, an AC exceptions should be raised.
31 |         Individual services can extend this method with extra parameters to make it more suitable to their
32 |         needs (e.g., to call the method given an already retrieved resource and avoid in this way an
33 |         extra request).
34 |         :param context: Dict with context information for the request (see api.views.get_request_context)
35 |         :param acid: Audio Commons unique resource identifier
36 |         :return: url to license the input resource (string)
37 |         """
38 |         raise NotImplementedError("Service must implement method ACLicensingMixin.get_licensing_url")
39 | 
40 |     def license(self, context, acid, *args, **kwargs):
41 |         """
42 |         This endpoint returns a license url along with a list of warnings that might contain relevant
43 |         information for the application. To get the URL, it uses 'get_licensing_url' method, therefore
44 |         'get_licensing_url' is the main method that should be overwritten by third party services.
45 |         Raise warnings using the BaseACService.add_response_warning method.
46 |         :param context: Dict with context information for the request (see api.views.get_request_context)
47 |         :param acid: Audio Commons unique resource identifier
48 |         :return: url where to get a license
49 |         """
50 |         return {'license_url': self.get_licensing_url(context, acid, *args, **kwargs)}
51 | 


--------------------------------------------------------------------------------
/services/acservice/utils.py:
--------------------------------------------------------------------------------
 1 | from services.acservice.constants import LICENSE_UNKNOWN, LICENSE_CC0, LICENSE_CC_BY, LICENSE_CC_BY_NC, \
 2 |     LICENSE_CC_BY_NC_ND, LICENSE_CC_BY_NC_SA, LICENSE_CC_BY_ND, LICENSE_CC_BY_SA, LICENSE_CC_SAMPLING_PLUS
 3 | from pyparsing import CaselessLiteral, Word, alphanums, alphas8bit, nums, quotedString, \
 4 |     operatorPrecedence, opAssoc, removeQuotes, Literal, Group, Suppress, Combine
 5 | 
 6 | 
 7 | def translate_cc_license_url(url):
 8 |     """
 9 |     Return CC license name from license URL
10 |     """
11 |     # TODO: this does not include license versioning (3.0, 4.0...)
12 |     if '/by/' in url: return LICENSE_CC_BY
13 |     if '/by-nc/' in url: return LICENSE_CC_BY_NC
14 |     if '/by-nd/' in url: return LICENSE_CC_BY_ND
15 |     if '/by-sa/' in url: return LICENSE_CC_BY_SA
16 |     if '/by-nc-sa/' in url: return LICENSE_CC_BY_NC_SA
17 |     if '/by-nc-nd/' in url: return LICENSE_CC_BY_NC_ND
18 |     if '/zero/' in url: return LICENSE_CC0
19 |     if '/publicdomain/' in url: return LICENSE_CC0
20 |     if '/sampling+/' in url: return LICENSE_CC_SAMPLING_PLUS
21 |     return LICENSE_UNKNOWN
22 | 
23 | 
24 | # Util functions for parsing filters, define grammar and parsing functions
25 | # Parsing is done using Pyparsing library. Relevant documentation for Pyparsing can be found here:
26 | # http://shop.oreilly.com/product/9780596514235.do
27 | 
28 | def as_number_if_number(x):
29 |     try:
30 |         x = float(x[0])  # Cast to float
31 |         if x.is_integer():
32 |             x = int(x)  # If is whole number, cast to integer
33 |     except ValueError as e:
34 |         pass
35 |     return x  # If casting fails, return as is
36 | 
37 | 
38 | alphanums_plus = alphanums + '_'  # Allow underscore character in filter name
39 | float_nums = nums + '.'  # Allow float numbers
40 | and_ = CaselessLiteral("and")
41 | or_ = CaselessLiteral("or")
42 | not_ = CaselessLiteral("not")
43 | filterValueText = (Word(alphanums_plus + alphas8bit + float_nums + '-') | quotedString.setParseAction(removeQuotes))\
44 |     .setParseAction(as_number_if_number)
45 | number_or_asterisk_or_quotedString = (Literal('*') | Word(float_nums) | quotedString.setParseAction(removeQuotes)).setParseAction(as_number_if_number)
46 | filterValueRange = Group(Suppress(Literal('[')).suppress() + number_or_asterisk_or_quotedString + Suppress(Literal(',')).suppress() +
47 |                          number_or_asterisk_or_quotedString + Suppress(Literal(']')).suppress())
48 | fieldName = Combine(Word(alphanums) + Literal(':') + Word(alphanums_plus))  # ontologyPrefix:givenFieldName
49 | filterTerm = Group(fieldName + Literal(':') + (filterValueText | filterValueRange))  # ontologyPrefix:givenFieldName:filterValue
50 | filterExpr = operatorPrecedence(filterTerm,
51 |                                 [
52 |                                     (not_, 1, opAssoc.RIGHT),
53 |                                     (and_, 2, opAssoc.LEFT),
54 |                                     (or_, 2, opAssoc.LEFT),
55 |                                 ])
56 | 
57 | 
58 | def parse_filter(filter_string):
59 |     """
60 |     Parse a filter string using the 'filterExpr' grammar defined above.
61 |     This function returns a pyparsing.ParseResults object that should be further
62 |     processed with the build_filter_string method of a ACServiceTextSearchMixin instance.
63 |     """
64 |     return filterExpr.parseString(filter_string, parseAll=True)
65 | 


--------------------------------------------------------------------------------
/services/apps.py:
--------------------------------------------------------------------------------
1 | from django.apps import AppConfig
2 | 
3 | 
4 | class ServicesConfig(AppConfig):
5 |     name = 'services'
6 | 


--------------------------------------------------------------------------------
/services/management/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AudioCommons/ac-mediator/3201c12865d986fd945a1108b00ad9e85d459827/services/management/__init__.py


--------------------------------------------------------------------------------
/services/management/commands/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AudioCommons/ac-mediator/3201c12865d986fd945a1108b00ad9e85d459827/services/management/commands/__init__.py


--------------------------------------------------------------------------------
/services/mgmt.py:
--------------------------------------------------------------------------------
  1 | import inspect
  2 | import pkgutil
  3 | import configparser
  4 | import os
  5 | from django.conf import settings
  6 | from services.acservice.base import BaseACService
  7 | from ac_mediator.exceptions import ImproperlyConfiguredACService, ACException, ACServiceDoesNotExist
  8 | 
  9 | SERVICES_CONFIGURATION_FILE = os.path.join(settings.BASE_DIR, 'services/services_conf.cfg')
 10 | SERVICES_SCAN_FOLDER = os.path.join(settings.BASE_DIR, 'services/3rd_party/')
 11 | 
 12 | 
 13 | def _load_services():
 14 |     """
 15 |     We walk through the modules in services ac-mediator package and instantiate objects
 16 |     for those classes which are subclass of BaseACService.
 17 |     :return: list of BaseACService instances
 18 |     """
 19 |     loaded_services = []
 20 |     for importer, modname, ispkg in pkgutil.walk_packages([SERVICES_SCAN_FOLDER], 'services.3rd_party.'):
 21 |         if not ispkg:
 22 |             module = __import__(modname, fromlist="dummy")
 23 |             for name, ftype in inspect.getmembers(module, inspect.isclass):
 24 |                 if issubclass(ftype, BaseACService) and name != 'BaseACService':
 25 |                     loaded_services.append(ftype())
 26 |     return loaded_services
 27 | 
 28 | 
 29 | def _configure_services(loaded_services):
 30 |     """
 31 |     Configure loaded services and return a list of those that were successfully configured.
 32 |     :param loaded_services: list of BaseACService instances
 33 |     :return: list of successfully configures BaseACService instances
 34 |     """
 35 |     config = configparser.ConfigParser()
 36 |     if not os.path.exists(SERVICES_CONFIGURATION_FILE):
 37 |         print('No services configuration file has been found, no services will be loaded...')
 38 |         return []
 39 |     config.read(SERVICES_CONFIGURATION_FILE)
 40 |     configured_services = []
 41 |     for service in loaded_services:
 42 |         try:
 43 |             try:
 44 |                 configuration = config[service.name]
 45 |                 enabled = configuration['enabled']
 46 |                 if enabled == 'no':
 47 |                     continue
 48 |             except KeyError:
 49 |                 raise ImproperlyConfiguredACService('No configuration section found')
 50 |             service.configure(configuration)
 51 |             if service.id in [srv.id for srv in configured_services]:
 52 |                 raise ACException('Each service should have a unique id')
 53 |             configured_services.append(service)
 54 |         except ImproperlyConfiguredACService as e:
 55 |             print('Service {0} could not be configured: {1}'.format(service.name, e))
 56 |             continue
 57 |     print('Loaded {0} services: {1}'.format(len(configured_services), [service.name for service in configured_services]))
 58 |     return configured_services
 59 | 
 60 | 
 61 | def _load_and_configure_services():
 62 |     loaded_services = _load_services()
 63 |     return _configure_services(loaded_services)
 64 | 
 65 | 
 66 | available_services = _load_and_configure_services()
 67 | 
 68 | 
 69 | def get_available_services(component=None, exclude=None, include=None):
 70 |     """
 71 |     Get all available services which implement a particular component (or all services if
 72 |     'component' is None). Allows excluding particular services and restricting those from which to filter.
 73 |     :param component: component (mixin) that should be implemented by returned services
 74 |     :param exclude: exclude services passed through this parameter (should be a list of service names)
 75 |     :param include: consider only services passed through this parameter (should be a list of service names)
 76 |     :return: list of matching services (can be empty)
 77 |     """
 78 |     out_services = list()
 79 |     for service in available_services:
 80 |         if component is not None:
 81 |             if component not in service.implemented_components:
 82 |                 continue
 83 |         if exclude is not None:
 84 |             if service.name in exclude:
 85 |                 continue
 86 |         if include is not None:
 87 |             if service.name not in include:
 88 |                 continue
 89 |         out_services.append(service)
 90 |     return out_services
 91 | 
 92 | 
 93 | def get_service_by_id(service_id):
 94 |     for service in available_services:
 95 |         if service.id == service_id:
 96 |             return service
 97 |     raise ACServiceDoesNotExist('Service with id {0} does not exist'.format(service_id))
 98 | 
 99 | 
100 | def get_service_by_name(service_name):
101 |     for service in available_services:
102 |         if service.name == service_name:
103 |             return service
104 |     raise ACServiceDoesNotExist('Service with name {0} does not exist'.format(service_name))
105 | 


--------------------------------------------------------------------------------
/services/models.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AudioCommons/ac-mediator/3201c12865d986fd945a1108b00ad9e85d459827/services/models.py


--------------------------------------------------------------------------------
/services/services_conf.example.cfg:
--------------------------------------------------------------------------------
 1 | [Freesound]
 2 | enabled=yes
 3 | service_id=AUDIO_COMMONS_SERVICE_ID # 8-chars alphanumeric unique id given to identify the service in the Audio Commons Ecosystem (e.g. krl5r874)
 4 | client_id=FREESOUND_CLIENT_ID
 5 | client_secret=FREESOUND_CLIENT_SECRET
 6 | 
 7 | [Jamendo]
 8 | enabled=yes
 9 | service_id=AUDIO_COMMONS_SERVICE_ID
10 | client_id=JAMENDO_CLIENT_ID
11 | client_secret=JAMENDO_CLIENT_SECRET
12 | 
13 | [Europeana]
14 | enabled=yes
15 | service_id=AUDIO_COMMONS_SERVICE_ID
16 | api_key=EUROPEANA_API_KEY
17 | 


--------------------------------------------------------------------------------
/services/test_services.cfg:
--------------------------------------------------------------------------------
 1 | [Freesound]
 2 | text_search_query=dogs
 3 | ac_resource_id_for_download=Freesound:1234
 4 | 
 5 | [Jamendo]
 6 | text_search_query=electronica
 7 | ac_resource_id_for_licensing=Jamendo:1162014
 8 | ac_resource_id_for_download=Jamendo:1162014
 9 | 
10 | [Europeana]
11 | text_search_query=factory
12 | 


--------------------------------------------------------------------------------
/services/tests.py:
--------------------------------------------------------------------------------
 1 | from django.test import TestCase
 2 | from services.mgmt import get_available_services, available_services
 3 | 
 4 | 
 5 | class ServicesManagement(TestCase):
 6 | 
 7 |     def test_get_available_services(self):
 8 | 
 9 |         # Check that all services are returned by get_available_services() when no further parameters are given
10 |         for service in available_services:
11 |             self.assertIn(service, get_available_services())
12 | 
13 |         # Check that using an include filter only returns included service
14 |         self.assertIn(available_services[0].name, get_available_services(include=[available_services[0].name])[0].name)
15 |         self.assertEquals(len(get_available_services(include=[available_services[0].name])), 1)
16 | 
17 |         # Check that using an empty list include filter returns no services
18 |         self.assertEquals(len(get_available_services(include=[])), 0)
19 | 
20 |         # Check that using an empty list for exclude has no effect
21 |         self.assertEquals(len(get_available_services(exclude=[])), len(get_available_services()))
22 | 
23 |         # Check that excluding a services removes it from the list
24 |         self.assertNotIn(available_services[0], get_available_services(exclude=[available_services[0].name]))
25 | 
26 |         # Check filtering by component
27 |         self.assertEquals(len(get_available_services(component="nonExistingComponent")), 0)
28 |         components = list()
29 |         for service in available_services:
30 |             components += service.implemented_components
31 |         component = components[0]
32 |         count = components.count(component)
33 |         self.assertEquals(len(get_available_services(component=component)), count)
34 | 


--------------------------------------------------------------------------------
/static/css/admin_extra.css:
--------------------------------------------------------------------------------
 1 | body {
 2 |     font-weight: 300;
 3 | }
 4 | 
 5 | #header {
 6 |     background: #1E5055;
 7 | }
 8 | 
 9 | .button.default, input[type=submit].default, .submit-row input.default {
10 |     background: #1E5055;
11 | }
12 | 
13 | .object-tools a:focus, .object-tools a:hover {
14 |     background-color: #1E5055;
15 | }
16 | 
17 | div.breadcrumbs {
18 |     background: #2e7d84;
19 | }
20 | 
21 | #user-tools a:focus, #user-tools a:hover {
22 |     border-bottom-color: #0F783C;
23 |     color: #0F783C;
24 | }
25 | 
26 | .button, input[type=submit], input[type=button], .submit-row input, a.button {
27 |     background: #0F783C;
28 | }
29 | 
30 | .module h2, .module caption, .inline-group h2 {
31 |     background: white;
32 |     font-size: 1.4em;
33 |     font-family: "Rajdhani", sans-serif;
34 | }
35 | 
36 | a:link, a:visited {
37 |     color: #0F783C;
38 | }
39 | 
40 | a:focus, a:hover {
41 |     color: #1E5055;
42 | }
43 | 
44 | a.section:link, a.section:visited {
45 |     color: #991933;
46 | }
47 | 
48 | th {
49 |     font-weight: 400;
50 | }
51 | 
52 | #branding h1 {
53 |     text-transform: uppercase;
54 |     font-family: "Rajdhani", sans-serif;
55 |     font-weight: 700;
56 |     color: #1E5055;
57 | }
58 | 
59 | #branding h1, #branding h1 a:link, #branding h1 a:visited {
60 |     color: white;
61 | }
62 | 
63 | h1 {
64 |     font-family: "Rajdhani", sans-serif;
65 |     color: gray;
66 |     font-size: 2em;
67 |     font-weight: 100;
68 | }
69 | 
70 | h2 {
71 |     text-transform: uppercase;
72 |     color: #991933;
73 |     font-size: 1.4em;
74 |     font-family: "Rajdhani", sans-serif;
75 |     font-weight: 400;
76 | }
77 | 


--------------------------------------------------------------------------------
/static/css/main.css:
--------------------------------------------------------------------------------
  1 | /* General */
  2 | 
  3 | body {
  4 |     font-weight: 300;
  5 |     font-family: "Roboto", sans-serif;
  6 |     font-size: 16px;
  7 |     color: #333;
  8 |     padding-top: 20px;
  9 |     padding-bottom: 20px;
 10 |     background-color: #f5f5f5;
 11 | }
 12 | 
 13 | .logo-breadcrumb {
 14 |     width: 32px;
 15 |     height: 32px;
 16 |     vertical-align: top;
 17 |     margin-top: 5px;
 18 | }
 19 | 
 20 | .breadcrumb-separator {
 21 |     color: lightgray;
 22 | }
 23 | 
 24 | .logo-background {
 25 |     z-index: -10;
 26 |     position: absolute;
 27 |     right: -30px;
 28 |     top: -60px;
 29 |     width: 500px;
 30 |     opacity: 0.15;
 31 | }
 32 | 
 33 | .block-center {
 34 |     max-width: 800px;
 35 |     padding: 19px 29px 29px;
 36 |     margin: 0 auto 20px;
 37 |     background-color: #fff;
 38 |     border: 1px solid #e5e5e5;
 39 |     -webkit-border-radius: 5px;
 40 |     -moz-border-radius: 5px;
 41 |     border-radius: 5px;
 42 |     -webkit-box-shadow: 0 1px 2px rgba(0,0,0,.05);
 43 |     -moz-box-shadow: 0 1px 2px rgba(0,0,0,.05);
 44 |     box-shadow: 0 1px 2px rgba(0,0,0,.05);
 45 | }
 46 | 
 47 | .footer {
 48 |     margin-top: 50px;
 49 |     border-top: 1px solid #e5e5e5;
 50 |     padding: 29px;
 51 |     text-align: center;
 52 | }
 53 | 
 54 | 
 55 | b { font-weight: 500; }
 56 | 
 57 | p { font-size: 16px; }
 58 | 
 59 | li { font-size: 16px; }
 60 | 
 61 | a, a:hover, a:focus, a:active, a.active { outline: 0; color: #0F783C; }
 62 | 
 63 | h1 {
 64 |     text-transform: uppercase;
 65 |     font-family: "Rajdhani", sans-serif;
 66 |     font-weight: 700;
 67 |     color: #1E5055;
 68 |     font-size: 2.8em;
 69 |     padding-bottom: 15px;
 70 | }
 71 | 
 72 | h2 {
 73 |     text-transform: uppercase;
 74 |     font-family: "Rajdhani", sans-serif;
 75 |     color: #991933;
 76 |     font-size: 2em;
 77 |     padding-bottom: 15px;
 78 | }
 79 | 
 80 | h3 {
 81 |     font-family: "Rajdhani", sans-serif;
 82 |     color: gray;
 83 |     font-size: 1.5em;
 84 |     font-weight: 100;
 85 | }
 86 | 
 87 | ul.table {
 88 |     list-style-type: none;
 89 |     margin: 0;
 90 |     padding: 0;
 91 | }
 92 | 
 93 | ul.table li {
 94 |     background-color: #fcfcfc;
 95 |     line-height: 50px;
 96 |     border-bottom: 1px solid #f5f5f5;
 97 |     padding-left: 10px;
 98 |     padding-right: 10px;
 99 | }
100 | 
101 | ul.table li:nth-child(odd) {
102 |     background: #fafafa;
103 | }
104 | 
105 | ul.table li:last-child {
106 |     border-bottom: none;
107 | }
108 | 
109 | .landing-options {
110 |     max-width: 600px;
111 |     margin: auto;
112 |     text-align: center;
113 |     padding: 0;
114 | }
115 | 
116 | .landing-options li{
117 |     display:inline-block;
118 |     text-align: center;
119 |     vertical-align: top;
120 |     margin-left:20px;
121 |     margin-right:20px;
122 |     margin-bottom:20px;
123 |     padding: 10px;
124 | }
125 | 
126 | .landing-options li:hover{
127 |     background-color: rgba(30, 80, 85, 0.1);
128 |     border-radius: 5px;
129 | }
130 | 
131 | .landing-options .glyphicon {
132 |     font-size: 42px;
133 | }
134 | 
135 | 
136 | /* Test services */
137 | 
138 | .json_output {
139 |     font-family: Menlo, Consolas, "Andale Mono", "Lucida Console", monospace;
140 |     font-weight: 100;
141 |     font-size: 80%;
142 |     max-height: 300px;
143 |     word-wrap: normal;
144 | }
145 | 
146 | .spinner {
147 |     width: 40px;
148 |     height: 40px;
149 |     -webkit-animation:spin 4s linear infinite;
150 |     -moz-animation:spin 4s linear infinite;
151 |     animation:spin 4s linear infinite;
152 |     opacity: 0.7;
153 | }
154 | 
155 | .test_box {
156 |     margin-bottom: 40px;
157 | }
158 | 
159 | @-moz-keyframes spin { 100% { -moz-transform: rotate(360deg); } }
160 | @-webkit-keyframes spin { 100% { -webkit-transform: rotate(360deg); } }
161 | @keyframes spin { 100% { -webkit-transform: rotate(360deg); transform:rotate(360deg); } }
162 | 
163 | /* Forms */
164 | 
165 | .error-list {
166 |     color: #991933;
167 |     list-style-type: none;
168 | }
169 | 
170 | .error-list li {
171 |     margin-bottom: 20px;
172 |     margin-left: -40px;
173 | }
174 | 
175 | #app_registration_form .control-group {
176 |     margin-bottom: 10px;
177 | }
178 | 
179 | #app_registration_form .control-group.error .control-label {
180 |     color: #991933;
181 | }
182 | 
183 | #app_registration_form .control-group input {
184 |     border: solid 1px #e5e5e5;
185 |     border-radius: 3px;
186 |     width: 100%;
187 | }
188 | 
189 | #app_registration_form .control-group input[type='checkbox'] {
190 |     border: solid 1px #e5e5e5;
191 |     border-radius: 3px;
192 |     width: 15px;
193 | }
194 | 
195 | #app_registration_form .control-group select {
196 |     border: 1px solid #ccc;
197 | }
198 | 
199 | #app_registration_form .control-group textarea {
200 |     width: 100%;
201 |     height: 100px;
202 |     border: solid 1px #e5e5e5;
203 |     border-radius: 3px;
204 | }
205 | 
206 | 
207 | /* API client detail */
208 | 
209 | .client_detail {
210 |     margin-bottom: 20px;
211 | }
212 | 
213 | .client_detail .credential_key {
214 |     width: 100%;
215 |     font-family: Menlo, Consolas, "Andale Mono", "Lucida Console", monospace;
216 |     font-weight: 300;
217 |     color: #1E5055;
218 |     border: solid 1px #e5e5e5;
219 |     border-radius: 3px;
220 | }
221 | 
222 | .client_detail textarea {
223 |     width: 100%;
224 |     border: solid 1px #e5e5e5;
225 |     border-radius: 3px;
226 | }
227 | 
228 | .client_detail ul {
229 |     list-style-type: none;
230 | }
231 | 
232 | .client_detail ul li {
233 |     margin-bottom: 20px;
234 |     margin-left: -40px;
235 | }
236 | 


--------------------------------------------------------------------------------
/static/img/logo-icon.svg:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="utf-8"?>
 2 | <!-- Generator: Adobe Illustrator 17.0.0, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
 3 | <!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
 4 | <svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
 5 | 	 width="512px" height="512px" viewBox="0 0 512 512" enable-background="new 0 0 512 512" xml:space="preserve">
 6 | <path fill="#1E5055" d="M469.27,197.059c-7.329-2.613-26.234-6.392-43.497,14.793c-10.262,12.597-16.52,31.794-23.141,52.119
 7 | 	c-5.183,15.902-14.249,43.735-22.979,50.658c-10.934-20.961-18.062-96.953-21.616-134.864c-2.042-21.774-3.97-42.338-6.194-57.333
 8 | 	c-2.422-16.342-6.087-41.038-28.122-41.038c-24.061,0-30.766,24.363-52.6,117.507c-3.037,12.963-6.614,28.216-9.96,41.404
 9 | 	c-8.236-14.4-17.128-26.298-32.072-26.298c-21.878,0-25.079,19.607-32.089,62.57c-2.079,12.744-5.465,33.503-9.473,50.306
10 | 	c-2.825-16.134-5.27-36.05-7.175-51.565c-8.559-69.734-14.216-115.801-47.85-115.801c-32.002,0-42.173,38.643-52.942,79.556
11 | 	c-4.098,15.566-10.863,41.263-16.271,47.716c-1.102,0.302-1.871,0.064-3.094-0.746c-5.734-3.789-11.918-16.161-11.918-29.543
12 | 	c0-114.541,93.184-207.725,207.725-207.725c64.025,0,119.732,23.463,153.273,64.388l-29.694,22.522l40.056,6.625l40.056,6.625
13 | 	l4.419-40.359l4.419-40.359l-26.33,19.971C400.865,36.91,333.078,7.5,256.002,7.5C118.703,7.5,7,119.203,7,256.502
14 | 	c0,26.234,12.23,51.945,30.43,63.977c13.215,8.74,28.535,10.111,43.161,3.89c21.622-9.211,29.62-39.6,38.885-74.786
15 | 	c2.617-9.943,6.278-23.853,10.06-34.652c4.088,18.492,7.508,46.359,9.849,65.418c8.206,66.862,13.631,111.034,45.801,111.034
16 | 	c34.904,0,43.477-52.536,52.553-108.156c0.02-0.118,0.037-0.235,0.057-0.353c7.538,12.036,16.12,21.192,29.342,21.192
17 | 	c21.73,0,25.593-16.493,44.172-95.74c1.68-7.165,3.621-15.452,5.69-24.064c10.084,107.43,18.384,173.238,58.804,173.238
18 | 	c39.768,0,54.353-44.766,66.073-80.739c4.827-14.81,10.282-31.555,15.586-38.445c3,4.155,6.261,12.009,6.261,18.186
19 | 	c0,114.538-93.184,207.722-207.722,207.722c-52.875,0-102.818-19.745-141.359-55.63l27.652-21.578l-40.143-6.075l-40.143-6.075
20 | 	l-3.865,40.416l-3.865,40.416l27.44-21.412c46.813,45.922,108.685,71.215,174.284,71.215C393.301,505.5,505,393.801,505,256.502
21 | 	C505,234.029,491.339,204.913,469.27,197.059z"/>
22 | </svg>


--------------------------------------------------------------------------------
/static/img/project_logo_h.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AudioCommons/ac-mediator/3201c12865d986fd945a1108b00ad9e85d459827/static/img/project_logo_h.png


--------------------------------------------------------------------------------
/static/js/all.js:
--------------------------------------------------------------------------------
 1 | var getJSON = function(url) {
 2 |   return new Promise(function(resolve, reject) {
 3 |     var xhr = new XMLHttpRequest();
 4 |     xhr.open('get', url, true);
 5 |     xhr.responseType = 'json';
 6 |     xhr.onload = function() {
 7 |       if (xhr.status === 200) {
 8 |         resolve(xhr);
 9 |       } else {
10 |         reject(xhr);
11 |       }
12 |     };
13 |     xhr.send();
14 |   });
15 | };


--------------------------------------------------------------------------------
/templates/accounts/about.html:
--------------------------------------------------------------------------------
 1 | {% extends "base.html" %}
 2 | {% load staticfiles %}
 3 | {% block title %}About{% endblock title %}
 4 | 
 5 | {% block content %}
 6 |     <h1>
 7 |         <a href="{% url 'home' %}"><img class="logo-breadcrumb" src="{% static "img/logo-icon.svg" %}" alt="Audio Commons Logo"></a>
 8 |         <span class="breadcrumb-separator">|</span> About
 9 |     </h1>
10 |     <div class="alert alert-warning" role="alert">
11 |         The about section is still under construction. For information about Audio Commons and the meditator please
12 |         visit <a href="http://audiocommons.org" target="_blank">https://audiocommons.org</a>.
13 |     </div>
14 |     <p>
15 |         Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna
16 |         aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.
17 |         Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur
18 |         sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
19 |     </p>
20 |     <div style="text-align: center;margin-top: 40px;">
21 |         <img src="/docs/_images/ac_services_diagram.svg" style="width:300px;"/>
22 |     </div>
23 | {% endblock %}
24 | 


--------------------------------------------------------------------------------
/templates/accounts/activate.html:
--------------------------------------------------------------------------------
 1 | {% extends "base.html" %}
 2 | {% block title %}Account activation{% endblock %}
 3 | {% block content %}
 4 | 
 5 |     {% if all_ok %}
 6 |         <h1>Activation succeeded...</h1>
 7 |         <p>You have been activated. Please <a href="{% url "login" %}">log in</a> to continue.
 8 |     {% else %}
 9 |         <h1>Activation failed...</h1>
10 |         {% if user_does_not_exist %}
11 |         <p>We're sorry but the user you are trying to activate does not exist! Please sign up again...</p>
12 |         {% endif %}
13 | 
14 |         {% if decode_error %}
15 |         <p>We're sorry but we can't find that activation key in the database.
16 |             Try copy-pasting the link that we sent you instead of clicking it...</p>
17 |         {% endif %}
18 |     {% endif %}
19 | 
20 | {% endblock %}


--------------------------------------------------------------------------------
/templates/accounts/authorize_client.html:
--------------------------------------------------------------------------------
 1 | {% extends "base.html" %}
 2 | {% load i18n %}
 3 | {% block content %}
 4 |     {% if not error %}
 5 |         <form id="authorizationForm" method="post">
 6 |             <h3 class="block-center-heading">{% trans "Authorize" %} {{ application.name }}?</h3>
 7 |             {% csrf_token %}
 8 | 
 9 |             {% for field in form %}
10 |                 {% if field.is_hidden %}
11 |                     {{ field }}
12 |                 {% endif %}
13 |             {% endfor %}
14 | 
15 |             <p>{% trans "Application requires following permissions" %}</p>
16 |             <ul>
17 |                 {% for scope in scopes_descriptions %}
18 |                     <li>{{ scope }}</li>
19 |                 {% endfor %}
20 |             </ul>
21 | 
22 |             {{ form.errors }}
23 |             {{ form.non_field_errors }}
24 | 
25 |             <div class="control-group">
26 |                 <div class="controls">
27 |                     <input type="submit" class="btn btn-large btn-danger" value="Cancel"/>
28 |                     <input type="submit" class="btn btn-large btn-success" name="allow" value="Authorize"/>
29 |                 </div>
30 |             </div>
31 |         </form>
32 | 
33 |     {% else %}
34 |         <h2>Error: {{ error.error }}</h2>
35 |         <p>{{ error.description }}</p>
36 |     {% endif %}
37 | {% endblock %}


--------------------------------------------------------------------------------
/templates/accounts/authorized-token-delete.html:
--------------------------------------------------------------------------------
1 | {% extends "base.html" %}
2 | {% load i18n %}
3 | {% block content %}
4 |     <form action="" method="post">{% csrf_token %}
5 |         <h1>{% trans "Are you sure you want to revoke this authorization?" %}</h1>
6 |         <input type="submit" class="btn btn-large btn-danger" value="{% trans "Delete" %}" />
7 |     </form>
8 | {% endblock %}
9 | 


--------------------------------------------------------------------------------
/templates/accounts/authorized-tokens.html:
--------------------------------------------------------------------------------
 1 | {% extends "base.html" %}
 2 | {% load staticfiles %}
 3 | {% load i18n %}
 4 | {% load url from compat %}
 5 | {% block title %}{% trans "Authorized applications" %}{% endblock title %}
 6 | 
 7 | {% block content %}
 8 |     <h1>
 9 |         <a href="{% url 'home' %}"><img class="logo-breadcrumb" src="{% static "img/logo-icon.svg" %}" alt="Audio Commons Logo"></a>
10 |         <span class="breadcrumb-separator">|</span> Authorized applications
11 |     </h1>
12 | 
13 |     <ul class="table">
14 |     {% for authorized_token in authorized_tokens %}
15 |         <li>
16 |             {{ authorized_token.application }}
17 |             <div class="pull-right"><a class="btn btn-danger" href="{% url 'authorized-token-delete' authorized_token.pk %}">Revoke</a></div>
18 |         </li>
19 |         <ul>
20 |         {% for scope_name, scope_description in authorized_token.scopes.items %}
21 |             <li>{{ scope_name }}: {{ scope_description }}</li>
22 |         {% endfor %}
23 |         </ul>
24 |     {% empty %}
25 |         <li>{% trans "No applications have been authorized yet" %}</li>
26 |     {% endfor %}
27 |     </ul>
28 |     <br><br>
29 |     <p><a href="{% url 'home' %}">Back</a></p>
30 | {% endblock %}
31 | 


--------------------------------------------------------------------------------
/templates/accounts/home.html:
--------------------------------------------------------------------------------
 1 | {% extends "base.html" %}
 2 | {% load staticfiles %}
 3 | {% block title %}Home{% endblock title %}
 4 | 
 5 | {% block content %}
 6 |     <h1><img class="logo-breadcrumb" src="{% static "img/logo-icon.svg" %}" alt="Audio Commons Logo"> Welcome!</h1>
 7 |     <br>
 8 |     <ul class="landing-options">
 9 |         <li><a href="{% url 'link_services' %}"><span class="glyphicon glyphicon-link" aria-hidden="true"></span> <br>Link service accounts</a></li>
10 |         <li><a href="{% url 'authorized-token-list' %}"><span class="glyphicon glyphicon-wrench" aria-hidden="true"></span> <br>Manage authorized applications</a></li>
11 |     </ul>
12 | {% endblock %}
13 | 


--------------------------------------------------------------------------------
/templates/accounts/link_service_callback.html:
--------------------------------------------------------------------------------
 1 | {% load staticfiles %}
 2 | 
 3 | <!DOCTYPE html>
 4 | <html lang="en">
 5 | <head>
 6 |     <meta charset="UTF-8">
 7 |     <title>Link service complete</title>
 8 |     <style>
 9 |         body {
10 |             background-color:#f5f5f5;
11 |             text-align:center;
12 |             font-family: "Helvetica Neue", Helvetica, Arial, sans-serif;
13 |         }
14 | 
15 |         .frame {
16 |             width:100%;
17 |             height:100%;
18 |         }
19 | 
20 |         .image {
21 |             position: absolute;
22 |             top: 50%;
23 |             left: 50%;
24 |             width: 120px;
25 |             height: 120px;
26 |             margin:-60px 0 0 -60px;
27 |             opacity:0.7;
28 |             {% if not errors %}
29 |                 -webkit-animation:spin 4s linear infinite;
30 |                 -moz-animation:spin 4s linear infinite;
31 |                 animation:spin 4s linear infinite;
32 |             {% endif %}
33 |         }
34 | 
35 |         @-moz-keyframes spin { 100% { -moz-transform: rotate(360deg); } }
36 |         @-webkit-keyframes spin { 100% { -webkit-transform: rotate(360deg); } }
37 |         @keyframes spin { 100% { -webkit-transform: rotate(360deg); transform:rotate(360deg); } }
38 |     </style>
39 |     <script>
40 |     function reloadParentWindow() {
41 |         if (!window.opener) {
42 |             // Try to reload parent window using opener property
43 |             // NOTE: in some situations window.opener seems to be undefined. For this reason
44 |             // the script in link_services.html will also automatically reload the page if it
45 |             // detects that the opened popup is closed.
46 |             window.opener.location.reload();
47 |         }
48 |     }
49 |     function closePopup() {
50 |         window.close();
51 |     }
52 |     </script>
53 | </head>
54 | <body onload="
55 |         {% if complete %}
56 |             reloadParentWindow();
57 |             {% if not errors %}
58 |                 closePopup();
59 |             {% endif %}
60 |         {% endif %}
61 |         {% if not errors and not complete %}
62 |             window.location='{% url "link_service_get_token" service_id %}?code={{ code }}';
63 |         {% endif %}">
64 |     <div class="frame">
65 |         <img class="image" src="{% static "img/logo-icon.svg" %}" alt="">
66 |         {% if errors %}<br><br>An error occured and we could not link your account...{% endif %}
67 |     </div>
68 | </body>
69 | </html>


--------------------------------------------------------------------------------
/templates/accounts/link_services.html:
--------------------------------------------------------------------------------
 1 | {% extends "base.html" %}
 2 | {% load staticfiles %}
 3 | {% block title %}Link Service accounts{% endblock title %}
 4 | 
 5 | {% block content %}
 6 |     <script>
 7 |     function openServiceAuthPopup(url, name, popupSpecs) {
 8 |         var popupWin = window.open(url, name, popupSpecs);
 9 |         var timer = setInterval(function() {
10 |             if(popupWin.closed) {
11 |                 clearInterval(timer);
12 |                 window.location.reload();
13 |             }
14 |         }, 200);
15 |     }
16 |     </script>
17 | 
18 |     <h1>
19 |         <a href="{% url 'home' %}"><img class="logo-breadcrumb" src="{% static "img/logo-icon.svg" %}" alt="Audio Commons Logo"></a>
20 |         <span class="breadcrumb-separator">|</span> Link service accounts
21 |     </h1>
22 | 
23 |     <h2>Linkable services</h2>
24 |     <ul class="table">
25 |     {% for service, user_credentials in linkable_services_info %}
26 |         <li style="margin-bottom:5px;">
27 |             {{ service.name }} ({{ service.url }})
28 |             <div class="pull-right">
29 |                 {% if user_credentials %}
30 |                     <a class="btn btn-danger"
31 |                        href="{% url "unlink_service" service.id %}"
32 |                     >unlink</a>
33 |                 {% else %}
34 |                     <button class="btn btn-success"
35 |                             onclick="openServiceAuthPopup('{{ service.get_authorize_url }}',
36 |                                                           '{{ service.name }} authorization',
37 |                                                           '{{ service.get_authorize_popup_specs }}')"
38 |                     >link</button>
39 |                 {% endif %}
40 |             </div>
41 |         </li>
42 |     {% empty %}
43 |         <li>No services available</li>
44 |     {% endfor %}
45 |     </ul>
46 |     <br>
47 | 
48 |     <h2>Non Linkable services</h2>
49 |     <ul class="table">
50 |     {% for service in non_linkable_services_info %}
51 |         <li>
52 |             {{ service.name }} ({{ service.url }})
53 |         </li>
54 |     {% empty %}
55 |         <li>No services available</li>
56 |     {% endfor %}
57 |     </ul>
58 | 
59 |     <br><br><a href="{% url 'home' %}">Back</a>
60 | {% endblock %}
61 | 


--------------------------------------------------------------------------------
/templates/accounts/login.html:
--------------------------------------------------------------------------------
 1 | {% extends "base.html" %}
 2 | {% block title %}Login{% endblock title %}
 3 | 
 4 | {% block content %}
 5 | 
 6 |     <h1>Audio Commons Mediator</h1>
 7 | 
 8 |     {% if form.errors %}
 9 |     <p>Your username and password didn't match. Please try again.</p>
10 |     {% endif %}
11 | 
12 |     {% if next %}
13 |         {% if user.is_authenticated %}
14 |         <p>Your account doesn't have access to this page. To proceed,
15 |         please login with an account that has access.</p>
16 |         {% else %}
17 |         <p>Please login to see this page.</p>
18 |         {% endif %}
19 |     {% endif %}
20 | 
21 |     <form method="post" action="{% url 'login' %}">
22 |     {% csrf_token %}
23 |     {{form.as_p}}
24 |     <input class="btn btn-success" type="submit" value="Login" />
25 |     <input type="hidden" name="next" value="{{ next }}" />
26 |     </form>
27 | 
28 |     <br>
29 |     <p><a href="{% url 'password_reset' %}">Lost password?</a></p>
30 |     <p><a href="{% url 'accounts-resend-activation' %}">Resend activation code</a></p>
31 | 
32 | {% endblock %}
33 | 


--------------------------------------------------------------------------------
/templates/accounts/password_reset_complete.html:
--------------------------------------------------------------------------------
 1 | {% extends "base.html" %}
 2 | {% block title %}Password reset complete{% endblock %}
 3 | {% block content %}
 4 | 
 5 | <h1>Password reset complete</h1>
 6 | 
 7 | <p>Your password has been set. You may go ahead and log in now.</p>
 8 | 
 9 | <p><a href="{{ login_url }}">Log in</a></p>
10 | 
11 | {% endblock %}
12 | 


--------------------------------------------------------------------------------
/templates/accounts/password_reset_confirm.html:
--------------------------------------------------------------------------------
 1 | {% extends "base.html" %}
 2 | {% block title %}Password reset{% endblock %}
 3 | {% block content %}
 4 | 
 5 | {% if validlink %}
 6 |     <h1>Enter new password</h1>
 7 |     
 8 |     <p>Please enter your new password twice so we can verify you typed it in correctly.</p>
 9 |     
10 |     <form action="." method="post">{% csrf_token %}
11 |     {{ form.as_p }}
12 |     <input type="submit" value=" Change my password " />
13 |     </form>
14 | {% else %}
15 |     <h1>Password reset unsuccessful</h1>
16 |     <p>The password reset link was invalid, possibly because it has already been used.
17 |         Please <a href="{% url 'password_reset' %}">request a new password reset</a>.</p>
18 | {% endif %}
19 | 
20 | {% endblock %}
21 | 


--------------------------------------------------------------------------------
/templates/accounts/password_reset_done.html:
--------------------------------------------------------------------------------
 1 | {% extends "base.html" %}
 2 | {% block title %}Password reset email sent{% endblock %}
 3 | 
 4 | {% block content %}
 5 | <h1>Password reset email sent</h1>
 6 | <p>We've e-mailed you instructions for setting your password to the e-mail address you submitted.
 7 |     You should be receiving them shortly.</p>
 8 | {% endblock %}
 9 | 
10 | 


--------------------------------------------------------------------------------
/templates/accounts/password_reset_form.html:
--------------------------------------------------------------------------------
 1 | {% extends "base.html" %}
 2 | {% block title %}Password reset{% endblock %}
 3 | {% block content %}
 4 | 
 5 | <h1>Password reset</h1>
 6 | 
 7 | <p>
 8 |     Forgotten your password?<br>
 9 |     Enter your e-mail address below, and we'll e-mail instructions for setting a new one.
10 | </p>
11 | 
12 | <form action="." method="post">{% csrf_token %}
13 | {{form.as_p}}
14 | <input type="submit" value="Reset my password" />
15 | </form>
16 | 
17 | {% endblock %}
18 | 


--------------------------------------------------------------------------------
/templates/accounts/registration.html:
--------------------------------------------------------------------------------
 1 | {% extends "base.html" %}
 2 | {% block title %}Registration{% endblock title %}
 3 | {% block content %}
 4 | 
 5 |     <h1>Registration</h1>
 6 | 
 7 |     {% if form %}
 8 |         <form method="post" action="{% url 'registration' %}">
 9 |         {% csrf_token %}
10 |         {{form.as_p}}
11 |         <input class="btn btn-success" type="submit" value="Register" />
12 |         </form>
13 |     {% else %}
14 |         <p>
15 |             Thanks for creating an Audio Commons account!<br>
16 |             Before being able to log in, you'll need to activate your account.<br>
17 |             Please follow the instructions that we have just sent you via email.
18 |         </p>
19 |     {% endif %}
20 | 
21 | {% endblock %}
22 | 


--------------------------------------------------------------------------------
/templates/accounts/resend_activation.html:
--------------------------------------------------------------------------------
 1 | {% extends "base.html" %}
 2 | {% block title %}Resend activation email{% endblock title %}
 3 | {% block content %}
 4 | 
 5 |     <h1>Registration</h1>
 6 | 
 7 |     {% if form %}
 8 |         <form method="post" action="{% url 'accounts-resend-activation' %}">
 9 |         {% csrf_token %}
10 |         {{form.as_p}}
11 |         <input class="btn btn-success" type="submit" value="Resend activation code" />
12 |         </form>
13 |     {% else %}
14 |         <p>
15 |             We just sent an email with instructions for activating your user account.<br>
16 |             Please check your inbox (including spam folders).
17 |         </p>
18 |     {% endif %}
19 | 
20 | {% endblock %}
21 | 


--------------------------------------------------------------------------------
/templates/admin/base_site.html:
--------------------------------------------------------------------------------
 1 | {% extends "admin/base.html" %}
 2 | {% load staticfiles %}
 3 | 
 4 | {% block title %}{{ title }} | AC mediator admin{% endblock %}
 5 | 
 6 | {% block extrastyle %}
 7 | <link rel="stylesheet" type="text/css" href="{% static "css/admin_extra.css" %}" />
 8 | {% endblock %}
 9 | 
10 | {% block branding %}
11 | <h1 id="site-name"><a href="{% url 'admin:index' %}">Audio Commons mediator administration</a></h1>
12 | {% endblock %}
13 | 
14 | {% block nav-global %}<a href="{% url 'admin-monitor' %}">Go to monitor</a>{% endblock %}
15 | 


--------------------------------------------------------------------------------
/templates/admin/monitor.html:
--------------------------------------------------------------------------------
 1 | {% extends "admin/base_site.html" %}
 2 | {% load i18n admin_urls admin_static admin_modify %}
 3 | 
 4 | {% block nav-global %}{% endblock %}
 5 | 
 6 | {% block breadcrumbs %}
 7 | <div class="breadcrumbs">
 8 | <a href="{% url 'admin:index' %}">{% trans 'Home' %}</a>
 9 | &rsaquo; Monitor
10 | </div>
11 | {% endblock %}
12 | 
13 | {% block content %}
14 | <h1>Monitor</h1>
15 | 
16 | <h2>Redis</h2>
17 | <p>
18 |     To monitor celery state please use the <a href="/redmon/" target="_blank">Redmon interface</a>.
19 |     <br>If asked for user and password in a development environment, use user <b>{{ redmon_auth.0 }}</b> and password <b>{{ redmon_auth.1 }}</b>.
20 | </p>
21 | 
22 | 
23 | <br>
24 | <h2>Celery</h2>
25 | <p>
26 |     To monitor celery state please use the <a href="/flower/" target="_blank">Flower interface</a>.
27 |     <br>If asked for user and password in a development environment, use user <b>{{ flower_auth.0 }}</b> and password <b>{{ flower_auth.1 }}</b>.
28 | </p>
29 | 
30 | {% endblock %}
31 | 


--------------------------------------------------------------------------------
/templates/base.html:
--------------------------------------------------------------------------------
 1 | {% load staticfiles %}
 2 | 
 3 | <!DOCTYPE html>
 4 | <html lang="en">
 5 | <head>
 6 |     <meta charset="UTF-8">
 7 |     <title>Audio Commons Mediator - {% block title %}{% endblock title %}</title>
 8 |     <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.5/css/bootstrap.min.css">
 9 |     <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/font-awesome/4.4.0/css/font-awesome.min.css">
10 |     <link href='https://fonts.googleapis.com/css?family=Rajdhani:400,700' rel='stylesheet' type='text/css'>
11 |     <link href='https://fonts.googleapis.com/css?family=Roboto:300,500' rel='stylesheet' type='text/css'>
12 |     <link rel="stylesheet" type="text/css" href="{% static "css/main.css" %}" />
13 |     <script src="{% static "js/all.js" %}" type="text/javascript"></script>
14 | </head>
15 | 
16 | <body>
17 | 
18 |     <div class="container">
19 |         <div class="logo-background">
20 |             <img src="{% static "img/logo-icon.svg" %}" style="height:550px;" alt="">
21 |         </div>
22 | 
23 |         <div class="block-center">
24 |             <div class="pull-right">
25 |                 {% if request.user.is_authenticated %}
26 |                     {{ request.user.username }} (<a href="{% url 'logout' %}">Logout</a>)
27 |                     {% if request.user.is_staff %}
28 |                         - <a href="{% url 'admin:index' %}">admin</a>
29 |                     {% endif %}
30 |                 {% else %}
31 |                     {% if user and user.is_authenticated %}
32 |                         {{ user }} (<a href="{% url 'logout' %}">Logout</a>)
33 |                     {% else %}
34 |                         <a href="{% url 'registration' %}">Register</a>
35 |                     {% endif %}
36 |                 {% endif %}
37 |             </div>
38 |             <br>
39 | 
40 |             {% block content %}
41 |             {% endblock content%}
42 | 
43 |             <div class="footer">
44 |                 {% if request.user.is_authenticated %}
45 |                     <div class="alert alert-warning" role="alert">
46 |                         This is a beta version of the <b>Audio Commons Mediator</b> website.
47 |                         <br>Some things might not work properly or appear to be unfinished.
48 |                         <br>Have some feedback for us? Feel free to <a href="mailto:audiocommons@upf.edu">send us an email</a>.
49 |                     </div>
50 |                 {% endif %}
51 |                 Audio Commons - <a href="http://www.audiocommons.org" target="_blank">http://audiocommons.org</a><br>
52 |                 {% if request.user.is_authenticated %}
53 |                     <a href="{% url 'home' %}">Home</a> | <a href="/docs/api_tos.html">Terms of Service and Privacy Policy</a> | <a href="{% url 'developers-app-list' %}">Developers</a>
54 |                 {% endif %}
55 |             </div>
56 |         </div>
57 |     </div>
58 | </body>
59 | </html>
60 | 
61 | 
62 | 
63 | 
64 | 


--------------------------------------------------------------------------------
/templates/developers/application_confirm_delete.html:
--------------------------------------------------------------------------------
 1 | {% extends "base.html" %}
 2 | {% block title %}Delete {{ application.name }}{% endblock title %}
 3 | {% load i18n %}
 4 | {% load url from compat %}
 5 | {% block content %}
 6 | 
 7 |     <h1>{% trans "Are you sure to delete the Api Client" %} {{ application.name }}?</h1>
 8 |     <form method="post" action="{% url 'developers-app-delete' application.pk %}">
 9 |         {% csrf_token %}
10 | 
11 |         <div class="control-group">
12 |             <div class="controls">
13 | 
14 |                 <input type="submit" class="btn btn-large btn-danger" name="allow" value="Yes I'm sure"/>
15 |                 &nbsp;&nbsp;<a href="{% url "developers-app-list" %}">{% trans "Cancel" %}</a>
16 |             </div>
17 |         </div>
18 |     </form>
19 | 
20 | {% endblock content %}


--------------------------------------------------------------------------------
/templates/developers/application_detail.html:
--------------------------------------------------------------------------------
 1 | {% extends "base.html" %}
 2 | {% block title %}{{ application.name }}{% endblock title %}
 3 | {% load staticfiles %}
 4 | {% load i18n %}
 5 | {% load url from compat %}
 6 | {% block content %}
 7 |     <h1>
 8 |         <a href="{% url 'home' %}"><img class="logo-breadcrumb" src="{% static "img/logo-icon.svg" %}" alt="Audio Commons Logo"></a>
 9 |         <span class="breadcrumb-separator">|</span> API Client Details
10 |     </h1>
11 | 
12 |     <div class="client_detail">
13 |         <ul class="unstyled">
14 |             <li>
15 |                 <p><b>{% trans "Name" %}</b>: {{ application.name }}<p>
16 |             </li>
17 | 
18 |             <li>
19 |                 <p><b>{% trans "Client id" %}</b>:</p>
20 |                 <p><input class="credential_key" type="text" value="{{ application.client_id }}" readonly></p>
21 |             </li>
22 | 
23 |             <li>
24 |                 <p><b>{% trans "Client type" %}</b>: {{ application.client_type }}</p>
25 |             </li>
26 | 
27 |             <li>
28 |                 <p><b>{% trans "Client secret" %}</b>:</p>
29 |                 <p><input class="credential_key" type="text" value="{{ application.client_secret }}" readonly></p>
30 |                 {% if application.client_type == application.CLIENT_PUBLIC %}
31 |                     <div class="alert alert-warning" role="alert">
32 |                         <span class="glyphicon glyphicon-exclamation-sign" aria-hidden="true"></span>
33 |                         Your client type is set to public, therefore you <b>should never use client secret</b>
34 |                         in your authentication flow. Client secret is reserved for confidential applications only.
35 |                     </div>
36 |                 {% endif %}
37 |             </li>
38 | 
39 |             <li>
40 |                 <p><b>{% trans "Authorization Grant Type" %}</b>: {{ application.authorization_grant_type }}</p>
41 |                 {% if application.authorization_grant_type == application.GRANT_PASSWORD %}
42 |                     {% if application.password_grant_is_allowed %}
43 |                         <div class="alert alert-success" role="alert">
44 |                             <span class="glyphicon glyphicon-ok" aria-hidden="true"></span>
45 |                             <b>Password grant</b> is allowed for this application.
46 |                         </div>
47 |                     {% else %}
48 |                         <div class="alert alert-warning" role="alert">
49 |                             <span class="glyphicon glyphicon-exclamation-sign" aria-hidden="true"></span>
50 |                             <b>Password grant</b> has not been enabled for this application and won't be allowed.
51 |                             To enable password grant please request it by sending an email to <a href="mailto:audiocommons@upf.edu">
52 |                             audiocommons@upf.edu</a>.
53 |                         </div>
54 |                     {% endif %}
55 |                 {% endif %}
56 |             </li>
57 | 
58 |             <li>
59 |                 <p><b>{% trans "Redirect URIs" %}</b></p>
60 |                 <p><textarea readonly>{{ application.redirect_uris }}</textarea></p>
61 |                 {% if application.authorization_grant_type == application.GRANT_PASSWORD %}
62 |                     <div class="alert alert-warning" role="alert">
63 |                         <span class="glyphicon glyphicon-exclamation-sign" aria-hidden="true"></span>
64 |                         Your client is set to use <b>password grant</b>  therefore no redirect URIs are employed
65 |                         during the authorization flow.
66 |                     </div>
67 |                 {% endif %}
68 |             </li>
69 | 
70 |         </ul>
71 |     </div>
72 | 
73 |     <div class="btn-toolbar pull-right">
74 |         <a class="btn btn-warning" href="{% url "developers-app-update" application.id %}">{% trans "Edit" %}</a>
75 |         <a class="btn btn-danger" href="{% url "developers-app-delete" application.id %}">{% trans "Delete" %}</a>
76 |     </div>
77 |     <a href="{% url "developers-app-list" %}">Back</a>
78 | {% endblock content %}


--------------------------------------------------------------------------------
/templates/developers/application_form.html:
--------------------------------------------------------------------------------
 1 | {% extends "base.html" %}
 2 | {% load staticfiles %}
 3 | {% load i18n %}
 4 | {% load url from compat %}
 5 | {% block content %}
 6 |     <script>
 7 |     window.onload=function(){
 8 |         document.getElementById("id_application_type").onchange=function(){
 9 |             showOrHideGrantWarning();
10 |         };
11 |         showOrHideGrantWarning();
12 |     };
13 |     function showOrHideGrantWarning(){
14 |         var currentValue = document.getElementById("id_application_type").value;
15 |         if (currentValue == "{{ form.PUBLIC_PASSWORD }}"){
16 |             document.getElementById("password_grant_warning").style.display = 'block';
17 |         } else {
18 |             document.getElementById("password_grant_warning").style.display = 'none';
19 |         }
20 |     }
21 |     </script>
22 |     <form id="app_registration_form" class="form-horizontal" method="post" action="{% block app-form-action-url %}{% url 'developers-app-update' application.id %}{% endblock app-form-action-url %}">
23 |         <h1>
24 |             <a href="{% url 'home' %}"><img class="logo-breadcrumb" src="{% static "img/logo-icon.svg" %}" alt="Audio Commons Logo"></a>
25 |         <span class="breadcrumb-separator">|</span>
26 |             {% block app-form-title %}
27 |                 {% trans "Edit application" %} {{ application.name }}
28 |             {% endblock app-form-title %}
29 |         </h1>
30 |         {% csrf_token %}
31 | 
32 |         {% for field in form.visible_fields %}
33 |             <div class="control-group {% if field.errors %}error{% endif %}">
34 |                 <label class="control-label" for="{{ field.id_for_label }}">{{ field.label }}:</label>
35 |                 <div class="controls">
36 |                     {% if not field.field.is_checkbox and field.help_text %}<p>{{ field.help_text }}</p>{% endif %}
37 |                     {{ field }}
38 |                     {% if field.field.is_checkbox and field.help_text %}{{ field.help_text }}{% endif %}
39 |                     {% if field.errors %}
40 |                         <br>
41 |                         <ul class="error-list">
42 |                         {% for error in field.errors %}
43 |                             <li>{{ error }}</li>
44 |                         {% endfor %}
45 |                         </ul>
46 |                     {% endif %}
47 |                 </div>
48 |             </div>
49 |             {% if field.name == 'application_type' %}
50 |                 <div id="password_grant_warning" style="display:none;">
51 |                 {% if application %}
52 |                     {% if application.password_grant_is_allowed %}
53 |                         <div class="alert alert-success" role="alert">
54 |                             <span class="glyphicon glyphicon-ok" aria-hidden="true"></span>
55 |                             <b>Password grant</b> is allowed for this application.
56 |                         </div>
57 |                     {% else %}
58 |                         <div class="alert alert-warning" role="alert">
59 |                             <span class="glyphicon glyphicon-exclamation-sign" aria-hidden="true"></span>
60 |                             <b>Password grant</b> has not been enabled for this application and won't be allowed.
61 |                             To enable password grant please request it by sending an email to <a href="mailto:audiocommons@upf.edu">
62 |                             audiocommons@upf.edu</a>.
63 |                         </div>
64 |                     {% endif %}
65 |                 {% else %}
66 |                     <div class="alert alert-warning" role="alert">
67 |                         <span class="glyphicon glyphicon-exclamation-sign" aria-hidden="true"></span>
68 |                         <b>Password grant</b> needs to be enabled for this application before it can be used.
69 |                         <br>To enable password grant please finish registering your application and then send an
70 |                         email to <a href="mailto:audiocommons@upf.edu">audiocommons@upf.edu</a> including your
71 |                         application details.
72 |                     </div>
73 |                 {% endif %}
74 |                 </div>
75 |             {% endif %}
76 |         {% endfor %}
77 | 
78 |         {% for field in form.hidden_fields %}
79 |              <div style="display:none;">{{ field }}</div>
80 |         {% endfor %}
81 | 
82 |         {% if form.non_field_errors %}
83 |             <ul class="error-list">
84 |             {% for error in form.non_field_errors %}
85 |                 <li>{{ error }}</li>
86 |             {% endfor %}
87 |             </ul>
88 |         {% endif %}
89 |         <br>
90 |         <div class="control-group">
91 |             <div class="controls">
92 |                 <button type="submit" class="btn btn-success pull-right">Save</button>
93 |                 &nbsp;&nbsp;<a href="{% block app-form-back-url %}{% url "developers-app-detail" application.id %}{% endblock app-form-back-url %}">Back</a>
94 |             </div>
95 |         </div>
96 |     </form>
97 | {% endblock %}


--------------------------------------------------------------------------------
/templates/developers/application_list.html:
--------------------------------------------------------------------------------
 1 | {% extends "base.html" %}
 2 | {% load staticfiles %}
 3 | {% load i18n %}
 4 | {% block title %}Manage API Clients{% endblock title %}
 5 | {% block content %}
 6 | 
 7 |     <h1>
 8 |         <a href="{% url 'home' %}"><img class="logo-breadcrumb" src="{% static "img/logo-icon.svg" %}" alt="Audio Commons Logo"></a>
 9 |         <span class="breadcrumb-separator">|</span> Developers
10 |     </h1>
11 | 
12 |     <h2>Manage API Clients</h2>
13 |     {% if applications %}
14 |         <ul class="table">
15 |             {% for application in applications %}
16 |                 <li><a href="{{ application.get_absolute_url }}">{{ application.name }}</a>
17 |                     <div class="pull-right">
18 |                         <a class="btn btn-warning" href="{% url 'developers-app-monitor' application.id %}"><span class="glyphicon glyphicon-stats" aria-hidden="true" title="Monitor"></span></a>
19 |                         {% comment %}<a class="btn btn-warning" href="{% url 'developers-app-update' application.id %}"><span class="glyphicon glyphicon-pencil" aria-hidden="true" title="Edit"></span></a>
20 |                         <a class="btn btn-danger" href="{% url 'developers-app-delete' application.id %}"><span class="glyphicon glyphicon-remove" aria-hidden="true" title="Delete"></span></a>{% endcomment %}
21 |                     </div>
22 |                 </li>
23 |             {% endfor %}
24 |         </ul>
25 |     {% endif %}
26 |     <br>
27 |     <a class="btn btn-success pull-right" href="{% url "developers-app-register" %}">New API Client</a>
28 |     <br><br>
29 | 
30 |     <h2>Documentation</h2>
31 |     <ul class="table">
32 |         <li><a href="{% url 'docs_root' %}api.html" target="_blank">API documentation</a></li>
33 |         <li><a href="{% url 'docs_root' %}services.html" target="_blank">Services documentation</a></li>
34 |         <li><a href="http://www.audiocommons.org/assets/files/AC-WP2-UPF-D2.6%20Service%20Integration%20Draft%20Guidelines.pdf" target="_blank">
35 |             Guidelines for implementing a new service component
36 |         </a></li>
37 |         <li><a href="https://github.com/AudioCommons/ac-mediator/wiki/Implementing-and-testing-new-services" target="_blank">
38 |             Steps for implementing and testing new services
39 |         </a></li>
40 |     </ul>
41 | 
42 | {% endblock content %}


--------------------------------------------------------------------------------
/templates/developers/application_registration_form.html:
--------------------------------------------------------------------------------
 1 | {% extends "developers/application_form.html" %}
 2 | {% block title %}Register a new Api Client{% endblock title %}
 3 | {% load i18n %}
 4 | {% load url from compat %}
 5 | 
 6 | {% block app-form-title %}{% trans "Register a new Api Client" %}{% endblock app-form-title %}
 7 | 
 8 | {% block app-form-action-url %}{% url 'developers-app-register' %}{% endblock app-form-action-url %}
 9 | 
10 | {% block app-form-back-url %}{% url "developers-app-list" %}"{% endblock app-form-back-url %}


--------------------------------------------------------------------------------
/templates/emails/account_activation.txt:
--------------------------------------------------------------------------------
 1 | {% extends "emails/email_base.txt" %}
 2 | {% load absurl %}
 3 | 
 4 | {% block salutation %}{{username}}{% endblock %}
 5 | 
 6 | {% block body %}
 7 | Thank you for creating an Audio Commons account!
 8 | 
 9 | In order to activate your account, please click this link:
10 | 
11 | {% absurl 'accounts-activate' username hash %}
12 | 
13 | If for some reason this fails, try copy-pasting the complete link into you browser.
14 | Some mail clients break up long lines, or do strange things to URL's!
15 | {% endblock %}
16 | 


--------------------------------------------------------------------------------
/templates/emails/email_base.txt:
--------------------------------------------------------------------------------
 1 | Hello there {% block salutation %}{% endblock %},
 2 | 
 3 | {% block body %}
 4 | {% endblock %}
 5 | 
 6 | 
 7 | 
 8 |  - The Audio Commons Mail Robot
 9 | 
10 | {% block footer %}{% endblock %}
11 | 


--------------------------------------------------------------------------------
/templates/emails/password_reset.txt:
--------------------------------------------------------------------------------
 1 | {% extends "emails/email_base.txt" %}
 2 | {% block salutation %}{{user.username}}{% endblock %}
 3 | 
 4 | {% block body %}
 5 | {% autoescape off %}
 6 | You're receiving this e-mail because you requested a password reset for your user account at {{domain}}.
 7 | 
 8 | Please go to the following page and choose a new password:
 9 | 
10 | {{ protocol }}://{{ domain }}{% url 'password_reset_confirm' uidb64=uid token=token %}
11 | 
12 | Your username, in case you've forgotten: {{ user.username }}
13 | {% endautoescape %}
14 | {% endblock %}


--------------------------------------------------------------------------------
/templates/emails/password_reset_subject.txt:
--------------------------------------------------------------------------------
1 | [AudioCommons] Password reset on {{ site_name }}


--------------------------------------------------------------------------------
/templates/services/test_service.html:
--------------------------------------------------------------------------------
  1 | <!DOCTYPE html>
  2 | <html lang="en">
  3 | <head>
  4 |     <meta charset="UTF-8">
  5 |     <title>Audio Commons Mediator - Test results for service {{ service.name }}</title>
  6 |     <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.5/css/bootstrap.min.css">
  7 |     <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/font-awesome/4.4.0/css/font-awesome.min.css">
  8 |     <link href='https://fonts.googleapis.com/css?family=Rajdhani:400,700' rel='stylesheet' type='text/css'>
  9 |     <link href='https://fonts.googleapis.com/css?family=Roboto:300,500' rel='stylesheet' type='text/css'>
 10 |     <style>
 11 |         body {
 12 |             font-weight: 300;
 13 |             font-family: "Roboto", sans-serif;
 14 |             font-size: 16px;
 15 |             color: #333;
 16 |             padding-top: 20px;
 17 |             padding-bottom: 20px;
 18 |             background-color: #f5f5f5;
 19 |         }
 20 | 
 21 |         .logo-background {
 22 |             z-index: -10;
 23 |             position: absolute;
 24 |             right: -30px;
 25 |             top: -60px;
 26 |             width: 500px;
 27 |             opacity: 0.15;
 28 |         }
 29 | 
 30 |         .block-center {
 31 |             max-width: 800px;
 32 |             padding: 19px 29px 29px;
 33 |             margin: 0 auto 20px;
 34 |             background-color: #fff;
 35 |             border: 1px solid #e5e5e5;
 36 |             -webkit-border-radius: 5px;
 37 |             -moz-border-radius: 5px;
 38 |             border-radius: 5px;
 39 |             -webkit-box-shadow: 0 1px 2px rgba(0,0,0,.05);
 40 |             -moz-box-shadow: 0 1px 2px rgba(0,0,0,.05);
 41 |             box-shadow: 0 1px 2px rgba(0,0,0,.05);
 42 |         }
 43 | 
 44 |         b { font-weight: 500; }
 45 | 
 46 |         p { font-size: 16px; }
 47 | 
 48 |         li { font-size: 16px; }
 49 | 
 50 |         a, a:hover, a:focus, a:active { outline: 0; color: #0F783C; }
 51 | 
 52 |         h1 {
 53 |             text-transform: uppercase;
 54 |             font-family: "Rajdhani", sans-serif;
 55 |             font-weight: 700;
 56 |             color: #1E5055;
 57 |             font-size: 2.8em;
 58 |             padding-bottom: 15px;
 59 |         }
 60 | 
 61 |         h2 {
 62 |             text-transform: uppercase;
 63 |             font-family: "Rajdhani", sans-serif;
 64 |             color: #991933;
 65 |             font-size: 2em;
 66 |             padding-bottom: 15px;
 67 |         }
 68 | 
 69 |         h3 {
 70 |             font-family: "Rajdhani", sans-serif;
 71 |             color: gray;
 72 |             font-size: 1.5em;
 73 |             font-weight: 100;
 74 |         }
 75 | 
 76 |         .json_output {
 77 |             font-family: Menlo, Consolas, "Andale Mono", "Lucida Console", monospace;
 78 |             font-weight: 100;
 79 |             font-size: 12px;
 80 |             max-height: 300px;
 81 |             word-wrap: normal;
 82 |         }
 83 | 
 84 |         .json_output p {
 85 |             font-size: 12px;
 86 |             margin: 0;
 87 |             padding: 0;
 88 |         }
 89 | 
 90 |         .test_box {
 91 |             margin-bottom: 40px;
 92 |         }
 93 |     </style>
 94 | </head>
 95 | <body>
 96 |     <div class="container">
 97 |         <div class="logo-background">
 98 |             <svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
 99 |                  width="512px" height="512px" viewBox="0 0 512 512" enable-background="new 0 0 512 512" xml:space="preserve">
100 |                 <path fill="#1E5055" d="M469.27,197.059c-7.329-2.613-26.234-6.392-43.497,14.793c-10.262,12.597-16.52,31.794-23.141,52.119
101 |                 c-5.183,15.902-14.249,43.735-22.979,50.658c-10.934-20.961-18.062-96.953-21.616-134.864c-2.042-21.774-3.97-42.338-6.194-57.333
102 |                 c-2.422-16.342-6.087-41.038-28.122-41.038c-24.061,0-30.766,24.363-52.6,117.507c-3.037,12.963-6.614,28.216-9.96,41.404
103 |                 c-8.236-14.4-17.128-26.298-32.072-26.298c-21.878,0-25.079,19.607-32.089,62.57c-2.079,12.744-5.465,33.503-9.473,50.306
104 |                 c-2.825-16.134-5.27-36.05-7.175-51.565c-8.559-69.734-14.216-115.801-47.85-115.801c-32.002,0-42.173,38.643-52.942,79.556
105 |                 c-4.098,15.566-10.863,41.263-16.271,47.716c-1.102,0.302-1.871,0.064-3.094-0.746c-5.734-3.789-11.918-16.161-11.918-29.543
106 |                 c0-114.541,93.184-207.725,207.725-207.725c64.025,0,119.732,23.463,153.273,64.388l-29.694,22.522l40.056,6.625l40.056,6.625
107 |                 l4.419-40.359l4.419-40.359l-26.33,19.971C400.865,36.91,333.078,7.5,256.002,7.5C118.703,7.5,7,119.203,7,256.502
108 |                 c0,26.234,12.23,51.945,30.43,63.977c13.215,8.74,28.535,10.111,43.161,3.89c21.622-9.211,29.62-39.6,38.885-74.786
109 |                 c2.617-9.943,6.278-23.853,10.06-34.652c4.088,18.492,7.508,46.359,9.849,65.418c8.206,66.862,13.631,111.034,45.801,111.034
110 |                 c34.904,0,43.477-52.536,52.553-108.156c0.02-0.118,0.037-0.235,0.057-0.353c7.538,12.036,16.12,21.192,29.342,21.192
111 |                 c21.73,0,25.593-16.493,44.172-95.74c1.68-7.165,3.621-15.452,5.69-24.064c10.084,107.43,18.384,173.238,58.804,173.238
112 |                 c39.768,0,54.353-44.766,66.073-80.739c4.827-14.81,10.282-31.555,15.586-38.445c3,4.155,6.261,12.009,6.261,18.186
113 |                 c0,114.538-93.184,207.722-207.722,207.722c-52.875,0-102.818-19.745-141.359-55.63l27.652-21.578l-40.143-6.075l-40.143-6.075
114 |                 l-3.865,40.416l-3.865,40.416l27.44-21.412c46.813,45.922,108.685,71.215,174.284,71.215C393.301,505.5,505,393.801,505,256.502
115 |                 C505,234.029,491.339,204.913,469.27,197.059z"/>
116 |             </svg>
117 |         </div>
118 | 
119 |         <div class="block-center">
120 | 
121 |             <h1>Audio Commons Mediator</h1>
122 |             <h2>Test results for service: {{ service.name }}</h2>
123 |             {% for component, result in components_results %}
124 |                 <h3>{{ component }}</h3>
125 |                 <div class="test_box">
126 |                     {% if result.status == 'FA' %}
127 |                        <span style="color:red;"><i class="fa fa-times" aria-hidden="true"></i> {{ result.status }}</span><br><pre class="json_output"> {{ result.formatted_response | linebreaks}} </pre>
128 |                     {% elif result.status == 'IN' %}
129 |                         <span style="color:red;">{{ result.formatted_response | linebreaks}}</span>
130 |                     {% elif result.status == 'OK' %}
131 |                         <span style="color:green;"><i class="fa fa-check" aria-hidden="true"></i> {{ result.status }}</span><br><pre class="json_output"> {{ result.formatted_response | linebreaks}} </pre>
132 |                     {% elif result.status == 'WR' %}
133 |                         <span style="color:orange;"><i class="fa fa-check" aria-hidden="true"></i> {{ result.status }}</span><br><pre class="json_output"> {{ result.formatted_response | linebreaks }} </pre>
134 |                         Warnings: <pre class="json_output"> {{ result.formatted_warnings | linebreaks }} </pre>
135 |                     {% endif %}
136 |                 </div>
137 |             {% endfor %}
138 | 
139 |         </div>
140 |     </div>
141 | </body>
142 | </html>
143 | 


--------------------------------------------------------------------------------
/utils/__init__.py:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/AudioCommons/ac-mediator/3201c12865d986fd945a1108b00ad9e85d459827/utils/__init__.py


--------------------------------------------------------------------------------
/utils/encryption.py:
--------------------------------------------------------------------------------
 1 | from django.conf import settings
 2 | import hashlib
 3 | 
 4 | 
 5 | def create_hash(data, add_secret=True, limit=16):
 6 |     m = hashlib.sha256()
 7 |     if add_secret:
 8 |         m.update((str(data) + settings.SECRET_KEY).encode('utf-8'))
 9 |     else:
10 |         m.update(str(data).encode('utf-8'))
11 |     return m.hexdigest()[0:limit]
12 | 


--------------------------------------------------------------------------------
/utils/mail.py:
--------------------------------------------------------------------------------
 1 | from django.core.mail import send_mail as django_send_email
 2 | from django.conf import settings
 3 | from django.template.loader import render_to_string
 4 | 
 5 | 
 6 | def send_mail(to_emails, from_email=settings.DEFAULT_FROM_EMAIL, subject='No subject',
 7 |               message=None, template=None, context=None, fail_silently=True):
 8 |     """Send email using Django's send_email function but setting a number of defaults and adding a
 9 |     prefix in the subject. It also renders a template with a context if provided."""
10 |     if not subject.startswith(settings.EMAIL_SUBJECT_PREFIX):
11 |         subject = settings.EMAIL_SUBJECT_PREFIX + subject
12 |     if template is not None and context is not None:
13 |         message = render_to_string(template, context)
14 |     if type(to_emails) is not list and type(to_emails) is not tuple:
15 |         to_emails = (to_emails, )
16 |     django_send_email(subject, message, from_email, to_emails, fail_silently)
17 | 


--------------------------------------------------------------------------------
/uwsgi.ini:
--------------------------------------------------------------------------------
1 | [uwsgi]
2 | master = true
3 | socket = 0.0.0.0:8000
4 | module = ac_mediator.wsgi
5 | callable = application
6 | chdir = /code/
7 | processes = 1


--------------------------------------------------------------------------------