AG
интересно какое сходство если атом clojure это и есть java.util.concurrent.atomic.AtomicReference
Size: a a a
2021 January 14
CD
Правильно ли я понимаю, что из коробки в кложе нет средств для документирования кроме docstrings? С помощью чего я могу описать аргументы функции?
CD
Если можно это как-то сделать чтобы ещё и IDE эти доки подтягивали ( как это работает с stdlib ) то вообще шикарно
CD
Знаю про clojure.spec но наколько понимаю, это ведь не совсем то и больше для тестов / контрактов ?
TL
Правильно ли я понимаю, что из коробки в кложе нет средств для документирования кроме docstrings? С помощью чего я могу описать аргументы функции?
А какая цель "описывания" в конкретной задаче?
AG
у спек область несколько шире, а просто документирование - докстринги, но ИДЕ их и подтягивает так же как и из core
CD
А какая цель "описывания" в конкретной задаче?
Иметь возможность сгенерить доку + чтобы IDE понимал
TL
у спек область несколько шире, а просто документирование - докстринги, но ИДЕ их и подтягивает так же как и из core
Ещё есть ^{:doc "xxx"} на символ
CD
Наверное надо просто посмотреть как это сделано в core 🤔
AG
Ещё есть ^{:doc "xxx"} на символ
точно не помню, но под капотом это и происходит когда ты указываешь doc-string? для функции, через мету
TL
точно не помню, но под капотом это и происходит когда ты указываешь doc-string? для функции, через мету
А, скорее всего да.
AG
(with-meta ...)
AG
Наверное надо просто посмотреть как это сделано в core 🤔
в core боюсь ты увидишь тоже самое, докстринги. Мне кажется есть недопонимание того что ты хочешь добиться, и каким путем. IDE берет это из меты, т.е. из этих самых докстрингов =
^{:doc "docstring}, и работать с ними можно так же совершенно как и со всем в кложе. Получить мету и писать в файл например. IDE тебе вместо этого просто тултипы "светит"AG
так что лучше посмотри иходники проектов которые генерят доки
CD
А, чёрт.. дополнения для VSCode в любом случае показывают просто векторы аргументов и докстринг.
Я думала что можно как-то описать каждый аргумент отдельно, как в JSDoc, к примеру
Я думала что можно как-то описать каждый аргумент отдельно, как в JSDoc, к примеру
CD
Пожалуй "описывать каждый параметр отдельно" - более точное определение того что я хочу
CD
;; интересно, в tag так и задумано? 🤔
AG
ну ты можешь и этого добиться при желании ) тоже
CD
ну ты можешь и этого добиться при желании ) тоже
Нет случайно примеров где такое реализовано?
RS
Правильно ли я понимаю, что из коробки в кложе нет средств для документирования кроме docstrings? С помощью чего я могу описать аргументы функции?
с помощью имён %)