Got a web site? Want social network replies and likes on your site? Want to post and tweet from your site? Bridgy is for you.
Bridgy pulls comments and likes from social networks back to your web site. You can also use it to publish your posts to those networks. See the docs for more details.
License: This project is placed in the public domain.
virtualenv local source local/bin/activate pip install -r requirements.freeze.txt # We install gdata in source mode, and App Engine doesn't follow .egg-link # files, so add a symlink to it. ln -s ../../../src/gdata/src/gdata local/lib/python2.7/site-packages/gdata ln -s ../../../src/gdata/src/atom local/lib/python2.7/site-packages/atom python -m unittest discover
The last command runs the unit tests. If you send a pull request, please include (or update) a test for the new functionality if possible!
bash: ./bin/easy_install: ...bad interpreter: No such file or directory ImportError: cannot import name certs ImportError: No module named dev_appserver ImportError: cannot import name tweepy File ".../site-packages/tweepy/auth.py", line 68, in _get_request_token raise TweepError(e) TweepError: must be _socket.socket, not socket error: option --home not recognized
There's a good chance you'll need to make changes to granary, oauth-dropins, or webmention-tools at the same time as bridgy. To do that, clone their repos elsewhere, then install them in "source" mode with:
pip uninstall -y oauth-dropins pip install -e <path to oauth-dropins> ln -s <path to oauth-dropins>/oauth_dropins \ local/lib/python2.7/site-packages/oauth_dropins pip uninstall -y granary pip install -e <path to granary> ln -s <path to granary>/granary \ local/lib/python2.7/site-packages/granary pip uninstall -y webmentiontools # webmention-tools isn't in pypi ln -s <path to webmention-tools>/webmentiontools \ local/lib/python2.7/site-packages/webmentiontools
The symlinks are necessary because App Engine's
vendor module evidently
.pth files. :/
To deploy to App Engine, run
is a useful interactive Python shell that can interact with the production app's
datastore, memcache, etc. To use it,
create a service account and download its JSON credentials,
put it somewhere safe, and put its path in your
Adding a new silo
So you want to add a new silo? Maybe MySpace, or Friendster, or even Tinder? Great! Here are the steps to do it. It looks like a lot, but it's not that bad, honest.
- Find the silo's API docs and check that it can do what Bridgy needs. At minimum, it should be able to get a user's posts and their comments, likes, and reposts, depending on which of those the silo supports. If you want publish support, it should also be able to create posts, comments, likes, reposts, and/or RSVPs.
- Fork and clone this repo.
- Create an app (aka client) in the silo's developer console, grab your app's id (aka key) and secret, put them into new local files in the repo root dir, following this pattern. You'll eventually want to send them to @snarfed and @kylewm too, but no hurry.
- Add the silo to oauth-dropins if it's not already there:
- Add the silo to granary:
- Add a new
.pyfile for your silo. Follow the existing examples. At minimum, you'll need to implement
get_activities_responseand convert your silo's API data to ActivityStreams.
- Add a new unit test file and write some tests!
- Add it to
index.html, and the README.
- Add a new
- Add the silo to Bridgy:
- Add a new
.pyfile for your silo with a model class. Follow the existing examples.
- Add it to
handlers.py, (just import the module).
- Add a 24x24 PNG icon to
- Add new
templates/. and add the silo to
listen_signup.html. Follow the existing examples.
- Add the silo to
about.htmland this README.
- If users' profile picture URLs can change, add a cron job that updates them
cron.yaml. Also add the model class to the datastore backup job there.
- Add a new
- Optionally add publish support:
Good luck, and happy hacking!
For alerting, we've set up Google Cloud Monitoring (née Stackdriver). Background in #377. It sends alerts by email and SMS when HTTP 4xx responses average >.1qps or 5xx >.05qps, latency averages >15s, or instance count averages >5 over the last 15m window.
The datastore is automatically backed up by a
Datastore Admin backup
and stores the results in
Cloud Storage, in the
It backs up all entities monthly, and all entities except
SyndicatedPost weekly, since they make up 92% of all entities by size and
they aren't as critical to keep.
We use this command to set a Cloud Storage lifecycle policy on that bucket that prunes older backups:
gsutil lifecycle set cloud_storage_lifecycle.json gs://brid-gy.appspot.com
Run this to see how much space we're currently using:
gsutil du -hsc gs://brid-gy.appspot.com/\*
Run this to download a single complete backup, for e.g. generating usage metrics
gsutil -m cp -r gs://brid-gy.appspot.com/weekly/datastore_backup_full_YYYY_MM_DD_\* .