導入

PyFabricate は、Python プロジェクトの作成を簡素化する Mac OS X アプリケーションです。 これは私が作成したものであるため、明らかに、これは私が考える Python プロジェクトのあるべき姿を独自に解釈したものです。 さらに、Python Mac OS X アプリケーションを作成できるようにするために使用する特定のツールセットもあります。 ただし、プロジェクト ファイルの作成元となるテンプレートを公開して、少しカスタマイズしてみました。 これについては後ほど詳しく説明します。

概要

PyFabricate はウィザードのようなインターフェイスを使用してプロジェクトの詳細をクエリします。

独断的な仮定

• 開発者は HomeBrew を使用して独自の依存関係をインストールします。

  • Python は pyenv 経由で管理されます (作成された仮想環境で使用するため)
  • direnv がインストールされています (オプション)

• プロジェクト名はモジュールのパッケージ名と同じです

インストール

ここから現在のリリースを入手してください。

このファイルを Mac OS アプリケーション フォルダにコピーします。 アプリケーションは Apple コードで署名されているため、初めて実行するときに承認を求める簡単なメッセージが表示されます。

プロジェクトのスケルトンの詳細

以下は、PyFabricator が作成する初期スケルトンのサンプルです。 作成した仮想環境が表示されるようになりました。 これについては後ほど詳しく説明します。

基本的に、PyFabricate は src ディレクトリと testing ディレクトリを作成します。 プロジェクトのルート ディレクトリに次のファイルが作成されます:

• .envrc
• .gitignore
• .mypi.ini
• .python_version
• 。ライセンス
• README.md
• pyproject.toml
• requirements.txt

さらに、PyFabricate は、すべての Python パッケージ ファイル (__init__.py) をすべての適切な場所に作成します。 最後に、アプリケーション用と単体テスト用の 2 セットのロギング構成ファイルを配置します。

製造の最後に、PyFabricate は Python 仮想環境を作成します。技術的な制限のため、PyFabricate は Python の pyenv バージョンを使用して仮想環境を作成できません。 したがって、Homebrew がインストールされているバージョンに依存します。

ウィザードUI

ウィザード UI は 4 ステップのプロセスであり、PyFabricate がスケルトン テンプレートの作成に使用する十分なプロジェクトの詳細を収集します。 テンプレートでは、次の一目瞭然の置換トークンを使用します。

以下は、pyroject.toml テンプレートの注釈付きグラフィックです。

ウィザード UI ステップ 1 - はじめに

このステップは PyFabricate の概要です。 このステップの後、PyFabricate は実行依存関係が満たされていることを確認するために最善の努力を行います。 そうでない場合、開発者はこのステップ以降に進むことができません。

ウィザード UI ステップ 2 - プロジェクトの詳細

このステップで、PyFabricate はプロジェクト固有の情報を収集します。 このほとんどは、pyproject.toml テンプレートを設定するために使用されます。

ウィザード UI ステップ 3 - ベース ディレクトリ

PyFabricate は、開発者がすべての Python プロジェクトを 1 つのサブディレクトリに保存していることを前提としています。 これは独断的な見解であり、単に組織の好みにすぎません。

ウィザード UI ステップ 4 - Python バージョン

PyFabricate は、開発者がインストールした Python バージョンについて pyenv をクエリします。 これらは、PyFabricate が Python 仮想環境を作成できる唯一のものです。

アクションログ

ウィザードの最後に、PyFabricate はプロジェクトの作成時にログを表示します。 以下はログの例です。

カスタマイズ

前述したように、開発者はプロジェクト生成のいくつかの側面をカスタマイズできます。 PyFabricate は、以下に示すように、使用するテンプレートを $HOME/.config/pyfabricate/templates に保存します。

たとえば、開発者は異なるライセンスを使用したい場合があります。 LICENSE.template ファイル

まとめ

PyFabricate は現在バージョン 0.5.0 のみです。 現在、機能の追加と制限の解除を検討中です。