Struct opml::OPML[−][src]

pub struct OPML {
    pub version: String,
    pub head: Option<Head>,
    pub body: Body,
}

Expand description

The top-level OPML element.

Fields

version: String

The version attribute from the element, valid values are 1.0, 1.1 and 2.0.

head: Option<Head>

The Head child element. Contains the metadata of the OPML document.

body: Body

The Body child element. Contains all the Outline elements.

Implementations

[src]

impl OPML

[src]

pub fn new(xml: &str) -> Result<Self, Error>

👎 Deprecated since 1.1.0:

Use from_str instead

Deprecated, use OPML::from_str instead.

[src]

pub fn from_str(xml: &str) -> Result<Self, Error>

Parses an OPML document.

Example

use opml::{OPML, Outline};

let xml = r#"<opml version="2.0"><head/><body><outline text="Outline"/></body></opml>"#;
let document = OPML::from_str(xml).unwrap();

let mut expected = OPML::default();
expected.body.outlines.push(Outline {
  text: "Outline".to_string(),
  ..Outline::default()
});

assert_eq!(document, expected);

[src]

pub fn from_reader<R>(reader: &mut R) -> Result<Self, Error> where
R: Read,

Parses an OPML document from a reader.

Example

use opml::OPML;
use std::fs::File;

let mut file = File::open("file.opml").unwrap();
let document = OPML::from_reader(&mut file).unwrap();

[src]

pub fn add_feed(&mut self, text: &str, url: &str) -> &mut Self

Helper function to add an Outline element with text and xml_url attributes to the Body. Useful for creating feed lists quickly. This function also exists as Outline::add_feed for grouped lists.

Example

use opml::{OPML, Outline};

let mut opml = OPML::default();
opml.add_feed("Feed Name", "https://example.com/");
let added_feed = opml.body.outlines.first().unwrap();

let expected_feed = &Outline {
  text: "Feed Name".to_string(),
  xml_url: Some("https://example.com/".to_string()),
  ..Outline::default()
};

assert_eq!(added_feed, expected_feed);

[src]

pub fn to_xml(&self) -> Result<String, Error>

👎 Deprecated since 1.1.0:

Use to_string instead

Deprecated, use OPML::to_string instead.

[src]

pub fn to_string(&self) -> Result<String, Error>

Converts the struct to an XML document.

Example

use opml::OPML;

let opml = OPML::default();
let xml = opml.to_string().unwrap();

let expected = r#"<opml version="2.0"><head/><body/></opml>"#;
assert_eq!(xml, expected);

[src]

pub fn to_writer<W>(&self, writer: &mut W) -> Result<(), Error> where
W: Write,

Converts the struct to an XML document and writes it using the writer.

Example

use opml::OPML;
use std::fs::File;

let opml = OPML::default();
let mut file = File::create("file.opml").unwrap();
let xml = opml.to_writer(&mut file).unwrap();