Python: stdlib models qa #13892
Workflow file for this run
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| name: "Check QLdoc coverage" | |
| on: | |
| pull_request: | |
| paths: | |
| - "*/ql/lib/**" | |
| - .github/workflows/check-qldoc.yml | |
| - .github/actions/fetch-codeql/action.yml | |
| branches: | |
| - main | |
| - "rc/*" | |
| permissions: | |
| contents: read | |
| jobs: | |
| qldoc: | |
| runs-on: ubuntu-latest | |
| steps: | |
| - uses: actions/checkout@v4 | |
| with: | |
| fetch-depth: 2 | |
| - name: Install CodeQL | |
| uses: ./.github/actions/fetch-codeql | |
| - name: Check QLdoc coverage | |
| shell: bash | |
| run: | | |
| EXIT_CODE=0 | |
| # TODO: remove the shared exception from the regex when coverage of qlpacks without dbschemes is supported | |
| changed_lib_packs="$(git diff --name-only --diff-filter=ACMRT HEAD^ HEAD | { grep -Po '^(?!(shared))[a-z]*/ql/lib' || true; } | sort -u)" | |
| for pack_dir in ${changed_lib_packs}; do | |
| lang="${pack_dir%/ql/lib}" | |
| codeql generate library-doc-coverage --output="${RUNNER_TEMP}/${lang}-current.txt" --dir="${pack_dir}" | |
| done | |
| git checkout HEAD^ | |
| for pack_dir in ${changed_lib_packs}; do | |
| # When we add a new language, pack_dir would not exist in HEAD^. | |
| # In this case the right thing to do is to skip the check. | |
| [[ ! -d "${pack_dir}" ]] && continue | |
| lang="${pack_dir%/ql/lib}" | |
| codeql generate library-doc-coverage --output="${RUNNER_TEMP}/${lang}-baseline.txt" --dir="${pack_dir}" | |
| awk -F, '{gsub(/"/,""); if ($4==0 && $6=="public") print "\""$3"\"" }' "${RUNNER_TEMP}/${lang}-current.txt" | sort -u > "${RUNNER_TEMP}/current-undocumented.txt" | |
| awk -F, '{gsub(/"/,""); if ($4==0 && $6=="public") print "\""$3"\"" }' "${RUNNER_TEMP}/${lang}-baseline.txt" | sort -u > "${RUNNER_TEMP}/baseline-undocumented.txt" | |
| UNDOCUMENTED="$(grep -f <(comm -13 "${RUNNER_TEMP}/baseline-undocumented.txt" "${RUNNER_TEMP}/current-undocumented.txt") "${RUNNER_TEMP}/${lang}-current.txt" || true)" | |
| if [ -n "$UNDOCUMENTED" ]; then | |
| echo "$UNDOCUMENTED" | awk -F, '{gsub(/"/,""); print "::warning file='"${pack_dir}"'/"$1",line="$2"::Missing QLdoc for "$5, $3 }' | |
| EXIT_CODE=1 | |
| fi | |
| done | |
| exit "${EXIT_CODE}" |