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.

Retorna

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âmetros

child_node_name: o nome a ser usado para cada node filho.

Retorna

Uma 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))

Retorna

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).

Retorna

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âmetros

fn: função de transformação de argumento único.

Retorna

A 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âmetros

format: uma string de formato para strftime.

Retorna

Uma 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.

Retorna

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âmetros

format: uma string de formato para strptime.

Retorna

Uma 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âmetros

index: a profundidade do código ou nome a ser extraído, onde 0 é a chave raiz e -1 é a chave da folha.

Retorna

Uma 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âmetros

index: a profundidade do código ou nome a ser extraído, onde 0 é a chave raiz e -1 é a chave da folha.

Retorna

Uma 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âmetros

index: a profundidade do código ou nome a ser extraído, onde 0 é a chave raiz e -1 é a chave da folha.

Retorna

Uma 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.

Retorna

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.

Retorna

Uma 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âmetros

fn: função de transformação de argumento único.

Retorna

A 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âmetros

index: o item (baseado em 0) na lista a ser retornada.

Retorna

Uma 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.

Retorna

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.

Retorna

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âmetros

pattern: um padrão de expressão regular para corresponder à string entrada.

Retorna

Uma 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.