Skip to content

Official Inference Code of EAGLE-4

8.8 KB
Raw Blame
# Copyright 2026 Eagle AI Corp.
# SPDX-License-Identifier: LicenseRef-Eagle-4-Source-Available

"""Exercise the header checker as a CLI in isolated Git repositories."""

from pathlib import Path
import subprocess
import sys

import pytest

CHECKER = Path(__file__).resolve().parents[1] / "tools" / "check_headers.py"
EAGLE = "# Copyright 2026 Eagle AI Corp.\n# SPDX-License-Identifier: LicenseRef-Eagle-4-Source-Available\n"


@pytest.fixture
def repo(tmp_path):
    subprocess.run(["git", "init", "-q", str(tmp_path)], check=True)
    return tmp_path


def run_checker(repo, *args):
    return subprocess.run([sys.executable, str(CHECKER), *args], cwd=repo, capture_output=True, text=True)


def test_check_fix_and_idempotence(repo):
    source = repo / "example.py"
    original = b'#!/usr/bin/env python3\n# coding: utf-8\n"""Module docstring."""\nfrom __future__ import annotations\n'
    source.write_bytes(original)
    source.chmod(0o755)
    result = run_checker(repo)
    assert result.returncode == 1
    assert "example.py" in result.stdout
    assert source.read_bytes() == original
    result = run_checker(repo, "--fix")
    assert result.returncode == 0, result.stderr + result.stdout
    expected = original.replace(b"# coding: utf-8\n", b"# coding: utf-8\n" + EAGLE.encode() + b"\n")
    assert source.read_bytes() == expected
    assert source.stat().st_mode & 0o777 == 0o755
    assert run_checker(repo).returncode == 0
    assert run_checker(repo, "--fix").returncode == 0
    assert source.read_bytes() == expected


@pytest.mark.parametrize(
    "original",
    [
        "# SPDX-FileCopyrightText: Copyright SGLang Team\n# Derived from upstream. Modified by Eagle AI Corp.\n",
        "# SPDX-FileCopyrightText: Copyright FlashInfer community\n# SPDX-License-Identifier: Apache-2.0\n",
        "# Copyright (c) 2026 Advanced Micro Devices, Inc.\n# SPDX-License-Identifier: Apache-2.0\n",
        "# Copyright (c) 2026 Advanced Micro Devices, Inc.\n# SPDX-License-Identifier: Apache-2.0\n"
        "# Modified by Eagle AI Corp.\n",
    ],
)
def test_preserves_upstream_notices(repo, original):
    source = repo / "kernel.py"
    original += '"""Kernel."""\n'
    source.write_text(original)
    for args in [(), ("--fix",), ("--fix",)]:
        result = run_checker(repo, *args)
        assert result.returncode == 0, result.stdout + result.stderr
        assert source.read_text() == original


@pytest.mark.parametrize(
    "notice",
    [
        "# Copyright LightSeek Foundation\n# SPDX-License-Identifier: MIT\n",
        "# Derived from TokenSpeed\n",
        "# Copyright Some Other Company\n",
        "# SPDX-License-Identifier: Apache-2.0\n",
    ],
)
def test_refuses_unapproved_provenance_without_writing(repo, notice):
    source = repo / "eagle_harness" / "kernel.py"
    source.parent.mkdir()
    source.write_text(notice + "x = 1\n")
    before = source.read_bytes()
    for args in [(), ("--fix",)]:
        result = run_checker(repo, *args)
        assert result.returncode == 1
        assert "eagle_harness/kernel.py" in result.stdout
        assert source.read_bytes() == before


@pytest.mark.parametrize(
    "notice",
    [
        EAGLE + "# Copyright (c) 2026 Advanced Micro Devices, Inc.\n# SPDX-License-Identifier: Apache-2.0\n",
        EAGLE + "# SPDX-FileCopyrightText: Copyright SGLang Team\n",
        "# Copyright (c) 2026 Advanced Micro Devices, Inc.\n# SPDX-License-Identifier: Apache-2.0-or-later\n",
        "# Copyright (c) 2026 Advanced Micro Devices, Inc.\n# Copyright Someone Else\n"
        "# SPDX-License-Identifier: Apache-2.0\n",
    ],
)
def test_refuses_conflicting_upstream_headers(repo, notice):
    path = repo / "upstream.py"
    path.write_text(notice + "pass\n")
    original = path.read_bytes()
    for args in [(), ("--fix",)]:
        result = run_checker(repo, *args)
        assert result.returncode == 1
        assert "upstream.py" in result.stdout
        assert path.read_bytes() == original


@pytest.mark.parametrize(
    "name,body",
    [
        ("docs/example.py", "x = 1\n"),
        ("LICENSES/example.py", "# third-party text\n"),
        ("scripts/data/example.py", "x = 1\n"),
        ("test.json", "{}\n"),
        ("scripts/notes.md", "notes\n"),
        ("generated.py", "# Generated by a code generator. DO NOT EDIT.\nx = 1\n"),
    ],
)
def test_skips_non_source_and_generated_files(repo, name, body):
    path = repo / name
    path.parent.mkdir(parents=True, exist_ok=True)
    path.write_text(body)
    assert run_checker(repo, "--fix").returncode == 0
    assert path.read_text() == body
    assert run_checker(repo).returncode == 0


