Expose the analyzer as a Clojure CLI tool

so that users can easily verify that their libraries workf fine with cljdoc

Author: holyjak

README.adoc

@@ -162,6 +162,41 @@ clojure -M -m cljdoc-analyzer.main analyze \
 
 We can look at other features as we get a feel for what folks are interested in.
 
+=== use as a Clojure CLI tool
+
+You can also install and use cljdoc-analyzer as a https://clojure.org/reference/deps_and_cli#tool_install[Clojure CLI Tool]. First you need to install it:
+
+[source,bash,no-wrap]
+----
+clojure -Ttools install io.github.cljdoc/cljdoc-analyzer '{:git/tag "0.10.3"}' :as cljdoc
+----
+
+and then you can invoke it in one of the supported ways.
+
+.Analyze a library from a (local) Maven repo
+[source,bash,no-wrap]
+----
+clojure -Tcljdoc analyze \
+  :project '"io.aviso/pretty"' :version '"0.1.29"' \
+  # Alt.1.: Download the jar, pom from a maven repo and derive the paths: \
+  :download? true \
+  # Alt.2.: Provide paths to the project artifacts manually: \
+  #:jarpath "/path/to/project.jar" \
+  #:pompath "/path/to/project.pom" \
+  :extra-repo '["clojars https://repo.clojars.org/"]'
+----
+
+See `cljdoc-analyzer.main/analyze` for accepted configuration.
+
+.Analyze a deps-based library in the current directory
+[source,bash,no-wrap]
+----
+cd git clone [email protected]:fulcrologic/fulcro.git
+cd fulcro
+clojure -Tcljdoc analyze-local
+# provided ./pom.xml and ./target/*.jar exist
+----
+
 === logging
 
 If using cljdoc-analyzer as a library, provide your own logging config as appropriate for your app.

deps.edn

@@ -5,7 +5,9 @@
         ch.qos.logback/logback-classic {:mvn/version "1.3.0-alpha12"}
         org.jsoup/jsoup {:mvn/version "1.14.3"}
         version-clj/version-clj {:mvn/version "2.0.2"}
-        cli-matic/cli-matic {:mvn/version "0.4.3"}}
+        cli-matic/cli-matic {:mvn/version "0.4.3"}
+        babashka/fs {:mvn/version "0.1.2"}}
+ :tools/usage {:ns-default cljdoc-analyzer.deps-tool}
  :aliases {:test
            {:extra-paths ["test/unit" "test/integration" "test-resources"]
             :extra-deps {lambdaisland/kaocha {:mvn/version "1.60.977"}

src/cljdoc_analyzer/main.clj

@@ -18,7 +18,9 @@
   (let [config (config/load)
         extra-repos (extra-repo-arg-to-option extra-repo)
         {:keys [jar pom]} (deps/resolve-dep (symbol project) version (:repos config) extra-repos)]
-    (runner/analyze! (-> (select-keys args [:project :version :exclude-with :output-filename])
+    (runner/analyze! (-> (merge 
+                           {:exclude-with [:no-doc :skip-wiki]} 
+                           (select-keys args [:project :version :exclude-with :output-filename]))
                          (assoc :jarpath jar :pompath pom :extra-repos extra-repos)))))
 
 (spec/def ::extra-repo