Struct atom_syndication::Feed

pub struct Feed { /* fields omitted */ }

Represents an Atom feed

Methods

impl Feed

fn read_from<B: BufRead>(reader: B) -> Result<Feed, Error>

Attempt to read an Atom feed from the reader.

Examples

use std::io::BufReader;
use std::fs::File;
use atom_syndication::Feed;

let file = File::open("example.xml").unwrap();
let feed = Feed::read_from(BufReader::new(file)).unwrap();

fn write_to<W: Write>(&self, writer: W) -> Result<W, Error>

Attempt to write this Atom feed to a writer.

Examples

use std::io::BufReader;
use std::fs::File;
use atom_syndication::Feed;

let file = File::open("example.xml").unwrap();
let feed = Feed::read_from(BufReader::new(file)).unwrap();
let out = File::create("out.xml").unwrap();
feed.write_to(out).unwrap();

fn title(&self) -> &str

Return the title of this feed.

Examples

use atom_syndication::Feed;

let mut feed = Feed::default();
feed.set_title("Feed Title");
assert_eq!(feed.title(), "Feed Title");

fn set_title<V>(&mut self, title: V) where
    V: Into<String>, 

Set the title of this feed.

Examples

use atom_syndication::Feed;

let mut feed = Feed::default();
feed.set_title("Feed Title");

fn id(&self) -> &str

Return the unique URI of this feed.

Examples

use atom_syndication::Feed;

let mut feed = Feed::default();
feed.set_id("urn:uuid:60a76c80-d399-11d9-b91C-0003939e0af6");
assert_eq!(feed.id(), "urn:uuid:60a76c80-d399-11d9-b91C-0003939e0af6");

fn set_id<V>(&mut self, id: V) where
    V: Into<String>, 

Set the unique URI of this feed.

Examples

use atom_syndication::Feed;

let mut feed = Feed::default();
feed.set_id("urn:uuid:60a76c80-d399-11d9-b91C-0003939e0af6");

fn updated(&self) -> &str

Return the last time that this feed was modified.

Examples

use atom_syndication::Feed;

let mut feed = Feed::default();
feed.set_updated("2017-06-03T15:15:44-05:00");
assert_eq!(feed.updated(), "2017-06-03T15:15:44-05:00");

fn set_updated<V>(&mut self, updated: V) where
    V: Into<String>, 

Set the last time that this feed was modified.

Examples

use atom_syndication::Feed;

let mut feed = Feed::default();
feed.set_updated("2017-06-03T15:15:44-05:00");

fn authors(&self) -> &[Person]

Return the authors of this feed.

Examples

use atom_syndication::{Feed, Person};

let mut feed = Feed::default();
feed.set_authors(vec![Person::default()]);
assert_eq!(feed.authors().len(), 1);

fn set_authors<V>(&mut self, authors: V) where
    V: Into<Vec<Person>>, 

Set the authors of this feed.

Examples

use atom_syndication::{Feed, Person};

let mut feed = Feed::default();
feed.set_authors(vec![Person::default()]);

fn categories(&self) -> &[Category]

Return the categories this feed belongs to.

Examples

use atom_syndication::{Feed, Category};

let mut feed = Feed::default();
feed.set_categories(vec![Category::default()]);
assert_eq!(feed.categories().len(), 1);

fn set_categories<V>(&mut self, categories: V) where
    V: Into<Vec<Category>>, 

Set the categories this feed belongs to.

Examples

use atom_syndication::{Feed, Category};

let mut feed = Feed::default();
feed.set_categories(vec![Category::default()]);

fn contributors(&self) -> &[Person]

Return the contributors to this feed.

Examples

use atom_syndication::{Feed, Person};

let mut feed = Feed::default();
feed.set_contributors(vec![Person::default()]);
assert_eq!(feed.contributors().len(), 1);

fn set_contributors<V>(&mut self, contributors: V) where
    V: Into<Vec<Person>>, 

Set the contributors to this feed.

Examples

use atom_syndication::{Feed, Person};

let mut feed = Feed::default();
feed.set_contributors(vec![Person::default()]);

fn generator(&self) -> Option<&Generator>

Return the name of the software used to generate this feed.

Examples

use atom_syndication::{Feed, Generator};

let mut feed = Feed::default();
feed.set_generator(Generator::default());
assert!(feed.generator().is_some());

fn set_generator<V>(&mut self, generator: V) where
    V: Into<Option<Generator>>, 

Set the name of the software used to generate this feed.

Examples

use atom_syndication::{Feed, Generator};

let mut feed = Feed::default();
feed.set_generator(Generator::default());

fn icon(&self) -> Option<&str>

Return the icon for this feed.

Examples

use atom_syndication::Feed;

let mut feed = Feed::default();
feed.set_icon("http://example.com/icon.png".to_string());
assert_eq!(feed.icon(), Some("http://example.com/icon.png"));

fn set_icon<V>(&mut self, icon: V) where
    V: Into<Option<String>>, 

Set the icon for this feed.

Examples

use atom_syndication::Feed;

let mut feed = Feed::default();
feed.set_icon("http://example.com/icon.png".to_string());

