vCard Parser

Parses and validates vCard data according to RFC 6350 specification.

Installation

Add the library to the dependencies section of your cargo.toml file.

[dependencies]
vcard_parser = "0.1.0"

Usage

Rust documentation here.

Parsing vCards

Reading a vcf file, updating the vCard object, and writing back to the file.

use std::fs;
use std::fs::read_to_string;
use vcard_parser::parse_to_vcards;
use vcard_parser::vcard::property::types::PropertyType;

fn main () {
    if let Ok(string) = read_to_string("contacts.vcf") {
        let mut vcards = parse_to_vcards(string.as_str()).unwrap();

        let mut vcard = vcards.first().unwrap().clone();
        let property = vcard.get_property_by_type(&PropertyType::Fn).unwrap();

        vcard.update_property(property.get_uuid(), "FN:John Doe").expect("Unable to update property.");
        vcards[0] = vcard;

        let mut data = String::new();
        for vcard in vcards {
            data.push_str(vcard.to_string().as_str())
        }
        fs::write("contacts.vcf", data).expect("Unable to write file.");
    }
}

Parsing a single vCard

use vcard_parser::vcard::Vcard;

fn main () {
    let mut vcard = Vcard::try_from("VERSION:4.0\nFN:John Doe\n").unwrap();
    vcard.add_property("NICKNAME:Johnny").unwrap();
    println!("{}", vcard.to_string());
}

Creating a new vCard