Provides a command line tool to synchronize web site redirects with an Amazon S3 bucket.
pip install s3redirect
You can also use
easy_install, download the source and run
python setup.py install, or use
s3redirect.py as a standalone script.
From the command line:
s3redirect [options] redirects bucket
The script takes two arguments:
redirects: a file containing a list of key names and redirect locations, separated by a space and listed one per line
bucket: name of Amazon S3 bucket
For more information, run
What it does
The S3 bucket is examined, any new redirects are set, and any modified
redirects are updated. With the
--delete option, all other redirects
are removed from the server. Regular files (that do not send a redirect
header) are not deleted.
If there is already a file in your bucket with the same name as one of your redirects, the file will be overwritten.
The redirect file
Each line of the redirect field
should have two fields with a space between them.
The first field contains the S3 key which should contain the redirect.
The second field contains the redirect location, which must begin with
old-blog/ /new-blog/ google.html http://google.com 2001/resolutions.html http://en.wikipedia.org/wiki/Resolution
Note that regular expressions and wildcards are not allowed.
The script reads your Amazon credentials from a file;
~/.awssecret by default.
The first line should be your access key and the second should be your
Using s3redirect with another sync tool
This script will only add and remove redirects, so it is safe to use alongside another sync tool. If the other sync tool deletes files from the bucket that have been removed from the local disk, the redirects may be deleted each time the other sync tool is used.
One workaround is to create an empty file in the position of each redirect. Under most circumstances, this will prevent other tools from deleting the redirects that s3redirect creates.