# Git LFS inclusion / exclusion is controlled by this file. Our approach is to:
# INCLUDE dirs in Git LFS broadly, and then EXCLUDE text file-types narrowly.
#
# Why include in LFS broadly? Once a large binary file is comitted without lfs,
# it is VERY hard to remove it from the git history as it requires a history
# rewrite. This cannot be done without major disruption to all devs. Thus,
# once merged to `staging`, that NNN MB file that missed LFS makes our git repo
# that much bigger forever.
#
# In contrast, if a text file (= a file that you want to be able to diff)
# is accidentally included in LFS, adding it back to git is easy,
# see: "HOW TO EXCLUDE A FILE/FILES THATS IN AN LFS DIR" below.

# INCLUDE these "large static asset" and localisation dirs in Git LFS:
apps/i18n/** filter=lfs diff=lfs merge=lfs -text
apps/static/** filter=lfs diff=lfs merge=lfs -text
dashboard/app/assets/** filter=lfs diff=lfs merge=lfs -text
dashboard/config/locales/** filter=lfs diff=lfs merge=lfs -text
dashboard/config/datablock_storage/** filter=lfs diff=lfs merge=lfs -text
dashboard/public/** filter=lfs diff=lfs merge=lfs -text
dashboard/test/fixtures/** filter=lfs diff=lfs merge=lfs -text
lib/test/fixtures/** filter=lfs diff=lfs merge=lfs -text
pegasus/cache/i18n/** filter=lfs diff=lfs merge=lfs -text
pegasus/sites.v3/** filter=lfs diff=lfs merge=lfs -text
pegasus/sites/** filter=lfs diff=lfs merge=lfs -text
shared/images/** filter=lfs diff=lfs merge=lfs -text

# HOW TO EXCLUDE A FILE/FILES FROM GIT LFS:
#
# 1. Add a new exclusion pattern in the immediately following section
# 2. Run `git add --renormalize .` from the root of the repo
# 3. All files matching the pattern should show up new and uncommitted
# 4. Commit your .gitattributes changes and the new files.
#
# 🙏 be thoughtful when adding new files/patterns: once the files
# are in our git history, they take up space forever.

# EXCLUDE these files from our Git LFS dirs:
apps/i18n/**/en_us.json !text !filter !merge !diff
apps/i18n/tts_keys/** !text !filter !merge !diff
apps/static/aichat/modelDescriptions.json !text !filter !merge !diff
dashboard/app/assets/javascripts/** !text !filter !merge !diff
dashboard/app/assets/stylesheets/** !text !filter !merge !diff
dashboard/config/locales/**/*en.yml !text !filter !merge !diff
dashboard/config/locales/**/*en.json !text !filter !merge !diff
dashboard/public/**/README.md !text !filter !merge !diff
dashboard/test/fixtures/**/*.tsv !text !filter !merge !diff
dashboard/test/fixtures/**/*.csv !text !filter !merge !diff
dashboard/test/fixtures/**/*.json !text !filter !merge !diff
dashboard/test/fixtures/**/*.course !text !filter !merge !diff
dashboard/test/fixtures/**/*.script_json !text !filter !merge !diff
dashboard/test/fixtures/**/*.level !text !filter !merge !diff
dashboard/test/fixtures/**/*.xml !text !filter !merge !diff
pegasus/cache/i18n/en-US.json !text !filter !merge !diff
pegasus/sites.v3/hourofcode.com/i18n/en.yml !text !filter !merge !diff
pegasus/sites*/**/*.collate !text !filter !merge !diff
pegasus/sites*/**/*.erb !text !filter !merge !diff
pegasus/sites*/**/*.fetch !text !filter !merge !diff
pegasus/sites*/**/*.haml !text !filter !merge !diff
pegasus/sites*/**/*.json !text !filter !merge !diff
pegasus/sites*/**/*.md !text !filter !merge !diff
pegasus/sites*/**/*.moved !text !filter !merge !diff
pegasus/sites*/**/*.partial !text !filter !merge !diff
pegasus/sites*/**/*.redirect !text !filter !merge !diff
pegasus/sites*/**/*.scss !text !filter !merge !diff

# INCLUDE these binary file types in Git LFS no matter where they occur.
# Extensions are matched case-insensitively (e.g. both .png and .PNG) via
# character classes, so files do not slip past LFS on case-sensitive
# filesystems (git attribute matching is case-sensitive on Linux).
*.[jJ][pP][eE][gG] filter=lfs diff=lfs merge=lfs -text
*.[jJ][pP][gG] filter=lfs diff=lfs merge=lfs -text
*.[pP][dD][fF] filter=lfs diff=lfs merge=lfs -text
*.[pP][nN][gG] filter=lfs diff=lfs merge=lfs -text
*.[tT][tT][fF] filter=lfs diff=lfs merge=lfs -text
*.[wW][hH][lL] filter=lfs diff=lfs merge=lfs -text
*.[zZ][iI][pP] filter=lfs diff=lfs merge=lfs -text

# Small list of very common text file types to EXCLUDE from Git LFS:
*.css !text !filter !merge !diff
*.js !text !filter !merge !diff
*.html !text !filter !merge !diff

# INCLUDE these specific files in Git LFS, no matter what:
pegasus/sites.v3/code.org/public/schools.json filter=lfs diff=lfs merge=lfs -text
pegasus/sites.v3/hourofcode.com/public/onetrust/** filter=lfs diff=lfs merge=lfs -text
pegasus/sites.v3/code.org/public/onetrust/** filter=lfs diff=lfs merge=lfs -text