rssutil

type RFC822 time.Time

type RSS struct {
	Version string     `xml:"version,attr" json:"version"`
	Channel RSSChannel `xml:"channel"      json:"channel"`
}

type RSSCategories []RSSCategory

type RSSCategory struct {
	Category string `xml:",chardata" json:"category"`

	Domain string `xml:"domain,attr,omitempty" json:"domain,omitempty"`
}

type RSSChannel struct {

	// The name of the channel. It's how people refer to your service. If
	// you have an HTML website that contains the same information as
	// your RSS file, the title of your channel should be the same as the
	// title of your website.
	//
	// Sample:
	//   GoUpstate.com News Headlines
	Title string `xml:"title" json:"title"`

	// The URL to the HTML website corresponding to the channel.
	//
	// Sample:
	//   http://www.goupstate.com/
	Link string `xml:"link" json:"link"`

	// Phrase or sentence describing the channel.
	//
	// Sample:
	//   The latest news from GoUpstate.com, a Spartanburg Herald-Journal Web site.
	Description string `xml:"description" json:"description"`

	// The language the channel is written in. This allows aggregators to
	// group all Italian language sites, for example, on a single page.
	// A list of allowable values for this element, as provided by
	// Netscape, is [here](https://cyber.harvard.edu/rss/languages.html).
	// You may also use [values defined](https://www.w3.org/TR/REC-html40/struct/dirlang.html#langcodes)
	// by the W3C.
	//
	// Sample:
	//   en-us
	Language string `xml:"language,omitempty" json:"language,omitempty"`

	// Copyright notice for content in the channel.
	//
	// Sample:
	//   Copyright 2002, Spartanburg Herald-Journal
	Copyright string `xml:"copyright,omitempty" json:"copyright,omitempty"`

	// Email address for person responsible for editorial content.
	//
	// Sample:
	//   geo@herald.com (George Matesky)
	ManagingEditor string `xml:"managingEditor,omitempty" json:"managing_editor,omitempty"`

	// Email address for person responsible for technical issues relating to channel.
	//
	// Sample:
	//   betty@herald.com (Betty Guernsey)
	WebMaster string `xml:"webMaster,omitempty" json:"webmaster,omitempty"`

	// The publication date for the content in the channel. For example,
	// the New York Times publishes on a daily basis, the publication
	// date flips once every 24 hours. That's when the pubDate of the
	// channel changes. All date-times in RSS conform to the Date and
	// Time Specification of [RFC 822](http://asg.web.cmu.edu/rfc/rfc822.html),
	// with the exception that the year may be expressed with two
	// characters or four characters (four preferred).
	//
	// Sample:
	//   Sat, 07 Sep 2002 00:00:01 GMT
	PubDate *RFC822 `xml:"pubDate,omitempty" json:"pub_date,omitempty"`

	// The last time the content of the channel changed.
	//
	// Sample:
	//   Sat, 07 Sep 2002 09:42:31 GMT
	LastBuildDate *RFC822 `xml:"lastBuildDate,omitempty" json:"last_build_date,omitempty"`

	// Specify one or more categories that the channel belongs to.
	// Follows the same rules as the <item>-level
	// [category](https://cyber.harvard.edu/rss/rss.html#ltcategorygtSubelementOfLtitemgt)
	// element. More [info](https://cyber.harvard.edu/rss/rss.html#syndic8).
	//
	// Sample:
	//   <category>Newspapers</category>
	Categories RSSCategories `xml:"category,omitempty" json:"category,omitempty"`

	// A string indicating the program used to generate the channel.
	//
	// Sample:
	//   MightyInHouse Content System v2.3
	Generator string `xml:"generator,omitempty" json:"generator,omitempty"`

	// A URL that points to the documentation for the format used in the
	// RSS file. It's probably a pointer to this page. It's for people
	// who might stumble across an RSS file on a Web server 25 years from
	// now and wonder what it is.
	//
	// Sample:
	//   http://blogs.law.harvard.edu/tech/rss
	Docs string `xml:"docs,omitempty" json:"docs,omitempty"`

	// Allows processes to register with a cloud to be notified of
	// updates to the channel, implementing a lightweight
	// publish-subscribe protocol for RSS feeds. More info
	// [here](https://cyber.harvard.edu/rss/rss.html#ltcloudgtSubelementOfLtchannelgt).
	//
	// Sample:
	//   <cloud domain="rpc.sys.com" port="80" path="/RPC2" registerProcedure="pingMe" protocol="soap"/>
	Cloud *RSSCloud `xml:"cloud,omitempty" json:"cloud,omitempty"`

	// TTL stands for time to live. It's a number of minutes that
	// indicates how long a channel can be cached before refreshing from
	// the source. More info [here](https://cyber.harvard.edu/rss/rss.html#ltttlgtSubelementOfLtchannelgt).
	//
	// Sample:
	//   <ttl>60</ttl>
	TTL int `xml:"ttl,omitempty" json:"ttl,omitempty"`

	// Specifies a GIF, JPEG or PNG image that can be displayed with the
	// channel.
	// More info [here](https://cyber.harvard.edu/rss/rss.html#ltimagegtSubelementOfLtchannelgt).
	Image *RSSImage `xml:"image,omitempty" json:"image,omitempty"`

	// The [PICS](https://www.w3.org/PICS/) rating for the channel.
	Rating string `xml:"rating,omitempty" json:"rating,omitempty"`

	// Specifies a text input box that can be displayed with the channel.
	// More info [here](https://cyber.harvard.edu/rss/rss.html#lttextinputgtSubelementOfLtchannelgt).
	TextInput *RSSTextInput `xml:"textInput,omitempty" json:"text_input,omitempty"`

	// A hint for aggregators telling them which hours they can skip.
	// More info [here](https://cyber.harvard.edu/rss/skipHoursDays.html#skiphours).
	SkipHours []int `xml:"skipHours>hour,omitempty" json:"skip_hours,omitempty"`

	// A hint for aggregators telling them which days they can skip.
	// More info [here](https://cyber.harvard.edu/rss/skipHoursDays.html#skipdays).
	SkipDays []time.Weekday `xml:"skipDays>day,omitempty" json:"skip_days,omitempty"`

	Items RSSItems `xml:"item,omitempty" json:"items,omitempty"`
}

