fn_registry/python/functions/infra/split_vcards.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
split_vcards	function	py	infra	1.0.0	pure	def split_vcards(vcf_text: str) -> list	Divide el texto completo de un archivo .vcf en sus VCARDs individuales. Devuelve una lista de strings, cada uno un VCARD completo (BEGIN:VCARD..END:VCARD) stripeado. Pura, solo stdlib (re). Util para importar a CardDAV un .vcf exportado de Google Contacts que concatena N tarjetas en un solo archivo: cada string resultante se sube como recurso .vcf independiente.	dav carddav vcard vcf contacts infra split				false		re	name desc vcf_text contenido completo del archivo .vcf, con una o varias tarjetas VCARD concatenadas. Tolera saltos de linea LF o CRLF.	list[str]. Cada elemento es un VCARD completo ('BEGIN:VCARD'..'END:VCARD') stripeado de espacios al inicio/fin. Lista vacia si el input es vacio o no contiene ninguna tarjeta.	true	test_dos_vcards_devuelve_dos test_vcard_unico test_input_vacio_devuelve_lista_vacia test_crlf_se_tolera test_cada_card_es_begin_end	python/functions/infra/split_vcards_test.py	python/functions/infra/split_vcards.py

Ejemplo

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

vcf = (
    "BEGIN:VCARD\r\nVERSION:3.0\r\nFN:Ada Lovelace\r\nEND:VCARD\r\n"
    "BEGIN:VCARD\r\nVERSION:3.0\r\nFN:Alan Turing\r\nEND:VCARD\r\n"
)
cards = split_vcards(vcf)
print(len(cards))            # 2
print(cards[0][:13])         # BEGIN:VCARD

Cuando usarla

Cuando exportas contactos de Google (o cualquier fuente) a un unico .vcf con muchas tarjetas concatenadas y necesitas subir cada una como recurso CardDAV separado. Es el primer paso del pipeline import_vcf_to_carddav: split → extraer UID por tarjeta → carddav_put_vcard. Tambien para contar/validar un .vcf sin parsear cada campo.

Gotchas

Funcion pura sin gotchas relevantes. No valida el contenido interno del VCARD (no comprueba VERSION ni campos obligatorios); solo segmenta por BEGIN:VCARD..END:VCARD. Si una tarjeta esta truncada (sin END:VCARD) no aparece en la salida.