.gitattributes

# ============================================================
# .gitattributes (ALL-REPOS)
# ============================================================
# Updated: 2026-06-27
#
# REQ: All professional GitHub repositories SHOULD include .gitattributes.
# WHY: Keep line endings, diffs, and file classification consistent across
# Windows, macOS, Linux, GitHub Actions, and environments.
# CUSTOM: Add rules when new shared file types are introduced.
# Git attributes: https://git-scm.com/docs/gitattributes


# === Core defaults ===

# WHY: Auto-detect text files and normalize text
# unless a later rule is more specific.
* text=auto eol=lf


# === Named root and metadata files ===

# WHY: Important extensionless repo files are text and should use LF.
CODEOWNERS  text eol=lf
LICENSE     text eol=lf


# === Operating-system files ===

# WHY: OS metadata files are binary/noisy and should not be normalized.
.DS_Store    binary
Thumbs.db    binary
desktop.ini  binary


# === Markup and documentation ===

# WHY: Documentation, web, and math markup use LF for stable cross-platform diffs.
*.bib   text eol=lf
*.cls   text eol=lf
*.css   text eol=lf
*.html  text eol=lf
*.md    text eol=lf
*.qmd   text eol=lf
*.rst   text eol=lf
*.sty   text eol=lf
*.tex   text eol=lf
*.xml   text eol=lf


# === Configuration and structured text ===

# WHY: Config and structured text files should produce stable diffs.
*.cfg     text eol=lf
*.env     text eol=lf
*.ini     text eol=lf
*.json    text eol=lf
*.jsonc   text eol=lf
*.jsonl   text eol=lf
*.ndjson  text eol=lf
*.toml    text eol=lf
*.txt     text eol=lf
*.yaml    text eol=lf
*.yml     text eol=lf


# === Programming languages and scripts ===

# WHY: Windows specific script types (.bat, .cmd)
# are covered under the general LF text policy.

# WHY: Source and script files use LF for CI, shells, containers, and tooling.
*.c     text eol=lf
*.cpp   text eol=lf
*.cs    text eol=lf
*.go    text eol=lf
*.h     text eol=lf
*.hpp   text eol=lf
*.java  text eol=lf
*.jl    text eol=lf
*.js    text eol=lf
*.mojo  text eol=lf
*.ps1   text eol=lf
*.py    text eol=lf
*.r     text eol=lf
*.R     text eol=lf
*.rs    text eol=lf
*.sh    text eol=lf
*.sql   text eol=lf
*.ts    text eol=lf


# === Formal, math, and proof languages ===

# WHY: Lean source files are text; Lean build artifacts are binary.
*.ilean  binary
*.lean   text eol=lf
*.olean  binary
*.trace  binary

# WHY: Lake build output should not be normalized if accidentally tracked.
.lake/**  binary


# === Notebooks ===

# WHY: Jupyter notebooks can contain Python, R, Julia, and other kernels.
*.ipynb  text eol=lf


# === Text and tabular data ===

# WHY: Small text data files benefit from readable diffs.
*.csv  text eol=lf
*.dat  text eol=lf
*.psv  text eol=lf
*.tsv  text eol=lf


# === Databases ===

# WHY: Database files are binary; text diffs are not meaningful.
*.db       binary
*.duckdb   binary
*.sqlite   binary
*.sqlite3  binary


# === Columnar and analytical data ===

# WHY: Columnar/analytical formats are binary; text diffs are not meaningful.
*.arrow    binary
*.avro     binary
*.feather  binary
*.orc      binary
*.parquet  binary


# === Office, BI, PDF, and compressed artifacts ===

# WHY: Office, BI, PDF, and archive files are binary.
*.7z    binary
*.bz2   binary
*.docx  binary
*.gz    binary
*.pbix  binary
*.pbit  binary
*.pdf   binary
*.pptx  binary
*.rar   binary
*.tar   binary
*.tgz   binary
*.xls   binary
*.xlsm  binary
*.xlsx  binary
*.xz    binary
*.zip   binary


# === Logs and generated runtime output ===

# WHY: Logs are generated runtime evidence; avoid normalization churn.
*.log        binary
project.log  binary


# === GitHub metadata and UI ===

# WHY: Exclude documentation and tests from GitHub language statistics.
docs/**   linguist-documentation
tests/**  linguist-documentation