Pular para o conteúdo principal
O cubehosting chama a API pública sem você montar o pedido à mão: um método para cada rota, os logs ao vivo, o envio de arquivos grandes ao Blob e os erros com o code da API. Não tem dependências: só a biblioteca padrão do Python 3.9 ou mais novo.

Instalar

O pacote da Cube no PyPI é só o cubehosting: não instale um de nome parecido nem passe a sua chave a ele.

Começar

Crie uma chave em Chaves de API e guarde na variável CUBE_API_KEY. O modelo Leitura basta para ver projetos, logs e métricas; para enviar e controlar, o Deploy (CI/CD); para os arquivos do projeto, uma chave com Arquivos · ler e Arquivos · escrever (o Ler e escrever tem as duas). Veja as permissões. A chave Só Blob alcança só os métodos do Blob.
Cada método tem o nome da operação no OpenAPI em snake_case: primeiro os IDs do caminho, depois os campos como argumentos nomeados em snake_case (memory_mb vai como memoryMb). A resposta é o JSON da API, com os campos como ela manda (memoryMb, createdAt).

Enviar código

O .zip vai pelo caminho, em bytes ou como um arquivo aberto em "rb", com o mesmo limite do plano (5 MB no Free e 10 MB nos pagos). Os outros campos são os de Criar um projeto; variables é um dicionário {"NOME": "valor"}.
Para mandar uma pasta sem montar o .zip, respeitando o .gitignore, use a CLI (cube deploy).

Logs ao vivo

Primeiro chegam as últimas lines linhas, depois as novas, e cada mudança de estado como status. follow=False manda só as últimas e termina; source="build" mostra a instalação. O texto é do seu projeto: mostre como texto, nunca como HTML.

Blob

O upload_blob faz os três passos do envio: pede o envio, manda os bytes direto ao armazenamento (em partes de 16 MB acima disso, lendo o arquivo aos pedaços) e confirma. Sem content_type, o tipo vem da extensão do nome.
O link (o publicUrl do objeto ou o de create_blob_download_url) abre com qualquer cliente HTTP, inclusive o urllib.request.urlopen sem cabeçalho nenhum: o download_blob só junta os dois passos. Se uma parte não chega (o SDK tenta cada uma 3 vezes), o erro é um CubeUploadError com o object_id: chame upload_blob(path, data, object_id=...) com o mesmo arquivo para mandar só o que falta. As partes que chegaram ficam guardadas por 24 horas.

Arquivos do projeto

Com uma chave com Arquivos · ler (files:read) para ler e Arquivos · escrever (files:write) para mudar, nos planos pagos. Tudo acontece na caixa do seu projeto, e cada ação entra na Atividade com o nome da chave. O compare_files diz, pelo tamanho e o SHA-256, se cada arquivo do seu computador é new, changed, unchanged ou blocked no projeto, sem mudar nada. O upload_file manda um arquivo de até 500 MB em partes de 16 MB, lendo do disco aos pedaços (o envio em partes do começo ao fim), e o apply_project_changes faz valer no projeto no ar, reinstalando as dependências só se o manifesto mudou:
Por cima de um arquivo que existe, só com should_overwrite=True (sem ele, 409 file_already_exists). O read_file e o write_file são para texto até 1 MB; o download_file e o download_files_zip pedem o link (que só abre com a mesma chave) e gravam num caminho ou num arquivo aberto em "wb". O move_file recebe from_path= e to=.

Erros

Toda resposta de erro vira um CubeApiError, com o code fixo em inglês da página Códigos de erro e a mensagem em português para mostrar a uma pessoa.
Sem conexão ou com o tempo esgotado, o erro é um CubeConnectionError. Todos herdam de CubeError.

Segurança

  • A chave nunca aparece no repr, no print nem em erro nenhum.
  • O SDK não segue redirecionamento: a chave só vai ao endereço da API.
  • Os bytes do Blob vão direto ao armazenamento pela URL assinada, sem a chave.
  • O User-Agent leva só o nome e a versão do SDK.