Clojure规范：非关键字键的映射

Question

让我们来看一下与Leiningen项目映射相关的现实世界例子：:global-vars：

 ;; Sets the values of global vars within Clojure. This example
 ;; disables all pre- and post-conditions and emits warnings on
 ;; reflective calls. See the Clojure documentation for the list of
 ;; valid global variables to set (and their meaningful values).
 :global-vars {*warn-on-reflection* true
               *assert* false}

它允许leiningen的用户重新定义其项目范围内Clojure全局变量的默认值。

现在，如果这个映射的键由关键字组成，我们将使用clojure.spec/keys来首先指定哪些键可以成为映射的一部分，然后单独定义这些键下预期的值。但是，由于clojure.spec/keys在:req和:req-un中静默忽略非关键字，并在:opt和:opt-un中抛出异常（截至alpha15），因此我们需要以某种方式解决这个问题。

我们可以通过以下方式获取大多数这些全局变量的类型：

(for [[sym varr] (ns-publics 'clojure.core)
      :when (re-matches #"\*.+\*" (name sym))]
  [varr (type @varr)])
  =>
[*print-namespace-maps*     java.lang.Boolean]
[*source-path*              java.lang.String]
[*command-line-args*        clojure.lang.ArraySeq]
[*read-eval*                java.lang.Boolean]
[*verbose-defrecords*       java.lang.Boolean]
[*print-level*              nil]
[*suppress-read*            nil]
[*print-length*             nil]
[*file*                     java.lang.String]
[*use-context-classloader*  java.lang.Boolean]
[*err*                      java.io.PrintWriter]
[*default-data-reader-fn*   nil]
[*allow-unresolved-vars*    java.lang.Boolean]
[*print-meta*               java.lang.Boolean]
[*compile-files*            java.lang.Boolean]
[*math-context*             nil]
[*data-readers*             clojure.lang.PersistentArrayMap]
[*clojure-version*          clojure.lang.PersistentArrayMap]
[*unchecked-math*           java.lang.Boolean]
[*out*                      java.io.PrintWriter]
[*warn-on-reflection*       nil]
[*compile-path*             java.lang.String]
[*in*                       clojure.lang.LineNumberingPushbackReader]
[*ns*                       clojure.lang.Namespace]
[*assert*                   java.lang.Boolean]
[*print-readably*           java.lang.Boolean]
[*flush-on-newline*         java.lang.Boolean]
[*agent*                    nil]
[*fn-loader*                nil]
[*compiler-options*         nil]
[*print-dup*                java.lang.Boolean]

其他的内容我们可以通过阅读文档来填写。但我想问你的是：我们如何编写一个规范，以确保如果映射包含键'*assert*'，它仅包含布尔值？

- Rovanion

Answer 1

请注意，目前没有计划支持s/keys中的非关键字键。

有几种方法可以解决这个问题（其中一种是在验证之前或在领先的转换器中执行类似于clojure.walk/keywordize-keys的操作，然后使用s/keys）。

另一种方法是将映射视为映射条目元组的集合（一些宏可以大大简化此过程）：

(defn warn-on-reflection? [s] #(= % '*warn-on-reflection*))
(s/def ::warn-on-reflection (s/tuple warn-on-reflection? boolean?))
(defn assert? [s] #(= % '*assert*))
(s/def ::assert (s/tuple assert? boolean?))

(s/def ::global-vars
  (s/coll-of (s/or :wor ::warn-on-reflection, :assert ::assert) :kind map?))

最后，尝试使用s/multi-spec而不是上面的s/or可能会很有趣 - 这将使此规范变成一个开放规范，可以在以后添加。以某种方式，使该规范开放可能很有用（因此也接受（s/tuple any? any?） - 因为将来可能会添加新事物或未列出的事物（例如，还有其他命名空间的动态变量）。

此外，请注意一些属性规范。例如，*unchecked-math*被视为逻辑真值，并且特别采用:warn-on-boxed这个特殊值，它是逻辑真值，但也会触发额外的行为。

- Alex Miller