.gitattributes

# Git para manejar los finales de línea (EOL)
#
# https://docs.github.com/en/get-started/getting-started-with-git/configuring-git-to-handle-line-endings
#
# El objetivo es poder trabajar en entornos mixtos de Windows, Linux y MacOS
# y permitir que Git gestione los finales de línea en los archivos.
#
# Una vez que hayas creado o ajustado tu archivo .gitattributes, debes realizar
# una re-normalización de los finales de línea de una vez por todas:
#
# 1. Busca y convierte todos los archivos a LF (Unix) en tu repositorio
#
#   OJO! Hay que tener mucho cuidado con convertir solo lo necesario, en este
#   ejemplo solo convierto lo que está debajo de "src", porque me aseguro de
#   que no haya archivos que no deban ser modificados, por ejemplo,
#   archivos binarios o archivos de configuración específicos de Windows.
#
#   Ir normalizando poco a poco, por ejemplo, primero con los archivos de código
#   fuente y luego con los archivos de configuración...
#
#   find src -type f -not -path "./.git/*" -exec dos2unix {} \;
#   git commit -a -m 'Conversión a dos2unix'
#
# 2. Asegúrate de que cada archivo se guarde como debe !!
#
#   git add .gitattributes
#   git commit -m 'agregando .gitattributes para unificar los finales de línea'
#
# Cuando se hace el commit de .gitattributes se sobrescribe la configuración
# de `core.autocrlf` en .git/config, de modo que nos aseguramos
# un comportamiento consistente para todos los usuarios.
#
# FYI:
# Aquí tienes una colección de archivos .gitattributes para los lenguajes de
# programación más populares: https://github.com/gitattributes/gitattributes
#
#################################################################################
# atributo          # Comportamiento                    Comportamiento
# atributo          #   CHECKIN                            CHECKOUT
#################################################################################
# text              # Normalizado a LF                 # Convertido a EOL nativo
# [text] eol=crlf   # Normalizado a LF                 # Convertido a CRLF
# [text] eol=lf     # Normalizado a LF                 # Convertido a LF
# -text o binary    # Sin conversión                   # Sin conversión
# text=auto         # "text" si es texto o de lo contrario, como "binary"
# no especificado   # Se usa lo que diga core.autocrlf  en .git/config
#
###############################################################################
#
# core.autocrlf     # Presente en tu archivo .git/config
#   false: igual que binary
#   true:  igual que eol=crlf      Usado en Windows
#   input: igual que eol=lf        Usado en Linux/MacOS

###############################################################################
# Establecer el comportamiento predeterminado para normalizar automáticamente
# los finales de línea. Manejar los finales de línea automáticamente para los
# archivos detectados como texto y dejar sin tocar los archivos detectados
# como binarios. En caso de que la gente no tenga configurado core.autocrlf.
###############################################################################
*        text=auto

###############################################################################
# Los archivos anteriores manejarán todos los archivos NO listados a continuación
#

# Ejemplos:
#
# Declarar explícitamente archivos de texto que siempre deseas normalizar y
# convertir a finales de línea nativos al hacer checkout.
# *.c text
# *.h text
#
# Declarar archivos que siempre tendrán finales de línea CRLF al hacer checkout.
# *.sln text eol=crlf
#
# Git siempre convertirá los finales de línea a LF al hacer checkout. Debes usar
# esto para archivos que deben mantener finales de línea LF, incluso en Windows.
# *.md  text eol=lf
# *.c   text eol=lf
#
# Denotar todos los archivos que son verdaderamente binarios y no deben ser modificados.
# *.png binary
# *.jpg binary

###############################################################################
# Estos archivos son texto y deben ser normalizados (Convertir crlf => lf)
*.gitattributes text
.gitignore      text

# Archivos que utilizo para hacer el unit testing, no cambiar nada !!
*.test     binary

# Docker
Dockerfile      text

#
# Habilitar resaltado de sintaxis para archivos con extensiones `.gitattributes`.
#
*.gitattributes linguist-language=gitattributes
*.gitattributes linguist-detectable=true
*.gitattributes linguist-documentation=false

