Skip to content
check-square

GitHub Action

CljDoc Check Action

v0.0.3 Pre-release

CljDoc Check Action

check-square

CljDoc Check Action

Check that CljDoc will be able to analyze the project successfully

Installation

Copy and paste the following snippet into your .yml file.

 
              
- name: CljDoc Check Action

              
  uses: cljdoc/cljdoc-check-action@v0.0.3
Learn more about this action in cljdoc/cljdoc-check-action

Choose a version

CljDoc Check Action

GitHub Action for checking that CljDoc will be able to analyze the project successfully

NOTE: CljDoc only works on the JAR archive of the library so you need to build it first.

Checking a clojure-deps based library is as simple as:

name: Check Cljdoc
on: [pull_request]
jobs:
  check-cljdoc:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v1
      - name Build target/<the lib>*.jar so that CljDoc analyze can use it:
        run: clojure -T:build jar # REPALCE with whatever you do to build your jar
      - name: CljDoc Check
          uses: cljdoc/cljdoc-check-action@v1

For other types of libraries, you need to install these into the local Maven repository (e.g. via lein install) and pass it the Maven coordinate and version:

# inside jobs.<name>.steps
- run: lein install # or whatever is usitable for your build tool/project, to install the library into a maven repo
- name: CljDoc Check
    uses: cljdoc/cljdoc-check-action@v1
    with:
      mvn_project: io.aviso/pretty
      mvn_version: LATEST # this is the default