为 defonce 添加文档字符串支持

Question

将 {{defonce}} 的所有参数传递给 {{def}}，以便它支持文档字符串（或可能的其他未来特性），就像 def 一样。

重新评估 {{defonce}} 时，文档字符串和其他 Var 元数据将会丢失。

*补丁:* clj-1148-defonce-6.patch

*审核人员：*

Answer 1

评论由：seancorfield

注意到我们在工作中有一个 JIRA 问题是为了给几个 {{defonce}} 调用添加文档字符串（通过 alter-meta!}），我发现这个议题并想知道什么阻止了其进步？

林纳斯的补丁方案在总体上是可接受的解决方案（只是缺少测试）吗？还是需要一个不同的方法？这是否被 CLJ-1446 堵塞了，人们希望在其更新 {{defonce}} 之前先修复它？

Answer 2

评论由：alexmiller

更改为缺陷，因为篡改了元数据。

Answer 3

评论由：stu

请添加测试。clojure.test-helper 名称空间提供了有用的临时名称空间支持。

Answer 4

评论者：joegallo

这个新补丁包括对defonce的更改以及测试。

Answer 5

评论由：alexmiller

改为Vetted，这样它就可以再次进行筛选。

Answer 6

评论者：richhickey

我不同意关于stomp元数据 - 提供了不同的元数据。defonce的目的是避免init的重新评估。这是否是最简单实现文档字符串的方式？无论如何，将其分为两部分。

Answer 7

评论由：alexmiller

将票据的范围缩减到仅仅传递defonce参数给def添加对文档字符串的支持。添加了一个执行此操作的补丁。

Answer 8

评论者：stuart(sierra)

审核过clj-1148-defonce-2.patch，但状态重返“不完整”。

在此补丁中{{:arglists}}元数据（符号列表）与{{:arglists}}的所有其他用途（向量列表）不一致。

除此之外，补丁很好。

Answer 9

评论由：alexmiller

更新了修复arglist格式不一致的补丁，并附加了clj-1148-defonce-3.patch。

Answer 10

评论者：stuart(sierra)

补丁 clj-1148-defonce-3.patch 是好的，但它并没有真正解决 docstring 的问题，因为 {{defonce}} 仍然会销毁元数据。例如

`
user=> (defonce foo "foo 的 docstring" (do (prn 42) 42))
42

'user/foo

user=> (doc foo)

user/foo
foo 的 docstring
nil
user=> (defonce foo "foo 的 docstring" (do (prn 42) 42))
nil

user=> (doc foo)

user/foo
nil
`

Answer 11

评论者：stuart(sierra)

screened with reservations noted.

Answer 12

评论者：richhickey

Stuart 是对的，第二个 defonce 应该保留 docstring（因为它再次提供了它，应该没有操作）

Answer 13

评论由：alexmiller

从 1.6 中移除

Answer 14

评论者：claj

这个版本使用 {{resolve}} 来查找先前定义的变量。如果变量已经定义并且有边界，重复的 defonce 实际上不会影响命名空间。

请确认使用 (resolve '~name) 与 {{ns}}-bindings 或类似没有问题。

这个补丁还包含了 {{clj-1148-defonce-3.patch}} 的测试以及 {{:arglists}} 属性。

(patch 4 错过了一个 def-row，抱歉邮件噪音)

Answer 15

_评论者：claj_

另一个更简单的 defonce 版本。没有包含测试用例。

这个版本只是在已解析的变量上进行一个 {{(or (nil? v#) (not (.hasRoot v#)))}} 测试。如果是真的，就通过 {{(def ~name ~@args)}} 真实定义，否则什么也不做。