Come ignoro i file in Subversion?

(Questa risposta è stata aggiornata per corrispondere al comportamento di SVN 1.8 e 1.9)

Hai 2 domande:

Contrassegnare i file come ignorati:

Con "file ignorato" intendo che il file non verrà visualizzato negli elenchi anche come "non verificato": il tuo client SVN farà finta che il file non esista affatto nel filesystem.

I file ignorati sono specificati da un "modello di file". La sintassi e il formato dei modelli di file sono spiegati nella documentazione online di SVN: http://svnbook.red-bean.com/nightly/en/svn.advanced.props.special.ignore.html "Pattern di file in Subversion ".

Subversion, dalla versione 1.8 (giugno 2013) e successive, supporta 3 diversi modi di specificare i pattern dei file. Ecco un riassunto con esempi:

1 - Area di configurazione runtime - Opzione global-ignores:

• Questa è un'impostazione solo per client-side, quindi il tuo elenco global-ignores non sarà condiviso da altri utenti e si applica a tutti i repos che effettui il checkout sul tuo computer.
• Questa impostazione è definita nel file Area di configurazione runtime:
  • Windows (basato su file) - C:\Users\{you}\AppData\Roaming\Subversion\config
  • Windows (basato sul registro) - Software\Tigris.org\Subversion\Config\Miscellany\global-ignores in HKLM e HKCU.
  • Linux/Unix - ~/.Subversion/config

2 - La proprietà svn:ignore, che è impostata sulle directory (non sui file):

• Questo è memorizzato all'interno del repository, quindi gli altri utenti avranno gli stessi file ignorati. Simile a come funziona .gitignore.
• svn:ignore è applicato alle directory ed è non ricorsivo o ereditato. Tutti i file o immediate sottodirectory della directory superiore che corrisponde al Pattern File saranno esclusi.

• Mentre SVN 1.8 aggiunge il concetto di "proprietà ereditate", la proprietà svn:ignore stessa viene ignorata nelle directory discendenti non immediate:

  cd ~/myRepoRoot                             # Open an existing repo.
  echo "foo" > "ignoreThis.txt"                # Create a file called "ignoreThis.txt".
  
  svn status                                  # Check to see if the file is ignored or not.
  > ?    ./ignoreThis.txt
  > 1 unversioned file                        # ...it is NOT currently ignored.
  
  svn propset svn:ignore "ignoreThis.txt" .   # Apply the svn:ignore property to the "myRepoRoot" directory.
  svn status
  > 0 unversioned files                       # ...but now the file is ignored!
  
  cd subdirectory                             # now open a subdirectory.
  echo "foo" > "ignoreThis.txt"                # create another file named "ignoreThis.txt".
  
  svn status
  > ?    ./subdirectory/ignoreThis.txt        # ...and is is NOT ignored!
  > 1 unversioned file
  

  (Quindi il file ./subdirectory/ignoreThis non viene ignorato, anche se "ignoreThis.txt" viene applicato alla radice del repository .).

• Pertanto, per applicare ricorsivamente un elenco di ignori è necessario utilizzare svn propset svn:ignore <filePattern> . --recursive.

  • Questo creerà una copia della proprietà in ogni sottodirectory.
  • Se il valore <filePattern> è diverso in una directory figlio, il valore del figlio sovrascrive completamente i genitori, quindi non vi è alcun effetto "additivo".
  • Quindi, se cambi <filePattern> nella root ., dovrai cambiarlo con --recursive per sovrascriverlo sulle directory figlio e discendente.

• Prendo atto che la sintassi della riga di comando è contro-intuitiva.

  • Ho iniziato assumendo che ignorassi un file in SVN digitando qualcosa come svn ignore pathToFileToIgnore.txt ma non è così che funziona la funzione ignora di SVN.

3- La proprietà svn:global-ignores. Richiede SVN 1.8 (giugno 2013):

• Questo è simile a svn:ignore, eccetto che fa uso della funzione "Proprietà ereditate" di SVN 1.8.
• Confronta con svn:ignore, il pattern del file viene applicato automaticamente in ogni directory discendente (non solo i bambini immediati) .
  • Ciò significa che non è necessario impostare svn:global-ignores con il flag --recursive, poiché i modelli di file ignorati ereditati vengono applicati automaticamente non appena vengono ereditati.

• Eseguendo lo stesso insieme di comandi come nell'esempio precedente, ma utilizzando svn:global-ignores invece:

  cd ~/myRepoRoot                                    # Open an existing repo
  echo "foo" > "ignoreThis.txt"                       # Create a file called "ignoreThis.txt"
  svn status                                         # Check to see if the file is ignored or not
  > ?    ./ignoreThis.txt
  > 1 unversioned file                               # ...it is NOT currently ignored
  
  svn propset svn:global-ignores "ignoreThis.txt" .
  svn status
  > 0 unversioned files                              # ...but now the file is ignored!
  
  cd subdirectory                                    # now open a subdirectory
  echo "foo" > "ignoreThis.txt"                       # create another file named "ignoreThis.txt"
  svn status
  > 0 unversioned files                              # the file is ignored here too!
  

Per gli utenti TortoiseSVN:

L'intero arrangiamento è stato per me fonte di confusione, perché la terminologia di TortoiseSVN (usata nel loro sistema di menu di Windows Explorer) inizialmente mi era fuorviante: non ero sicuro di quale fosse il significato del menu Ignora "Aggiungi ricorsivamente", "Aggiungi *" e "Aggiungi" opzioni. Spero che questo post spieghi come la caratteristica Ignore si collega alla funzione Proprietà SVN. Detto questo, suggerisco di usare la riga di comando per impostare i file ignorati in modo da avere un'idea di come funziona invece di usare la GUI, e solo usando la GUI per manipolare le proprietà dopo che sei a tuo agio con la riga di comando.

Elenco dei file che vengono ignorati:

Il comando svn status nasconderà i file ignorati (ovvero i file che corrispondono a un pattern R__zglobal-ignores, o corrispondono a un pattern svn:ignore della directory madre immediata o corrispondano a uno schema svn:global-ignores di qualsiasi directory di ancesor.

Utilizzare l'opzione --no-ignore per vedere quei file elencati. I file ignorati hanno lo stato di I, quindi reindirizzano l'output a grep per mostrare solo le righe che iniziano con "I".

Il comando è:

svn status --no-ignore | grep "^I"

Per esempio:

svn status
> ? foo                             # An unversioned file
> M modifiedFile.txt                # A versioned file that has been modified

svn status --no-ignore
> ? foo                             # An unversioned file
> I ignoreThis.txt                  # A file matching an svn:ignore pattern
> M modifiedFile.txt                # A versioned file that has been modified

svn status --no-ignore | grep "^I"
> I ignoreThis.txt                  # A file matching an svn:ignore pattern

ta-da!