Nota: Python 2.7 ha raggiunto la fine del supporto il 31 gennaio 2024. Le applicazioni Python 2.7 esistenti continueranno a essere eseguite e a ricevere traffico. Tuttavia, App Engine potrebbe bloccare il ri deployment di applicazioni che utilizzano runtime dopo la data di fine del supporto. Ti consigliamo di eseguire la migrazione all'ultima versione supportata di Python.

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.