Pythonプロジェクトをインストールするsetup.pyを使用して簡単

最近のプロジェクトはすぐに弟を変更し、setup.pyは間違った場所に速やかに大物ください場合は、記事に編成個人の理解を追加するためにいくつかの情報を収集するために、プロジェクトをビルドするために、この便利なツールをインストールする必要があります。以下の説明では、正式にsetup.pyに入っ説明します。

1.私たちはPythonのパッケージにパッケージ化され、私たちのプロジェクトにsetup.pyを使用するので、最初に我々はパッケージフォルダを作成する必要があるため、パッケージは形式を命名次のパッケージのバージョンに従って命名されています。

  NN [.N] + [{| B | C | RC} N [.N] +] [DEVN。] [POSTN。】

    説明:

  「NN」は、2つの「N」の一部であるとメイン基板とサブバージョン番号の存在を表します。

  「[.N]」:マイナーバージョン番号は、ゼロ個以上を持つことができます。

  "{A | B | C | RC}" コード位相、必要に応じて、A、B、C、RC表すアルファ、ベータ、候補とリリース候補。

  「N [.N]」:ステージのバージョン番号は、提供される場合、少なくとも一つのメジャーバージョン番号があり、後者は、マイナーバージョン番号の数に制限を追加することができます。

  「.PostN」:更新されたバージョン番号、オプションのリリース後。

  「.DevN」:オプションの開発中のリリース番号、。

 注:可能な限りすべて小文字に関与するという名前の上記(私がテストしたときには、このことの具体的な状況に応じて、何の問題もなく、すべて小文字です)。

バージョン番号を確認するためにパッケージした後、我々は、それらのファイルが含まれている必要がありますどのパッケージを把握するために、標準CHANGES.rstを含める必要があり、パッケージ、LICENSE、MANIFEST.in、README.rst、setup.py、のsetup.cfg、SRCを(2.必要いくつかの記事を紹介しますフォルダを含む__init__.pyファイル)は、他のファイルを持っているかもしれないが、これらのファイルは、基本的には何の問題もされていません。

3.パッケージ内のファイルへの導入後、我々は、各ファイルの特定の役割を見てください。

  MANIFEST.in:例えば、書き込みを探すためにパッケージを配布する必要のあるパス配布パッケージ内のファイルを含める必要があります:    

    
1 MANIFEST含まれています。 
2再帰含まSRC / *
コードの表示

  setup.cfg:主にデフォルトパラメータを提供するために使用さsetup.pyファイルには、私は他のニーズがある場合、あなたはを参照することができ、PIPミラー元アドレスを埋めるために使用されたhttps://docs.python.org/3/ distutilsの/ configfile.html    

    
【easy_installを】
Index_url = http://pypi.douban.com/simple
コードの表示

  SRC:ソースコードを含む、__init__.pyファイルを含むフォルダは、主にsetup.pyファイルパッケージのために、さらにパッケージ化する必要がありますfind_packages()このパラメータを。

  setup.py:主に書かれたが、我々がするために使用されるいくつかの基本的なパラメータを導入し、ここで、いくつかのパッケージ構成情報をインストールする必要があります。

    名前:パッケージの名前、ときに、この名前照会の世話をする必要があります。

    バージョン:パッケージのバージョン番号。

    ライセンス:プログラムについてのライセンス情報。

    説明:プログラムの簡単な説明。

    LONG_DESCRIPTION:番組の詳細な説明。

    筆者:プログラムの作者。

    auther_email:著者のメールボックス。

    パッケージ:パッケージ内容は、対処する(フォルダが含まれている__init__.pyファイル)を必要とするが、一般的にfind_packages()関数を使用することができ、それは、setup.pyに、同じディレクトリの下に__init__.pyを含まれる各バッグを検索デフォルト設定されますあなたが特定のパケットを除外することができ、find_packagesは(=除外[ "*の.text" を、...])。

    install_requires:依存関係は、この値がリストファイルである必要があり、インストールする必要があります。

    DOWNLOAD_URL:プログラムをダウンロードしてください。

    package_data:パッケージには、指定したデータファイルの中に含まれている必要があります。

    DATA_FILES:なように絵、コンフィギュレーションファイル、およびなど、必要なパッケージパックされたデータファイル。

    setup_requiresは:自身がパッケージを依存setup.pyファイルを実行するために指定します。

    include_package_data:このパラメータが自動的にバージョンコントロールにより、パッケージデータファイルを追加するには、Trueに設定されている(私も知って取得していないが、通常はTrueに設定され、大きな神は理解して私を教えることができ、感謝!)。

    zip_safe:このパラメータは、zipファイル圧縮のインストールの卵としてパッケージかどうか、またはツールとしていくつかは、zipファイルをサポートしていないため、および圧縮されたパッケージは、最後の.eggインストールするには、debugディレクトリに容易ではない、それが提案されています。 Falseに設定します。

    entry_points:entry_pointsにおける動的サービス発見およびプラグ、console_scriptsは、次のコード例のようなコマンドラインツールの名前を指定し、等号は、プログラムのエントリアドレスを示した後に、名前の前に等号は、キットの内容を示しますあなたが複数のレコードを持つことができ、ここでは、そのようなプロジェクトは、複数のコマンドラインツールを作成することができます。私たちは、対応するプログラムを起動するときに、ちょうど等号ツールキットの前に名前を入力します。  

      
1つの セットアップ(
 2      ..... 
3      entry_points = {
 4          " console_scripts " 5               " SERVICE_NAME = service.main " 6               .................... 。
 7           ]   
 8      }   
 9  
10
コードの表示

4.私は、プロジェクトの一般的なルーチンを完了するために、setup.pyファイルを作るもの以上のものを仕上げ、そしてあなたは、特定のパラメータは、以下のウェブサイトを参照することができ、他の機能を追加する必要がある場合:

  http://blog.konghy.cn/2018/04/29/setup-dot-py/

  https://docs.python.org/3/distutils/setupscript.html

    

おすすめ

転載: www.cnblogs.com/yangwm/p/11243346.html