Cover Art Archive URL redirect service
This service will redirect from
coverartarchive.org URLs to
archive.org URLs, taking into account MBID redirects
caused by release merges.
For example, this URL:
should redirect to:
There are two ways of setting up the server: with and without Docker. First option might be easier if you are just getting started. Second requires having a MusicBrainz database set up on your machine.
Option 1: Docker-based
$ docker-compose -f docker/docker-compose.dev.yml up --build
After all Docker images start you should be able to access the web server at
Note: Keep in mind that any changes that you make won't show up until the server container is recreated. To do that you can simply stop the server (Ctrl + C) and run the command above again.
Option 2: Manual
CAA redirect server works with Python 3, so make sure that you have it installed. Create a virtual environment, if necessary.
Install all required packages using pip:
$ pip install -r requirements.txt
Copy config.default.ini to config.ini and adjust configuration values. You'd want to set up a connection to the instance of PostgreSQL with a MusicBrainz database that you should already have running.
Finally, run the artwork_redirect_server.py script to start the server.
All logging goes to stdout, including stacktraces, so its suitable for running inside of daemontools.
Currently some tests depend on an actual MusicBrainz database running in the background, so make sure to follow the setup process first. We use Pytest as a test runner. All tests can be run with the following command:
There are more ways to use Pytest (for example, to run only tests for a specific module). Check their documentation to see what kinds of additional options you have.
With Docker you can run all the tests like this:
$ docker-compose -f docker/docker-compose.test.yml up --build
You should see test results in the output.