48 releases (17 stable)

1.7.1 Mar 24, 2025
1.7.0 Jun 30, 2024
1.6.1 Mar 23, 2024
1.6.0 Nov 4, 2023
0.0.10 Nov 6, 2015

#28 in Parser implementations

Download history 90617/week @ 2024-12-27 115105/week @ 2025-01-03 128214/week @ 2025-01-10 122955/week @ 2025-01-17 130304/week @ 2025-01-24 143576/week @ 2025-01-31 153426/week @ 2025-02-07 130449/week @ 2025-02-14 145702/week @ 2025-02-21 140510/week @ 2025-02-28 141813/week @ 2025-03-07 161024/week @ 2025-03-14 162027/week @ 2025-03-21 164545/week @ 2025-03-28 162561/week @ 2025-04-04 132221/week @ 2025-04-11

654,309 downloads per month
Used in 715 crates (115 directly)

MIT license

250KB
6K SLoC

Plist

A rusty plist parser.

Many features from previous versions are now hidden behind the enable_unstable_features_that_may_break_with_minor_version_bumps feature. These will break in minor version releases after the 1.0 release. If you really really must use them you should specify a tilde requirement e.g. plist = "~1.0.3" in you Cargo.toml so that the plist crate is not automatically updated to version 1.1.

Documentation


lib.rs:

Plist

A rusty plist parser.

Usage

Put this in your Cargo.toml:

[dependencies]
plist = "1"

And put this in your crate root:

extern crate plist;

Examples

Using serde

extern crate plist;
#[macro_use]
extern crate serde_derive;

#[derive(Deserialize)]
#[serde(rename_all = "PascalCase")]
struct Book {
    title: String,
    author: String,
    excerpt: String,
    copies_sold: u64,
}

let book: Book = plist::from_file("tests/data/book.plist")
    .expect("failed to read book.plist");

assert_eq!(book.title, "Great Expectations");
#

Using Value

use plist::Value;

let book = Value::from_file("tests/data/book.plist")
    .expect("failed to read book.plist");

let title = book
    .as_dictionary()
    .and_then(|dict| dict.get("Title"))
    .and_then(|title| title.as_string());

assert_eq!(title, Some("Great Expectations"));

Unstable Features

Many features from previous versions are now hidden behind the enable_unstable_features_that_may_break_with_minor_version_bumps feature. These will break in minor version releases after the 1.0 release. If you really really must use them you should specify a tilde requirement e.g. plist = "~1.0.3" in you Cargo.toml so that the plist crate is not automatically updated to version 1.1.

Dependencies

~3.5MB
~62K SLoC