我是怎么做的…

文件夹结构:

project/
    src/
        code.py
    tests/
    setup.py

Setup.py指向src/作为包含我的项目模块的位置，然后运行:

setup.py develop

它将我的项目添加到站点包中，指向我的工作副本。要运行测试，我使用:

setup.py tests

使用我配置的任何测试运行程序。

如果测试很简单，就把它们放在文档字符串中——大多数Python测试框架都可以使用它:

>>> import module
>>> module.method('test')
'testresult'

对于其他更复杂的测试，我将它们放在../tests/test_module.py或tests/test_module.py中。

我也倾向于把我的单元测试放在文件本身中，正如Jeremy Cantrell上面所指出的，尽管我倾向于不把测试函数放在主体中，而是把所有东西都放在一个文件中

if __name__ == '__main__':
   do tests...

块。这最终会将文档添加到文件中，作为如何使用您正在测试的python文件的“示例代码”。

我应该补充一点，我倾向于编写非常紧凑的模块/类。如果你的模块需要大量的测试，你可以把它们放在另一个测试中，但即使这样，我仍然会补充:

if __name__ == '__main__':
   import tests.thisModule
   tests.thisModule.runtests

这让任何阅读源代码的人都知道到哪里去寻找测试代码。

我不相信存在既定的“最佳实践”。

我把我的测试放在应用程序代码之外的另一个目录中。然后，我将主应用程序目录添加到sys。路径(允许您从任何地方导入模块)在我的测试运行脚本(它也做一些其他的事情)之前运行所有的测试。这样，当我发布主代码时，我就不必从主代码中删除测试目录，节省了我的时间和精力，即使时间和精力非常少。

我建议你在GitHub上查看一些主要的Python项目，并获得一些想法。

当你的代码变大，你添加了更多的库，最好在你有setup.py的同一个目录下创建一个测试文件夹，并为每种测试类型镜像你的项目目录结构(unittest, integration，…)

例如，如果你有一个这样的目录结构:

myPackage/
    myapp/
       moduleA/
          __init__.py
          module_A.py
       moduleB/
          __init__.py
          module_B.py
setup.py

添加测试文件夹后，您将拥有如下目录结构:

myPackage/
    myapp/
       moduleA/
          __init__.py
          module_A.py
       moduleB/
          __init__.py
          module_B.py
test/
   unit/
      myapp/
         moduleA/
            module_A_test.py
         moduleB/
            module_B_test.py
   integration/
          myapp/
             moduleA/
                module_A_test.py
             moduleB/
                module_B_test.py
setup.py

许多正确编写的Python包使用相同的结构。Boto包就是一个很好的例子。 检查https://github.com/boto/boto

一种常见的做法是将测试目录放在与模块/包相同的父目录中。因此，如果你的模块名为foo.py，你的目录布局将如下所示:

parent_dir/
  foo.py
  tests/

当然，没有一种方法可以做到这一点。您还可以创建一个tests子目录，并使用绝对导入导入模块。

无论您在哪里进行测试，我都建议您使用nose来运行它们。Nose在您的目录中搜索测试。这样，您就可以把测试放在组织上最有意义的地方。