開発環境の構築¶
BeeWareへの貢献には、開発環境のセットアップが必要です。
前提条件¶
以下の前提条件をインストールする必要があります。
BeeWare は Python 3.10+
が必要です。また、仮想環境を管理する手法（例：venv）も必要です。
インストール済みのPythonのバージョンを確認するには、次のコマンドを実行します：
$ python3 --version
複数のPythonバージョンがインストールされている場合、python3を特定のバージョン番号（例：python3.13）に置き換える必要がある場合があります。
最近リリースされたバージョンのPython（例：3.14.0のような「.0」または「.1」のマイナーバージョン番号を持つバージョン）の使用は避けることを推奨します。これは、macOS上でPythonをサポートするために必要なツールが、通常、最近リリースされた安定版のPythonバージョンでは利用できない場合が多いからです。
BeeWare は Python 3.10+
が必要です。また、仮想環境を管理する手法（例：venv）も必要です。
インストール済みのPythonのバージョンを確認するには、次のコマンドを実行します：
$ python3 --version
複数のPythonバージョンがインストールされている場合、python3を特定のバージョン番号（例：python3.13）に置き換える必要がある場合があります。
Pythonの最近リリースされたバージョン（例：3.14.0のような「.0」または「.1」のマイナーバージョン番号を持つバージョン）の使用は避けることを推奨します。これは、Linux上でPythonをサポートするために必要なツールが、通常、最近リリースされた安定版Pythonバージョンでは利用できない場合が多いからです。
BeeWare は Python 3.10+
が必要です。また、仮想環境を管理する手法（例：venv）も必要です。
インストール済みのPythonのバージョンを確認するには、次のコマンドを実行します：
C:\...>py -3 --version
複数のバージョンのPythonがインストールされている場合、-3を特定のバージョン番号（例：-python3.13）に置き換える必要がある場合があります。
Pythonの最近リリースされたバージョン（例：3.14.0のような「.0」または「.1」のマイナーバージョン番号を持つバージョン）の使用は避けることを推奨します。これは、Windows上でPythonをサポートするために必要なツールが、通常、最近リリースされた安定版Pythonバージョンでは利用できない場合が多いからです。
開発環境を設定する¶
BeeWareの開発環境を設定する推奨方法は、仮想環境を使用し、その後BeeWareの開発版とその依存関係をインストールすることです。
BeeWare リポジトリをクローンする¶
次に、GitHub上のBeeWareページに移動し、まだ行っていない場合は、リポジトリをフォークして自分のアカウントに追加してください。 次に、フォークしたリポジトリの「<> コード」ボタンをクリックします。お使いのコンピュータにGitHubデスクトップアプリケーションがインストールされている場合は、「GitHub Desktopで開く」を選択できます。そうでない場合は、表示されたHTTPS URLをコピーし、コマンドラインを使用してリポジトリをコンピュータにクローンします：
BeeWare リポジトリをフォークし、その後：
$ git clone https://github.com/<your username>/beeware.git
(あなたのGitHubユーザー名をここに置き換えてください)
BeeWare リポジトリをフォークし、その後：
$ git clone https://github.com/<your username>/beeware.git
(あなたのGitHubユーザー名をここに置き換えてください)
BeeWare リポジトリをフォークし、その後：
C:\...>git clone https://github.com/<your username>/beeware.git
(あなたのGitHubユーザー名をここに置き換えてください)
仮想環境を作成する¶
仮想環境を設定し、pip をアップグレードするには、以下を実行してください：
$ cd beeware
$ python3 -m venv .venv
$ source .venv/bin/activate
(.venv) $ python -m pip install -U pip
$ cd beeware
$ python3 -m venv .venv
$ source .venv/bin/activate
(.venv) $ python -m pip install -U pip
C:\...>cd beeware
C:\...>py -3 -m venv .venv
C:\...>.venv\Scripts\activate
(.venv) $ python -m pip install -U pip
プロンプトには現在、前に (.venv) プレフィックスが付いているはずです。
インストール BeeWare¶
ソースコードを入手したので、開発環境に(https://setuptools.pypa.io/en/latest/userguide/development_mode.html)を[編集可能なインストール]BeeWareできます。次のコマンドを実行してください：
(.venv) $ python -m pip install -U -e . --group dev
(.venv) $ python -m pip install -U -e . --group dev
(.venv) C:\...>python -m pip install -U -e . --group dev
コミット前の検証を有効にする¶
BeeWareでは、単純な問題の特定やコードフォーマットの標準化のためにpre-commitというツールを使用しています。これは、gitフックをインストールすることで実現され、gitコミットを確定する前に一連のコードリンターを自動的に実行します。pre-commitを有効にするには、以下を実行してください：
(.venv) $ pre-commit install
pre-commit installed at .git/hooks/pre-commit
(.venv) $ pre-commit install
pre-commit installed at .git/hooks/pre-commit
(.venv) C:\...>pre-commit install
pre-commit installed at .git/hooks/pre-commit
さあ、BeeWareのハッキングを始めましょう！