python - 为什么 PyObjC 文档如此糟糕？

Question

例如， http: //developer.apple.com/cocoa/pyobjc.html仍然适用于 OS X 10.4 Tiger，而不是 10.5 Leopard。这就是 Apple 的官方文档。

PyObjC 官方页面同样糟糕，http ://pyobjc.sourceforge.net/

太糟糕了，令人费解.. 我正在考虑学习 Ruby，主要是因为 RubyCocoa 的东西有更好的文档记录，并且有很多不错的教程（例如http://www.rubycocoa.com/），而且因为鞋子图形用户界面工具包..

我想做的就是使用 Cocoa GUI 创建相当简单的 Python 应用程序。
任何人都可以了解可怕的文档，或者指出一些教程，这些教程不仅给你大量的代码块，而且假设你知道做什么NSThread.detachNewThreadSelector_toTarget_withObject_("queryController", self, None)。 ?

score 31 · Accepted Answer

PyObjC 缺乏文档的主要原因是只有一个开发人员（我），而作为大多数开发人员，我并不特别喜欢编写文档。因为 PyObjC 对我来说是一个副项目，所以我倾向于专注于功能和错误修复，因为这对我来说更有趣。

改进文档的最佳方法是自愿在 pyobjc-dev 邮件列表中提供帮助。

顺便说一句：pythonmac-sig 邮件列表（参见 google）是在 MacOSX（不仅仅是 PyObjC）上获得 Python 帮助的绝佳资源。

score 21 · Accepted Answer

我同意该教程存在缺陷，将随机的、无法解释的代码扔在你的眼前。它介绍了诸如自动释放池和用户默认值之类的概念，而没有解释您为什么想要它们（“用于内存管理的自动释放池”几乎不是解释）。

也就是说……</p>

基本上我想做的就是编写 Cocoa 应用程序，而不必学习 ObjC。

恐怕目前，您需要基本掌握 ObjC 才能从使用 Cocoa 的任何语言中受益。PyObjC、RubyCocoa、Nu 等充其量只是小众，它们都是由非常熟悉 ObjC和Cocoa 来龙去脉的人开发的。

现在，如果您真正看到这些桥梁在脚本语言真正发挥作用的地方很有用，而不是试图用它们构建整个应用程序，那么您将受益最大。虽然这已经完成（使用 LimeChat，我现在正在使用 RubyCocoa 编写的应用程序），但这种情况很少见，并且可能会持续一段时间。

score 21 · Accepted Answer

说白了：

如果你想成为一名高效的 Cocoa 程序员，你必须学习 Objective-C。故事结局。

Python 或 Ruby 都不能通过各自的桥梁替代 Objective-C。您仍然需要了解 Objective-C API、NSObject 派生类的固有行为以及 Cocoa 的许多其他细节。

PyObjC 和 RubyCocoa 是从 Cocoa 应用程序访问 Python 或 Ruby 功能的好方法，包括大部分（如果不是完全）用 Python 或 Ruby 构建 Cocoa 应用程序。但其中的成功是建立在对 Cocoa 及其组成的 Objective-C API 的透彻理解之上的。

score 7 · Accepted Answer

Tom 和 Martin 的回答绝对正确（在几乎任何开源项目中，您都会发现大多数贡献者对开发特别感兴趣；对文档等半相关问题不太感兴趣），但我不认为您最后的特定问题很适合 PyObjC 文档。

NSThread.detachNewThreadSelector_toTarget_withObject_("queryController", self, None)

NSThread是 Cocoa API 的一部分，因此记录在 Apple，包括特定的方法+ detachNewThreadSelector:toTarget:withObject:（我会链接到那里，但显然 stackoverflow 有解析它的错误）。CocoaDev wiki也有一篇文章。

我认为 PyObjC 尝试记录 Cocoa 不是一个好主意，除了一些如何在 Python 中使用它的基本示例。解释选择器也可能超出了 PyObjC 的范围，因为这些也是 Objective-C 的一个特性，而不是 PyObjC 的一个特性。

score 7 · Accepted Answer

