Observação: o Python 2.7 chegou ao fim do suporte em 31 de janeiro de 2024. Os aplicativos Python 2.7 atuais continuarão a ser executados e a receber tráfego. No entanto, o App Engine pode bloquear a reimplantação de aplicativos que usam ambientes de execução após o término da data de suporte. Recomendamos que você migre para a versão compatível mais recente do Python.

Módulo google.appengine.api.conf

Resumo

Uma biblioteca que gerencia configurações semelhantes a sinalizações, atualizada dinamicamente.

Índice

class google.appengine.api.conf.Config(parent=None, key_name=None, _app=None, **kwds)Fonte

Bases: google.appengine.ext.db.Expando

Representa uma configuração no armazenamento de dados e no memcache.

ah__conf__load_from_yaml(parsed_config)source

Carrega todos os parâmetros de uma configuração YAMLConfiguration para campos "Expando".

Configuramos essas propriedades "Expando" com um prefixo de nome especial 'p_' para mantê-las separadas dos atributos estáticos do "Config". Dessa forma, não é preciso verificar em outro lugar para garantir que o usuário não ignore nossas propriedades internas.

Parâmetros

parse_config: uma YAMLConfiguration.

ah__conf__version: Uma propriedade de número inteiro.

classmethod kind()Fonte: Substitua o nome do tipo para evitar colisões com os usuários.

google.appengine.api.conf.LoadSingleConf(stream)Fonte

Carregue um arquivo ou string conf.yaml e retorne um objeto YAMLConfiguration.

Parâmetros

stream: um objeto de arquivo correspondente a um arquivo conf.yaml ou o respectivo conteúdo como uma string.

Retorna

Uma instância do YAMLConfiguration

classe google.appengine.api.conf.YAMLConfiguration(**attributes)Fonte

Bases: google.appengine.api.validation.Validated

Essa classe descreve a estrutura de um arquivo conf.yaml.

No nível superior, o arquivo precisa ter um atributo params, que é um mapeamento de strings para escalares. Exemplo:

Parâmetros

background_color: ‘vermelho’
tamanho da mensagem: 1024
boolean_valued_param: true

ATTRIBUTES = {'parameters': <class 'google.appengine.api.conf._ParameterDict'>}

google.appengine.api.conf.get(name, default=None)source

Receba o valor de um parâmetro de configuração.

Esta função tem a garantia de retornar o mesmo valor para cada chamada durante uma única solicitação.

Parâmetros

nome: o nome do parâmetro de configuração para o valor desejado.
padrão: um valor padrão para retornar caso não exista o parâmetro nomeado.

Retorna

O valor da string do parâmetro de configuração.

google.appengine.api.conf.get_all()source

Retorna um objeto com um atributo para cada parâmetro "conf".

Retorna

Um objeto com um atributo para cada parâmetro "conf".

google.appengine.api.conf.refresh()source

Atualize o cache de configuração local do memcache/datastore.

Geralmente, os parâmetros de configuração são atualizados apenas no início de uma nova solicitação. Quando você tem uma solicitação de execução muito longa ou precisa dos dados mais recentes por algum motivo, é possível chamar essa função para forçar uma atualização.