Módulo google.appengine.ext.cloudstorage.common

Resumo

Auxiliares compartilhados por cloudstorage_stub e cloudstorage_api.

Conteúdo

google.appengine.ext.cloudstorage.common.CSFileStat

alias de GCSFileStat

google.appengine.ext.cloudstorage.common.dt_str_to_posix(dt_str)source

format str to posix.

datetime str é do formato %Y-%m-%dT%H:%M:%S.%fZ. Por exemplo, 2013-04-12T00:22:27.978Z. De acordo com ISO 8601, T é um separador entre data e hora quando estão na mesma linha. Z indica UTC (meridiano zero).

Um ponteiro: http://www.cl.cam.ac.uk/~mgk25/iso-time.html

Ele é usado para analisar o nó LastModified da resposta XML do intervalo GET do GCS.

Parâmetros

dt_str: um str de data e hora.

Retorna

Um flutuante de segundos do epoch Unix. Pela definição de posix, epoch é meia-noite, 1970/1/1 UTC.

google.appengine.ext.cloudstorage.common.local_api_url()source

Retorne URL para emulação GCS em dev appserver.

google.appengine.ext.cloudstorage.common.local_run()source

Se precisamos acertar o stub dev appserver GCS.

google.appengine.ext.cloudstorage.common.get_access_token()source

Retorna o token de acesso compartilhado.

google.appengine.ext.cloudstorage.common.get_stored_content_length(headers)source

Retorna o tamanho do conteúdo (em bytes) do objeto, conforme armazenado no GCS.

x-goog-stored-content-length precisa estar sempre presente, exceto quando chamado por meio de dev_appserver local. Por isso, caso ele não esteja presente, assumimos como padrão o cabeçalho do tamanho de conteúdo padrão.

Parâmetros

headers: um dict de cabeçalhos da resposta http.

Retorna

o tamanho do conteúdo armazenado.

google.appengine.ext.cloudstorage.common.get_metadata(headers)source

Receba opções definidas pelo usuário de cabeçalhos de resposta HTTP.

class google.appengine.ext.cloudstorage.common.GCSFileStat(filename, st_size, etag, st_ctime, content_type=None, metadata=None, is_dir=False)source

Bases: object

Contêiner do stat do arquivo GCS.

google.appengine.ext.cloudstorage.common.http_time_to_posix(http_time)source

Converta formato de hora HTTP em hora posix.

Consulte http://www.w3.org/Protocols/rfc2616/rfc2616-sec3.html#sec3.3.1 para formato de hora http.

Parâmetros

http_time: hora em formato RFC 2616. Por exemplo, “Mon, 20 Nov 1995 19:12:08 GMT".

Retorna

Um flutuante de segundos do epoch Unix.

google.appengine.ext.cloudstorage.common.memory_usage(method)source

Registre o uso de memória antes e depois de um método.

google.appengine.ext.cloudstorage.common.posix_time_to_http(posix_time)source

Converta hora posix no formato de hora do cabeçalho HTML.

Parâmetros

posix_time: hora unix.

Retorna

Um str de data e hora no formato RFC 2616.

google.appengine.ext.cloudstorage.common.posix_to_dt_str(posix)source

Contrário de str_to_datetime.

Ele é usado pelo stub GCS para gerar a resposta XML do intervalo GET.

Parâmetros

posix: um flutuante de segundos do epoch Unix.

Retorna

Um str de data e hora.

google.appengine.ext.cloudstorage.common.set_access_token(access_token)source

Defina o token de acesso compartilhado a ser autenticado com o Google Cloud Storage.

Quando definida, a biblioteca tentará sempre se comunicar com o Google Cloud Storage real com esse token, mesmo quando estiver em execução no dev appserver. O token pode expirar. Dessa maneira, cabe a você renová-lo.

Quando ausente, a biblioteca solicitará e atualizará automaticamente um token no appserver ou, quando estiver em dev appserver, falará com um stub do Google Cloud Storage.

Parâmetros

access_token: receba um executando "gsutil -d ls" e copie str após "Bearer".

google.appengine.ext.cloudstorage.common.validate_options(options)source

Valide as opções do Google Cloud Storage.

Parâmetros

options: um dict str->basestring de opções a serem passadas para o Google Cloud Storage.

Gera
  • ValueError: caso a opção não seja compatível.

  • TypeError: caso a opção não seja do tipo str ou o valor de uma opção não seja do tipo basestring.

google.appengine.ext.cloudstorage.common.validate_bucket_name(name)source

Valide um nome de intervalo do Armazenamento do Google.

Parâmetros

name: um nome de intervalo do Google Storage sem prefixo ou sufixo.

Gera

ValueError: caso o nome seja inválido.

google.appengine.ext.cloudstorage.common.validate_bucket_path(path)source

Valide um caminho do intervalo do Google Cloud Storage.

Parâmetros

path: um caminho do intervalo do Armazenamento do Google. Ele precisa ter o formulário "/bucket".

Gera

ValueError: caso o caminho seja inválido.

google.appengine.ext.cloudstorage.common.validate_file_path(path)source

Valide um caminho de arquivo do Google Cloud Storage.

Parâmetros

path: um caminho de arquivo do Google Storage. Ele precisa ter o formato "/bucket/filename".

Gera

ValueError: caso o caminho seja inválido.

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Ambiente padrão do App Engine para Python 2