我偶然发现了一个关于 PyObjC/Cocoa 的好教程：

http://lethain.com/entry/2008/aug/22/an-epic-introduction-to-pyobjc-and-cocoa/

score 5 · Accepted Answer

我想做的就是使用 Cocoa GUI 创建相当简单的 Python 应用程序。任何人都可以阐明可怕的文档，或者指出一些教程，这些教程不仅给你大量的代码块，而且假设你知道什么 NSThread.detachNewThreadSelector_toTarget_withObject_ ("queryController", self, None) 确实..？

[...]

基本上我想做的就是编写 Cocoa 应用程序，而不必学习 ObjC。

虽然我基本上同意 Soeren 的回应，但我会更进一步：

如果有的话，在不了解 Objective C 的情况下使用 Cocoa 将需要很长时间。Cocoa 不是独立于 Objective C 构建的抽象，它明确地与它相关联。您可以在上面引用的示例代码行中看到这一点：

NSThread.detachNewThreadSelector_toTarget_withObject_("queryController", self, None)

这是编写 Objective C 行的 Python 方式：

[NSThread detachNewThreadSelector:@selector(queryController:) toTarget:self withObject:nil];

现在，重要的是要注意，这条线可以通过两种方式看到：(1) 作为 Objective C 的一条线，或者 (2) 作为 Cocoa 框架的调用。从语法上看，我们将其视为 (1)。通过认识到 NSThread 是一个提供一组方便特性的 Cocoa 框架，我们将其视为 (2)。在这种情况下，这个特殊的 Cocoa 框架让我们可以很容易地让一个对象在一个新线程上开始做某事。

但更重要的是：这里的 Cocoa 框架 (NSThread) 以一种与框架编写的语言明确相关的方式为我们提供了这种方便的服务。也就是说，NSThread 为我们提供了一个明确引用“选择器”的特性. 实际上，选择器是关于 Objective C 工作原理的基本名称。

所以问题来了。Cocoa 从根本上说是 Objective-C 的产物，它的创建者在构建它时考虑了 Objective C。我并不是说不可能将 Cocoa 特性的界面翻译成其他语言更自然的形式。只是一旦您更改 Cocoa 框架以停止引用“选择器”，它就不再是真正的 Cocoa 框架了。是翻译版本。一旦你开始走这条路，我猜事情会变得非常混乱。您正在努力跟上 Apple 更新 Cocoa 的步伐，也许您遇到了 Cocoa 的某些部分，这些部分只是不能很好地翻译成新的语言，无论如何。所以相反，像 PyObjC 这样的东西选择直接公开 Cocoa，以一种非常清晰和简单的相关性。正如他们在文档中所说：

为了在 Objective-C 消息和 Python 方法之间进行无损且明确的转换，Python 方法名称等价物只是将冒号替换为下划线的选择器。

当然，它有点难看，它确实意味着你需要了解一些关于 Objective-C 的知识，但那是因为替代方案，如果真的存在，不一定更好。

score 5 · Accepted Answer

我对Objective C或Cocoa一无所知（但对Python了解很多），但我现在正在用PyObjc编写一个相当复杂的应用程序。我是怎么学的？我选择了Cocoa Programming for OSX并使用 PyObjC 阅读了整本书（一个非常快速的过程）。只需忽略有关内存管理的任何内容，您就可以了。唯一需要注意的是，偶尔你必须使用像 endSheetMethod 这样的装饰器（实际上我认为这是我唯一遇到的）：

@PyObjcTools.AppHelper.endSheetMethod
def alertEnded_code_context_(self, alert, choice, context):
    pass

score 3 · Accepted Answer

这个答案不会很有帮助，但是作为开发人员，我讨厌做文档。这是一个开源项目，很难找到做文档的人。

score 3 · Accepted Answer

汤姆说的都是真的。许多开源项目都有专门的开发人员，很少有人对文档感兴趣。球门柱每天都在变化这一事实无济于事，这意味着不仅要创建文档，还要维护文档。

python - 为什么 PyObjC 文档如此糟糕？

9 回答 9

Related

Reference