面向人类的软件元数据
about的Python项目详细描述
summary:在一个地方定义项目的元数据,然后 使其在安装时和运行时可用。
让我们以about包为例;我们将 项目文件,在源树中,一个名为about.py的文件 包含项目的元数据:
about |--- setup.py |--- README.md |... |--- about | |--- __init__.py | |... | |--- about.py
此文件包含元数据(和一些样板):
# coding: utf-8 metadata = dict( __name__ = "about", __version__ = "5.1.1", __license__ = "MIT License", __author__ = u"Sébastien Boisgérault <Sebastien.Boisgerault@gmail.com>", __url__ = "https://warehouse.python.org/project/about", __summary__ = "Software Metadata for Humans", __keywords__ = "Python / 2.7, OS independent, software development" ) globals().update(metadata) __all__ = metadata.keys()
setup.若要使用此元数据,setup.pyfile包含 代码:
import about import about.about info = about.get_metadata(about.about) # add extra information (contents, requirements, etc.). info.update(...) if __name__ == "__main__": setuptools.setup(**info)
runtime.元数据存储为 about.about模块。如果我们包含在about/__init__.py文件中 一行
from .about import *
它们在顶级模块中可用:
>>> import about >>> print about.__name__ about >>> print about.__version__ 5.1.1 >>> print about.__license__ MIT License