Check in `help-all.json` for posterity #43

thejcannon · 2024-01-02T20:40:43Z

This changed fixes #29 by:

Checking in the help-all.json for every version, under the reference directory
Adjust the sync docs CI and generation scripts to handle this change

Script to generate these versions

(Note /home/josh/work/scie-pants/dist/scie-pants-linux-x86_64 contains a temporary fix for pantsbuild/scie-pants#321)

#!/bin/bash -x
set -e

HERE=$PWD
cd $(mktemp -d)
touch pants.toml
touch BUILDROOT

# @TODO: The Pants launcher dies pre 2.8: https://github.com/pantsbuild/scie-pants/issues/321

export PANTS_NO_VERIFY_CONFIG=true
export PANTS_BACKEND_PACKAGES=[]

PANTS_VERSION=2.0.2 /home/josh/work/scie-pants/dist/scie-pants-linux-x86_64 \
    --backend-packages='[ \
        "pants.backend.python", \
        "pants.backend.python.lint.black", \
        "pants.backend.python.lint.docformatter", \
        "pants.backend.python.lint.flake8", \
        "pants.backend.python.lint.isort", \
        "pants.backend.python.typecheck.mypy", \
        "pants.backend.python.lint.bandit", \
        "pants.backend.python.lint.pylint", \
        "pants.backend.codegen.protobuf.python", \
        "pants.backend.awslambda.python"\
    ]' \
    help-all > "$HERE/2.0.x.help-all.json"

PANTS_VERSION=2.1.2 /home/josh/work/scie-pants/dist/scie-pants-linux-x86_64 \
    --backend-packages='[ \
        "pants.backend.python", \
        "pants.backend.python.lint.black", \
        "pants.backend.python.lint.docformatter", \
        "pants.backend.python.lint.flake8", \
        "pants.backend.python.lint.isort", \
        "pants.backend.python.typecheck.mypy", \
        "pants.backend.python.lint.bandit", \
        "pants.backend.python.lint.pylint", \
        "pants.backend.codegen.protobuf.python", \
        "pants.backend.awslambda.python"\
    ]' \
    help-all > "$HERE/2.1.x.help-all.json"

PANTS_VERSION=2.2.4 /home/josh/work/scie-pants/dist/scie-pants-linux-x86_64 \
    --backend-packages='[ \
        "pants.backend.awslambda.python", \
        "pants.backend.python", \
        "pants.backend.codegen.protobuf.python", \
        "pants.backend.python.lint.black", \
        "pants.backend.python.lint.docformatter", \
        "pants.backend.python.lint.flake8", \
        "pants.backend.python.lint.isort", \
        "pants.backend.python.typecheck.mypy", \
        "pants.backend.python.mixed_interpreter_constraints", \
        "pants.backend.python.lint.bandit", \
        "pants.backend.python.lint.pylint", \
    ]' \
    help-all > "$HERE/2.2.x.help-all.json"

PANTS_VERSION=2.3.3 /home/josh/work/scie-pants/dist/scie-pants-linux-x86_64 \
    --backend-packages='[ \
        "pants.backend.awslambda.python", \
        "pants.backend.python", \
        "pants.backend.codegen.protobuf.python", \
        "pants.backend.python.lint.black", \
        "pants.backend.python.lint.docformatter", \
        "pants.backend.python.lint.flake8", \
        "pants.backend.python.lint.isort", \
        "pants.backend.python.typecheck.mypy", \
        "pants.backend.python.mixed_interpreter_constraints", \
        "pants.backend.python.lint.bandit", \
        "pants.backend.python.lint.pylint", \
    ]' \
    help-all > "$HERE/2.3.x.help-all.json"

PANTS_VERSION=2.4.2 /home/josh/work/scie-pants/dist/scie-pants-linux-x86_64 \
    --backend-packages='[ \
        "pants.backend.awslambda.python", \
        "pants.backend.python", \
        "pants.backend.codegen.protobuf.python", \
        "pants.backend.python.lint.black", \
        "pants.backend.python.lint.docformatter", \
        "pants.backend.python.lint.flake8", \
        "pants.backend.python.lint.isort", \
        "pants.backend.python.typecheck.mypy", \
        "pants.backend.python.mixed_interpreter_constraints", \
        "pants.backend.python.lint.bandit", \
        "pants.backend.python.lint.pylint", \
    ]' \
    help-all > "$HERE/2.4.x.help-all.json"

PANTS_VERSION=2.5.2 /home/josh/work/scie-pants/dist/scie-pants-linux-x86_64 \
    --backend-packages='[ \
        "pants.backend.awslambda.python", \
        "pants.backend.python", \
        "pants.backend.codegen.protobuf.python", \
        "pants.backend.python.lint.black", \
        "pants.backend.python.lint.docformatter", \
        "pants.backend.python.lint.flake8", \
        "pants.backend.python.lint.isort", \
        "pants.backend.python.typecheck.mypy", \
        "pants.backend.python.mixed_interpreter_constraints", \
        "pants.backend.shell", \
        "pants.backend.shell.lint.shellcheck", \
        "pants.backend.shell.lint.shfmt", \
        "pants.backend.python.lint.bandit", \
        "pants.backend.python.lint.pylint", \
    ]' \
    help-all > "$HERE/2.5.x.help-all.json"

PANTS_VERSION=2.6.1 /home/josh/work/scie-pants/dist/scie-pants-linux-x86_64 \
    --backend-packages='[ \
        "pants.backend.awslambda.python", \
        "pants.backend.python", \
        "pants.backend.codegen.protobuf.python", \
        "pants.backend.python.lint.black", \
        "pants.backend.python.lint.docformatter", \
        "pants.backend.python.lint.flake8", \
        "pants.backend.python.lint.isort", \
        "pants.backend.python.typecheck.mypy", \
        "pants.backend.python.mixed_interpreter_constraints", \
        "pants.backend.shell", \
        "pants.backend.shell.lint.shellcheck", \
        "pants.backend.shell.lint.shfmt", \
        "pants.backend.python.lint.bandit", \
        "pants.backend.python.lint.pylint", \
    ]' \
    help-all > "$HERE/2.6.x.help-all.json"

PANTS_VERSION=2.7.2 /home/josh/work/scie-pants/dist/scie-pants-linux-x86_64 \
    --backend-packages='[ \
        "pants.backend.python", \
        "pants.backend.python.lint.black", \
        "pants.backend.python.lint.docformatter", \
        "pants.backend.python.lint.flake8", \
        "pants.backend.python.lint.isort", \
        "pants.backend.python.typecheck.mypy", \
        "pants.backend.python.mixed_interpreter_constraints", \
        "pants.backend.shell", \
        "pants.backend.shell.lint.shellcheck", \
        "pants.backend.shell.lint.shfmt", \
        "pants.backend.experimental.python", \
        "pants.backend.experimental.docker", \
        "pants.backend.codegen.protobuf.python", \
        "pants.backend.awslambda.python", \
        "pants.backend.python.lint.bandit", \
        "pants.backend.python.lint.pylint", \
        "pants.backend.python.lint.yapf", \
    ]' \
    help-all > "$HERE/2.7.x.help-all.json"

PANTS_VERSION=2.8.1 /home/josh/work/scie-pants/dist/scie-pants-linux-x86_64 \
    --backend-packages='[ \
        "pants.backend.python", \
        "pants.backend.experimental.python.lint.autoflake", \
        "pants.backend.python.lint.black", \
        "pants.backend.python.lint.docformatter", \
        "pants.backend.python.lint.flake8", \
        "pants.backend.python.lint.isort", \
        "pants.backend.python.typecheck.mypy", \
        "pants.backend.python.mixed_interpreter_constraints", \
        "pants.backend.shell", \
        "pants.backend.shell.lint.shellcheck", \
        "pants.backend.shell.lint.shfmt", \
        "pants.backend.experimental.docker", \
        "pants.backend.experimental.go", \
        "pants.backend.experimental.java", \
        "pants.backend.experimental.java.debug_goals", \
        "pants.backend.experimental.python", \
        "pants.backend.experimental.python.lint.pyupgrade", \
        "pants.backend.codegen.protobuf.python", \
        "pants.backend.awslambda.python", \
        "pants.backend.python.lint.bandit", \
        "pants.backend.python.lint.pylint", \
        "pants.backend.python.lint.yapf", \
    ]' \
    help-all > "$HERE/2.8.x.help-all.json"

PANTS_VERSION=2.9.2 /home/josh/work/scie-pants/dist/scie-pants-linux-x86_64 \
    --backend-packages='[ \
        "pants.backend.awslambda.python", \
        "pants.backend.codegen.protobuf.python", \
        "pants.backend.experimental.docker", \
        "pants.backend.experimental.docker.lint.hadolint", \
        "pants.backend.experimental.go", \
        "pants.backend.experimental.java", \
        "pants.backend.experimental.java.lint.google_java_format", \
        "pants.backend.experimental.python", \
        "pants.backend.experimental.python.lint.autoflake", \
        "pants.backend.experimental.python.lint.pyupgrade", \
        "pants.backend.experimental.scala", \
        "pants.backend.experimental.scala.lint.scalafmt", \
        "pants.backend.google_cloud_function.python", \
        "pants.backend.plugin_development", \
        "pants.backend.python", \
        "pants.backend.python.lint.bandit", \
        "pants.backend.python.lint.black", \
        "pants.backend.python.lint.docformatter", \
        "pants.backend.python.lint.flake8", \
        "pants.backend.python.lint.isort", \
        "pants.backend.python.lint.pylint", \
        "pants.backend.python.lint.yapf", \
        "pants.backend.python.mixed_interpreter_constraints", \
        "pants.backend.python.typecheck.mypy", \
        "pants.backend.shell", \
        "pants.backend.shell.lint.shellcheck", \
        "pants.backend.shell.lint.shfmt", \
    ]' \
    help-all > "$HERE/2.9.x.help-all.json"

PANTS_VERSION=2.10.1 /home/josh/work/scie-pants/dist/scie-pants-linux-x86_64 \
    --backend-packages='[ \
        "pants.backend.awslambda.python", \
        "pants.backend.codegen.protobuf.python", \
        "pants.backend.codegen.thrift.apache.python", \
        "pants.backend.docker", \
        "pants.backend.docker.lint.hadolint", \
        "pants.backend.experimental.go", \
        "pants.backend.experimental.java", \
        "pants.backend.experimental.java.lint.google_java_format", \
        "pants.backend.experimental.python", \
        "pants.backend.experimental.python.lint.autoflake", \
        "pants.backend.experimental.python.lint.pyupgrade", \
        "pants.backend.experimental.python.packaging.pyoxidizer", \
        "pants.backend.experimental.scala", \
        "pants.backend.experimental.scala.lint.scalafmt", \
        "pants.backend.google_cloud_function.python", \
        "pants.backend.plugin_development", \
        "pants.backend.python", \
        "pants.backend.python.lint.bandit", \
        "pants.backend.python.lint.black", \
        "pants.backend.python.lint.docformatter", \
        "pants.backend.python.lint.flake8", \
        "pants.backend.python.lint.isort", \
        "pants.backend.python.lint.pylint", \
        "pants.backend.python.lint.yapf", \
        "pants.backend.python.mixed_interpreter_constraints", \
        "pants.backend.python.typecheck.mypy", \
        "pants.backend.shell", \
        "pants.backend.shell.lint.shellcheck", \
        "pants.backend.shell.lint.shfmt", \
    ]' \
    help-all > "$HERE/2.10.x.help-all.json"

PANTS_VERSION=2.11.1 /home/josh/work/scie-pants/dist/scie-pants-linux-x86_64 \
    --backend-packages='[ \
        "pants.backend.awslambda.python", \
        "pants.backend.codegen.protobuf.lint.buf", \
        "pants.backend.codegen.protobuf.python", \
        "pants.backend.codegen.thrift.apache.python", \
        "pants.backend.docker", \
        "pants.backend.docker.lint.hadolint", \
        "pants.backend.experimental.codegen.protobuf.go", \
        "pants.backend.experimental.codegen.protobuf.java", \
        "pants.backend.experimental.codegen.protobuf.scala", \
        "pants.backend.experimental.go", \
        "pants.backend.experimental.helm", \
        "pants.backend.experimental.java", \
        "pants.backend.experimental.java.lint.google_java_format", \
        "pants.backend.experimental.python", \
        "pants.backend.experimental.python.lint.autoflake", \
        "pants.backend.experimental.python.lint.pyupgrade", \
        "pants.backend.experimental.python.packaging.pyoxidizer", \
        "pants.backend.experimental.scala", \
        "pants.backend.experimental.scala.lint.scalafmt", \
        "pants.backend.experimental.terraform", \
        "pants.backend.google_cloud_function.python", \
        "pants.backend.plugin_development", \
        "pants.backend.python", \
        "pants.backend.python.lint.bandit", \
        "pants.backend.python.lint.black", \
        "pants.backend.python.lint.docformatter", \
        "pants.backend.python.lint.flake8", \
        "pants.backend.python.lint.isort", \
        "pants.backend.python.lint.pylint", \
        "pants.backend.python.lint.yapf", \
        "pants.backend.python.mixed_interpreter_constraints", \
        "pants.backend.python.typecheck.mypy", \
        "pants.backend.shell", \
        "pants.backend.shell.lint.shellcheck", \
        "pants.backend.shell.lint.shfmt", \
    ]' \
    help-all > "$HERE/2.11.x.help-all.json"

PANTS_VERSION=2.12.1 /home/josh/work/scie-pants/dist/scie-pants-linux-x86_64 \
    --backend-packages='[ \
        "pants.backend.awslambda.python", \
        "pants.backend.codegen.protobuf.lint.buf", \
        "pants.backend.codegen.protobuf.python", \
        "pants.backend.codegen.thrift.apache.python", \
        "pants.backend.docker", \
        "pants.backend.docker.lint.hadolint", \
        "pants.backend.experimental.codegen.protobuf.go", \
        "pants.backend.experimental.codegen.protobuf.java", \
        "pants.backend.experimental.codegen.protobuf.scala", \
        "pants.backend.experimental.go", \
        "pants.backend.experimental.helm", \
        "pants.backend.experimental.java", \
        "pants.backend.experimental.java.lint.google_java_format", \
        "pants.backend.experimental.kotlin", \
        "pants.backend.experimental.kotlin.lint.ktlint", \
        "pants.backend.experimental.python", \
        "pants.backend.experimental.python.lint.autoflake", \
        "pants.backend.experimental.python.lint.pyupgrade", \
        "pants.backend.experimental.python.packaging.pyoxidizer", \
        "pants.backend.experimental.scala", \
        "pants.backend.experimental.scala.lint.scalafmt", \
        "pants.backend.experimental.terraform", \
        "pants.backend.google_cloud_function.python", \
        "pants.backend.plugin_development", \
        "pants.backend.python", \
        "pants.backend.python.lint.bandit", \
        "pants.backend.python.lint.black", \
        "pants.backend.python.lint.docformatter", \
        "pants.backend.python.lint.flake8", \
        "pants.backend.python.lint.isort", \
        "pants.backend.python.lint.pylint", \
        "pants.backend.python.lint.yapf", \
        "pants.backend.python.mixed_interpreter_constraints", \
        "pants.backend.python.typecheck.mypy", \
        "pants.backend.shell", \
        "pants.backend.shell.lint.shellcheck", \
        "pants.backend.shell.lint.shfmt", \
    ]' \
    help-all > "$HERE/2.12.x.help-all.json"

PANTS_VERSION=2.13.1 /home/josh/work/scie-pants/dist/scie-pants-linux-x86_64 \
    --backend-packages='[ \
        "pants.backend.awslambda.python", \
        "pants.backend.codegen.protobuf.lint.buf", \
        "pants.backend.codegen.protobuf.python", \
        "pants.backend.codegen.thrift.apache.python", \
        "pants.backend.docker", \
        "pants.backend.docker.lint.hadolint", \
        "pants.backend.experimental.codegen.protobuf.go", \
        "pants.backend.experimental.codegen.protobuf.java", \
        "pants.backend.experimental.codegen.protobuf.scala", \
        "pants.backend.experimental.go", \
        "pants.backend.experimental.helm", \
        "pants.backend.experimental.java", \
        "pants.backend.experimental.java.lint.google_java_format", \
        "pants.backend.experimental.kotlin", \
        "pants.backend.experimental.kotlin.lint.ktlint", \
        "pants.backend.experimental.python", \
        "pants.backend.experimental.python.lint.autoflake", \
        "pants.backend.experimental.python.lint.pyupgrade", \
        "pants.backend.experimental.python.packaging.pyoxidizer", \
        "pants.backend.experimental.scala", \
        "pants.backend.experimental.scala.lint.scalafmt", \
        "pants.backend.experimental.terraform", \
        "pants.backend.google_cloud_function.python", \
        "pants.backend.plugin_development", \
        "pants.backend.python", \
        "pants.backend.python.lint.bandit", \
        "pants.backend.python.lint.black", \
        "pants.backend.python.lint.docformatter", \
        "pants.backend.python.lint.flake8", \
        "pants.backend.python.lint.isort", \
        "pants.backend.python.lint.pylint", \
        "pants.backend.python.lint.yapf", \
        "pants.backend.python.mixed_interpreter_constraints", \
        "pants.backend.python.typecheck.mypy", \
        "pants.backend.shell", \
        "pants.backend.shell.lint.shellcheck", \
        "pants.backend.shell.lint.shfmt", \
    ]' \
    help-all > "$HERE/2.13.x.help-all.json"

PANTS_VERSION=2.14.2 /home/josh/work/scie-pants/dist/scie-pants-linux-x86_64 \
    --backend-packages='[ \
        "pants.backend.build_files.fmt.black", \
        "pants.backend.build_files.fmt.buildifier", \
        "pants.backend.build_files.fmt.yapf", \
        "pants.backend.awslambda.python", \
        "pants.backend.codegen.protobuf.lint.buf", \
        "pants.backend.codegen.protobuf.python", \
        "pants.backend.codegen.thrift.apache.python", \
        "pants.backend.docker", \
        "pants.backend.docker.lint.hadolint", \
        "pants.backend.experimental.codegen.protobuf.go", \
        "pants.backend.experimental.codegen.protobuf.java", \
        "pants.backend.experimental.codegen.protobuf.scala", \
        "pants.backend.experimental.go", \
        "pants.backend.experimental.helm", \
        "pants.backend.experimental.java", \
        "pants.backend.experimental.java.lint.google_java_format", \
        "pants.backend.experimental.kotlin", \
        "pants.backend.experimental.kotlin.lint.ktlint", \
        "pants.backend.experimental.python", \
        "pants.backend.experimental.python.lint.autoflake", \
        "pants.backend.experimental.python.lint.pyupgrade", \
        "pants.backend.experimental.python.packaging.pyoxidizer", \
        "pants.backend.experimental.scala", \
        "pants.backend.experimental.scala.lint.scalafmt", \
        "pants.backend.experimental.terraform", \
        "pants.backend.google_cloud_function.python", \
        "pants.backend.plugin_development", \
        "pants.backend.python", \
        "pants.backend.python.lint.bandit", \
        "pants.backend.python.lint.black", \
        "pants.backend.python.lint.docformatter", \
        "pants.backend.python.lint.flake8", \
        "pants.backend.python.lint.isort", \
        "pants.backend.python.lint.pylint", \
        "pants.backend.python.lint.yapf", \
        "pants.backend.python.mixed_interpreter_constraints", \
        "pants.backend.python.typecheck.mypy", \
        "pants.backend.shell", \
        "pants.backend.shell.lint.shellcheck", \
        "pants.backend.shell.lint.shfmt", \
    ]' \
    help-all > "$HERE/2.14.x.help-all.json"

PANTS_VERSION=2.15.2 /home/josh/work/scie-pants/dist/scie-pants-linux-x86_64 \
    --backend-packages='[ \
        "pants.backend.build_files.fix.deprecations", \
        "pants.backend.build_files.fmt.black", \
        "pants.backend.build_files.fmt.buildifier", \
        "pants.backend.build_files.fmt.yapf", \
        "pants.backend.awslambda.python", \
        "pants.backend.codegen.protobuf.lint.buf", \
        "pants.backend.codegen.protobuf.python", \
        "pants.backend.codegen.thrift.apache.python", \
        "pants.backend.docker", \
        "pants.backend.docker.lint.hadolint", \
        "pants.backend.experimental.codegen.protobuf.go", \
        "pants.backend.experimental.codegen.protobuf.java", \
        "pants.backend.experimental.codegen.protobuf.scala", \
        "pants.backend.experimental.go", \
        "pants.backend.experimental.helm", \
        "pants.backend.experimental.java", \
        "pants.backend.experimental.java.lint.google_java_format", \
        "pants.backend.experimental.kotlin", \
        "pants.backend.experimental.kotlin.lint.ktlint", \
        "pants.backend.experimental.openapi", \
        "pants.backend.experimental.openapi.lint.spectral", \
        "pants.backend.experimental.python", \
        "pants.backend.experimental.python.lint.add_trailing_comma", \
        "pants.backend.experimental.python.lint.autoflake", \
        "pants.backend.experimental.python.lint.pyupgrade", \
        "pants.backend.experimental.python.packaging.pyoxidizer", \
        "pants.backend.experimental.scala", \
        "pants.backend.experimental.scala.lint.scalafmt", \
        "pants.backend.experimental.terraform", \
        "pants.backend.google_cloud_function.python", \
        "pants.backend.plugin_development", \
        "pants.backend.python", \
        "pants.backend.python.lint.bandit", \
        "pants.backend.python.lint.black", \
        "pants.backend.python.lint.docformatter", \
        "pants.backend.python.lint.flake8", \
        "pants.backend.python.lint.isort", \
        "pants.backend.python.lint.pylint", \
        "pants.backend.python.lint.yapf", \
        "pants.backend.python.mixed_interpreter_constraints", \
        "pants.backend.python.typecheck.mypy", \
        "pants.backend.shell", \
        "pants.backend.shell.lint.shellcheck", \
        "pants.backend.shell.lint.shfmt", \
    ]' \
    help-all > "$HERE/2.15.x.help-all.json"

PANTS_VERSION=2.16.1rc4 /home/josh/work/scie-pants/dist/scie-pants-linux-x86_64 \
    --backend-packages='[ \
        "pants.backend.build_files.fix.deprecations", \
        "pants.backend.build_files.fmt.black", \
        "pants.backend.build_files.fmt.buildifier", \
        "pants.backend.build_files.fmt.yapf", \
        "pants.backend.awslambda.python", \
        "pants.backend.codegen.protobuf.lint.buf", \
        "pants.backend.codegen.protobuf.python", \
        "pants.backend.codegen.thrift.apache.python", \
        "pants.backend.docker", \
        "pants.backend.docker.lint.hadolint", \
        "pants.backend.experimental.adhoc", \
        "pants.backend.experimental.codegen.protobuf.go", \
        "pants.backend.experimental.codegen.protobuf.java", \
        "pants.backend.experimental.codegen.protobuf.scala", \
        "pants.backend.experimental.go", \
        "pants.backend.experimental.helm", \
        "pants.backend.experimental.java", \
        "pants.backend.experimental.java.lint.google_java_format", \
        "pants.backend.experimental.kotlin", \
        "pants.backend.experimental.kotlin.lint.ktlint", \
        "pants.backend.experimental.openapi", \
        "pants.backend.experimental.openapi.lint.spectral", \
        "pants.backend.experimental.python", \
        "pants.backend.experimental.python.framework.stevedore", \
        "pants.backend.experimental.python.lint.add_trailing_comma", \
        "pants.backend.experimental.python.lint.ruff", \
        "pants.backend.experimental.python.packaging.pyoxidizer", \
        "pants.backend.experimental.scala", \
        "pants.backend.experimental.scala.lint.scalafmt", \
        "pants.backend.experimental.terraform", \
        "pants.backend.experimental.tools.yamllint", \
        "pants.backend.google_cloud_function.python", \
        "pants.backend.plugin_development", \
        "pants.backend.python", \
        "pants.backend.python.lint.autoflake", \
        "pants.backend.python.lint.bandit", \
        "pants.backend.python.lint.black", \
        "pants.backend.python.lint.docformatter", \
        "pants.backend.python.lint.flake8", \
        "pants.backend.python.lint.isort", \
        "pants.backend.python.lint.pydocstyle", \
        "pants.backend.python.lint.pylint", \
        "pants.backend.python.lint.pyupgrade", \
        "pants.backend.python.lint.yapf", \
        "pants.backend.python.mixed_interpreter_constraints", \
        "pants.backend.python.typecheck.mypy", \
        "pants.backend.shell", \
        "pants.backend.shell.lint.shellcheck", \
        "pants.backend.shell.lint.shfmt", \
        "pants.backend.tools.preamble", \
    ]' \
    help-all > "$HERE/2.16.x.help-all.json"

PANTS_VERSION=2.17.1rc3 /home/josh/work/scie-pants/dist/scie-pants-linux-x86_64 \
    --backend-packages='[ \
        "pants.backend.build_files.fix.deprecations", \
        "pants.backend.build_files.fmt.black", \
        "pants.backend.build_files.fmt.buildifier", \
        "pants.backend.build_files.fmt.yapf", \
        "pants.backend.awslambda.python", \
        "pants.backend.codegen.protobuf.lint.buf", \
        "pants.backend.codegen.protobuf.python", \
        "pants.backend.codegen.thrift.apache.python", \
        "pants.backend.docker", \
        "pants.backend.docker.lint.hadolint", \
        "pants.backend.experimental.adhoc", \
        "pants.backend.experimental.codegen.protobuf.go", \
        "pants.backend.experimental.codegen.protobuf.java", \
        "pants.backend.experimental.codegen.protobuf.scala", \
        "pants.backend.experimental.go", \
        "pants.backend.experimental.helm", \
        "pants.backend.experimental.java", \
        "pants.backend.experimental.java.lint.google_java_format", \
        "pants.backend.experimental.kotlin", \
        "pants.backend.experimental.kotlin.lint.ktlint", \
        "pants.backend.experimental.openapi", \
        "pants.backend.experimental.openapi.lint.spectral", \
        "pants.backend.experimental.python", \
        "pants.backend.experimental.python.framework.stevedore", \
        "pants.backend.experimental.python.lint.add_trailing_comma", \
        "pants.backend.experimental.python.lint.ruff", \
        "pants.backend.experimental.python.packaging.pyoxidizer", \
        "pants.backend.experimental.scala", \
        "pants.backend.experimental.scala.lint.scalafmt", \
        "pants.backend.experimental.terraform", \
        "pants.backend.experimental.tools.workunit_logger", \
        "pants.backend.experimental.tools.yamllint", \
        "pants.backend.google_cloud_function.python", \
        "pants.backend.plugin_development", \
        "pants.backend.python", \
        "pants.backend.python.lint.autoflake", \
        "pants.backend.python.lint.bandit", \
        "pants.backend.python.lint.black", \
        "pants.backend.python.lint.docformatter", \
        "pants.backend.python.lint.flake8", \
        "pants.backend.python.lint.isort", \
        "pants.backend.python.lint.pydocstyle", \
        "pants.backend.python.lint.pylint", \
        "pants.backend.python.lint.pyupgrade", \
        "pants.backend.python.lint.yapf", \
        "pants.backend.python.mixed_interpreter_constraints", \
        "pants.backend.python.typecheck.mypy", \
        "pants.backend.shell", \
        "pants.backend.shell.lint.shellcheck", \
        "pants.backend.shell.lint.shfmt", \
        "pants.backend.tools.preamble", \
    ]' \
    help-all > "$HERE/2.17.x.help-all.json"

PANTS_VERSION=2.18.0rc5 /home/josh/work/scie-pants/dist/scie-pants-linux-x86_64 \
    --backend-packages='[ \
        "pants.backend.build_files.fix.deprecations", \
        "pants.backend.build_files.fmt.black", \
        "pants.backend.build_files.fmt.buildifier", \
        "pants.backend.build_files.fmt.yapf", \
        "pants.backend.awslambda.python", \
        "pants.backend.codegen.protobuf.lint.buf", \
        "pants.backend.codegen.protobuf.python", \
        "pants.backend.codegen.thrift.apache.python", \
        "pants.backend.docker", \
        "pants.backend.docker.lint.hadolint", \
        "pants.backend.experimental.adhoc", \
        "pants.backend.experimental.codegen.protobuf.go", \
        "pants.backend.experimental.codegen.protobuf.java", \
        "pants.backend.experimental.codegen.protobuf.scala", \
        "pants.backend.experimental.go", \
        "pants.backend.experimental.helm", \
        "pants.backend.experimental.java", \
        "pants.backend.experimental.java.lint.google_java_format", \
        "pants.backend.experimental.kotlin", \
        "pants.backend.experimental.kotlin.lint.ktlint", \
        "pants.backend.experimental.openapi", \
        "pants.backend.experimental.openapi.lint.spectral", \
        "pants.backend.experimental.python", \
        "pants.backend.experimental.python.framework.stevedore", \
        "pants.backend.experimental.python.lint.add_trailing_comma", \
        "pants.backend.experimental.python.lint.ruff", \
        "pants.backend.experimental.python.packaging.pyoxidizer", \
        "pants.backend.experimental.python.typecheck.pytype", \
        "pants.backend.experimental.scala", \
        "pants.backend.experimental.scala.lint.scalafmt", \
        "pants.backend.experimental.terraform", \
        "pants.backend.experimental.tools.workunit_logger", \
        "pants.backend.experimental.tools.yamllint", \
        "pants.backend.google_cloud_function.python", \
        "pants.backend.plugin_development", \
        "pants.backend.python", \
        "pants.backend.python.lint.autoflake", \
        "pants.backend.python.lint.bandit", \
        "pants.backend.python.lint.black", \
        "pants.backend.python.lint.docformatter", \
        "pants.backend.python.lint.flake8", \
        "pants.backend.python.lint.isort", \
        "pants.backend.python.lint.pydocstyle", \
        "pants.backend.python.lint.pylint", \
        "pants.backend.python.lint.pyupgrade", \
        "pants.backend.python.lint.yapf", \
        "pants.backend.python.mixed_interpreter_constraints", \
        "pants.backend.python.typecheck.mypy", \
        "pants.backend.shell", \
        "pants.backend.shell.lint.shellcheck", \
        "pants.backend.shell.lint.shfmt", \
        "pants.backend.tools.preamble", \
    ]' \
    help-all > "$HERE/2.18.x.help-all.json"


PANTS_VERSION=2.19.0rc1 /home/josh/work/scie-pants/dist/scie-pants-linux-x86_64 \
    --backend-packages='[ \
        "pants.backend.build_files.fix.deprecations", \
        "pants.backend.build_files.fmt.black", \
        "pants.backend.build_files.fmt.buildifier", \
        "pants.backend.build_files.fmt.yapf", \
        "pants.backend.awslambda.python", \
        "pants.backend.codegen.protobuf.lint.buf", \
        "pants.backend.codegen.protobuf.python", \
        "pants.backend.codegen.thrift.apache.python", \
        "pants.backend.docker", \
        "pants.backend.docker.lint.hadolint", \
        "pants.backend.experimental.adhoc", \
        "pants.backend.experimental.codegen.protobuf.go", \
        "pants.backend.experimental.codegen.protobuf.java", \
        "pants.backend.experimental.codegen.protobuf.scala", \
        "pants.backend.experimental.go", \
        "pants.backend.experimental.helm", \
        "pants.backend.experimental.java", \
        "pants.backend.experimental.java.lint.google_java_format", \
        "pants.backend.experimental.kotlin", \
        "pants.backend.experimental.kotlin.lint.ktlint", \
        "pants.backend.experimental.openapi", \
        "pants.backend.experimental.openapi.lint.openapi_format", \
        "pants.backend.experimental.openapi.lint.spectral", \
        "pants.backend.experimental.python", \
        "pants.backend.experimental.python.framework.stevedore", \
        "pants.backend.experimental.python.lint.add_trailing_comma", \
        "pants.backend.experimental.python.lint.ruff", \
        "pants.backend.experimental.python.packaging.pyoxidizer", \
        "pants.backend.experimental.python.typecheck.pytype", \
        "pants.backend.experimental.scala", \
        "pants.backend.experimental.scala.lint.scalafmt", \
        "pants.backend.experimental.terraform", \
        "pants.backend.experimental.tools.semgrep", \
        "pants.backend.experimental.tools.workunit_logger", \
        "pants.backend.experimental.tools.yamllint", \
        "pants.backend.google_cloud_function.python", \
        "pants.backend.plugin_development", \
        "pants.backend.python", \
        "pants.backend.python.lint.autoflake", \
        "pants.backend.python.lint.bandit", \
        "pants.backend.python.lint.black", \
        "pants.backend.python.lint.docformatter", \
        "pants.backend.python.lint.flake8", \
        "pants.backend.python.lint.isort", \
        "pants.backend.python.lint.pydocstyle", \
        "pants.backend.python.lint.pylint", \
        "pants.backend.python.lint.pyupgrade", \
        "pants.backend.python.lint.yapf", \
        "pants.backend.python.mixed_interpreter_constraints", \
        "pants.backend.python.typecheck.mypy", \
        "pants.backend.shell", \
        "pants.backend.shell.lint.shellcheck", \
        "pants.backend.shell.lint.shfmt", \
        "pants.backend.tools.preamble", \
    ]' \
    help-all > "$HERE/2.19.x.help-all.json"

PANTS_VERSION=2.20.0.dev2 /home/josh/work/scie-pants/dist/scie-pants-linux-x86_64 \
    --backend-packages='[ \
        "pants.backend.build_files.fix.deprecations", \
        "pants.backend.build_files.fmt.black", \
        "pants.backend.build_files.fmt.buildifier", \
        "pants.backend.build_files.fmt.yapf", \
        "pants.backend.awslambda.python", \
        "pants.backend.codegen.protobuf.lint.buf", \
        "pants.backend.codegen.protobuf.python", \
        "pants.backend.codegen.thrift.apache.python", \
        "pants.backend.docker", \
        "pants.backend.docker.lint.hadolint", \
        "pants.backend.experimental.adhoc", \
        "pants.backend.experimental.codegen.protobuf.go", \
        "pants.backend.experimental.codegen.protobuf.java", \
        "pants.backend.experimental.codegen.protobuf.scala", \
        "pants.backend.experimental.go", \
        "pants.backend.experimental.helm", \
        "pants.backend.experimental.java", \
        "pants.backend.experimental.java.lint.google_java_format", \
        "pants.backend.experimental.kotlin", \
        "pants.backend.experimental.kotlin.lint.ktlint", \
        "pants.backend.experimental.openapi", \
        "pants.backend.experimental.openapi.lint.openapi_format", \
        "pants.backend.experimental.openapi.lint.spectral", \
        "pants.backend.experimental.python", \
        "pants.backend.experimental.python.framework.stevedore", \
        "pants.backend.experimental.python.lint.add_trailing_comma", \
        "pants.backend.experimental.python.lint.ruff", \
        "pants.backend.experimental.python.packaging.pyoxidizer", \
        "pants.backend.experimental.python.typecheck.pytype", \
        "pants.backend.experimental.scala", \
        "pants.backend.experimental.scala.lint.scalafmt", \
        "pants.backend.experimental.terraform", \
        "pants.backend.experimental.tools.semgrep", \
        "pants.backend.experimental.tools.workunit_logger", \
        "pants.backend.experimental.tools.yamllint", \
        "pants.backend.google_cloud_function.python", \
        "pants.backend.plugin_development", \
        "pants.backend.python", \
        "pants.backend.python.lint.autoflake", \
        "pants.backend.python.lint.bandit", \
        "pants.backend.python.lint.black", \
        "pants.backend.python.lint.docformatter", \
        "pants.backend.python.lint.flake8", \
        "pants.backend.python.lint.isort", \
        "pants.backend.python.lint.pydocstyle", \
        "pants.backend.python.lint.pylint", \
        "pants.backend.python.lint.pyupgrade", \
        "pants.backend.python.lint.yapf", \
        "pants.backend.python.mixed_interpreter_constraints", \
        "pants.backend.python.typecheck.mypy", \
        "pants.backend.shell", \
        "pants.backend.shell.lint.shellcheck", \
        "pants.backend.shell.lint.shfmt", \
        "pants.backend.tools.preamble", \
    ]' \
    help-all > "$HERE/2.20.x.help-all.json"

huonw

Thanks for this.

Is the list of backends basically a reproduction of https://github.com/pantsbuild/pants/blob/7a1cd54d98a43485027d2ac53099565900659811/build-support/bin/generate_docs.py#L174-L227 ?

huonw · 2024-01-02T21:25:28Z

.github/workflows/sync_docs.yml

@@ -60,6 +60,7 @@ jobs:
      - run: |
          rm -rf "pantsbuild.org/${{ steps.get-destination-dir.outputs.DESTINATION_DIR }}"
          mkdir "pantsbuild.org/${{ steps.get-destination-dir.outputs.DESTINATION_DIR }}"
+          cp help-all.json "pantsbuild.org/${{ steps.get-destination-dir.outputs.DESTINATION_DIR }}"


I can't comment directly on the line, but the pants help-all invocation used in this script appears to be different to the one in the PR description; is that intentional?

Do you mean with regards to backend packages? If so, see #44

yeah; cool 👍

thejcannon · 2024-01-02T21:30:54Z

Is the list of backends basically a reproduction of

Yup!

thejcannon · 2024-01-02T21:31:19Z

Although in some cases backends were missing, so I also plugged some holes

This runs `for d in docs versioned_docs/*; do npm run generate-reference $d; done`, `npm run format-all` to regenerate all docs off the `help-all.json` files that are now checked in (#43). Fixes #37, hopefully.

add it all

9c8f2b9

thejcannon requested a review from huonw January 2, 2024 20:40

thejcannon mentioned this pull request Jan 2, 2024

Auto-synced reference docs don't match checked-in code, thus sync PRs have spurious changes #37

Closed

thejcannon enabled auto-merge (squash) January 2, 2024 21:01

huonw approved these changes Jan 2, 2024

View reviewed changes

thejcannon merged commit 8850b13 into main Jan 2, 2024
1 check passed

thejcannon deleted the jcannon/checkin-reference branch January 2, 2024 21:34

huonw mentioned this pull request Jan 4, 2024

Regenerate reference docs from in-repo sources #50

Merged

huonw mentioned this pull request Jan 8, 2024

Update docs site for version 2.18.1 #71

Closed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Check in `help-all.json` for posterity #43

Check in `help-all.json` for posterity #43

thejcannon commented Jan 2, 2024

huonw left a comment

huonw Jan 2, 2024

thejcannon Jan 2, 2024

huonw Jan 2, 2024

thejcannon commented Jan 2, 2024

thejcannon commented Jan 2, 2024

Check in help-all.json for posterity #43

Check in help-all.json for posterity #43

Conversation

thejcannon commented Jan 2, 2024

huonw left a comment

Choose a reason for hiding this comment

huonw Jan 2, 2024

Choose a reason for hiding this comment

thejcannon Jan 2, 2024

Choose a reason for hiding this comment

huonw Jan 2, 2024

Choose a reason for hiding this comment

thejcannon commented Jan 2, 2024

thejcannon commented Jan 2, 2024

Check in `help-all.json` for posterity #43

Check in `help-all.json` for posterity #43