clang-tool-chain 1.0.2__py3-none-any.whl

clang_tool_chain/__version__.py

@@ -0,0 +1,4 @@
+"""Version information for clang-tool-chain."""
+
+__version__ = "1.0.2"
+__llvm_version__ = "21.1.5"

clang_tool_chain/checksums.py

@@ -0,0 +1,270 @@
+"""
+SHA256 checksums for known LLVM releases.
+
+This module provides a database of known SHA256 checksums for LLVM binary releases.
+Checksums are used to verify the integrity and authenticity of downloaded binaries.
+
+Note: LLVM releases typically use GPG signatures (.sig files) and GitHub attestations
+(.jsonl files) rather than publishing standalone checksum files. The checksums in this
+database are computed from verified LLVM releases and can be used for automated
+verification during download.
+
+To add checksums for a new release:
+1. Download the official binary from https://github.com/llvm/llvm-project/releases
+2. Verify the GPG signature or GitHub attestation
+3. Compute the SHA256 checksum: `sha256sum <file>` (Linux/macOS) or `certutil -hashfile <file> SHA256` (Windows)
+4. Add the checksum to the KNOWN_CHECKSUMS dictionary below
+
+Platform keys follow the format: "{os}-{arch}"
+- Windows x64: "win-x86_64"
+- macOS x64: "mac-x86_64"
+- macOS ARM: "mac-arm64"
+- Linux x64: "linux-x86_64"
+- Linux ARM: "linux-arm64"
+"""
+
+# Database of known SHA256 checksums for LLVM releases
+# Format: {version: {platform: checksum}}
+KNOWN_CHECKSUMS: dict[str, dict[str, str]] = {
+    "21.1.5": {
+        # Windows x64 - Full archive (not installer)
+        # File: clang+llvm-21.1.5-x86_64-pc-windows-msvc.tar.xz
+        # Note: Add checksum after verifying the GPG signature
+        # "win-x86_64": "",
+        # macOS x64
+        # File: clang+llvm-21.1.5-x86_64-apple-darwin.tar.xz
+        # Note: May not be available in all releases
+        # "mac-x86_64": "",
+        # macOS ARM64
+        # File: clang+llvm-21.1.5-arm64-apple-darwin.tar.xz
+        # Note: May not be available in all releases
+        # "mac-arm64": "",
+        # Linux x64
+        # File: LLVM-21.1.5-Linux-X64.tar.xz
+        # Note: Add checksum after verifying the GitHub attestation
+        # "linux-x86_64": "",
+        # Linux ARM64
+        # File: LLVM-21.1.5-Linux-ARM64.tar.xz
+        # Note: Add checksum after verifying the GitHub attestation
+        # "linux-arm64": "",
+    },
+    # Additional versions can be added here
+    # "21.1.4": {...},
+    # "21.1.3": {...},
+}
+
+
+def get_checksum(version: str, platform: str) -> str | None:
+    """
+    Get the known SHA256 checksum for a specific LLVM version and platform.
+
+    Args:
+        version: LLVM version string (e.g., "21.1.5")
+        platform: Platform key in format "{os}-{arch}" (e.g., "linux-x86_64")
+
+    Returns:
+        SHA256 checksum as hex string, or None if not found
+
+    Example:
+        >>> get_checksum("21.1.5", "linux-x86_64")
+        'abc123...'  # Returns checksum if available, None otherwise
+    """
+    version_checksums = KNOWN_CHECKSUMS.get(version)
+    if version_checksums is None:
+        return None
+
+    return version_checksums.get(platform)
+
+
+def has_checksum(version: str, platform: str) -> bool:
+    """
+    Check if a checksum is available for a specific version and platform.
+
+    Args:
+        version: LLVM version string (e.g., "21.1.5")
+        platform: Platform key in format "{os}-{arch}" (e.g., "linux-x86_64")
+
+    Returns:
+        True if checksum is available, False otherwise
+
+    Example:
+        >>> has_checksum("21.1.5", "linux-x86_64")
+        False  # No checksum available yet
+    """
+    checksum = get_checksum(version, platform)
+    return checksum is not None and len(checksum) > 0
+
+
+def get_supported_versions() -> list[str]:
+    """
+    Get a list of LLVM versions that have checksum information.
+
+    Returns:
+        List of version strings
+
+    Example:
+        >>> get_supported_versions()
+        ['21.1.5']
+    """
+    return list(KNOWN_CHECKSUMS.keys())
+
+
+def get_supported_platforms(version: str) -> list[str]:
+    """
+    Get a list of platforms that have checksums for a specific version.
+
+    Args:
+        version: LLVM version string (e.g., "21.1.5")
+
+    Returns:
+        List of platform keys, or empty list if version not found
+
+    Example:
+        >>> get_supported_platforms("21.1.5")
+        []  # No checksums added yet
+    """
+    version_checksums = KNOWN_CHECKSUMS.get(version)
+    if version_checksums is None:
+        return []
+
+    return [platform for platform, checksum in version_checksums.items() if checksum]
+
+
+def add_checksum(version: str, platform: str, checksum: str) -> None:
+    """
+    Add or update a checksum for a specific version and platform.
+
+    This function is primarily for programmatic updates to the checksum database.
+    For permanent additions, edit the KNOWN_CHECKSUMS dictionary directly.
+
+    Args:
+        version: LLVM version string (e.g., "21.1.5")
+        platform: Platform key in format "{os}-{arch}" (e.g., "linux-x86_64")
+        checksum: SHA256 checksum as hex string
+
+    Example:
+        >>> add_checksum("21.1.5", "linux-x86_64", "abc123...")
+    """
+    if version not in KNOWN_CHECKSUMS:
+        KNOWN_CHECKSUMS[version] = {}
+
+    KNOWN_CHECKSUMS[version][platform] = checksum.lower()
+
+
+def format_platform_key(os_name: str, arch: str) -> str:
+    """
+    Format an OS name and architecture into a platform key.
+
+    Args:
+        os_name: Operating system name ("win", "mac", "linux")
+        arch: Architecture name ("x86_64", "arm64", "x86")
+
+    Returns:
+        Platform key string
+
+    Example:
+        >>> format_platform_key("linux", "x86_64")
+        'linux-x86_64'
+    """
+    # Normalize architecture names
+    arch_map = {
+        "x86": "x86_64",  # Treat x86 as x86_64 for modern systems
+        "x64": "x86_64",
+        "amd64": "x86_64",
+        "arm": "arm64",  # Treat arm as arm64 for modern systems
+        "aarch64": "arm64",
+    }
+    normalized_arch = arch_map.get(arch.lower(), arch.lower())
+
+    return f"{os_name.lower()}-{normalized_arch}"
+
+
+# Documentation for adding checksums
+CHECKSUM_INSTRUCTIONS = """
+How to Add Checksums to the Database
+=====================================
+
+1. Download the Official Binary
+   - Go to https://github.com/llvm/llvm-project/releases
+   - Download the binary for your target platform
+   - Example: LLVM-21.1.5-Linux-X64.tar.xz
+
+2. Verify the Official Signature
+   For Linux (GitHub attestation):
+   ```bash
+   gh attestation verify LLVM-21.1.5-Linux-X64.tar.xz --owner llvm
+   ```
+
+   For Windows (GPG signature):
+   ```bash
+   gpg --verify LLVM-21.1.5-win64.exe.sig LLVM-21.1.5-win64.exe
+   ```
+   (First import LLVM release keys from https://releases.llvm.org/)
+
+3. Compute the SHA256 Checksum
+   Linux/macOS:
+   ```bash
+   sha256sum LLVM-21.1.5-Linux-X64.tar.xz
+   ```
+
+   Windows PowerShell:
+   ```powershell
+   Get-FileHash LLVM-21.1.5-win64.exe -Algorithm SHA256
+   ```
+
+   Windows CMD:
+   ```cmd
+   certutil -hashfile LLVM-21.1.5-win64.exe SHA256
+   ```
+
+4. Add to KNOWN_CHECKSUMS Dictionary
+   Edit this file and add the checksum:
+   ```python
+   "21.1.5": {
+       "linux-x86_64": "abc123...",  # Your computed checksum
+   }
+   ```
+
+5. Test the Checksum
+   ```bash
+   uv run python -c "from clang_tool_chain.checksums import get_checksum; print(get_checksum('21.1.5', 'linux-x86_64'))"
+   ```
+
+Platform Keys Reference
+=======================
+- Windows 64-bit: "win-x86_64"
+- macOS Intel:    "mac-x86_64"
+- macOS Apple Silicon: "mac-arm64"
+- Linux 64-bit:   "linux-x86_64"
+- Linux ARM64:    "linux-arm64"
+
+File Naming Conventions
+=======================
+LLVM uses different naming patterns for releases:
+
+Windows:
+- Installer: LLVM-{version}-win64.exe (or win32.exe)
+- Archive: clang+llvm-{version}-x86_64-pc-windows-msvc.tar.xz
+
+Linux:
+- Archive: LLVM-{version}-Linux-X64.tar.xz (or Linux-ARM64.tar.xz)
+
+macOS (when available):
+- Archive: clang+llvm-{version}-x86_64-apple-darwin.tar.xz
+- Archive: clang+llvm-{version}-arm64-apple-darwin.tar.xz
+
+Note: macOS binaries are not always available in official releases.
+Consider using Homebrew builds or terralang/llvm-build for macOS.
+"""
+
+
+if __name__ == "__main__":
+    # Print instructions when run directly
+    print(CHECKSUM_INSTRUCTIONS)
+    print("\nCurrently Supported Versions:")
+    for version in get_supported_versions():
+        platforms = get_supported_platforms(version)
+        if platforms:
+            print(f"  {version}: {', '.join(platforms)}")
+        else:
+            print(f"  {version}: (no checksums added yet)")