kopia lustrzana https://github.com/snarfed/bridgy-fed
99 wiersze
5.2 KiB
Markdown
99 wiersze
5.2 KiB
Markdown
<img src="https://raw.github.com/snarfed/bridgy-fed/main/static/bridgy_fed_logo.png" width="120" /> [Bridgy Fed](https://fed.brid.gy/) [](https://circleci.com/gh/snarfed/bridgy-fed) [](https://coveralls.io/github/snarfed/bridgy-fed?branch=main)
|
|
===
|
|
|
|
Bridgy Fed connects your web site to [Mastodon](https://joinmastodon.org) and the [fediverse](https://en.wikipedia.org/wiki/Fediverse) via [ActivityPub](https://activitypub.rocks/), [webmentions](https://webmention.net/), and [microformats2](https://microformats.org/wiki/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](https://fed.brid.gy/docs) for more details.
|
|
|
|
https://fed.brid.gy/
|
|
|
|
Also see the [original](https://snarfed.org/indieweb-activitypub-bridge) [design](https://snarfed.org/indieweb-ostatus-bridge) blog posts.
|
|
|
|
License: This project is placed in the public domain.
|
|
|
|
|
|
Development
|
|
---
|
|
Pull requests are welcome! Feel free to [ping me in #indieweb-dev](https://indieweb.org/discuss) with any questions.
|
|
|
|
First, fork and clone this repo. Then, install the [Google Cloud SDK](https://cloud.google.com/sdk/) and run `gcloud components install beta cloud-datastore-emulator` to install the [datastore emulator](https://cloud.google.com/datastore/docs/tools/datastore-emulator). Once you have them, set up your environment by running these commands in the repo root directory:
|
|
|
|
```sh
|
|
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:
|
|
|
|
```shell
|
|
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:
|
|
|
|
```shell
|
|
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](https://github.com/snarfed/oauth-dropins#troubleshootingfaq). For searchability, here are a handful of error messages that [have solutions there](https://github.com/snarfed/oauth-dropins#troubleshootingfaq):
|
|
|
|
```
|
|
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](https://github.com/snarfed/granary), [oauth-dropins](https://github.com/snarfed/oauth-dropins), [mf2util](https://github.com/kylewm/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.:
|
|
|
|
```sh
|
|
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:
|
|
|
|
```sh
|
|
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](https://bridgy.readthedocs.io/#stats). Here's how.
|
|
|
|
1. [Export the full datastore to Google Cloud Storage.](https://cloud.google.com/datastore/docs/export-import-entities) 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](https://cloud.google.com/datastore/docs/export-import-entities#limitations):
|
|
> _Data exported without specifying an entity filter cannot be loaded into BigQuery._
|
|
1. Wait for it to be done with `gcloud datastore operations list | grep done`.
|
|
1. [Import it into BigQuery](https://cloud.google.com/bigquery/docs/loading-data-cloud-datastore#loading_cloud_datastore_export_service_data):
|
|
|
|
```
|
|
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
|
|
```
|
|
1. Check the jobs with `bq ls -j`, then wait for them with `bq wait`.
|
|
1. [Run the full stats BigQuery query.](https://console.cloud.google.com/bigquery?sq=664405099227:58879d2908824a21b737eee98fff2de8) Download the results as CSV.
|
|
1. [Open the stats spreadsheet.](https://docs.google.com/spreadsheets/d/1OtOZ2Rb4EqAGEp9rHziWkyJD4BaRFb_971KjOqMKePA/edit) Import the CSV, replacing the _data_ sheet.
|
|
1. Check out the graphs! Save full size images with OS or browser screenshots, thumbnails with the _Download Chart_ button.
|