# vparser
[Source](https://git.sr.ht/~whynothugo/vparser)
| [Issues](https://todo.sr.ht/~whynothugo/pimsync)
| [Patches](https://lists.sr.ht/~whynothugo/vdirsyncer-devel)
| [Chat](irc://ircs.libera.chat:6697/#pimutils)
A low-level icalendar and vcard parser.
- Gracefully handle invalid or malformed data.
- Handles large amount of data without unnecessary copies.
- Does not interpret the internal data in calendar components or contact data
inside of vcards.
This library is likely too low level calendar applications or other consumers
that need to interpret calendar data itself. It is suitable for tools that
operate on icalendar components in an opaque manner. E.g.: normalisation,
merging components, synchronisation, etc.
## Requirements
`vparser` requires Rust and Cargo to built. It has no additional build or
runtime dependencies. It is technically usable in a `no_std` environment,
although that is unlikely to be of much use.
## Documentation
The API documentation [is available online at docs.rs][docs]. It can also be
rendered locally using `cargo doc`.
[docs]: https://docs.rs/vparser/
For additional design notes, see [this article written during its
development][article]
[article]: https://whynothugo.nl/journal/2023/11/27/vdirsyncer-status-update-november-2023/
## Thanks
Special thanks to the [NLnet foundation][nlnet] and the [NGI Zero Entrust
program][ngi0] of the European Commission, which helped secure funding for the
work on [pimsync] and related projects such a this one.
[nlnet]: https://nlnet.nl/project/vdirsyncer/
[ngi0]: https://www.ngi.eu/ngi-projects/ngi-zero-entrust/
[pimsync]: https://git.sr.ht/~whynothugo/pimsync
## Licence
This project is licensed under the ISC licence. See LICENCE for details.