Nota: Python 2.7 ha raggiunto 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 rideployment delle applicazioni che utilizzano i runtime al termine del periodo di assistenza. Ti consigliamo di eseguire la migrazione alla versione più recente di Python supportata.

Modulo google.appengine.ext.bulkload.Transform

Riepilogo

Funzioni di supporto per la trasformazione di collettivo.

Una raccolta di funzioni helper per il caricamento collettivo dei dati, generalmente indicate a partire da un file batchloader.yaml.

Contenuti

google.appengine.ext.bulkload.Transform.blob_to_file(filename_hint_propertyname=None, directory_hint='')fonte

Scrive i contenuti del blob in un file e li sostituisce con il nome del file.

Parametri

filename_hint_propertyname - Se presente, il nome file inizierà con i contenuti di questo valore nell'entità esportata.
directory_hint – Se presenti, i file verranno archiviati in questa directory.

Restituisce

Una funzione che scrive il blob di input in un file.

google.appengine.ext.bulkload.Transform.blobproperty_from_base64(value)sorgente

google.appengine.ext.bulkload.Transform.bytestring_from_base64(valore)source

google.appengine.ext.bulkload.Transform.child_node_from_list(child_node_name)origine

Restituisce un valore adatto alla generazione di un nodo secondario XML durante l'esportazione.

Il valore restituito è un elenco di tupla che il connettore Simplexml utilizzerà per creare un nodo secondario.

Vedi anche list_from_child_node

Parametri

children_node_name: il nome da utilizzare per ciascun nodo figlio.

Restituisce

Una funzione che funziona come descritto negli argomenti.

google.appengine.ext.bulkload.Transform.create_deep_key(*path_info)origine

Un metodo che crea oggetti chiave su più livelli.

Genera una chiave multilivello da più campi nel dizionario di input.

Questa opzione di solito viene utilizzata per le chiavi per le entità che hanno chiavi padre variabili, ad esempio quelle con relazioni di proprietà. Può essere utilizzato sia per __key__ che per i riferimenti.

Utilizza create_foreign_key per creare chiavi a livello singolo in modo più semplice.

Parametri

