SDK de Python: gestor de archivos de la app

El gestor de archivos está en client.apps.files. Todos los métodos reciben primero el id de la aplicación y después una ruta dentro de la aplicación. Las rutas tienen como máximo 256 caracteres. Los ejemplos usan el client de Crear el cliente. app_id es el id de una de tus aplicaciones: client.account.me() las lista.

Listar un directorio

files.list(app_id, path=None) lista un directorio (la raíz de la aplicación cuando se omite path). A diferencia de otros modificadores opcionales, path puede pasarse por posición.

for entry in client.apps.files.list(app_id, "/src"):
    print(entry["type"], entry["name"], entry.get("size"), entry.get("lastModified"))

Campo	Tipo	Descripción
`name`	`str`	Nombre de la entrada
`type`	`"file" \| "directory"`	Tipo de entrada
`size`	`int`, opcional	Tamaño en bytes. Ausente en algunas entradas de directorio
`lastModified`	`float \| None`, opcional	Ms Unix (puede incluir decimales); `None` cuando no se puede leer

Un directorio que no existe da 404 FILE_NOT_FOUND. Una ruta que el gestor de archivos no expone da 403 BLOCKED_PATH.

Leer un archivo

files.read(app_id, path) devuelve el contenido del archivo como bytes. Los archivos están limitados a 10 MB: uno más grande da 413 FILE_TOO_LARGE.

import json

data = client.apps.files.read(app_id, "/config.json")
text = data.decode()

print(json.loads(text))

Escribir un archivo

files.write(app_id, path, content) crea o sobrescribe un archivo.

Un str se envía como texto plano.
Los bytes se envían en base64, así que cualquier contenido binario se conserva intacto.
Un contenido vacío ('' o b'') crea un archivo vacío.

import json
import urllib.request

# Text
client.apps.files.write(app_id, "/config.json", json.dumps({"debug": False}))

# Binary
with urllib.request.urlopen(image_url) as response:
    image = response.read()
client.apps.files.write(app_id, "/assets/logo.png", image)

Un contenido de más de 10 MB falla localmente con FILE_TOO_LARGE (estado 0) antes de enviar nada. Un contenido de más de 1 MiB se envía sin timeout una vez conectado, como una subida. Para archivos más grandes, usa apps.commit().

Escribir no reinicia la aplicación. Llama a apps.restart() para aplicar el cambio.

Mover o renombrar un archivo

client.apps.files.move(app_id, "/config.json", "/config.old.json")

Eliminar un archivo

client.apps.files.delete(app_id, "/config.old.json")

Errores

Estado	Código	Cuándo
0	`FILE_TOO_LARGE`	Contenido de `write` de más de 10 MB (se comprueba localmente)
400	`INVALID_PATH`	La ruta no supera la validación (traversal, caracteres no válidos, demasiado larga), o `move` a la misma ruta
400	`DELETE_FAILED`, `RENAME_FAILED`	El clúster no pudo eliminar o renombrar el archivo
403	`BLOCKED_PATH`	El gestor de archivos no expone la ruta
403	`PERMISSION_DENIED`	Tu rol en el workspace no puede tocar un archivo restringido (como `.env`)
404	`FILE_NOT_FOUND`	El archivo o directorio no existe
413	`FILE_TOO_LARGE`	`read` de un archivo de más de 10 MB
429	`KEEP_CALM`	Más de 10 escrituras en 5 segundos

Consulta Errores para ver los códigos que puede devolver cualquier llamada.

Próximos pasos

Variables de entorno

Lee y cambia las variables de una aplicación.

Referencia de la API del gestor de archivos

Los endpoints REST detrás de estos métodos.

Gestionar archivos desde la CLI

Las mismas acciones desde la terminal.

CLI

VS Code

SDKs

SDK de Python: gestor de archivos de la app

Listar un directorio

Leer un archivo

Escribir un archivo

Mover o renombrar un archivo

Eliminar un archivo

Errores

Próximos pasos

Variables de entorno

Referencia de la API del gestor de archivos

Gestionar archivos desde la CLI

​Listar un directorio

​Leer un archivo

​Escribir un archivo

​Mover o renombrar un archivo

​Eliminar un archivo

​Errores

​Próximos pasos

Variables de entorno

Referencia de la API del gestor de archivos

Gestionar archivos desde la CLI

Listar un directorio

Leer un archivo

Escribir un archivo

Mover o renombrar un archivo

Eliminar un archivo

Errores

Próximos pasos