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

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

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

我建议你在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

在c#中，我通常将测试分离到单独的程序集中。

在Python中——到目前为止——我倾向于编写doctests，其中测试位于函数的文档字符串中，或者将它们放在模块底部的if __name__ == "__main__"块中。

我将测试放在与测试代码(CUT)相同的目录中。在项目中，我可以用我的插件调整pytest，对于foo.py，我使用foo.pt进行测试，这使得编辑特定的模块及其测试非常容易:vi foo.*。

在不能这样做的地方，我使用foo_ut.py或类似的方法。你仍然可以使用vi foo*，尽管它也会捕获foobar.py和foobar_ut.py(如果它们存在的话)。

在这两种情况下，我调整测试发现过程来找到这些。

这将测试放在目录列表中代码的旁边，使测试明显地存在于那里，并使打开测试尽可能容易，当它们位于单独的文件中时。(对于从命令行开始的编辑器，如上所述;对于GUI系统，单击代码文件和相邻的(或非常接近相邻的)测试文件。

正如其他人所指出的，这也使得重构和提取代码以供在其他地方使用变得更容易。

I really dislike the idea of putting tests in a completely different directory tree; why make it harder than necessary for developers to open up the tests when they're opening the file with the CUT? It's not like the vast majority of developers are so keen on writing or tweaking tests that they'll ignore any barrier to doing that, instead of using the barrier as an excuse. (Quite the opposite, in my experience; even when you make it as easy as possible I know many developers who can't be bothered to write tests.)

每隔一段时间，我发现自己检查了测试放置的主题，每次大多数人都建议在库代码旁边使用单独的文件夹结构，但我发现每次的论点都是一样的，而且没有那么令人信服。我最终把我的测试模块放在核心模块旁边的某个地方。

这样做的主要原因是:重构。

当我移动东西时，我确实希望测试模块与代码一起移动;如果测试位于单独的树中，则很容易丢失测试。说实话，迟早你会得到一个完全不同的文件夹结构，就像django, flask和其他的一样。如果你不在乎也没关系。

你应该问自己的主要问题是:

我在写:

A)可重复使用的库或 B)构建一个项目，而不是将一些半分离的模块捆绑在一起?

如果一个:

单独的文件夹和额外的维护其结构的工作可能更适合。没有人会抱怨将测试部署到生产环境中。

但是，当测试与核心文件夹混合在一起时，也很容易将它们排除在分发之外;把这个放到setup.py中:

find_packages("src", exclude=["*.tests", "*.tests.*", "tests.*", "tests"]) 

如果b:

您可能希望—正如我们每个人都希望—您正在编写可重用的库，但是大多数时候它们的生命与项目的生命紧密相连。能够轻松地维护您的项目应该是优先考虑的。

然后，如果你做得很好，你的模块很适合另一个项目，它可能会被复制到这个新项目中，而不是被分叉或被做成一个单独的库，并且与在一个单独的测试文件夹中搜索测试相比，在相同的文件夹结构中移动放在它旁边的测试很容易。(你可能会说，它一开始就不应该一团糟，但让我们现实一点)。

所以选择仍然是你的，但我认为混合测试可以实现与单独文件夹相同的功能，但在保持文件整洁方面花费的精力更少。

我们在编写为Python程序生成单元测试的Pythoscope (https://pypi.org/project/pythoscope/)时遇到了同样的问题。在我们选择目录之前，我们对python列表中的测试进行了民意调查，有很多不同的意见。最后，我们选择将“tests”目录放在与源代码相同的目录中。在该目录中，我们为父目录中的每个模块生成一个测试文件。