Go to file
jim teeuwen 057769eeb5 Rename "examples" folder to "testdata". This causes "go install" to ignore it when building the lib. Example binaries do not get installed in $GOBIN this way. They do not belong there. 2012-03-04 12:52:37 +01:00
testdata Rename "examples" folder to "testdata". This causes "go install" to ignore it when building the lib. Example binaries do not get installed in $GOBIN this way. They do not belong there. 2012-03-04 12:52:37 +01:00
LICENSE Switch to more liberal CC0 Public Domain license. 2011-03-19 14:48:01 +01:00
README No more Makefiles. Use go command to build and install. 2012-02-09 17:31:42 +01:00
atom.go Fix bug introduced in commit 09a1cbe77d 2012-02-29 10:48:17 +01:00
author.go Making package easily usable with goinstall. Including the reference to go-pkg-xmlx and the build target in the makefile. 2011-01-20 22:57:04 +01:00
category.go Making package easily usable with goinstall. Including the reference to go-pkg-xmlx and the build target in the makefile. 2011-01-20 22:57:04 +01:00
channel.go Making package easily usable with goinstall. Including the reference to go-pkg-xmlx and the build target in the makefile. 2011-01-20 22:57:04 +01:00
cloud.go Making package easily usable with goinstall. Including the reference to go-pkg-xmlx and the build target in the makefile. 2011-01-20 22:57:04 +01:00
content.go Making package easily usable with goinstall. Including the reference to go-pkg-xmlx and the build target in the makefile. 2011-01-20 22:57:04 +01:00
enclosure.go Making package easily usable with goinstall. Including the reference to go-pkg-xmlx and the build target in the makefile. 2011-01-20 22:57:04 +01:00
feed.go Add xmlx.CharsetFunc parameter to Feed.Fetch method. Can be used to supply a custom character encoding conversion routine to the xml decoder. Update test code accordingly. 2012-02-29 11:31:01 +01:00
feed_test.go Add xmlx.CharsetFunc parameter to Feed.Fetch method. Can be used to supply a custom character encoding conversion routine to the xml decoder. Update test code accordingly. 2012-02-29 11:31:01 +01:00
generator.go Making package easily usable with goinstall. Including the reference to go-pkg-xmlx and the build target in the makefile. 2011-01-20 22:57:04 +01:00
image.go Making package easily usable with goinstall. Including the reference to go-pkg-xmlx and the build target in the makefile. 2011-01-20 22:57:04 +01:00
input.go Making package easily usable with goinstall. Including the reference to go-pkg-xmlx and the build target in the makefile. 2011-01-20 22:57:04 +01:00
item.go Making package easily usable with goinstall. Including the reference to go-pkg-xmlx and the build target in the makefile. 2011-01-20 22:57:04 +01:00
link.go Making package easily usable with goinstall. Including the reference to go-pkg-xmlx and the build target in the makefile. 2011-01-20 22:57:04 +01:00
rss.go gofix error 2011-11-02 16:51:04 +01:00
source.go Making package easily usable with goinstall. Including the reference to go-pkg-xmlx and the build target in the makefile. 2011-01-20 22:57:04 +01:00
subtitle.go Making package easily usable with goinstall. Including the reference to go-pkg-xmlx and the build target in the makefile. 2011-01-20 22:57:04 +01:00

README

================================================================================
 RSS
================================================================================

This package allows us to fetch Rss and Atom feeds from the internet.
They are parsed into an object tree which is a hybrid of both the RSS and Atom
standards.

Supported feeds are:
- Rss v0.91, 0.92 and 2.0
- Atom 1.0

The package allows us to maintain cache timeout management. This prevents us
from querying the servers for feed updates too often and risk ip bans. Apart 
from setting a cache timeout manually, the package also optionally adheres to
the TTL, SkipDays and SkipHours values specied in the feeds themselves.

Note that the TTL, SkipDays and SkipHour fields are only part of the RSS spec.
For Atom feeds, we use the CacheTimeout in the Feed struct.

Because the object structure is a hybrid between both RSS and Atom specs, not
all fields will be filled when requesting either an RSS or Atom feed. I have
tried to create as many shared fields as possible but some of them simply do
not occur in either the RSS or Atom spec.

The Feed object supports notifications of new channels and items.
This is achieved by passing 2 function handlers to the feeder.New() function.
They will be called whenever a feed is updated from the remote source and
either a new channel or a new item is found that previously did not exist.
This allows you to easily monitor a feed for changes. See src/feed_test.go for
an example of how this works.

================================================================================
 DEPENDENCIES
================================================================================

 github.com/jteeuwen/go-pkg-xmlx

================================================================================
 USAGE
================================================================================

 An idiomatic example program can be found in example.go.