Clojurians Log v2

Hi, I try to build some documentation using codox by clj -A:dev -X:codox in a polylith ws. The ws contains several components all created with poly create component name:example. The problem is that codox does not find any namespaces and emits an empty index.html. I tried several :source-paths configurations without success. Any advice would be greatly appreciated.

I don't see any docs on the Codox site for running it via the CLI. What is your :codox alias and how are you providing the Codox configuration?

Thank you for the answer. The alias is:

:codox {:source-paths ["components/stmem/src"
                        ;; and variations of that
                        ]

                    :extra-deps {codox/codox {:mvn/version "0.10.7"}}
                    :exec-fn codox.main/generate-docs
                    :exec-args {:language :clojure
                                :output-path "docs"}}

You need :source-paths inside the :exec-args map.

When you use -X, the command-line arguments are parsed and passed as part of the :exec-args hash map.

In your deps.edn, :source-paths is at the same level as :extra-deps etc and therefore is presented as an option for tools.deps.alpha (and it'll be ignored as unknown).

^ @wactbprot does that make sense?

Yes, makes sense if you explain it. Thank you very much. I find all the tools.deps stuff hard to understand.

It def. doesn't help that all of Codox's docs refer to Leiningen and so all of the config examples are about project.clj which inherently provides options to plugins.

Yes, but it's the same for most of the libs out there so far.

Thank you again!

Happy to help. We stopped using lein years ago at work. We switched to boot in 2015 and then to the CLI/`deps.edn` in 2018.