Телеграмм чат группы clojure

Size: a a a

Clojure — русскоговорящее сообщество

656 membersпожаловаться на группу

2021 January 14

ДН

Денис Нибаев... in Clojure — русскоговорящее сообщество

Camina Drummer

Это VSCode? Там Calva часто непредсказуемо себя ведёт, мне рестарт IDE помогал 😅

VSCode, рестартил неоднократно. Пока безуспешно. Теперь еще докер плагин не видит докер.. аа

источник

10:55пожаловаться #1

ДН

Денис Нибаев... in Clojure — русскоговорящее сообщество

все-таки в обновлении что-то толи поломалось, толи изменились настройки.
работает в v2.0.148

источник

11:07пожаловаться #2

Sergey Trofimov in Clojure — русскоговорящее сообщество

Camina Drummer

Пожалуй "описывать каждый параметр отдельно" - более точное определение того что я хочу

ну, в принципе, в ^:doc можно засунуть произвольную структуру данных вместо просто стринга

источник

11:19пожаловаться #3

Oleg Roshchupkin in Clojure — русскоговорящее сообщество

Ivan Grishaev

если задана функциональная спека, то функция doc нарисует ее вдобавок к тому, что указано в докстринге

Ещё arglists было

источник

11:29пожаловаться #4

Sergey Trofimov in Clojure — русскоговорящее сообщество

Sergey Trofimov

ну, в принципе, в ^:doc можно засунуть произвольную структуру данных вместо просто стринга

кстати, выглядит как клёвая идея
можно писать докстринг, смешивая текст и данные

(defn test
  {:doc ["Text" '{a "data"}]}
  [a])

источник

11:30пожаловаться #5

Mikhail Kuzmin in Clojure — русскоговорящее сообщество

Sergey Trofimov

кстати, выглядит как клёвая идея
можно писать докстринг, смешивая текст и данные

(defn test
  {:doc ["Text" '{a "data"}]}
  [a])

cider такое не переваривает

источник

11:38пожаловаться #6

Sergey Trofimov in Clojure — русскоговорящее сообщество

Mikhail Kuzmin

cider такое не переваривает

курсив переваривает 😊

источник

11:38пожаловаться #7

Sergey Trofimov in Clojure — русскоговорящее сообщество

с :arglists пока в голову приходит только такое

:arglists '(["a - Decs" "b - Desc" "c - Desc"])

источник

11:40пожаловаться #8

Ivan Grishaev in Clojure — русскоговорящее сообщество

Oleg Roshchupkin

Ещё arglists было

кажется, он только для макросов? или для функций тоже канает?

источник

11:43пожаловаться #9

Sergey Trofimov in Clojure — русскоговорящее сообщество

Ivan Grishaev

кажется, он только для макросов? или для функций тоже канает?

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

источник

11:46пожаловаться #10

Sergey Trofimov in Clojure — русскоговорящее сообщество

Для рефакторинга интересно выглядит такое описание аргументов, но оно видно только в исходниках и в doc не попадает

(defn test
  [a]
  {:doc {'a "Description"}})

источник

11:47пожаловаться #11

Kirill Chernyshov in Clojure — русскоговорящее сообщество

arglists веселее работают)

источник

11:49пожаловаться #12

Kirill Chernyshov in Clojure — русскоговорящее сообщество

источник

11:50пожаловаться #13

Kirill Chernyshov in Clojure — русскоговорящее сообщество

так виднее что происходит

источник

11:50пожаловаться #14

Kirill Chernyshov in Clojure — русскоговорящее сообщество

Это я к тому что в ядре есть возможность добавлять выразительную документацию, включая аргументы. Дело только за тулингом

источник

11:53пожаловаться #15

Sergey Trofimov in Clojure — русскоговорящее сообщество

Sergey Trofimov

(defn test
  [a]
  {:doc {'a "Description"}})

сорри, тут я налажал с синтаксисом, не работает такое

источник

11:56пожаловаться #16

Sergey Trofimov in Clojure — русскоговорящее сообщество

Kirill Chernyshov

клёво
только список аргументов читать становится сложнее 😞

источник

11:58пожаловаться #17

Kirill Chernyshov in Clojure — русскоговорящее сообщество

Sergey Trofimov

клёво
только список аргументов читать становится сложнее 😞

гворю же — дело за тулингом) если сидер начнет показывать документацию в зависимости от контекста — читать станет проще

источник

12:01пожаловаться #18

Ivan Grishaev in Clojure — русскоговорящее сообщество

надо тогда по одному в строку писать. В принципе, удобно: аргументы и доки сразу в одном месте

источник

12:01пожаловаться #19

Sergey Trofimov in Clojure — русскоговорящее сообщество

Kirill Chernyshov

ну, лично я чаще исходники читаю, включая собственные 😊

источник

12:02пожаловаться #20