It's easier if you leave all the shell stuff out of the equation and try to repro in pure Clojure

and also repro the string input separately. So solve one problem at a time

doc indeed is a macro and macros expect static input, in the case of doc it is a symbol, like (doc whatever) . (doc (slurp *in*)) doesn't work, as you say find-doc would work since that is the function equivalent

but you can work around this using another macro, like here: https://github.com/babashka/babashka/blob/master/examples/random_doc.clj

ok, i'll try using another macro as shown in random-doc and also inside a script instead of putting everything in string on shell 😅

nice :)

I couldn't make use of random-doc macro, to make get-doc, everytime it just returned java.lang.ClassCastException: clojure.lang.PersistentList cannot be cast to clojure.lang.Named, so ended up doing it manually:

(require '[bblgum.core :refer [gum]]
         '[clojure.string :as str]
         '[clojure.repl :as repl])

(defn filter-menu [input placeholder] (first (:result (gum :filter :in input :placeholder placeholder :fuzzy false))))

(defn print-doc [item-meta]
  (println "-------------------------")
  (let [namespace-value (str (:ns item-meta))
        function-name (:name item-meta)
        arg-list (:arglists item-meta)
        doc-string (:doc item-meta)]
    (println (str namespace-value "/" function-name))
    (println arg-list)
    (println doc-string)))

(let [item (filter-menu (str/join "\n" (repl/apropos "")) "Search documentation...")]
  (if (nil? item)
    (println "No documentation available.")
    (print-doc (meta (resolve (symbol item))))))

This was get-doc (I tried):

(require '[clojure.repl])

(defmacro get-doc [sym]
  (if (:doc (meta (resolve sym)))
    `(clojure.repl/doc ~sym)
    `(println "No documentation available for" '~sym)))

(get-doc (symbol "clojure.core/diff")) ;; Error

You are passing a list to get-doc . Macros don't evaluate their arguments

if you want to pass a string then write (resolve (symbol the-string)) in the macro instead

I'm not passing a list to get-doc I am passing string only, also I tried (resolve (symbol the-string)) too before and again right now, it prints exactly the same exception error. I'm also scratching my head on this: `(defmacro get-doc [sym] (if (:doc (meta (resolve (symbol sym)))) (clojure.repl/doc (resolve (symbol ~sym))) (println "No documentation available for" '~sym)))`

(get-doc (symbol "clojure.core/diff"))

how its a list?

macros do not evaluate their arguments.

(defmacro foo [x] (prn (type x)))
(foo (symbol "clojure.core/diff"))

Ok got it, it is passing as (symbol "clojure.core/diff"), which is a list, sorry 😅, so I should pass a static input to a macro?

yes

macros are compile time functions, typically used for code transformation

they only operate on what literally pass to them

I gotta learn more about macros, I gotta try it, sorry about dumb questions.

You could run your tests with babashka. I do that in my https://github.com/justone/bb-scripts project. I can run:

bb test

clojure -M:clj:test

I think there is also neil add test which does a similar (maybe the same) thing

And then you have to keep the babashka included versions in sync manually in your deps, e.g.: https://github.com/justone/bb-scripts/blob/5f54bcec441622097b88539ddb809784925f6c67/deps.edn#L7 ? There’s no such thing as a maven parent with babashka libs, so that I could extend from that and then pull in libraries (e.g. babashka/fs) without specifying the version, as it’s provided by the parent?

@U05KWT468F8 re "parent", you can just make one dependency without any source which depends on other libraries.

bb print-deps

I’m sure someone could write a bb script to take the output of bb print-deps and then use rewrite-edn to update the corresponding ones in deps.edn.