Как аннотировать протоколы и их методы в core.typed Clojure?

Question

Я делаю игру в крестики-нолики и составил протокол для моей стратегии. Игра работает нормально, поэтому я хочу воспользоваться этой возможностью, чтобы отточить свои основные навыки. Я аннотировал протокол (как показано ниже), но когда я запускаю (cf method-name) или же (cf protocol-name) в ответ я получаю эту ошибку:

например:

=> `(cf win)`
clojure.lang.ExceptionInfo: Type Checker: Found 1 error :: {:type-error :top-level-error, :errors (#<ExceptionInfo clojure.lang.ExceptionInfo: Unannotated var tic-tac-toe.protocol/win
Hint: Add the annotation for tic-tac-toe.protocol/win via check-ns or cf {:env {:file "/Users/jessediaz/Documents/workspace/tic-tac-toe/src/tic_tac_toe/protocol.clj", :column 5, :line 47}, :form win, :type-error :clojure.core.typed.errors/tc-error-parent}>)}

Я проверил, чтобы убедиться, что версия протокола на самом деле core.typed / protocol. Консоль гавкала на меня, когда я использовал протокол>, говоря, что синтаксис устарел. Я также просмотрел документацию на странице github и clojure-doc.org. Вот так я узнал, что есть необязательный :methods Ключевое слово, которое я могу использовать для сопоставления методов с типами. Я чувствую, что это может удалить много повторений из моего кода, но я не смог найти никаких примеров его использования. основные методы стратегии в протоколе имеют побочные эффекты и отдачу nil, Методы проверки либо возвращают nil или оригинал Strategy методы, которые они проверяют. Я не уверен, что у меня есть синтаксис прямо здесь, но код хорошо оценивается в LightTable, с или без Fn подпись, и они core.typed вики подразумевает, что это не всегда необходимо.

Я чувствую, что нахожусь здесь на пороге изучения этой удивительной библиотеки и буду признателен за любые проницательные советы, которые могут помочь моему пониманию.

файл protocol.clj:

(ns tic-tac-toe.protocol
  (:require [clojure.core.typed :refer :all]))

(ann-protocol Strategy
                win                        (Fn [Strategy -> nil])
                block                      (Fn [Strategy -> nil])
                fork                       (Fn [Strategy -> nil])
                block-fork                 (Fn [Strategy -> nil])
                take-center                (Fn [Strategy -> nil])
                take-opposite-corner       (Fn [Strategy -> nil])
                take-corner                (Fn [Strategy -> nil])
                take-side                  (Fn  [Strategy -> nil])

                can-win?                   (Fn [Strategy -> (U nil (Fn [Strategy -> nil]))])
                can-block?                 (Fn [Strategy -> (U nil (Fn [Strategy -> nil]))])
                can-fork?                  (Fn [Strategy -> (U nil (Fn [Strategy -> nil]))])
                can-block-fork?            (Fn [Strategy -> (U nil (Fn [Strategy -> nil]))])
                can-take-center?           (Fn [Strategy -> (U nil (Fn [Strategy -> nil]))])
                can-take-corner?           (Fn [Strategy -> (U nil (Fn [Strategy -> nil]))])
                can-take-side?             (Fn [Strategy -> (U nil (Fn [Strategy -> nil]))]))
(defprotocol Strategy
  "Strategy methods update the Tic-tac-toe board when they are called"

  ;; strategies
  (win [_] "wins the game by filling an open space to get 3 in a row")
  (block [_] "blocks an opponents win by filling an open space")
  (fork [_] "creates a two way win scenario guaranteeing victory")
  (block-fork [_] "prevents an opponent from forking")
  (take-center [_] "takes center")
  (take-opposite-corner [_] "takes a corner opposite to one the computer already has")
  (take-corner [_] "takes an avaiable corner")
  (take-side [_] "takes an available side")

  ;; tests
  (can-win? [_])
  (can-block? [_])
  (can-fork? [_])
  (can-block-fork? [_])
  (can-take-center? [_])
  (can-take-opposite-corner? [_])
  (can-take-corner? [_])
  (can-take-side? [_]))

Answer 1

Я подозреваю, что вам нужно check-ns текущее пространство имен, прежде чем запрашивать его cf, Оценка типизированного кода не вызывает проверку типа или сбор аннотаций.

ann-protocol здесь не нужно, clojure.core.typed/defprotocol поддерживает встроенную аннотацию.

Попробуйте что-то вроде:

(defprotocol Strategy
  "Strategy methods update the Tic-tac-toe board when they are called"

  ;; strategies
  (win [_] :- nil "wins the game by filling an open space to get 3 in a row")
  (block [_] :- nil "blocks an opponents win by filling an open space")
  ...)