clj kondo下載-CLJ clj kondo源代碼下載

clj kondo

其他類別

v2024.11.14

下載

Clojure代碼的靜態分析儀和Linter引起歡樂。

非常感謝Clj-Kondo。這就像我的同伴。這使Clojure再次變得有趣。
- @geraldodev on clojurians懈怠

理由

Clj-Kondo對Clojure，Clojurescript和EDN進行靜態分析。它會在輸入時通知您可能出現的潛在錯誤（無執行程序）。

特徵

CLJ-KONDO檢測到：

內聯def表達式
多餘的do ， let包裝
Arity錯誤：
- 在同一名稱空間和跨命名空間中
- 靜態Java方法調用
- 當地的let and letfn綁定呼叫
- 遞歸電話（包括recur ）
- 超負荷功能中的矛盾的貧苦
未使用的私人var
私人和棄用的VAR用法
需要但未使用的名稱空間
未分類的必需名稱空間
引用但未使用的vars
重複需要
未使用的函數論證並讓綁定
標記為未使用，但使用了爭論並允許綁定（可選）
未使用的進口
重新定義var
未解決的符號，var和名稱空間
放置的docstrings
重複的地圖鍵和設置元素
在測試常數的情況下重複和引用
缺少地圖鍵
綁定向量中的形式數量無效
clojure.test/deftest中缺少斷言
別名一致性
類型檢查
Datalog語法檢查
格式字符串參數不匹配
陰影的var
2降低的論點用法（可選）

在您的表格命中率之前。

它建議了幾種樣式指南建議，例如：

斯圖爾特·塞拉（Stuart Sierra）的規則
使用:else作為cond中的全部測試表達式（請參閱Clojure樣式指南）
使用seq而不是(not (empty? ,,,)) （請參閱Clojure樣式指南）
不要讓您的行太久（請參閱Clojure樣式指南）

它支持對clojure.core.async/alt!! ， schema.core/defn potemkin/import-vars

它檢測到deps.edn和bb.edn中的常見錯誤

它提供分析數據，使您可以構建自己的自定義襯裡。

在此處查看所有可用的襯裡。

這個林格是：

與.clj ， .cljs ， .cljc和.edn文件兼容
構建工具和編輯不可知論
靜態代碼分析儀
使用graalvm編譯為本機代碼

在互動遊樂場嘗試CLJ-KONDO。

觀看談話：

支持❤️

您可以通過GitHub贊助商，OpenCollective，Ko-Fi或間接通過Clojurists一起支持此項目。

頂級贊助商

clojurists在一起
漫遊研究
NextJournal
Toyokumo
認知
Kepler16
adgoji

安裝

在JVM上運行

與Docker一起跑步

用法

命令行

來自stdin的皮棉：

$ echo ' (def x (def x 1)) ' | clj-kondo --lint -
<stdin>:1:8: warning: inline def

棉絨文件：

$ echo ' (def x (def x 1)) ' > /tmp/foo.clj
$ clj-kondo --lint /tmp/foo.clj
/tmp/foo.clj:1:8: warning: inline def

棉絨目錄：

$ clj-kondo --lint src
src/clj_kondo/test.cljs:7:1: warning: redundant do
src/clj_kondo/calls.clj:291:3: error: Wrong number of args (1) passed to clj-kondo.calls/analyze-calls

索具項目類Path：

$ clj-kondo --lint " $( lein classpath ) "

幫助：

$ clj-kondo --help
clj-kondo v2024.11.14

Options:

--lint <file>: a file can either be a normal file, directory or classpath. In the
case of a directory or classpath, only .clj, .cljs and .cljc will be
processed. Use - as filename for reading from stdin.

--lang <lang>: if lang cannot be derived from the file extension this option will be
used. Supported values: clj, cljs, cljc.

--filename <file>: in case stdin is used for linting, use this to set the
reported filename.

--cache-dir: when this option is provided, the cache will be resolved to this
directory. If --cache is false, this option will be ignored.

--cache: if false, won't use cache. Otherwise, will try to resolve cache
using `--cache-dir`. If `--cache-dir` is not set, cache is resolved using the
nearest `.clj-kondo` directory in the current and parent directories.

--config <config>: extra config that is merged. May be a file or an EDN expression. See https://github.com/clj-kondo/clj-kondo/blob/master/doc/config.md.

--config-dir <config-dir>: use this config directory instead of auto-detected
.clj-kondo dir.

--parallel: lint sources in parallel.

--dependencies: don't report any findings. Useful for populating cache while linting dependencies.

--copy-configs: copy configs from dependencies while linting.

--skip-lint: skip lint/analysis, still check for other tasks like copy-configs.