# Archivos de configuración de Visual Studio
*.csproj text merge=union
*.sln    text merge=union eol=crlf
*.SLN    text merge=union eol=crlf

# Archivos de word
*.docx   diff=astextplain
*.DOCX   diff=astextplain

# las rutas absolutas son válidas, al igual que los patrones glob
# /**/postinst* text eol=lf

# las rutas que no comienzan con / se tratan relativas a la carpeta .gitattributes
# relative/path/*.txt text eol=lf

# Fuentes
*.c     text diff=cpp
*.cc    text diff=cpp
*.cxx   text diff=cpp
*.cpp   text diff=cpp
*.cpi   text diff=cpp
*.c++   text diff=cpp
*.hpp   text diff=cpp
*.h     text diff=cpp
*.h++   text diff=cpp
*.hh    text diff=cpp
*.cs     text diff=csharp
*.java   text diff=java
*.js     text

# HTML
*.html   text diff=html
*.css    text
*.js     text

# Archivo de bases de datos
*.sql    text

# Archivos de objetos compilados
*.slo   binary
*.lo    binary
*.o     binary
*.obj   binary

# Encabezados precompilados
*.gch   binary
*.pch   binary

# Bibliotecas dinámicas compiladas
*.so    binary
*.dylib binary
*.dll   binary

# Bibliotecas estáticas compiladas
*.lai   binary
*.la    binary
*.a     binary
*.lib   binary

# Ejecutables
*.exe   binary
*.out   binary
*.app   binary

# Documentos
*.md       text diff=markdown eol=lf
*.mdx      text diff=markdown eol=lf
*.tex      text diff=tex eol=lf
*.adoc     text eol=lf
*.textile  text eol=lf
*.mustache text eol=lf
*.csv      text eol=lf
*.tab      text eol=lf
*.tsv      text eol=lf
*.txt      text eol=lf

# Gráficos
*.svg      text eol=lf
*.png      binary
*.jpg      binary
*.jpeg     binary
*.gif      binary
*.tif      binary
*.tiff     binary
*.ico      binary
*.eps      binary

# Scripts
*.bash     text eol=lf
*.fish     text eol=lf
*.ksh      text eol=lf
*.sh       text eol=lf
*.zsh      text eol=lf
# Windows
*.bat      text eol=crlf
*.cmd      text eol=crlf
*.ps1      text eol=crlf
*.BAT      text eol=crlf
*.CMD      text eol=crlf
*.PS1      text eol=crlf

# Ficheros de configuración
*.conf     text eol=lf

# Serialización
*.json     text eol=lf
*.toml     text eol=lf
*.xml      text eol=lf
*.yaml     text eol=lf
*.yml      text eol=lf

# Archivos
*.7z       binary
*.bz       binary
*.bz2      binary
*.bzip2    binary
*.gz       binary
*.lz       binary
*.lzma     binary
*.rar      binary
*.tar      binary
*.taz      binary
*.tbz      binary
*.tbz2     binary
*.tgz      binary
*.tlz      binary
*.txz      binary
*.xz       binary
*.Z        binary
*.zip      binary
*.zst      binary
*.bin      binary
*.jar      binary

# Ficheros de text en los que debo preservar el EOL
*.patch    -text

# Go
# ============
*.go        text diff=golang eol=lf

# Python
# ============
*.pxd    text diff=python
*.py     text diff=python
*.py3    text diff=python
*.pyw    text diff=python
*.pyx    text diff=python
*.pyz    text diff=python
*.pyi    text diff=python

# Binarios
# ============
*.db     binary
*.p      binary
*.pkl    binary
*.pickle binary
*.pyc    binary export-ignore
*.pyo    binary export-ignore
*.pyd    binary

# Jupyter notebook
*.ipynb  text eol=lf

# Documentos comunes
*.bibtex   text diff=bibtex
*.doc      binary
*.DOC      binary
*.docx     binary
*.DOCX     binary
*.dot      binary
*.DOT      binary
*.pdf      binary
*.PDF      binary
*.rtf      binary
*.RTF      binary
*.epub     binary