ab1c28ee4d
remaining: $ flake8 --extend-ignore=E501 *.py tests/*.py "pyflakes" failed during execution due to "'FlakesChecker' object has no attribute 'NAMEDEXPR'" Run flake8 with greater verbosity to see more details activitypub.py:15:1: F401 'oauth_dropins.webutil.util.json_loads' imported but unused activitypub.py:36:1: F401 'web' imported but unused activitypub.py:48:1: E302 expected 2 blank lines, found 1 activitypub.py:51:9: F811 redefinition of unused 'web' from line 36 app.py:6:1: F401 'flask_app.app' imported but unused app.py:9:1: F401 'activitypub' imported but unused app.py:9:1: F401 'convert' imported but unused app.py:9:1: F401 'follow' imported but unused app.py:9:1: F401 'pages' imported but unused app.py:9:1: F401 'redirect' imported but unused app.py:9:1: F401 'superfeedr' imported but unused app.py:9:1: F401 'ui' imported but unused app.py:9:1: F401 'webfinger' imported but unused app.py:9:1: F401 'web' imported but unused app.py:9:1: F401 'xrpc_actor' imported but unused app.py:9:1: F401 'xrpc_feed' imported but unused app.py:9:1: F401 'xrpc_graph' imported but unused app.py:9:19: E401 multiple imports on one line models.py:19:1: F401 'oauth_dropins.webutil.util.json_loads' imported but unused models.py:364:31: E114 indentation is not a multiple of four (comment) models.py:364:31: E116 unexpected indentation (comment) protocol.py:17:1: F401 'oauth_dropins.webutil.util.json_loads' imported but unused redirect.py:26:1: F401 'oauth_dropins.webutil.util.json_loads' imported but unused web.py:18:1: F401 'oauth_dropins.webutil.util.json_loads' imported but unused webfinger.py:13:1: F401 'oauth_dropins.webutil.util.json_loads' imported but unused webfinger.py:110:13: E122 continuation line missing indentation or outdented webfinger.py:111:13: E122 continuation line missing indentation or outdented webfinger.py:131:13: E122 continuation line missing indentation or outdented webfinger.py:132:13: E122 continuation line missing indentation or outdented webfinger.py:133:13: E122 continuation line missing indentation or outdented webfinger.py:134:13: E122 continuation line missing indentation or outdented tests/__init__.py:2:1: F401 'oauth_dropins.webutil.tests' imported but unused tests/test_follow.py:11:1: F401 'oauth_dropins.webutil.util.json_dumps' imported but unused tests/test_follow.py:14:1: F401 '.testutil.Fake' imported but unused tests/test_models.py:156:15: E122 continuation line missing indentation or outdented tests/test_models.py:157:15: E122 continuation line missing indentation or outdented tests/test_models.py:158:11: E122 continuation line missing indentation or outdented tests/test_web.py:12:1: F401 'oauth_dropins.webutil.util.json_dumps' imported but unused tests/test_web.py:17:1: F401 '.testutil' imported but unused tests/test_web.py:1513:13: E128 continuation line under-indented for visual indent tests/test_web.py:1514:9: E124 closing bracket does not match visual indentation tests/testutil.py:106:1: E402 module level import not at top of file tests/testutil.py:107:1: E402 module level import not at top of file tests/testutil.py:108:1: E402 module level import not at top of file tests/testutil.py:109:1: E402 module level import not at top of file tests/testutil.py:110:1: E402 module level import not at top of file tests/testutil.py:301:24: E203 whitespace before ':' tests/testutil.py:301:25: E701 multiple statements on one line (colon) tests/testutil.py:301:25: E231 missing whitespace after ':' |
||
---|---|---|
.circleci | ||
.github | ||
docs | ||
scripts | ||
static | ||
templates | ||
tests | ||
.gcloudignore | ||
.gitignore | ||
README.md | ||
activitypub.py | ||
app.py | ||
app.yaml | ||
appengine_config.py | ||
common.py | ||
config.py | ||
convert.py | ||
flask_app.py | ||
follow.py | ||
index.yaml | ||
indieauth_client_id | ||
lexicons | ||
models.py | ||
oauth_dropins_fonts | ||
oauth_dropins_static | ||
pages.py | ||
protocol.py | ||
redirect.py | ||
requirements.txt | ||
superfeedr.py | ||
ui.py | ||
web.py | ||
webfinger.py | ||
xrpc_actor.py | ||
xrpc_feed.py | ||
xrpc_graph.py |
README.md
Bridgy Fed
Bridgy Fed connects your web site to Mastodon and the fediverse via ActivityPub, webmentions, and microformats2. Your site gets its own fediverse profile, posts and avatar and header and all. Bridgy Fed translates likes, reposts, mentions, follows, and more back and forth. See the user docs and developer docs for more details.
Also see the original design blog posts.
License: This project is placed in the public domain.
Development
Development reference docs are at bridgy-fed.readthedocs.io. Pull requests are welcome! Feel free to ping me in #indieweb-dev with any questions.
First, fork and clone this repo. Then, install the Google Cloud SDK and run gcloud components install beta cloud-datastore-emulator
to install the datastore emulator. Once you have them, set up your environment by running these commands in the repo root directory:
gcloud config set project bridgy-federated
python3 -m venv local
source local/bin/activate
pip install -r requirements.txt
Now, run the tests to check that everything is set up ok:
gcloud beta emulators datastore start --use-firestore-in-datastore-mode --no-store-on-disk --host-port=localhost:8089 --quiet < /dev/null >& /dev/null &
python3 -m unittest discover
Finally, run this in the repo root directory to start the web app locally:
GAE_ENV=localdev FLASK_ENV=development flask run -p 8080
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.
You may need to change granary, oauth-dropins, 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>
To deploy to the production instance on App Engine - if @snarfed has added you as an owner - run:
gcloud -q beta app deploy --no-cache --project bridgy-federated *.yaml
Stats
I occasionally generate stats and graphs of usage and growth via BigQuery, like I do with Bridgy. Here's how.
-
Export the full datastore to Google Cloud Storage. Include all entities except
MagicKey
. Check to see if any new kinds have been added since the last time this command was run.gcloud datastore export --async gs://bridgy-federated.appspot.com/stats/ --kinds Follower,Response
Note that
--kinds
is required. From the export docs:Data exported without specifying an entity filter cannot be loaded into BigQuery.
-
Wait for it to be done with
gcloud datastore operations list | grep done
. -
for kind in Follower Response; do bq load --replace --nosync --source_format=DATASTORE_BACKUP datastore.$kind gs://bridgy-federated.appspot.com/stats/all_namespaces/kind_$kind/all_namespaces_kind_$kind.export_metadata done
-
Check the jobs with
bq ls -j
, then wait for them withbq wait
. -
Run the full stats BigQuery query. Download the results as CSV.
-
Open the stats spreadsheet. Import the CSV, replacing the data sheet.
-
Check out the graphs! Save full size images with OS or browser screenshots, thumbnails with the Download Chart button.