api - 我应该为使用我的图书馆的人默认环境吗？

Question

我一直在和一个 friend 讨论这个问题，我在那里有一个库(它的 python，但我没有将它作为标签包含在内，因为这个问题适用于任何语言)，它有一些依赖项。争论的焦点是是在初始化时提供默认环境还是强制代码的用户显式设置一个。

我的观点是强制用户明确表示，并避免混淆并明确他们所指的内容。

我的 friend ，默认环境更安全，更方便，如果用户愿意，可以让用户覆盖。

想法？流行的库中是否有任何好的引用资料或示例/模式支持我们的任一论点？另外，有没有讨论这个 API 设计点的流行博客或文章？

Answer 1

我没有任何引用资料，但这里是我作为上述库的潜在用户的想法。

我认为有一个默认配置可以让开发人员快速评估库是很好的。我不想为了查看库是否会满足我的需要而进行大量配置。一旦我很高兴图书馆会做我需要它做的事情，那么我很高兴按照我想要的方式配置它。

一个很好的例子是微软的 ASP.Net MVC 框架。当您创建一个新的 MVC 项目时，它会与默认的身份验证和成员资格提供程序 Hook ，这使开发人员能够非常快速地启动并运行正常运行的应用程序。如果默认提供者不满足相关应用程序的要求，也可以轻松配置要使用的不同提供者。

作为一个稍微不同的例子，A​​tlassian Confluence 是一个支持许多不同后端数据库的 wiki 软件。 Atlassian 可以选择没有默认的数据库配置，而是 Confluence 附带一个默认的、简单的、基于文件的数据库，以允许用户评估软件。对于生产安装，您可以连接到 Oracle、SQL Server、mySQL 或任何其他您喜欢的东西。

在某些情况下，库的默认配置可能没有任何意义，但我认为这将是一种特殊情况，而不是一般规则。