--fail-level <level>: minimum severity for exit with error code.  Supported values:
warning, error.  The default level if unspecified is warning.

--report-level <level>: minimum severity for which to report.  Supported values:
info, warning, error.  The default level if unspecified is info.

--debug: print debug information.

項目設置

為了檢測項目中命名空間的棉布錯誤，需要緩存。為了讓Clj-Kondo知道在哪裡創建一個，請在項目的根部製作.clj-kondo目錄，這意味著與您的project.clj ， deps.edn或build.boot ：buil.boot：

$ mkdir -p .clj-kondo

當您運行clj-kondo時，將在其內部創建一個緩存。在編輯器內部覆蓋之前，建議您使用整個class Path教授clj-kondo有關您使用的所有庫，包括Clojure和/或Clojurescript本身。一些庫帶有配置。要導入它們，首先運行：

$ clj-kondo --lint " <classpath> " --dependencies --copy-configs --skip-lint

--copy-configs標誌將搜索並複制從依賴關係中的配置中，並將其搜索到.clj-kondo目錄中，linting（請參閱config.md）。

使用配置，現在我們可以正確分析依賴項：

$ clj-kondo --lint " <classpath> " --dependencies --parallel

--dependencies標誌表明CLJ-KONDO用於分析源以填充緩存。啟用後，CLJ-KONDO將抑制警告並跳過已經凸起的.jar文件以供性能。

--parallel選項將使用多個線程來提起您的來源，並更快地通過它們。

注意：在2024.05.24之後的版本中，複製配置和覆蓋依賴項可以一次使用：

$ clj-kondo --lint " <classpath> " --dependencies --parallel --copy-configs

構建工具特定的方法來獲取類路徑：

lein classpath
boot with-cp -w -f -
clojure -Spath
npx shadow-cljs classpath

因此，對於lein整個命令將是：

 $ clj-kondo --lint "$(lein classpath)" --dependencies --parallel --copy-configs

現在，您可以使用編輯器集成來提高單個文件。對編輯器中編輯文件時發生的模擬：

$ echo ' (select-keys) ' | clj-kondo --lang cljs --lint -
<stdin>:1:1: error: Wrong number of args (0) passed to cljs.core/select-keys

由於Clj-Kondo現在通過緩存知道您的Clojurescript版本，因此它檢測到您傳遞給select-keys參數數量無效。每次您編輯文件時，緩存都會逐步更新，因此CLJ-KONDO會知道您剛剛編寫的新功能。

如果要使用其他目錄來讀取緩存，請使用--cache-dir選項。即使您有一個.clj-kondo目錄，請禁用緩存，請使用--cache false 。

配置

編輯整合

退出代碼

退出代碼可以由--fail-level <level>選項控制。默認失敗級別是warning ，該警告返回出口代碼如下：

0 ：找不到錯誤或警告
2 ：發現一個或多個警告
3 ：發現一個或多個錯誤

如果提供了--fail-level error ，則警告不會導致非零退出代碼：

0 ：找不到錯誤
0 ：發現一個或多個警告
3 ：發現一個或多個錯誤

除0和3以外的所有退出2都均表示錯誤，因為CLJ-KONDO中的錯誤或CLJ-KONDO的控制之外的其他一些意外錯誤。

CI集成

分析數據

開發人員文檔

使用Clj-Kondo的公司

宏

由於Clj-Kondo是靜態分析儀，因此不需要運行時（JVM，瀏覽器，node.js等）。它不會執行您的代碼。因此，它可以是使用運行時（例如Eastwood）的Linters的更快替代方法。這種方法具有Clj-Kondo無法執行宏的限制，因為宏可以使用運行時的任意功能。 Clj-Kondo支持Clojure Core宏和社區的一些受歡迎的圖書館。可以使用配置支持不支持的宏。配置宏的方法之一是為它們編寫鉤子（也請參見此Blogpost）。對於許多庫，您已經可以導入一種配置。還可以查看包含第三方庫配置的CLJ-KONDO配置。

Babashka Pod

Clj-Kondo可以被稱為Babashka Pod。

 #! /usr/bin/env bb
( ns script
  ( :require [babashka.pods :as pods]))

( pods/load-pod " clj-kondo " )
( require '[pod.borkdude.clj-kondo :as clj-kondo])

( clj-kondo/merge-configs
 '{ :linters { :unresolved-symbol { :exclude [( foo1.bar )]}}}
 '{ :linters { :unresolved-symbol { :exclude [( foo2.bar )]}}})
; ;=> {:linters {:unresolved-symbol {:exclude [(foo1.bar) (foo2.bar)]}}}

( -> ( clj-kondo/run! { :lint [ " src " ]})
    :summary )
; ;=> {:error 0, :warning 0, :info 0, :type :summary, :duration 779}