@pytest.mark.parametrize(
    "name,preamble,body",
    [
        ("kernel.cu", b"", b"int x;\n"),
        ("kernel.hpp", b"", b"#pragma once\n"),
        ("run.sh", b"#!/bin/sh\n", b"exit 0\n"),
        ("plan.env", b"", b"export OMP_NUM_THREADS=4\n"),
        ("run", b"#!/usr/bin/env python3\n", b"pass\n"),
        ("rules.sky", b"", b"x = 1\n"),
        ("docker/test.Dockerfile", b"", b"FROM scratch\n"),
        ("Dockerfile", b"# syntax=docker/dockerfile:1\n", b"FROM scratch\n"),
        (
            "docker/directives.Dockerfile",
            b"# syntax=docker/dockerfile:1\n# escape=`\n# check=error=true\n",
            b"FROM scratch\n",
        ),
        ("Dockerfile", b"# SyNtAx = docker/dockerfile:1\n", b"FROM scratch\n"),
        ("scripts/helper.py", b"", b"pass\n"),
        ("latin.py", b"# coding: latin-1\n", b"# caf\xe9\npass\n"),
        ("bom.py", b"\xef\xbb\xbf", b"pass\n"),
        ("crlf.py", b"#!/usr/bin/env python3\r\n", b"pass\r\n"),
        ("comment.py", b"", b"# default width: derived from the cost table\npass\n"),
        ("empty.py", b"", b""),
    ],
)
def test_source_forms_preserve_bytes(repo, name, preamble, body):
    path = repo / name
    path.parent.mkdir(parents=True, exist_ok=True)
    path.write_bytes(preamble + body)
    result = run_checker(repo, "--fix")
    assert result.returncode == 0, result.stdout + result.stderr
    header = EAGLE.replace("#", "//") if path.suffix in (".cu", ".hpp") else EAGLE
    newline = b"\r\n" if b"\r\n" in preamble else b"\n"
    separator = newline if body else b""
    assert path.read_bytes() == preamble + header.encode().replace(b"\n", newline) + separator + body
    assert run_checker(repo).returncode == 0


@pytest.mark.parametrize("newline", [b"\n", b"\r\n", b"\r"])
def test_preserves_newlines_and_unterminated_source(repo, newline):
    path = repo / "unterminated.py"
    preamble = b"#!/usr/bin/env python3" + newline + b"# coding: utf-8" + newline
    body = b'"""Module docstring."""' + newline + b"pass"
    path.write_bytes(preamble + body)
    result = run_checker(repo, "--fix")
    assert result.returncode == 0, result.stdout + result.stderr
    assert path.read_bytes() == preamble + EAGLE.encode().replace(b"\n", newline) + newline + body
    assert run_checker(repo).returncode == 0


@pytest.mark.parametrize("tracked", [False, True])
@pytest.mark.parametrize(
    "header",
    [
        "",
        "# Copyright 2026 Eagle AI Corp.\n# SPDX-License-Identifier: MIT\n",
        "# Copyright 2025 Eagle AI Corp.\n# SPDX-License-Identifier: LicenseRef-Eagle-4-Source-Available\n",
        "# Copyright 2026 Not Eagle Corp.\n# SPDX-License-Identifier: LicenseRef-Eagle-4-Source-Available\n",
    ],
)
def test_rejects_missing_or_incorrect_new_headers(repo, tracked, header):
    path = repo / "new.py"
    path.write_text(header + "pass\n")
    if tracked:
        subprocess.run(["git", "add", "new.py"], cwd=repo, check=True)
    original = path.read_bytes()
    result = run_checker(repo)
    assert result.returncode == 1
    assert "new.py" in result.stdout
    assert path.read_bytes() == original
    if header:
        assert run_checker(repo, "--fix").returncode == 1
        assert path.read_bytes() == original


def test_skips_ignored_files_and_symlinks_but_checks_tracked(repo):
    (repo / ".gitignore").write_text("ignored.py\ntracked.py\n")
    ignored = repo / "ignored.py"
    ignored.write_text("pass\n")
    (repo / "link.py").symlink_to(ignored)
    assert run_checker(repo, "--fix").returncode == 0
    assert ignored.read_text() == "pass\n"
    assert (repo / "link.py").is_symlink()
    (repo / "tracked.py").write_text("pass\n")
    subprocess.run(["git", "add", "-f", "tracked.py"], cwd=repo, check=True)
    result = run_checker(repo)
    assert result.returncode == 1
    assert "tracked.py" in result.stdout


@pytest.mark.parametrize("partial", EAGLE.splitlines(keepends=True))
def test_repairs_partial_eagle_header_without_duplicate(repo, partial):
    path = repo / "partial.py"
    path.write_text(partial + "pass\n")
    result = run_checker(repo)
    assert result.returncode == 1
    assert path.read_text() == partial + "pass\n"
    result = run_checker(repo, "--fix")
    assert result.returncode == 0, result.stdout + result.stderr
    assert path.read_text() == EAGLE + "\npass\n"
    assert run_checker(repo).returncode == 0