Modulo google.appengine.api.files.file

Riepilogo

API Files.

Deprecata dalla versione 1.8.1: utilizza la libreria client di Google Cloud Storage.

Contenuti

exception google.appengine.api.files.file.ApitemporaryUnavailableErrorsource

Basi: google.appengine.api.files.file.Error

L'API Files non è al momento disponibile. Riprova a richiedere l'accesso.

eccezione google.appengine.api.files.file.Errorsource

Basi: eccezioni.Eccezione

Classe di errore di base per questo modulo.

exception google.appengine.api.files.file.EsclusiLockFailedErrorsource

Basi: google.appengine.api.files.file.Error

Impossibile ottenere l'esclusivo blocco.

exception google.appengine.api.files.file.ExistenceErrororigine

Basi: google.appengine.api.files.file.Error

Il file ha uno stato di esistenza errato.

exception google.appengine.api.files.file.FileNotOpenedErrorsource

Basi: google.appengine.api.files.file.Error

Il file non è stato aperto.

eccezione google.appengine.api.files.file.FiletemporaryAvailableErrorsource

Basi: google.appengine.api.files.file.Error

Il file è temporaneamente non disponibile. Riprova a richiedere l'accesso.

exception google.appengine.api.files.file.FinalizationErrororigine

Basi: google.appengine.api.files.file.Error

Il file è in stato di finalizzazione errato.

exception google.appengine.api.files.file.InvalidArgumentErrorsource

Basi: google.appengine.api.files.file.Error

L'argomento della funzione ha un valore non valido.

exception google.appengine.api.files.file.InvalidFileNameErrororigine

Basi: google.appengine.api.files.file.Error

Il nome del file non è valido.

exception google.appengine.api.files.file.InvalidParameterErrororigine

Basi: google.appengine.api.files.file.Error

Il parametro specificato nella chiamata Create() non è valido.

exception google.appengine.api.files.file.OperationNotSupportedErrororigine

Basi: google.appengine.api.files.file.Error

Modalità di apertura file non corretta.

exception google.appengine.api.files.file.PermissionDeniedErrorsource

Basi: google.appengine.api.files.file.Error

L'applicazione non dispone delle autorizzazioni per eseguire l'operazione.

exception google.appengine.api.files.file.ReadOnlyErrororigine

Basi: google.appengine.api.files.file.Error

Il file è in modalità di sola lettura.

exception google.appengine.api.files.file.SequenzaKeyOutOfOrderError(last_sequence_key, cause=None)source

Basi: google.appengine.api.files.file.Error

La chiave della sequenza specificata non è corretta.

ultima_sequenza_chiave

Ultima chiave della sequenza scritta nel file.

exception google.appengine.api.files.file.UnknownErrororigine

Basi: google.appengine.api.files.file.Error

Si è verificato un errore io imprevisto sconosciuto.

exception google.appengine.api.files.file.SupportedContentTypeErrorsource

Basi: google.appengine.api.files.file.Error

Il tipo di contenuto del file specificato non è supportato da questa API.

exception google.appengine.api.files.file.SupportedOpenModeErrorsource

Basi: google.appengine.api.files.file.Error

È stata specificata la modalità di apertura del file non supportata.

exception google.appengine.api.files.file.ErrorContentTypeErrorsource

Basi: google.appengine.api.files.file.Error

Il file ha un tipo di contenuti diverso.

exception google.appengine.api.files.file.ErrorOpenModeErrororigine

Basi: google.appengine.api.files.file.Error

Modalità di apertura file non corretta.

google.appengine.api.files.file.delete(*nomefile)origine

Eliminare definitivamente i file.

Eliminare i file non finalizzati/non esistenti è autonomo.

Parametri

nomi file - nomi file definitivi come stringhe. Il nome file deve avere il formato "/gs/bucket/filename" o "/blobstore/blobkey".

Aumenta

• InvalidFileNameError: viene aumentato quando un nome file non ha un formato valido o non è un nome definitivo.

