summaryrefslogtreecommitdiffstats
path: root/README.md
blob: 1c3897a6f6163c4eec0e94d5954674ce42f30c18 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
# VObject parser and generator for Rust

[![Build Status](https://travis-ci.org/untitaker/rust-vobject.svg?branch=master)](https://travis-ci.org/untitaker/rust-vobject)

This is a parser and generator for the
[vCard](https://tools.ietf.org/html/rfc6350) and
[iCalendar](https://tools.ietf.org/html/rfc5545) formats.

- It doesn't follow all relevant RFCs, and some fundamental things such as
  property encodings are missing.
- The API is still quite unstable and the implementation inefficient. This is
  an experiment by me to learn Rust.

Nevertheless, I use it for [a simple addressbook
script](https://github.com/untitaker/mates.rs), and you're encouraged to test
it and give feedback in the issue tracker.

Sourcecode is available on [GitHub](https://github.com/untitaker/rust-vobject).
The API documentation is [online
available](http://rust-vobject.unterwaditzer.net), or you can build it
yourself:

    make docs

The testsuite can be run with:

    make test


It is licensed under MIT, see `LICENSE`.