fn links(&self) -> &[Link]

Return the Web pages related to this feed.

Examples

use atom_syndication::{Feed, Link};

let mut feed = Feed::default();
feed.set_links(vec![Link::default()]);
assert_eq!(feed.links().len(), 1);

fn set_links<V>(&mut self, links: V) where
    V: Into<Vec<Link>>, 

Set the Web pages related to this feed.

Examples

use atom_syndication::{Feed, Link};

let mut feed = Feed::default();
feed.set_links(vec![Link::default()]);

fn logo(&self) -> Option<&str>

Return the logo for this feed.

Examples

use atom_syndication::Feed;

let mut feed = Feed::default();
feed.set_logo("http://example.com/logo.png".to_string());
assert_eq!(feed.logo(), Some("http://example.com/logo.png"));

fn set_logo<V>(&mut self, logo: V) where
    V: Into<Option<String>>, 

Set the logo for this feed.

Examples

use atom_syndication::Feed;

let mut feed = Feed::default();
feed.set_logo("http://example.com/logo.png".to_string());

fn rights(&self) -> Option<&str>

Return the information about the rights held in and over this feed.

Examples

use atom_syndication::Feed;

let mut feed = Feed::default();
feed.set_rights("© 2017 John Doe".to_string());
assert_eq!(feed.rights(), Some("© 2017 John Doe"));

fn set_rights<V>(&mut self, rights: V) where
    V: Into<Option<String>>, 

Set the information about the rights held in and over this feed.

Examples

use atom_syndication::Feed;

let mut feed = Feed::default();
feed.set_rights("© 2017 John Doe".to_string());

fn subtitle(&self) -> Option<&str>

Return the description or subtitle of this feed.

Examples

use atom_syndication::Feed;

let mut feed = Feed::default();
feed.set_subtitle("Feed subtitle".to_string());
assert_eq!(feed.subtitle(), Some("Feed subtitle"));

fn set_subtitle<V>(&mut self, subtitle: V) where
    V: Into<Option<String>>, 

Set the description or subtitle of this feed.

Examples

use atom_syndication::Feed;

let mut feed = Feed::default();
feed.set_subtitle("Feed subtitle".to_string());

fn entries(&self) -> &[Entry]

Return the entries in this feed.

Examples

use atom_syndication::{Feed, Entry};

let mut feed = Feed::default();
feed.set_entries(vec![Entry::default()]);
assert_eq!(feed.entries().len(), 1);

fn set_entries<V>(&mut self, entries: V) where
    V: Into<Vec<Entry>>, 

Set the entries in this feed.

Examples

use atom_syndication::{Feed, Entry};

let mut feed = Feed::default();
feed.set_entries(vec![Entry::default()]);

fn extensions(&self) -> &ExtensionMap

Return the extensions for this feed.

Examples

use std::collections::HashMap;
use atom_syndication::Feed;
use atom_syndication::extension::{ExtensionMap, Extension};

let extension = Extension::default();

let mut item_map = HashMap::<String, Vec<Extension>>::new();
item_map.insert("ext:name".to_string(), vec![extension]);

let mut extension_map = ExtensionMap::default();
extension_map.insert("ext".to_string(), item_map);

let mut feed = Feed::default();
feed.set_extensions(extension_map);
assert_eq!(feed.extensions()
               .get("ext")
               .and_then(|m| m.get("ext:name"))
               .map(|v| v.len()),
           Some(1));

fn set_extensions<V>(&mut self, extensions: V) where
    V: Into<ExtensionMap>, 

Set the extensions for this feed.

Examples

use atom_syndication::Feed;
use atom_syndication::extension::ExtensionMap;

let mut feed = Feed::default();
feed.set_extensions(ExtensionMap::default());

fn namespaces(&self) -> &HashMap<String, String>

Return the namespaces for this feed.

Examples

use std::collections::HashMap;
use atom_syndication::Feed;

let mut namespaces = HashMap::new();
namespaces.insert("ext".to_string(), "http://example.com".to_string());

let mut feed = Feed::default();
feed.set_namespaces(namespaces);
assert_eq!(feed.namespaces().get("ext").map(|s| s.as_str()), Some("http://example.com"));

fn set_namespaces<V>(&mut self, namespaces: V) where
    V: Into<HashMap<String, String>>, 

Set the namespaces for this feed.

Examples

use std::collections::HashMap;
use atom_syndication::Feed;

let mut feed = Feed::default();
feed.set_namespaces(HashMap::new());

Trait Implementations

impl Debug for Feed

fn fmt(&self, __arg_0: &mut Formatter) -> Result

Formats the value using the given formatter.

impl Default for Feed

fn default() -> Feed

Returns the "default value" for a type.

impl Clone for Feed

fn clone(&self) -> Feed

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl PartialEq for Feed

fn eq(&self, __arg_0: &Feed) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, __arg_0: &Feed) -> bool

This method tests for !=.

impl FromStr for Feed

type Err = Error

The associated error which can be returned from parsing.

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

Parses a string s to return a value of this type.

impl ToString for Feed

fn to_string(&self) -> String

Converts the given value to a String.