type RSSCloud struct {
	Domain            string `xml:"domain,attr" json:"domain"`
	Port              int    `xml:"port,attr" json:"port"`
	Path              string `xml:"path,attr" json:"path"`
	RegisterProcedure string `xml:"registerProcedure,attr" json:"register_procedure"`
	Protocol          string `xml:"protocol,attr" json:"protocol"`
}

type RSSEnclosure struct {
	URL    string `xml:"url,attr"    json:"url"`
	Length int    `xml:"length,attr" json:"length"`
	Type   string `xml:"type,attr"   json:"type"`
}

type RSSFeedInitNotifier func(items RSSItems, userData interface{})

type RSSGUID struct {
	GUID        string `xml:",chardata" json:"guid"`
	IsPermaLink bool   `xml:"isPermaLink,attr" json:"is_perma_link"`
}

type RSSImage struct {

	// URL is the URL of a GIF, JPEG or PNG image that represents the
	// Channel.
	URL string `xml:"url" json:"url"`

	// Title describes the image, it's used in the ALT attribute of the
	// HTML <img> tag when the channel is rendered in HTML.
	Title string `xml:"title" json:"title"`

	// Link is the URL of the site, when the channel is rendered, the
	// image is a link to the site. (Note, in practice the image Title
	// and Link should have the same value as the Channel's Title and Link.
	Link string `xml:"link" json:"link"`

	// Width is an optional elements, in numbers, indicating the width of
	// the image in pixels.
	//
	// Maximum value for width is 144, default value is 88.
	Width int `xml:"width,omitempty" json:"width,omitempty"`

	// Height is an optional elements, in numbers, indicating the height
	// of the image in pixels.
	//
	// Maximum value for height is 400, default value is 31.
	Height int `xml:"height,omitempty" json:"height,omitempty"`

	// Description is an optional elements, which contains text that is
	// included in the TITLE attribute of the link formed around the
	// image in the HTML rendering.
	Description string `xml:"description,omitempty" json:"description,omitempty"`
}