*path_info – Un elenco di tupla, che descrivono (kind, property, is_id=False).
Tipo: il nome del tipo.
proprietà: la proprietà esterna nel dizionario di importazione corrente o Transform.CURRENT_PROPERTY per il valore passato alla trasformazione.
is_id -
Se True, converte il valore in int e lo tratta come ID numerico. Se il valore è False, il valore è un nome di stringa. Il valore predefinito è False.
Esempio: create_deep_key(‘rootkind’, ‘rootcolumn’),
('childkind’, 'childcolumn’, True), ('leafkind’, Transform.CURRENT_PROPERTY)

Restituisce

Una funzione di trasformazione che analizza le informazioni dell'attuale dizionario neutro in una chiave con dati padre, come descritto da path_info.

google.appengine.ext.bulkload.Transform.create_foreign_key(kind, key_is_id=False)origine

Un metodo che crea oggetti Key a livello singolo.

In genere questi attributi vengono utilizzati nella proprietà Reference in Python, dove il valore di riferimento è una chiave con nome del tipo (o del modello).

Questo metodo di supporto non supporta le chiavi con i genitori. Utilizza create_deep_key per creare chiavi con i genitori.

Parametri

type: il nome del riferimento sotto forma di stringa.
key_is_id – Se True, converte la chiave in un numero intero da utilizzare come ID. Se il valore è False, la chiave rimane nel formato di input, in genere una stringa.

Restituisce

Una funzione di argomento singolo che analizza un valore in una chiave di tipo entità_kind.

google.appengine.ext.bulkload.Transform.empty_if_none(fn)origine

Un wrapper che restituisce "" se il suo input è None. Utile per l'esportazione.

Può essere utilizzato nei file di configurazione (ad es. "Transform.empty_if_none(unicode)") o come decoratore.

Parametri

fn - Funzione di trasformazione con argomento singolo.

Restituisce

La funzione aggregata.

google.appengine.ext.bulkload.Transform.export_date_time(formato)source

Un wrapper attorno a strftime che restituisce "" se il valore è Nessuno.

Parametri

format – Una stringa di formato per strftime.

Restituisce

Una funzione di argomento singolo che converte una data/ora in una stringa utilizzando il formato.

google.appengine.ext.bulkload.assicurarti.fix_param_typo(oops, fix)source

Un decorator che corregge il nome di un parametro errato.

Un parametro nelle funzioni split_string() e join_list() aveva inizialmente un errore di ortografia come "delimeter" anziché "delimitatore". Non è stato possibile correggere l'errore semplicemente rinominandolo, perché questo codice causava il malfunzionamento del codice client che assegnava il nome al parametro.

# Questo va bene: suddividi le stringhe con punto e virgola. split_string(';’)

# Questa operazione si interrompe a meno che anche il codice client non abbia modificato il delimitatore in delimitatore. split_string(delimeter=’;’)

Ma l'ortografia è valida, anche nel codice, eccolo qui.

Parametri

oops - Il nome del parametro scritto in modo scorretto.
risolto: il nome del parametro digitato correttamente, che corrisponde al nome nella definizione della funzione decorata.

Restituisce

Una funzione che chiama la funzione decorata correttamente quando viene richiamata con un parametro contenente errori ortografici.

google.appengine.ext.bulkload.Transform.import_date_time(formato, _strptime=None)origine

Un wrapper attorno allo strptime che restituisce Nessuno se l'input è vuoto.

Parametri

format – Una stringa di formato per strptime.

Restituisce

Una funzione di argomento singolo che analizza una stringa in una data e ora utilizzando il formato.

google.appengine.ext.bulkload.assicurarti.join_list(*args, **kwargs)source: Richiama la funzione decorata con il parametro corretto.

google.appengine.ext.bulkload.transform.key_id_or_name_as_string(key)source

google.appengine.ext.bulkload.Transform.key_id_or_name_as_string_n(index)origine

Recupera l'ID o il nome nth (basata su 0) da una chiave con padre.

Se è presente una chiave, restituisce il relativo ID o nome come stringa.

Tieni presente che in questo modo perdi la distinzione tra ID interi e stringhe che hanno l'aspetto di numeri interi. Utilizza key_type per distinguerli.

Questo è un utile complemento a create_deep_key.

Parametri

indice: la profondità dell'ID o del nome da estrarre, dove 0 è la chiave radice e -1 è la chiave foglia.

Restituisce

Una funzione che estrae il nome o l'ID della chiave all'indice di profondità, come stringa Unicode. La funzione restituisce '' se la chiave è vuota (non salvata), altrimenti restituisce IndexError se la chiave non è così profonda come descritto.

google.appengine.ext.bulkload.Transform.key_kind(value)origine

google.appengine.ext.bulkload.transform.key_kind_n(index)source

Recupera il tipo di chiave nth (basata su 0) da una chiave con genitori.

Questo è un utile complemento a create_deep_key.

Parametri

indice: la profondità dell'ID o del nome da estrarre, dove 0 è la chiave radice e -1 è la chiave foglia.

Restituisce

Una funzione che restituirà il tipo di chiave all'indice di profondità o alza l'indice di errore se la chiave non è così profonda come descritto.

google.appengine.ext.bulkload.change.key_type(key)source

google.appengine.ext.bulkload.transform.key_type_n(index)source

Recupera il tipo di chiave nth (basata su 0) da una chiave con chiavi padre.

Ciò è particolarmente utile se associato a key_id_or_name_as_string_n. Questo è un utile complemento a create_deep_key.

Parametri

indice: la profondità dell'ID o del nome da estrarre, dove 0 è la chiave radice e -1 è la chiave foglia.

Restituisce

Una funzione che restituisce il tipo ("ID" o "nome") della chiave nell'indice di profondità. La funzione restituisce '' se la chiave è vuota (non salvata), altrimenti restituisce IndexError se la chiave non è così profonda come descritto.

google.appengine.ext.bulkload.Transform.list_from_child_node(xpath, suppress_blank=False)origine

Restituisce una proprietà elenco da nodi secondari del nodo XML corrente.

Viene applicato solo l'helper Simplexml, in quanto presume __node__, il nodo ElementTree corrente corrispondente al record di importazione.

Esempio di utilizzo per la struttura:

<Visita>

<VisitaActivities>: <Attività>A1</Attività> <Attività>A2</Attività>

</VisitaActivities>

</Visita>

property: activity external_name: VisitActivities # Ignorato all'importazione, utilizzato nell'esportazione. import_transform: list_from_xml_node("VisitaActivities/Activity") esport_transform: children_node_from_list("Activity")

Parametri

xpath - XPath da eseguire sul nodo corrente.
suppress_blank: se True, i nodi senza testo verranno ignorati.

Restituisce

Una funzione che funziona come descritto negli argomenti.

google.appengine.ext.bulkload.trasform.list_from_multiproperty(*external_names)sorgente

Crea un elenco utilizzando più proprietà.

Parametri

*external_names - Un elenco di proprietà da utilizzare.

Restituisce

Una funzione che restituisce un elenco delle proprietà in external_names.

google.appengine.ext.bulkload.Transform.none_if_empty(fn)origine

Un wrapper che restituisce Nessuno se il valore inserito è vuoto, altro fn(x).

Utile all'importazione. Può essere utilizzato nei file di configurazione (ad esempio "Transform.none_if_empty(int)") o come decoratore.

Parametri

fn - Funzione di trasformazione con argomento singolo.

Restituisce

La funzione aggregata.

google.appengine.ext.bulkload.Transform.property_from_list(index)origine

Restituisce l'elemento nella posizione "index" da un elenco.

Parametri

index: l'elemento (in base a 0) dell'elenco da restituire.

Restituisce

Una funzione che restituisce l'elemento specificato da un elenco o "" se l'elenco contiene un numero insufficiente di elementi.

google.appengine.ext.bulkload.tras.regexp_bool(regexp, flags=0)origine

Restituisce un valore booleano che indica se l'espressione corrisponde a re.match.

Tieni presente che viene creata una nuova corrispondenza con gli ancoraggi all'inizio, ma non alla fine della stringa.

Parametri

regexp - Stringa, espressione regolare.
flags: flag facoltativi da passare a re.match.

Restituisce

Una funzione che restituisce True se l'espressione corrisponde.

google.appengine.ext.bulkload.tras.regexp_extract(pattern, method=match, group=1)origine

Restituisce la stringa che corrisponde al gruppo specificato nel pattern dell'espressione regolare.

Parametri

pattern - Un'espressione regolare con cui creare una corrispondenza con almeno un gruppo.
metodo: il metodo da utilizzare per la corrispondenza; di solito re.match (il valore predefinito) o re.search.
gruppo: il gruppo da utilizzare per estrarre un valore; il primo gruppo per impostazione predefinita.

Restituisce

Una funzione di Argomento singolo che restituisce la stringa che corrisponde al gruppo specificato nel pattern oppure Nessuna se non è stata trovata alcuna corrispondenza o l'input è stato vuoto.

google.appengine.ext.bulkload.tras.regexp_to_list(pattern)origine

Restituisce un elenco di oggetti che corrispondono a un'espressione regolare.

Utile all'importazione. Utilizza l'espressione regolare fornita per suddividere un valore stringa in un elenco di stringhe. Racchiuso tra none_if_input_or_result_empty, quindi restituisce None se non ci sono corrispondenze per l'espressione regolare o se l'input è vuoto.

Parametri

pattern - Un pattern di espressione regolare da trovare in corrispondenza della stringa di input.

Restituisce

Una funzione che restituisce None se l'input era Nessuna o nessuna corrispondenza trovata, altrimenti un elenco di stringhe corrispondenti all'espressione di input.

google.appengine.ext.bulkload.tras.split_string(*args, **kwargs)origine: Richiama la funzione decorata con il parametro corretto.