• IOError - Aumentato se si verifica un problema durante il contatto con il sistema di backend.

google.appengine.api.files.file.finalize(filename, content_type=0)origine

Finalizzare un file.

Parametri

• filename – Nome del file come stringa.

• content_type - Il tipo di contenuti del file. Valore ottenuto da eContentFileType.ContentType enum.

google.appengine.api.files.file.listdir(path, **kwargs)fonte

Restituisce un elenco ordinato di nomi file (che corrispondono a un pattern) nel percorso specificato.

Al momento, sono supportati solo i percorsi di Google Cloud Storage.

Parametri

• path: un percorso di Google Cloud Storage in formato "/gs/bucketname".

• kwargs - altri argomenti delle parole chiave da inoltrare a Google Cloud Storage. Questa opzione consente di selezionare determinati file con nomi corrispondenti a un pattern. Per maggiori dettagli, visita google.appengine.api.files.gs.listdir.

Restituisce

un elenco contenente i nomi file (che corrispondono a un pattern) del percorso specificato. Ordinata per stringa Python.

google.appengine.api.files.file.open(nomefile, mode='r', content_type=0, esclusive_lock=False, buffering=0)origine

Apri un file.

Parametri

• filename – Un nome del file come stringa.

• mode – Modalità file aperta. Può essere "a" o "r".

• content_type - Il tipo di contenuti del file. Valore ottenuto da eContentFileType.ContentType enum.

• esclusive_lock – Se il file deve essere bloccato esclusivamente. Tutti gli altri tentativi di blocco esclusivi verranno archiviati finché il file non verrà chiuso correttamente.

• buffering: argomento facoltativo simile a quello aperto in Python. Specifica la dimensione del buffer desiderata del file: 0 significa un valore senza buffer; un valore positivo significa utilizzare un buffer di quella dimensione, mentre qualsiasi valore negativo indica la dimensione predefinita. È supportato solo il buffering di lettura.

Restituisce

Oggetto File.

Aumenta

InvalidArgumentError: viene elevato quando viene assegnato un valore o un tipo di argomento non valido.

google.appengine.api.files.file.stat(filename)origine

Conoscere lo stato di un file finalizzato poiché il nome del file è completo.

Restituisce

Un oggetto _FileStat simile a quello restituito da os.stat(path) di python.

Genera:

FinalizzazioneError se il file non è finalizzato.

classgoogle.appengine.api.files.file.BufferedFile(filename, buffer_size=524288)origine

Basi: oggetto

BufferedFile è un oggetto simile a un file che legge il file in blocchi.

chiudi()sorgente

source(size=None)

Leggere i dati da un file RAW.

Parametri

size - Numero di byte da leggere come numero intero. Il numero effettivo di byte letti è sempre uguale alle dimensioni, a meno che non termini se è stato raggiunto il file.

Restituisce

Una stringa con dati letti.

readline(size=-1)origine

Leggi una riga delimitata da " " nel file.

Nella stringa viene mantenuto un carattere di nuova riga finale. Potrebbe essere assente quando un file termina con una riga incompleta. Se l'argomento di dimensione non è negativo, specifica la dimensione massima della stringa (conteggiando la nuova riga) da restituire. Viene restituita una stringa vuota solo quando EOF viene rilevata immediatamente.

Argomenti:

size: numero massimo di byte da leggere. Se non specificato, la riga di lettura si interrompe

solo su "

' o EOF.

Risultato:

I dati vengono letti come stringa.

search(offset, whence=0)origine

Imposta la posizione corrente del file.

Parametri

• offset: cerca l'offset come numero.

• da cui cercare: modalità di ricerca. Le modalità supportate sono os.SEEK_SET (ricerca assoluta), os.SEEK_CUR (ricerca relativa alla posizione corrente) e os.SEEK_END (ricerca relativa alla fine, l'offset deve essere negativo).

Tell()Source

Restituisce la posizione corrente del file.