La libreria di riferimento di Python

Previous: 6.28.2.2 FileHandler Up: 6.28.2 Oggetti Handler Next: 6.28.2.4 SocketHandler

---

6.28.2.3 RotatingFileHandler

La classe RotatingFileHandler supporta la rotazione dei file di log sul disco.

class RotatingFileHandler(

filename[, mode[, maxBytes[, backupCount]]])

Restituisce una nuova istanza della classe RotatingFileHandler. Il file specificato viene aperto ed utilizzato come flusso per il logging. Se mode non viene specificato, viene adottato 'a'. Non esiste un limite predefinito sulla dimensione del file.

Potete utilizzare i valori maxBytes e backupCount per consentire al file di essere rollover (NdT: sostituito) con uno di dimensione predeterminata. Quando la misura sta per essere superata, il file viene chiuso ed un nuovo file viene silenziosamente aperto per la registrazione. La sostituzione avviene quando il corrente file di log č vicino, per dimensione, a maxBytes; se maxBytes vale zero, la sostituzione non avviene. Se backupCount č diverso da zero, il sistema salverā il vecchio file di log aggiungendo l'estensione ".1", ".2" etc., al nome del file. Per esempio, se backupCount vale 5 ed il nome base del file č app.log, il file in corso di scrittura č sempre app.log. Quando questo file č pieno, viene chiuso e rinominato in app.log.1, e se il file app.log.1, app.log.2 esistono, verranno rinominati rispettivamente in app.log.2, app.log.3.

doRollover(

)

Effettua una sostituzione, come descritto sopra.

emit(

record)

Registra l'output di record nel file, occupandosi anche della sostituzione come descritto in setRollover().

---

La libreria di riferimento di Python

Previous: 6.28.2.2 FileHandler Up: 6.28.2 Oggetti Handler Next: 6.28.2.4 SocketHandler

---

Release 2.3.4, documentation updated on 21. maggio 2005.