跳转到主要内容

为简单包提供简单打包工具。

项目描述

Flit 是将Python包和模块上传到PyPI的一种简单方法。它试图减少对打包的思考,并帮助您避免常见的错误。有关如何与其他Python打包工具相比的更多信息,请参阅 为什么使用Flit?

安装

$ python3 -m pip install flit

Flit需要Python 3,因此需要使用Python 3版本的pip进行安装。

可以使用Flit分发Python 2模块,但需要在Python 3上无错误地导入。

用法

假设你正在编写一个名为 foobar 的模块——可以是单个文件 foobar.py,也可以是一个目录——并且你想要分发它。

  1. 确保foobar的docstring以模块的简短概述开始,并且包含一个 __version__

    """An amazing sample package!"""
    
    __version__ = "0.1"
  2. 如果你还没有安装flit,请安装它

    python3 -m pip install flit
  3. 在包含模块的目录中运行 flit init 命令以创建一个 pyproject.toml 文件。它看起来可能如下所示

    [build-system]
    requires = ["flit_core >=3.2,<4"]
    build-backend = "flit_core.buildapi"
    
    [project]
    name = "foobar"
    authors = [{name = "Sir Robin", email = "robin@camelot.uk"}]
    dynamic = ["version", "description"]
    
    [project.urls]
    Home = "https://github.com/sirrobin/foobar"

    你可以编辑此文件以添加其他元数据,例如设置命令行脚本。请参阅文档中的 pyproject.toml 页面

    如果你已经有了用于旧版本Flit的 flit.ini 文件,可以通过运行 python3 -m flit.tomlify 将其转换为 pyproject.toml

  4. 运行此命令将你的代码上传到PyPI

    flit publish

一旦你的包发布,人们就可以像安装任何其他包一样使用 pip 安装它。在大多数情况下,pip会下载一个“wheel”包,这是它知道如何安装的标准格式。如果你特别要求pip安装一个“sdist”包,它将使用Flit在一个临时环境中安装并使用。

要本地安装包以供开发使用,请运行

flit install [--symlink] [--python path/to/python]

Flit一次打包一个可导入的模块或包,使用导入名称作为PyPI上的名称。包内所有子包和数据文件都会自动包含在内。

项目详情


下载文件

下载适用于您平台的电影文件。如果您不确定选择哪个,请了解更多关于 安装包 的信息。

源分布

flit-3.9.0.tar.gz (141.1 kB 查看散列值)

上传时间

构建分布

flit-3.9.0-py3-none-any.whl (49.9 kB 查看散列值)

上传于 Python 3

由以下支持