Files
egutierrez 4300f1242d feat(metabase): expansion de funciones Python — documents, collections, permissions, validation
Añade un conjunto amplio de funciones al paquete python/functions/metabase:
- Nuevos modulos: collections.py, documents.py, maintenance.py, permissions.py, validation.py (+ test).
- Ampliacion de cards.py, dashboards.py, client.py e __init__.py para exponer las nuevas operaciones.
- Funciones de documentos (create/get/update/delete/archive/copy/move + comentarios), grupos y memberships, permission/collection graphs, copy/move de cards y dashboards, validacion de MBQL/SQL y payloads, actualizacion segura de dashboards y fix_null_ratio.
- .md por funcion con frontmatter para que fn index los registre.
- Actualiza pyproject.toml y uv.lock con las dependencias resultantes.

Impacto: ampliamente mas cobertura de la API de Metabase desde el registry, reutilizable por apps y analisis. No toca Go ni frontend.
2026-04-13 23:31:42 +02:00

40 lines
1.2 KiB
Python

"""CRUD y operaciones sobre collections de Metabase."""
from .client import MetabaseClient
def metabase_move_collection(
client: MetabaseClient,
collection_id: int,
parent_id: int | None,
) -> dict:
"""Mueve una collection (sub-arbol completo) a otro padre.
Endpoint: PUT /api/collection/:id con {parent_id: ...}.
parent_id=None mueve la collection a la raiz ("Our analytics").
Metabase reubica la collection y todo su sub-arbol (colecciones hijas,
cards, dashboards, documents) atomicamente.
Args:
client: Cliente autenticado.
collection_id: ID de la collection a mover.
parent_id: ID de la collection padre destino. None = raiz.
Returns:
Collection actualizada con el nuevo parent_id y location.
Example:
>>> col = metabase_move_collection(client, 12, parent_id=3)
>>> print(col["location"]) # "/3/"
>>> # Mover a raiz:
>>> col = metabase_move_collection(client, 12, parent_id=None)
>>> print(col["location"]) # "/"
"""
return client.request(
"PUT",
f"/api/collection/{collection_id}",
json={"parent_id": parent_id},
)