7

他のPythonモジュールを読んでいると、多くの人がソースファイルにグローバル変数を含めることがよくあり__version__ます__author__（PEP3001でも言及されています）。これらの変数の妥当なセットを使用してコードを文書化したいと思います。一般的に含まれる可能性のあるグローバル変数のリストは何ですか？

4

2 に答える 2

2

これらのグローバル変数には特定の標準はありません-リンクした PEP に記載されているように、それらは標準を達成するための試みでしたが、特異な形で普遍的に受け入れられるようにはなりませんでした。

実際の標準は PyPI メタデータでありsetup.py、モジュールのファイルでdistutils(または互換性のあるインターフェイスを使用して) 指定されています。以下は、パッケージング チュートリアルの例です。

from distutils.core import setup

setup(
    name='TowelStuff',
    version='0.1.0',
    author='J. Random Hacker',
    author_email='jrh@example.com',
    packages=['towelstuff', 'towelstuff.test'],
    scripts=['bin/stowe-towels.py','bin/wash-towels.py'],
    url='http://pypi.python.org/pypi/TowelStuff/',
    license='LICENSE.txt',
    description='Useful towel-related stuff.',
    long_description=open('README.txt').read(),
    install_requires=[
        "Django >= 1.1.1",
        "caldav == 0.1.4",
    ],
)

http://guide.python-distribute.org/creation.html

于 2013-01-21T17:34:48.507 に答える
1

代わりにdistutils(またはスーパーセットsetuptools) を使用して、プロジェクトに関するメタデータを提供してください。

特に を使用する場合、そのメタデータはモジュールsetuptoolsを介して検出および再利用できます。pkg_resources

などのグローバル変数の標準はなく__version__、Python stdlib についてさえありません。そのため、Python 3 の stdlib でこのメタデータを提供する努力は何の成果も上げていません。

プロジェクトを適切にパッケージ化する方法の入門書として、 Python Packaging User Guideをお勧めします。

于 2013-01-21T17:35:57.997 に答える