python - 在哪里可以找到函数的 kwargs/args 文档

Question

大多数库(如请求或 matplotlib)不包含正确的 kwargs/args 文档。有时会有示例，但大多数情况下缺少特定用例。
我的问题:

我在哪里可以找到那种信息。

为什么开发人员没有正确记录 kwargs/args

Answer 1

我只是尝试在许多类似的情况下找到来源。通常，如果没有记录，args 将被传递给某个较低级别的函数。一旦您知道更高级别的功能所遵循的低级别功能，目的就会更有意义。
例如，查看 requests.request 的文档.正如你提到的，它表明该方法需要一个 kwargs ，但没有提到它的用途。然而，它确实给了我们一个方便的link to the source ， 这表现了:

def request(method, url, **kwargs):
    . . .
    with sessions.Session() as session:
        return session.request(method=method, url=url, **kwargs)

所以，我们可以看到它是 sessions 上的一个相当薄的包装器。 ' 实例方法 request ，它刚刚通过 kwargs下。
如果我们检查 source for that method? 会怎样？ :

def request(self, method, url,
            params=None, data=None, headers=None, cookies=None, files=None,
            auth=None, timeout=None, allow_redirects=True, proxies=None,
            hooks=None, stream=None, verify=None, cert=None, json=None):
    . . .

我们可以看到 kwargs得到扩展，并有望成为这些参数之一。此时，我们可以查看 the documentation for that method更好地了解每个参数的作用。
我会注意到，如果您使用 Pycharm，您可以在符号顶部按 ctrl+b 以跳转到其源，因此您甚至不需要追踪源来进行任何侦查。

为什么不记录它们？人们在写东西时很懒惰和/或错过重要的细节。他们可能认为记录每个细节是“足够直观的”是不必要的。谁知道。有时，对于某些细节，阅读源代码比阅读文档学到的更多。