rumdl 0.2.55

A fast Markdown linter written in Rust (Ru(st) MarkDown Linter)
Documentation
name: "rumdl-action"
description: "Lint Markdown files with rumdl"
author: "rvben"

branding:
  icon: "check-circle"
  color: "orange"

inputs:
  version:
    description: "Version of rumdl to install (default: latest)"
    required: false
    default: ""
  command:
    description: |
      Which rumdl command to run.
      Possible values: check (default), fmt-check, fmt
      `fmt-check` reports files that are not formatted and leaves them alone;
      `fmt` rewrites them in the workspace.
    required: false
    default: "check"
  path:
    description: "File(s) or directories to lint, space-separated (default: workspace root)"
    required: false
    default: ""
  config:
    description: "Path to config file"
    required: false
    default: ""
  report-type:
    description: |
      How this action should report results.
      Possible values: logs (default), annotations
    required: false
    default: "logs"
  fail-on-error:
    description: "Fail the workflow if violations are found (default: true)"
    required: false
    default: "true"
  output-file:
    description: "Write results to this file path (optional)"
    required: false
    default: ""
  args:
    description: "Additional CLI arguments passed to the selected command (e.g. --extend-disable MD013,MD024)"
    required: false
    default: ""
  install-only:
    description: |
      Install rumdl and add it to PATH without linting, so later steps can call
      `rumdl` themselves (e.g. from a Makefile). All lint inputs are ignored.
      Possible values: false (default), true
    required: false
    default: "false"

outputs:
  rumdl-version:
    description: "Version of rumdl that was installed"
    value: ${{ steps.rumdl.outputs.rumdl-version }}
  rumdl-path:
    description: "Absolute path to the installed rumdl executable"
    value: ${{ steps.rumdl.outputs.rumdl-path }}

runs:
  using: "composite"
  steps:
    - name: Install rumdl and lint Markdown files
      id: rumdl
      shell: bash
      run: $GITHUB_ACTION_PATH/scripts/rumdl-action.sh
      env:
        GHA_RUMDL_VERSION: ${{ inputs.version }}
        GHA_RUMDL_INSTALL_ONLY: ${{ inputs.install-only }}
        GHA_RUMDL_COMMAND: ${{ inputs.command }}
        GHA_RUMDL_PATH: ${{ inputs.path }}
        GHA_RUMDL_CONFIG: ${{ inputs.config }}
        GHA_RUMDL_REPORT_TYPE: ${{ inputs.report-type }}
        GHA_RUMDL_FAIL_ON_ERROR: ${{ inputs.fail-on-error }}
        GHA_RUMDL_OUTPUT_FILE: ${{ inputs.output-file }}
        GHA_RUMDL_ARGS: ${{ inputs.args }}