git clone ''

(ql:quickload :camsaul.lein-docstring-checker)


Clojars Project

CircleCI GitHub license

Leiningen Plugin that lints your Clojure project and checks that every public var is documented.


Add docstring-checker to your :plugins in your project.clj:

:plugins [[docstring-checker "1.0.3"]]

Optionally specify which namespace regex patterns to :include and :exclude in your project.clj:

:docstring-checker {:include [#"^my-project\.core"]
                    :exclude [#"test"

Then run the linter with

$ lein docstring-checker

The linter will fail if any public vars in namespaces that match the specified patterns are undocumented.

Running Tests

Docstring Checker has a few small Leiningen projects in the test-projects directory that are used to make sure things are working correctly. You can run the shell script to test them:


These tests run on CircleCI whenever a new commit is pushed.


Copyright © 2018 Cam Saul

Distributed under the 3-Clause BSD License.