Howto Ignorar Archivos O Directorios En Un Svn

HOWTO - Ignorar archivos o directorios de un repositorio SVN

Pablo Nicolás Diaz Bilotto.

Introducción Este documento indica como configurar un cliente de SVN para que ignore el manejo un conjunto de archivos del sistema de versionado, evitando su aparición en los commits. Para evitar que el cliente de SVN versione un conjunto de archivos, hay dos opciones de configuración, una es seteando la propiedad svn:ignore a los archivos o directorios que se desea ignorar; y la otra es agregando el conjunto de archivos a la variable globalignore del archivo de configuración del cliente, cabe aclarar que una de las opciones afecta a TODOS los repositorios de los cuales se tiene copia local y la otra opción solamente afecta a los archivos de un cierto repositorio en particular.

Usando propiedades Para utilizar la propiedad svn:ignore, se debe ejecutar el siguiente comando $ svn propset svn:ignore PROPERTY_VALUE PATH [PATH ...] por ejemplo, ignorar los archivos .classpath del directorio jose/, el comando sería : $ svn propset svn:ignore .classpath jose/ también es posible agregar varios archivos/directorios a la propiedad, por ejemplo $ svn propset svn:ignore '.classpath .settings' jose/ o usar un archivo como fuente al valor de la propiedad, por ejemplo, se desea ignorar los archivos del ejemplo anterior, pero usando el archivo ignored.txt, para lo cual, el archivo deberá tener el nombre de los dos archivos previamente presentados y de a una linea por archivo; Entonces, cuando se ejecute el comando cat, se deberá tener la siguiente salida : $ cat ignored.txt .settings .classpath $

1

y para aplicar la propiedad, ejecutamos $ svn propset svn:ignore -F ignored.txt jose/ Para chequear que hemos hecho bien nuestro trabajo de ignorar los archivos, lo haremos utilizando el comando status y pasando el flag --no-ignore como parametro, con lo cual deberíamos ver el estado de los archivos ignorados, supongamos que se ha ejecutado el comando propset sobre el directorio jose/ y que los archivos .classpath y .settings fueron pasados como paramétro, entonces a la salida del comando deberían aparecer listados $ svn status --no-ignore ... I jose/.classpath ... I jose/.settings ... cabe aclarar que el valor de la propiedad svn:ignore tambien soporta la expansión de pathnames, por ejemplo el siguiente comando permitiria ignorar todos los JAR del directorio jose/ $ svn propset svn:ignore '*.jar' jose/ Notese que con las comillas se evita la expansión del cuarto parametro.

Usando el archivo de configuración La otra opción es poner los archivos en la entrada global_ignore en el archivo de configuración, el cual esta localizado usualmente en ~/.subversion/config; El valor de esta propiedad tambien soporta el uso de wilcards, de la misma manera que se mostro en el apartado anterior. Un ejemplo de como debería ser el valor de esta variable seria el siguiente $ grep global-ignores ~/.subversion/config ... global-ignores = *.o *.lo *.la *.al .libs *.so *.so.[0-9]* *.a *.pyc *.pyo ... con lo cual se ignoran los tipos de archivos mas comunes dentro de un proyecto de desarrollo de software, como son los archivos objeto, las librerías dinámicas, el directorio usado por libtools y los archivos compilados de python. Vale aclarar que es posible configurar a svn para que active la funcionalidad conocida como autoprop, la cual permite la asignación automática de propiedades, la cual esta fuera del alcance de este documento.

Valores recomendados para el projecto Como posibles valores se pueden listar los siguientes target *.jar *.dll *.exe

2

Thumbs.db .settings .classpath libs lib *.o *.so *.so.[0-9]* los cuales cubren a los directorios 'target' generados por maven, los archivos JAR, los cuales se recomienda agregar como dependencias en los archivos pom.xml, los archivos DLL y Thumbs.db, usualmente presentes en las plataformas de Microsoft, los archivos .classpath y .settings generados por eclipse, y los archivos *.so y sus variantes, los cuales aparecen usualmente en plataformas *nix. En caso de que los archivos JPEG no sean necesarios para el funcionamiento de los programas, los mismos podrían incluirse las siguientes entradas : *.jpg *.jpeg Cabe aclarar que la lista no es extensiva, ya que la variedad de plataformas y herramientas usadas por cada integrante de la organización pueden ser distintas según los requerimientos que implementen y por consiguiente imposible de listar en forma extensiva.

Índice HOWTO - Ignorar archivos ............................................................. 0 o directorios de un repositorio SVN................................................ 0 Introducción .................................................................................. 1 Usando propiedades........................................................................ 1 Usando el archivo de configuración ................................................... 2 Valores recomendados para el projecto ............................................. 2 Índice ........................................................................................... 3

3