Crate rfc822_like

A library for handling RFC822-like format used in Debian

This crate implements the file format inpired by RFC822 that is used in Debian packages. It is the format of the debian/control files in packages and Packages file of apt. It is called rfc822-like instead of just rfc822 because Debian does not claim to implement RFC822 exactly and this crate is focused on working with Debian tools, not parsing exact RFC822 file format. Frankly, I didn’t even bother to read RFC822 itself.

If you need to strictly parse RFC822, I suggest you to fork this crate and fix whatever differences there are. I’m not interested in maintaining strict RFC822 crate, so don’t send PRs for that but I’m willing to put common pieces into their own crate. If you’re interested in this approach feel free to file a PR (or ask beforehand if you have questions).

Note that this crate is currently not optimized for performance. There are multiple places where allocation could be avoided and other optimizations may be missing. It’s absolutely fine for my own use cases, and probably will be for yours as well. If you need it to be faster or just want to have fun improving its performance I’ll be happy to accept PRs.

The API is currently not set in stone and may change over time. Basic steps to minimize the impact of changes were taken (e.g. encapsulation of Error type). The crate also currently lacks serialization but it will be implemented eventually. Feel free to send PRs!

Check Deserializer type for deserialization API reference and examples. Check Serializer type for serialization API reference and examples.

Re-exports

pub use de::Deserializer;

pub use ser::Serializer;

Modules

de

Deserialization of RFC822-like format

ser

Serialization of RFC822-like format

Functions

from_bytes

Deserializes a value from bytes that are not guaranteed to be UTF-8.

from_file

Reads the file and deserializes the value from it.

from_reader

Deserialize a value from a reader.

from_str

Deserializes a value from a string.

to_fmt_writer

Writes the value to std::fmt::Writer.

to_string

Serializes the value into memory.

to_writer

Writes the value to std::io::Writer.