Módulo google.appengine.ext.bulkload.transform
Resumo
Funções auxiliares de transformação do bulkloader.
Um conjunto de funções auxiliares para o processo de carregamento de dados em massa, geralmente referenciadas em um arquivo bulkloader.yaml.
Conteúdo
- google.appengine.ext.bulkload.transform.blob_to_file(filename_hint_propertyname=None, directory_hint='')Fonte
Grava o conteúdo do blob em um arquivo e o substitui pelo nome do arquivo.
Parâmetros-
filename_hint_propertyname: se presente, o nome do arquivo começará com o conteúdo desse valor na entidade que está sendo exportada.
-
directory_hint: se presente, os arquivos serão armazenados neste diretório.
Uma função que grava o blob de entrada em um arquivo.
-
- google.appengine.ext.bulkload.transform.blobproperty_from_base64(value)Fonte
- google.appengine.ext.bulkload.transform.bytestring_from_base64(value)Fonte
- google.appengine.ext.bulkload.transform.child_node_from_list(child_node_name)Fonte
Retorna um valor adequado para gerar um node XML filho na exportação.
O valor de retorno é uma lista de tuplas que o conector simplexml usará para construir um node filho.
Consulte também list_from_child_node
Parâmetroschild_node_name: o nome a ser usado para cada node filho.
RetornaUma função que funciona conforme descrito nos argumentos.
- google.appengine.ext.bulkload.transform.create_deep_key(*path_info)Fonte
Um método que cria objetos Key de vários níveis.
Gera uma chave de vários níveis de diversos campos no dicionário de entrada.
Normalmente usado para chaves de entidades com chaves pai variáveis, por exemplo, aquelas com relacionamentos de propriedade. Usado tanto para __key__ quanto para referências.
Use create_foreign_key para criar chaves de nível único de maneira mais simples.
Parâmetros-
*path_info – uma lista de tuplas, descrevendo (kind, property, is_id=False).
-
kind: o nome do tipo.
-
property: a propriedade externa no dicionário de importação atual ou transform.CURRENT_PROPERTY do valor passado à transformação.
-
is_id:
Se for verdadeiro, converte o valor em int e o trata como um código numérico. Se for falso, o valor será um nome de string. O padrão é "false".
Exemplo: create_deep_key((‘rootkind’, ‘rootcolumn’),
(‘childkind’, ‘childcolumn’, True), (‘leafkind’, transform.CURRENT_PROPERTY))
Uma função de transformação que analisa as informações do dicionário neutro atual em uma chave com os pais, conforme descrito por path_info.
-
- google.appengine.ext.bulkload.transform.create_foreign_key(kind, key_is_id=False)Fonte
Um método que cria objetos Key de um nível.
Normalmente, eles não são usados em ReferenceProperty em Python, onde o valor de referência é uma chave com nome de tipo (ou modelo).
Este método auxiliar não aceita chaves com pais. Use create_deep_key para criar chaves com pais.
Parâmetros-
kind: o nome do tipo da referência como uma string.
-
key_is_id: se verdadeiro, converte a chave em um inteiro a ser usado como um código. Se for falso, deixa a chave no formato de entrada (geralmente uma string).
Uma função de argumento único que analisa um valor em uma chave do tipo entity_kind.
-
- google.appengine.ext.bulkload.transform.empty_if_none(fn)Fonte
Um wrapper que retorna ‘’ se sua entrada for None. Útil para a exportação.
Pode ser usado em arquivos de configuração (por exemplo, “transform.empty_if_none(unicode)”) ou como decorador.
Parâmetrosfn: função de transformação de argumento único.
RetornaA função com wrapper.
- google.appengine.ext.bulkload.transform.export_date_time(format)Fonte
Um wrapper em torno de strftime que retorna ‘’ se a entrada for None.
Parâmetrosformat: uma string de formato para strftime.
RetornaUma função de argumento único que converte datetime em uma string usando formato.
- google.appengine.ext.bulkload.transform.fix_param_typo(oops, fixed)Fonte
Um decorador que corrige um nome de parâmetro incorreto.
Um parâmetro nas funções split_string() e join_list() foi escrito originalmente de maneira incorreta como "delimeter" em vez de "delimiter". Não foi possível corrigir o erro simplesmente renomeando-o, porque isso quebraria todo código de cliente com o nome do parâmetro ao chamar uma das funções:
# Isso é bom: dividir strings com ponto e vírgula. split_string(‘;’)
# Isso levaria a uma falha, a menos que o código do cliente também alterasse o "delimeter" para "delimiter". split_string(delimeter=’;’)
Mas a ortografia é importante, mesmo no código, então aqui estamos nós.
Parâmetros-
oops: o nome do parâmetro com erros ortográficos.
-
fixed: o nome do parâmetro escrito corretamente, que corresponde ao nome na definição da função decorada.
Uma função que chama a função decorada corretamente quando é invocada com um parâmetro com erros ortográficos.
-
- google.appengine.ext.bulkload.transform.import_date_time(format, _strptime=None)Fonte
Um wrapper em torno de strptime que retorna None se a entrada estiver vazia.
Parâmetrosformat: uma string de formato para strptime.
RetornaUma função de argumento único que analisa uma string em um datetime usando o formato.
- google.appengine.ext.bulkload.transform.join_list(*args, **kwargs)Fonte
-
Chama a função decorada com o parâmetro correto.
- google.appengine.ext.bulkload.transform.key_id_or_name_as_string(key)Fonte
- google.appengine.ext.bulkload.transform.key_id_or_name_as_string_n(index)Fonte
Recupera o enésimo código ou nome da chave (base 0) de uma chave com pais.
Se uma chave estiver presente, retorna seu código ou nome como uma string.
Isso perde a distinção entre códigos inteiros e strings que parecem ser números inteiros. Use key_type para distingui-los.
Este complemento é útil para create_deep_key.
Parâmetrosindex: a profundidade do código ou nome a ser extraído, onde 0 é a chave raiz e -1 é a chave da folha.
RetornaUma função que extrai o nome ou código da chave no índice de profundidade, como uma string unicode. A função retornará ‘’ se a chave estiver vazia (não salva). Caso contrário, gerará IndexError se a chave não for tão profunda quanto descrito.
- google.appengine.ext.bulkload.transform.key_kind(value)Fonte
- google.appengine.ext.bulkload.transform.key_kind_n(index)Fonte
Recupera o enésimo tipo de chave (base 0) de uma chave com pais.
Este complemento é útil para create_deep_key.
Parâmetrosindex: a profundidade do código ou nome a ser extraído, onde 0 é a chave raiz e -1 é a chave da folha.
RetornaUma função que retornará o tipo da chave no índice de profundidade ou gerará IndexError se a chave não for tão profunda quanto descrito.
- google.appengine.ext.bulkload.transform.key_type(key)Fonte
- google.appengine.ext.bulkload.transform.key_type_n(index)Fonte
Recupera o enésimo tipo de chave (base 0) de uma chave com pais.
Isso é mais útil quando emparelhado com key_id_or_name_as_string_n. Este complemento é útil para create_deep_key.
Parâmetrosindex: a profundidade do código ou nome a ser extraído, onde 0 é a chave raiz e -1 é a chave da folha.
RetornaUma função que retorna o tipo ('ID' ou 'name') da chave no índice de profundidade. A função retornará ‘’ se a chave estiver vazia (não salva). Caso contrário, gerará IndexError se a chave não for tão profunda quanto descrito.
- google.appengine.ext.bulkload.transform.list_from_child_node(xpath, suppress_blank=False)Fonte
Retorna uma propriedade de lista dos nodes filhos do node xml atual.
Aplicado somente ao auxiliar simplexml, já que ele pressupõe __node__, o node ElementTree atual correspondente ao registro importado.
- Uso de amostra para estrutura:
-
- <Visit>
-
- <VisitActivities>
-
<Activity>A1</Activity> <Activity>A2</Activity>
</VisitActivities>
</Visit>
property: atividades external_name: VisitActivities # Ignorado na importação, usado na exportação. import_transform: list_from_xml_node(‘VisitActivities/Activity’) export_transform: child_node_from_list(‘Activity’)
Parâmetros-
xpath: XPath para execução no node atual.
-
suppress_blank: se for verdadeiro, os nodes sem texto serão ignorados.
Uma função que funciona conforme descrito nos argumentos.
- google.appengine.ext.bulkload.transform.list_from_multiproperty(*external_names)Fonte
Cria uma lista de várias propriedades.
Parâmetros*external_names: uma lista de propriedades a serem usadas.
RetornaUma função que retorna uma lista das propriedades em external_names.
- google.appengine.ext.bulkload.transform.none_if_empty(fn)Fonte
Um wrapper que retorna None, se sua entrada estiver vazia. Caso contrário, fn(x).
Útil na importação. Pode ser usado em arquivos de configuração (por exemplo, “transform.none_if_empty(int)”) ou como decorador.
Parâmetrosfn: função de transformação de argumento único.
RetornaA função com wrapper.
- google.appengine.ext.bulkload.transform.property_from_list(index)Fonte
Retorna o item na posição 'index' de uma lista.
Parâmetrosindex: o item (baseado em 0) na lista a ser retornada.
RetornaUma função que retorna o item especificado de uma lista, ou ‘’ se a lista contiver poucos itens.
- google.appengine.ext.bulkload.transform.regexp_bool(regexp, flags=0)Fonte
Retorna um booleano indicando se a expressão corresponde a re.match.
Observe que re.match ancora no início, mas não no final da string.
Parâmetros-
regexp: string, expressão regular.
-
flags: sinalizações opcionais a serem passadas para re.match.
Uma função que retorna verdadeiro se a expressão corresponder.
-
- google.appengine.ext.bulkload.transform.regexp_extract(pattern, method=match, group=1)Fonte
Retorna a string que corresponde ao grupo especificado no padrão regex.
Parâmetros-
pattern: uma expressão regular para corresponder a pelo menos um grupo.
-
method: o método a ser usado para correspondência. Normalmente re.match (o padrão) ou re.search.
-
group: o grupo a ser usado para extrair um valor. O primeiro grupo por padrão.
Uma função de argumento único que retorna a string que corresponde ao grupo especificado no padrão ou None, se nenhuma correspondência foi encontrada ou a entrada estava vazia.
-
- google.appengine.ext.bulkload.transform.regexp_to_list(pattern)Fonte
Retorna uma lista de objetos que correspondem a uma regex.
Útil na importação. Usa o regex fornecido para dividir um valor de string em uma lista de strings. Encapsulado por none_if_input_or_result_empty, portanto, retorna None se não houver correspondências para o regex ou se a entrada estiver vazia.
Parâmetrospattern: um padrão de expressão regular para corresponder à string entrada.
RetornaUma função que retorna None se a entrada foi None ou nenhuma correspondência foi encontrada. Caso contrário, uma lista de strings que correspondem à expressão de entrada.
- google.appengine.ext.bulkload.transform.split_string(*args, **kwargs)Fonte
-
Chama a função decorada com o parâmetro correto.