为 Python 包分发“bin”和“tests”目录的正确方法是什么？

Question

我创建了一个 python 包。

根据几个互联网来源（包括https://github.com/pypa/sampleproject）的建议，我设置了这样的目录结构：

root_dir
├── bin
│   └── do_stuff.py
├── MANIFEST.in
├── README.md
├── my_lib
│   ├── __init__.py
│   ├── __main__.py
│   └── my_lib.py
├── setup.cfg
├── setup.py
├── important_script.py
└── tests
    ├── __init__.py
    └── test_lib.py

我已在清单中包含tests、bin 和important_script.py，并将setup.py 中的include_package_data 设置为True。

但是，在运行pip install root_dir 之后，我看到它正确安装了my_lib，但bin 和tests 只是直接放入Lib/site-packages，就好像它们是单独的包一样。

我根本找不到important_script.py，而且我认为它没有安装。

如何在我的安装中正确包含这些文件/目录？

编辑

所以，原来bin 和tests 目录被直接放入site-packages 目录是由我之前做的某事引起的，但我不知道是什么。在某些时候，我的root_dir 中生成了build 和dist 目录（我假设是通过pip 或setuptools 生成的？），之后我对项目所做的任何更改实际上都没有显示在已安装的包中。删除这些目录后，我不再能够重现该问题。

Answer 1

示例项目既不分发bin 也不分发tests，甚至分发explicitly excludes tests。

要包含bin，您应该使用scripts 或entry_points（就像在示例项目中一样）。将此添加到您的 setup.py 到 setup() 通话中：

scripts=['bin/do_stuff.py'],

要包含tests，您应该重组您的树，以在包目录下包含目录tests：

root_dir
├── bin
│   └── do_stuff.py
├── MANIFEST.in
├── README.md
├── my_lib
│   ├── __init__.py
│   ├── __main__.py
│   └── my_lib.py
│   └── tests
│       ├── __init__.py
│       └── test_lib.py
├── setup.cfg
├── setup.py
├── important_script.py