Got an IndieWeb site? Want to interact with federated social networks like Mastodon, Hubzilla, and more? Bridgy Fed is for you.
 
 
 
 
Go to file
Ryan Barrett 2854b08862 migrate to circleci 2.0
https://circleci.com/docs/2.0/
2018-09-20 18:21:06 -07:00
.circleci migrate to circleci 2.0 2018-09-20 18:21:06 -07:00
static web: remove unnecessary h-card from link to my site 2018-03-20 10:55:07 -07:00
templates webmention: refactor storing Responses so we can do it earlier 2017-10-26 12:31:04 -07:00
test Use the acct: URI for this domain, if in h-card 2018-04-16 11:10:03 -05:00
.gitignore
README.md update docs to better handle gcloud SDK 2018-09-20 13:24:43 -07:00
activitypub.py fix logging for failed outbound HTTP requests 2017-10-24 18:27:07 -07:00
add_webmention.py
app.yaml app.yaml: use includes to reuse builtins and skip_files from webutil 2018-04-30 06:39:22 -07:00
appengine_config.py activitypub: point actor ids to bridgy fed, not source web site 2017-10-23 21:57:08 -07:00
common.py webmention: if u-url is missing, default to source url 2017-12-12 18:07:12 -08:00
logs.py webmention: refactor storing Responses so we can do it earlier 2017-10-26 12:31:04 -07:00
models.py minor tweak to fix /log 2017-10-26 17:31:40 -07:00
render.py
requirements.freeze.txt bump a few dependency versions 2018-09-20 18:17:14 -07:00
requirements.txt tell circle we need mox3 2018-03-24 21:15:47 -07:00
salmon.py activitypub: prefer id over url for inReplyTo and Like/Announce object 2017-10-23 21:23:33 -07:00
webfinger.py Use the acct: URI for this domain, if in h-card 2018-04-16 11:10:03 -05:00
webmention.py only email me on successful webmentions, not all 2018-04-02 09:36:09 -07:00

README.md

Bridgy Fed Circle CI Coverage Status

Got an IndieWeb site? Want to interact with federated social networks like Mastodon, Hubzilla, and more? Bridgy Fed is for you.

https://fed.brid.gy/

Bridgy Fed connects the IndieWeb with federated social networks using ActivityPub and OStatus. Original design docs:

License: This project is placed in the public domain.

Development

First, install the Google Cloud SDK (aka gcloud) with the gcloud-appengine-python and gcloud-appengine-python-extras components.

Once you've done that, run this to find the App Engine libraries directory:

gcloud info | grep -o -E '/[^:]+google_appengine'

(If that doesn't output anything, try just gcloud info, look in the Python PATH section, and try to find the App Engine directory.)

Add that directory to your $PYTHONPATH, e.g. export PYTHONPATH=$PYTHONPATH:/opt/homebrew-cask/Caskroom/google-cloud-sdk/latest/google-cloud-sdk/platform/google_appengine. Then, run:

virtualenv local
source local/bin/activate
pip install -r requirements.txt
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 you hit an error during setup, check out the oauth-dropins Troubleshooting/FAQ section. For searchability, here are a handful of error messages that have solutions there:

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

You may need to change granary, oauth-dropins, webmention-tools, mf2util, or other dependencies as well as as Bridgy Fed. To do that, clone their repo locally, then install them in "source" mode with e.g.:

pip uninstall -y granary
pip install -e <path to granary>
ln -s <path to granary>/granary \
  local/lib/python2.7/site-packages/granary

The symlinks are necessary because App Engine's vendor module evidently doesn't follow .egg-link or .pth files. :/

To deploy to the production instance on App Engine - if @snarfed has added you as an owner - run:

gcloud -q app deploy --project bridgy-federated *.yaml

Compatibility

Here are in progress notes on how I'm testing interoperability with various federated social networks.

ActivityPub

Salmon