Bump version for release

Author: NoahTheDuke

CHANGELOG.md

@@ -4,6 +4,10 @@ This changelog is loose. Versions are not semantic, they are incremental. Splint
 
 ## Unreleased
 
+## 1.20.0 - 2025-03-28
+
+## 1.20.0 - 2025-03-28
+
 ### New Rules
 
 - `lint/misplaced-type-hint`: Prefer `(defn make-str ^String [] "abc")` over `(defn ^String make-str [] "abc")`. Only checks `defn` forms at the moment.

README.md

@@ -21,7 +21,7 @@ More explicit instructions can be found in the [installation][installation], [us
 ### Clojure CLI
 
 ```clojure lazytest/skip=true
-:aliases {:splint {:extra-deps {io.github.noahtheduke/splint {:mvn/version "1.19.0"}
+:aliases {:splint {:extra-deps {io.github.noahtheduke/splint {:mvn/version "1.20.0"}
                                 org.clojure/clojure {:mvn/version "1.11.1"}}
                    :main-opts ["-m" "noahtheduke.splint"]}}
 ```
@@ -33,7 +33,7 @@ Run with `clojure -M:splint [args...]`.
 Add this to `project.clj`:
 
 ```clojure lazytest/skip=true
-:profiles {:dev {:dependencies [[io.github.noahtheduke/splint "1.19.0"]
+:profiles {:dev {:dependencies [[io.github.noahtheduke/splint "1.20.0"]
                                 [org.clojure/clojure "1.11.1"]]}}
 :aliases {"splint" ["run" "-m" "noahtheduke.splint"]})
 ```

docs/installation.md

@@ -5,7 +5,7 @@ When used in a project as a library, put it in an alias to make it easier to inv
 ## Clojure CLI
 
 ```clojure
-:aliases {:splint {:extra-deps {io.github.noahtheduke/splint {:mvn/version "1.19.0"}
+:aliases {:splint {:extra-deps {io.github.noahtheduke/splint {:mvn/version "1.20.0"}
                                 org.clojure/clojure {:mvn/version "1.11.1"}}
                    :main-opts ["-m" "noahtheduke.splint"]}}
 ```
@@ -17,7 +17,7 @@ Run with `clojure -M:splint [args...]`.
 Add this to `project.clj`:
 
 ```clojure
-:profiles {:dev {:dependencies [[io.github.noahtheduke/splint "1.19.0"]
+:profiles {:dev {:dependencies [[io.github.noahtheduke/splint "1.20.0"]
                                 [org.clojure/clojure "1.11.1"]]}}
 :aliases {"splint" ["run" "-m" "noahtheduke.splint"]}
 ```
@@ -34,7 +34,7 @@ In the meantime, it runs fast on babashka and can be installed using `bbin`:
 $ bbin install io.github.noahtheduke/splint
 {:coords
  #:git{:url "https://github.com/noahtheduke/splint",
-       :tag "v1.19.0",
+       :tag "v1.20.0",
        :sha "..."},
  :lib io.github.noahtheduke/splint}
 ```

docs/rules/lint.md

@@ -25,6 +25,7 @@
 - [lint/locking-object](#lintlocking-object)
 - [lint/loop-do](#lintloop-do)
 - [lint/loop-empty-when](#lintloop-empty-when)
+- [lint/misplaced-type-hint](#lintmisplaced-type-hint)
 - [lint/missing-body-in-when](#lintmissing-body-in-when)
 - [lint/not-empty?](#lintnot-empty)
 - [lint/prefer-method-values](#lintprefer-method-values)
@@ -576,6 +577,42 @@ Empty loops with nested `when` can be `while`. Doesn't apply if the final expr o
 
 ---
 
+## lint/misplaced-type-hint
+
+| Enabled by default | Safe | Autocorrect | Version Added | Version Updated |
+| ------------------ | ---- | ----------- | ------------- | --------------- |
+| true               | true | false       | 1.20.0        | 1.20.0          |
+
+In interop scenarios, it can be necessary to add a type hint to mark a function's return type. This can be done by adding metadata to the function's name symbol or to the function's param vector. The former works but is prone to errors and is not recommended by the core team, whereas the latter is the official method. (See links below for further discussion.)
+
+**NOTE:** Only checks `defn` forms. (Compare with [eastwood's `:wrong-tag`](https://github.com/jonase/eastwood#wrong-tag) linter.)
+
+### Examples
+
+```clojure
+; avoid
+(defn ^String make-str
+  []
+  "abc")
+
+(defn ^String make-str
+  ([] "abc")
+  ([a] (str a "abc")))
+
+; prefer
+(defn make-str ^String [] "abc")
+(defn make-str
+  (^String [] "abc")
+  (^String [a] (str a "abc")))
+```
+
+### Reference
+
+* <https://clojure.org/reference/java_interop#typehints>
+* <https://clojure.org/guides/faq#return_type_hint>
+
+---
+
 ## lint/missing-body-in-when
 
 | Enabled by default | Safe | Autocorrect | Version Added | Version Updated |

docs/usage.md

@@ -2,7 +2,7 @@
 
 ```text
 $ clojure -M:splint --help
-splint v1.19.0
+splint v1.20.0
 
 Usage:
   splint [options]

justfile

@@ -73,7 +73,7 @@ current_version := `cat resources/SPLINT_VERSION | xargs`
 # Builds the uberjar, builds the jar, sends the jar to clojars
 @release version:
     echo 'Running tests'
-    just test-all
+    just test-all --output quiet
     echo 'Setting new version {{version}}'
     just set-version {{version}}
     echo 'Rendering docs'

resources/SPLINT_VERSION

@@ -1 +1 @@
-1.19.0
+1.20.0

resources/config/default.edn

@@ -162,8 +162,8 @@
  lint/misplaced-type-hint
  {:description "Put type hint on function's param vector, not function name."
   :enabled true
-  :added "<<next>>"
-  :updated "<<next>>"
+  :added "1.20.0"
+  :updated "1.20.0"
   :links ["https://clojure.org/reference/java_interop#typehints"
           "https://clojure.org/guides/faq#return_type_hint"]}