我应该使用shutil.copytree吗？

Question

shutil的Python 2版本中的documentation for the copytree function说，

  

这个的源代码应该被视为一个例子，而不是最终的工具。

这究竟是什么意思？ copytree是否打算成为概念证明而不是实际用于程序？或者这只是一个免责声明，代码是凌乱的？ （the Python 3 version中没有此声明。）

Answer 1

在早期版本的shutil代码中，它有此注释（introduced by Guido）：

  

XXX考虑这个示例代码而不是最终工具。

此说明随后在this commit中删除。所以这个说明似乎没有特定的理由，除了代码已经从不完全准备好支持 - 我们需要什么。