Saltar para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.replit.com/llms.txt

Use this file to discover all available pages before exploring further.

Este guia demonstra como usar a biblioteca cliente Python para fazer upload, listar, baixar e excluir arquivos no seu bucket do App Storage.

Criar um Replit App em Python

  1. Selecione sinal de mais Criar App na tela inicial.
  2. Navegue até a aba Escolher um Template.
  3. Digite “Python” no campo de busca de templates e selecione-o conforme mostrado abaixo:
    Tela de seleção do template Python
  4. Selecione sinal de mais Criar App.

Instalar a biblioteca cliente oficial

Para instalar a biblioteca cliente, siga as instruções de configuração com um clique ou do gerenciador de pacotes abaixo.
1

Acessar a ferramenta App Storage

  1. Navegue até a aba App Storage.
  2. Selecione a visualização ícone de colchetes angulares Comandos na aba App Storage.
A tela de instalação deve ser semelhante à captura de tela a seguir:
captura de tela da instalação do pacote do App Storage
2

Instalar as dependências

  1. Selecione “Python” no menu suspenso de linguagem de programação no canto superior esquerdo.
  2. Selecione Instalar o pacote replit-object-storage.
  3. Quando concluído, o texto do botão deve exibir Pacote instalado.

Criar um bucket

Antes de armazenar objetos, você deve criar um bucket. Siga os passos abaixo para criar um novo bucket:
  1. Navegue até a ferramenta App Storage
  2. Selecione Criar novo bucket
  3. Insira um nome para o bucket no campo Nome
  4. Selecione Criar bucket

Adicionar e executar o código de exemplo

1

Localizar main.py

Abra a ferramenta ícone de arquivos Arquivos na barra lateral esquerda.Selecione main.py para abri-lo em um editor de arquivos.
2

Adicionar o código do cliente

Copie e cole o seguinte código em main.py:
# Instanciar um Client
from replit.object_storage import Client
client = Client()

# Fazer upload de um arquivo de texto com o conteúdo "Hello, World!"
client.upload_from_text("file.txt", "Hello World!")

# Listar os objetos no bucket
objects = client.list()
print("Conteúdo do bucket:", objects)

# Recuperar e imprimir o conteúdo do arquivo enviado
contents = client.download_as_text("file.txt")
print("Conteúdo de file.txt: ", contents)
3

Executar o app

Selecione Executar para rodar o código de exemplo.Navegue até a aba Console para ver a saída, que deve ser semelhante ao resultado abaixo:
Conteúdo do bucket: [Object(name='file.txt')]
Conteúdo de file.txt:  Hello World!
Confirme que o objeto file.txt aparece no seu bucket na visualização Objetos da ferramenta Object Storage.
Recarregue a página para atualizar a lista de objetos se file.txt não aparecer.

Excluir o objeto

Para remover o arquivo file.txt do bucket,
  1. Substitua o conteúdo de main.py pelo seguinte código:
    from replit.object_storage import Client
    client = Client()
    
    # Excluir file.txt do bucket
    client.delete("file.txt")
    print("Exclusão bem-sucedida")
    
  2. Selecione Executar para rodar o código de exemplo.
  3. Navegue até a aba Console para ver a saída, que deve ser semelhante ao resultado abaixo:
    Exclusão bem-sucedida
    
  4. Verifique que o objeto file.txt não aparece mais no bucket.

Próximos passos

Para saber mais sobre o Replit App Storage, consulte os seguintes recursos: