Pacote google.appengine.api.capabilities

Resumo

Permite que aplicativos identifiquem interrupções na API e inatividade agendada.

Exemplo:

def StoreUploadedProfileImage(self):
  uploaded_image = self.request.get('img')
  # If the images API is unavailable, we'll just skip the resize.
  if CapabilitySet('images').is_enabled():
    uploaded_image = images.resize(uploaded_image, 64, 64)
  store(uploaded_image)

def RenderHTMLForm(self):
  datastore_readonly = CapabilitySet('datastore_v3', capabilities=['write'])
  if datastore_readonly.is_enabled():
    # ...render form normally...
  else:
    # self.response.out('<p>Not accepting submissions right now: %s</p>' %
                        datastore_readonly.admin_message())
    # ...render form with form elements disabled...

Os módulos de wrappers de APIs individuais expõem objetos CapabilitySet para usuários, o que elimina a dependência de usuários para criá-los. Eles também podem criar métodos de conveniência que deleguem o CapabilitySet relevante. Por exemplo, db.IsReadOnly().

Índice

Classe google.appengine.api.capabilities.CapabilitySet(package, capabilities=None, methods=None, stub_map=google.appengine.api.apiproxy_stub_map)Fonte

Bases: object

Encapsula um ou mais recursos.

Os recursos são nomeados explicitamente ou inferidos da lista de métodos fornecidos. Caso nenhum recurso ou método seja fornecido, será feita a verificação para saber se o pacote inteiro está ativado.

admin_message()source

Recupera qualquer mensagem de aviso do administrador para esses recursos.

Retorna

Uma string contendo uma ou mais mensagens do administrador ou uma string vazia.

Gera

UnknownCapabilityError, caso um recurso especificado não tenha sido reconhecido.

is_enabled()source

Testa se os recursos estão atualmente ativados.

Retorna

True em caso de êxito das chamadas de API que exijam esses recursos.

Gera

UnknownCapabilityError, caso um recurso especificado não tenha sido reconhecido.

will_remain_enabled_for(time=60)source

Retorna se um recurso permanecerá ativado.

OBSOLETO: este método nunca foi totalmente implementado e é considerado obsoleto. Use is_enabled().

Parâmetros

tempo: número de segundos no futuro a ser observado ao verificar o tempo de inatividade programado.

Retorna

True se não houver inatividade programada para o recurso especificado no período especificado.

Gera

UnknownCapabilityError, caso um recurso especificado não tenha sido reconhecido.

Exceção google.appengine.api.Capabilities.UnknownCapabilitiesErrorFonte

Bases: exceptions.Exception

Foi solicitado um recurso desconhecido.