type RSSItem struct {
	// The title of the item.
	//
	// Sample:
	//   Venice Film Festival Tries to Quit Sinking
	Title string `xml:"title,omitempty" json:"title,omitempty"`

	// The URL of the item.
	//
	// Sample:
	//   http://nytimes.com/2004/12/07FEST.html
	Link string `xml:"link,omitempty" json:"link,omitempty"`

	// The item synopsis.
	//
	// Sample:
	//   Some of the most heated chatter at the Venice Film Festival this
	//   week was about the way that the arrival of the stars at the
	//   Palazzo del Cinema was being staged.
	Description string `xml:"description,omitempty" json:"description,omitempty"`

	// Email address of the author of the item.
	// [More](https://cyber.harvard.edu/rss/rss.html#ltauthorgtSubelementOfLtitemgt).
	//
	// Sample:
	//   oprah@oxygen.net
	Author string `xml:"author,omitempty" json:"author,omitempty"`

	// Includes the item in one or more categories.
	// [More](https://cyber.harvard.edu/rss/rss.html#ltcategorygtSubelementOfLtitemgt).
	Categories RSSCategories `xml:"category,omitempty" json:"category,omitempty"`

	// URL of a page for comments relating to the item.
	// [More](https://cyber.harvard.edu/rss/rss.html#ltcommentsgtSubelementOfLtitemgt).
	//
	// Sample:
	//   http://www.myblog.org/cgi-local/mt/mt-comments.cgi?entry_id=290
	Comments string `xml:"comments,omitempty" json:"comments,omitempty"`

	// Describes a media object that is attached to the item.
	// [More](https://cyber.harvard.edu/rss/rss.html#ltenclosuregtSubelementOfLtitemgt).
	Enclosure *RSSEnclosure `xml:"enclosure,omitempty" json:"enclosure,omitempty"`

	// A string that uniquely identifies the item.
	// [More](https://cyber.harvard.edu/rss/rss.html#ltguidgtSubelementOfLtitemgt).
	//
	// Sample:
	//   http://inessential.com/2002/09/01.php#a2
	GUID *RSSGUID `xml:"guid,omitempty" json:"guid,omitempty"`

	// Indicates when the item was published.
	// [More](https://cyber.harvard.edu/rss/rss.html#ltpubdategtSubelementOfLtitemgt).
	//
	// Sample:
	//   Sun, 19 May 2002 15:21:36 GMT
	PubDate *RFC822 `xml:"pubDate,omitempty" json:"pub_date,omitempty"`

	// The RSS channel that the item came from.
	// [More](https://cyber.harvard.edu/rss/rss.html#ltsourcegtSubelementOfLtitemgt).
	//
	// Sample:
	//   <source url="http://www.tomalak.org/links2.xml">Tomalak's Realm</source>
	Source *RSSSource `xml:"source,omitempty" json:"source,omitempty"`
}

type RSSItems []RSSItem

type RSSSource struct {
	Source string `xml:",chardata" json:"source"`
	URL    string `xml:"url,attr" json:"url"`
}

type RSSTextInput struct {

	// The label of the Submit button in the text input area.
	Title string `xml:"title" json:"title"`

	// Explains the text input area.
	Description string `xml:"description" json:"description"`

	// The name of the text object in the text input area.
	Name string `xml:"name" json:"name"`

	// The URL of the CGI script that processes text input requests.
	Link string `xml:"link" json:"link"`
}

type RSSUpdateNotifier func(items RSSItems, userData interface{})

type RSSUtil struct {
	FeedInitNotifier RSSFeedInitNotifier
	UpdateNotifier   RSSUpdateNotifier
	// contains filtered or unexported fields
}