fn_registry/python/functions/infra/caldav_put_event.md

name, kind, lang, domain, version, purity, signature, description, tags, uses_functions, uses_types, returns, returns_optional, error_type, imports, params, output, tested, tests, test_file_path, file_path

name	kind	lang	domain	version	purity	signature	description	tags	uses_functions	uses_types	returns	returns_optional	error_type	imports	params	output	tested	tests	test_file_path	file_path
caldav_put_event	function	py	infra	1.0.0	impure	def caldav_put_event(base_url: str, username: str, password: str, collection_path: str, uid: str, vcalendar_text: str, *, timeout_s: float = 20.0, verify_tls: bool = True) -> dict	Sube (HTTP PUT) un VCALENDAR (con un VEVENT) a una coleccion CalDAV con HTTP Basic auth. Construye el header Authorization: Basic base64(user:pass) a mano con stdlib. El nombre del recurso se deriva del UID saneado (safe(uid)+'.ics'). verify_tls=True por defecto. Idempotente por UID: re-subir el mismo UID sobrescribe el recurso. Maneja errores sin lanzar (HTTPError/URLError -> {status:'error'}). Solo stdlib (urllib, base64, re, ssl). Probado contra Xandikos.	dav caldav ical ics vevent http put calendar infra upload				false	error_go_core	base64 re ssl urllib.error urllib.request	name desc base_url URL base del servidor DAV (p.ej. 'https://dav-eedeb681c4ab89ab8e444ac9.organic-machine.com'). name desc username usuario para HTTP Basic auth (p.ej. 'enmanuel'). name desc password contrasena para HTTP Basic auth. Resolver desde pass con pass_get_secret, nunca hardcodear. name desc collection_path ruta de la coleccion CalDAV (p.ej. '/enmanuel/calendars/calendar/'). name desc uid UID del evento; se sanea ([^A-Za-z0-9_.-]->_ , max 120 chars) para formar el nombre del recurso .ics. name desc vcalendar_text texto completo del VCALENDAR (BEGIN:VCALENDAR..END:VCALENDAR) con un VEVENT. Se asegura terminacion en CRLF. name desc timeout_s timeout de la peticion HTTP en segundos. Default 20.0. name desc verify_tls si True (default) verifica el certificado TLS. No desactivar salvo entorno de prueba.	dict. En exito: {status:'ok', http_status:int, url:str}. En error (sin lanzar): {status:'error', error:str, http_status:int|None}. http_status es el codigo HTTP devuelto (201 created / 204 no content tipico en CalDAV).	true	test_construye_request_put_con_headers_correctos test_url_se_forma_con_uid_saneado test_content_type_es_text_calendar test_extension_es_ics test_httperror_devuelve_status_error	python/functions/infra/caldav_put_event_test.py	python/functions/infra/caldav_put_event.py

Ejemplo

import sys
sys.path.insert(0, "python/functions")
from infra.pass_get_secret import pass_get_secret
from infra.caldav_put_event import caldav_put_event

pw = pass_get_secret("dav/xandikos-enmanuel")["value"]  # NO logear

cal = (
    "BEGIN:VCALENDAR\r\nVERSION:2.0\r\nPRODID:-//x//EN\r\nCALSCALE:GREGORIAN\r\n"
    "BEGIN:VEVENT\r\nUID:evt-1@google.com\r\nSUMMARY:Reunion\r\n"
    "DTSTART:20260101T100000Z\r\nDTEND:20260101T110000Z\r\nEND:VEVENT\r\n"
    "END:VCALENDAR\r\n"
)
res = caldav_put_event(
    base_url="https://dav-eedeb681c4ab89ab8e444ac9.organic-machine.com",
    username="enmanuel",
    password=pw,
    collection_path="/enmanuel/calendars/calendar/",
    uid="evt-1@google.com",
    vcalendar_text=cal,
)
print(res)  # {"status": "ok", "http_status": 201, "url": ".../evt-1_google.com.ics"}

Cuando usarla

Cuando quieres subir un evento individual a Xandikos (u otro servidor CalDAV) por HTTP. Es la primitiva de escritura de calendario del grupo dav; el pipeline import_ics_to_caldav la invoca por cada VCALENDAR producido por split_vevents_to_vcalendars. Antes de llamarla, resuelve el UID con extract_or_make_uid y la password con pass_get_secret.

Gotchas

• Escritura remota real: re-subir el mismo UID SOBRESCRIBE el recurso (idempotente, no duplica).
• El VCALENDAR debe ser completo y autonomo (header + VTIMEZONE necesarias + un VEVENT). Subir un VEVENT suelto sin envolver en VCALENDAR fallara.
• Contrasena en header Basic sobre TLS; nunca hardcodear, leer de pass. No se logea.
• verify_tls=False solo en pruebas; abre MITM.
• Devuelve dict (status/http_status/error), NO un int crudo: captura errores HTTP/red sin lanzar.