将个人Python项目变成可发布的库
我是一名学者，而不是程序员，并且我有多年编写供自己使用的Python程序以支持我的研究的经验。我的最新项目可能对我和其他许多人都有用，并且我正在考虑将其作为开源Python库发布。 但是，从运行中的个人项目到可以被其他人轻松安装和使用的库，似乎有许多障碍需要克服。这个问题是关于我应该开始着手公开发布的第一步。 目前，我只有一个git存储库，其中包含使用该库以及该库本身的代码，并且我将git用作紧急撤消按钮，以防万一发生任何问题。所有这些对于单个用户都可以正常工作，但是如果我要释放它，显然不合适。我要结束的地方是我的库位于单独的存储库中，并且可以由其他人使用来安装pip，并且具有稳定的API。 一旦我想发布它，学习使用setuptools等可能就不那么困难了-我的问题是知道如何工作才能达到这一点。 所以我的问题是，为了开始准备供公众使用的Python库项目，应该采取的第一步步骤是什么？我应该如何重组我的目录结构，git仓库等，以便开始努力公开发布该库？ 更一般而言，如果首次尝试使用已知有帮助的资源，那将非常有帮助。指向最佳实践和避免错误的指针等也将非常有帮助。 需要澄清的是：当前的答案是按照“如何使我的Python库成为其他人可以使用的好库？”的方式来解决一个问题。这很有用，但是与我要提出的问题不同。 我目前正处于发布项目的漫长旅程的开始。我的实现的核心工作正常（并且工作得很好），但是我对即将进行的大量工作感到不知所措，并且我正在寻找有关如何进行流程导航的指导。例如： 我的库代码当前已耦合到我自己的使用它的特定于域的代码。它位于子文件夹中，并且共享相同的git存储库。最终，需要将其制作成一个独立的库并放入其自己的存储库中，但是由于我不知道如何做，所以我一直在拖延。（既不是如何在“开发模式”下安装库以使我仍然可以对其进行编辑，也没有如何使两个git仓库保持同步。） 我的文档字符串很简洁，因为我知道最终我将不得不使用Sphinx或其他工具。但是这些工具似乎并不容易学习，因此这成为一个主要的子项目，我一直推迟进行。 在某些时候，我需要学习使用setuptools或其他工具来打包它并跟踪依赖项，这非常复杂。我不确定现在是否需要这样做，并且该文档对于新用户来说绝对是个迷宫，因此我决定以后再做。 我从来不需要进行系统的测试，但是我肯定会对此项目进行测试，因此，我必须（i）了解足够的测试知识，以了解哪种方法适合我的项目；（ii）了解哪些工具可用于我选择的方法；（iii）学习使用我选择的工具；（iv）为我的项目实施测试套件等。这本身就是一个项目。 我可能还有其他事情要做。例如，jonrsharpe发布了一个有用的链接，其中提到了git-flow，tox，TravisCI，virtualenv和CookieCutter，我以前从未听说过。（该帖子来自2013年，所以我还必须做一些工作来找出仍有多少钱。） 当您将所有这些放在一起时，这是一项巨大的工作，但是我敢肯定，如果我坚持不懈地完成工作，那么我就可以完成所有工作，而且我不着急。我的问题是知道如何将其分解为可管理的步骤，一次可以完成。 换句话说，我要问的是我现在可以采取哪些最重要的具体步骤，以便最终获得可发布的产品。如果我有空闲的周末，我应该关注哪些事情？哪一个（如果有的话）可以与其他人孤立地完成，这样我至少可以完成一个步骤而无需做整个事情？学习这些东西最有效的方法是什么，这样我仍然有时间专注于项目本身？（请记住，所有这些本质上都是一项业余项目，而不是我的工作。）我是否真的不需要做任何事情，从而为自己节省了大量时间和精力？ 非常感谢所有答案，但是我特别欢迎关注这些项目管理方面的答案，尤其是对现代Python开发的引用。