lint-api

#!/usr/bin/env python3
# Copyright 2026 The Kubernetes Authors.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

"""
Run kube-api-linter (KAL) on API directories.
KAL validates Custom Resource Definitions against Kubernetes API conventions.

Usage:
    python3 dev/tools/lint-api
"""

import subprocess
import sys
import os

from shared import utils


def main():
    """Run kube-api-linter for API directories."""
    repo_root = utils.get_repo_root()
    tools_dir = os.path.join(repo_root, "dev", "tools")
    kal_config = os.path.join(tools_dir, ".golangci-kal.yml")
    kal_binary = os.path.join(tools_dir, "tmp", "bin", "golangci-kube-api-linter")

    # Build binary if it doesn't exist
    if not os.path.exists(kal_binary):
        print(f"Building golangci-kube-api-linter...")
        build_script = os.path.join(tools_dir, "build-kal")
        build_result = subprocess.run([build_script], cwd=repo_root)
        if build_result.returncode != 0:
            return build_result.returncode

    # Run custom golangci-lint with KAL plugin
    args = [kal_binary, "run", "--config", kal_config]
    if "--fix" in sys.argv:
        args.append("--fix")
    args.extend([
        "./api/...",
        "./extensions/api/...",
    ])
    result = subprocess.run(args, cwd=repo_root)

    return result.returncode


if __name__ == "__main__":
    sys.exit(main())