47 releases (16 stable)

1.7.0 Jun 30, 2024
1.6.1 Mar 23, 2024
1.6.0 Nov 4, 2023
1.5.0 Jul 9, 2023
0.0.10 Nov 6, 2015

#28 in Parser implementations

Download history 115593/week @ 2024-10-30 124388/week @ 2024-11-06 134006/week @ 2024-11-13 117043/week @ 2024-11-20 119519/week @ 2024-11-27 133693/week @ 2024-12-04 131616/week @ 2024-12-11 104280/week @ 2024-12-18 84028/week @ 2024-12-25 98900/week @ 2025-01-01 121120/week @ 2025-01-08 124360/week @ 2025-01-15 130197/week @ 2025-01-22 139424/week @ 2025-01-29 153278/week @ 2025-02-05 112945/week @ 2025-02-12

555,374 downloads per month
Used in 670 crates (107 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
~61K SLoC