一个简单的包装工具简单的包。
flit的Python项目详细描述
flit是将python包和模块放在pypi上的简单方法。
安装
$ python3 -m pip install flit
flit需要python 3,因此需要使用python3安装 pip的版本。
Python2模块可以使用flit进行分发,但需要在 python 3没有错误。
用法
假设您正在编写一个模块foobar-或者作为单个文件foobar.py, 或者作为一个目录-你想分发它。
确保foobar的docstring以 模块是,并且它有一个__version__:
"""An amazing sample package!"""__version__='0.1'
如果您还没有安装flit:
python3 -m pip install flit
运行flit init创建pyproject.toml文件。它看起来像什么 像这样:
[build-system]requires=["flit"]build-backend="flit.buildapi"[tool.flit.metadata]module="foobar"author="Sir Robin"author-email="robin@camelot.uk"home-page="https://github.com/sirrobin/foobar"
您可以编辑此文件以添加其他元数据,例如设置 命令行脚本。见 pyproject.toml page 文件的。
如果您已经有一个flit.ini文件用于 弗利特,现在仍然有效,但你应该把它转换成 pyproject.toml方便时。
运行此命令将代码上载到pypi:
flit publish
要在本地安装用于开发的软件包,请运行:
flit install [--symlink] [--python path/to/python]
flit一次打包一个可导入的模块或包,使用导入 名称作为pypi上的名称。包中的所有子包和数据文件都是 自动包含。
开发
从github安装flit的开发版本:
git clone https://github.com/takluyver/flit.git cd flit python3 -m pip install docutils requests pytoml python3 -m flit install
您可能需要使用--symlink或--pth-file选项,以便可以测试 更改而不重新安装。
要运行测试,请运行pytest。