go get github.com/turnage/graw
graw is a library for building Reddit bots that takes care of everything you don't want to. Read the tutorial book!
As of major version 1, the API promise is: no breaking changes, ever. Details below. This applies to all (library) subpackages of graw.
The design of graw is that your bot is a handler for events, Reddit is a source of events, and graw connects the two. If you want to announce all the new posts in a given subreddit, this is your bot:
type announcer struct {}
func (a *announcer) Post(post *reddit.Post) error {
fmt.Printf("%s posted \"%s\"\n", post.Author, post.Title)
return nil
}
Give this to graw with an api handle from the reddit package and a tell it what events you want to subscribe to; graw will take care of the rest. See the godoc and tutorial book for more information.
The primary feature of graw is robust event streams. graw supports many exciting event streams:
Processing all of these events is as as simple as implementing a method to receive them!
graw also provides two lower level packages for developers to tackle other interactions with Reddit like one-shot scripts and bot actions. See subdirectories in the godoc.
As of version 1.0.0, the graw API is stable. I will not make any backwards incompatible changes, ever. The only exceptions are:
I don't foresee anyone having a reason to do either of these things.