setuptools-build-subpackage 1.0.0

安装

pip install setuptools-build-subpackage

您也可以使用以下命令安装开发中的版本：

pip install https://github.com/ashb/setuptools-build-subpackage/archive/master.zip

使用方法

此发行版包含setuptools的Distribution子类，旨在将“子模块”作为独立发行版进行构建。

它旨在与setuptools的声明性配置一起使用 - 即所有内容都在setup.cfg中定义，而不是在setup.py中

例如，以下布局

├── example
│   ├── __init__.py
│   ├── sub_module_a
│   │   ├── __init__.py
│   │   ├── setup.cfg
│   │   └── where.py
│   └── sub_module_b
│       ├── __init__.py
│       ├── setup.cfg
│       └── where.py
└── setup.cfg

这假设我们想要将example.sub_module_a和example.sub_module_b包含在主发行版中，而不是作为单独的发行版发布到PyPI。

这组类确保以下内容

• 顶级setup.cfg没有加载，而是只加载从子包指定的一个

• build/文件夹对于每个子包都保持清洁，因此一个构建的文件不会泄漏到另一个中

• setup.cfg在子文件夹中存在于构建的sdist中，这意味着它可以正常安装。

• 包括一个stub setup.py文件，以便与较旧的安装程序兼容

setup(
    ...
    packages=find_packages(exclude=['example.sub_module_*'])
)

[options.packages.find]
exclude =
  example.sub_module_*

python -m setuptools_build_subpackage \
  --subpackage-folder example/sub_module_b \
  sdist \
  bdist_wheel

python -m setuptools_build_subpackage \
  --subpackage-folder example/sub_module_b \
  sdist --license-template ./LICENSE \
  bdist_wheel

开发

要运行所有测试，请运行

pip install -e '.[devel]' && pytest

还建议您安装pre-commit来检查风格规则

变更日志

1.0.0 (2021-04-23)

• 在PyPI上的首次发布。