metabrainz.org

Metabrainz Foundationのウェブサイト。これは、財団とそのサポーターに関する情報を提供し、ユーザーと組織からの寄付を受け入れ、MusicBrainzのレプリケーションパケットへのアクセスを提供するフラスコベースのWebアプリケーションです。

リリースを行う

他のPythonbrainzと同様に、このリポジトリには、リリースを支援するGitHubアクションセットアップもあります。 Docker画像が構築され、GitHubからリリースが行われるたびにDocker Hubにプッシュされます。以下は、リリースを行うための手順です。

1. [リリース]ページに移動します。リリースの詳細については、こちらをご覧ください。
2. 上部にDraftリリースが表示されるはずです。その横のEditボタンをクリックします。
3. Tag Versionフィールドに、タグ付けするドッカーイメージに必要なタグを入力します。たとえば、 v-2021-06-08.0をタグとして入力すると、対応するDocker画像はmetabrainz/metabrainz:v-2021-06-08.0です。
4. Publish releaseをクリックします。

注記：

1. ビルドのステータスは、アクションページから確認できます。
2. リリースタイトルフィールドは、アクションによって無視されます。それは私たちが望むあらゆる価値に設定することができます。通常、そのリリースのタグに設定します。
3. リリースの説明は、マスターに直接プッシュされた合併PRSのタイトルでのみ更新されます。

開発セットアップ

開発のためにMetabrainz Webサイトを設定する最も簡単な方法は、Dockerを使用することです。指示に従う前に、マシンにインストールされていることを確認してください。

構成

アプリの構成は、 config.pyというファイルに保存する必要があります。例（ config.py.example ）を使用して、構成を微調整できます。

 $ cp config.py.example config.py
$ vim config.py

必要な変数が設定されていることを確認する必要があります。

MusicBrainz Oauth

ユーザーがログインできるようにするには、 MUSICBRAINZ_CLIENT_IDとMUSICBRAINZ_CLIENT_SECRET 2つのキーを設定する必要があります。これらのキーを取得するには、https://musicbrainz.org/account/applications/registerのMetabrainz.orgのインスタンスをMusicBrainzに登録する必要があります。 callback urlフィールドをhttp://<your host>/login/musicbrainz/postに設定します（configファイルのPREFERRED_URL_SCHEMEがhttpsに設定されている場合、コールバックURLについて同じプロトコルを指定してください）。サーバーをローカルに実行する場合は、 <your host>をlocalhostに置き換えます。

支払い

次は、支払いシステムの構成です。 PayPalとStripeを使用して、財団への支払いを受け入れます。 PayPal_account_ids辞書には、サポートされている各通貨のアカウントのPayPal IDまたは電子メールアドレスが含まれています。 PayPal_Businessは、非義務のアドレスです。そこに送られたすべての支払いは無視されます。

これらの設定が設定された後、テストモード内で構成が適切に動作していることを確認してください。スイッチをフリップできます。デバッグをFalseに設定し、 payment_productionをTrueに設定します。警告！開発目的では、デバッグモードでのみ支払いを使用する必要があります。

レプリケーションパケットのサービング

レプリケーションパケットは./data/replication_packets replication_packetsディレクトリにコピーする必要があります。次の構造が必要です。

 ./data/replication_packets/
    - hourly replication packets

起動する

このコマンドは、開発に使用できるすべてのサービスを構築および開始します。

 $ ./develop.sh

アプリケーションを初めて設定したときは、データベースを初期化する必要があります。

 $ ./develop.sh manage init-db --create-db

Webサーバーは、http：// localhost：80/でアクセスできるようになりました。

構築スタイルのシート

Dockerとの開発環境の動作により、画像の構築とは別にCSSを構築する必要があります。そのためには、開発サーバー（Dockerが構成したすべてのコンテナ）を起動し、 webコンテナに接続する必要があります。

$ ./develop.sh exec -it web bash

次に、NPMモジュールをインストールし、CSSを構築します。

web# npm install
web# ./node_modules/.bin/lessc ./metabrainz/static/css/main.less > ./metabrainz/static/css/main.css
web# ./node_modules/.bin/lessc ./metabrainz/static/css/theme/boostrap/boostrap.less > ./metabrainz/static/css/theme/boostrap/boostrap.css
web# ./node_modules/.bin/lessc ./metabrainz/static/fonts/font_awesome/less/font-awesome.less > ./metabrainz/static/fonts/font_awesome/less/font-awesome.css

最後の2つのビルドは、管理インターフェイスを使用することを計画している場合にのみ必要です。

翻訳

文字列を抽出します

上記のようにすべてのサービスを構築して開始したら、実行してください。

$ ./develop.sh manage extract-strings

文字列をコンパイルします

ポットファイルは、サービスが構築されるたびに自動的にコンパイルされますが、ポットファイルに変更を加えて翻訳ファイルを再度コンパイルする場合は、実行します。

$ ./develop.sh manage compile-translations

テスト

すべてのテストを実行するには：

 $ ./test.sh

支払いのテスト

何かをする前に、構成ファイルのPAYMENT_PRODUCTION変数がFalseに設定されていることを確認してください！これにより、クレジットカードと銀行口座が実際に請求されないテスト環境を使用します。各支払いサービスのテスト環境に関する詳細については、ドキュメントをご覧ください。

• Paypal：https：//developer.paypal.com/webapps/developer/docs/
• ストライプ：https：//stripe.com/docs/testing

IPNが機能するには、アプリケーションが公開されている必要があることに注意してください。ローカルマシンで開発を行っている場合、コールバックエンドポイントが支払いプロセッサに到達できない可能性があります。