orca

A simple reddit API interface for Rust

Features Implemented:

• Comment streams from entire subreddits
• Comment tree traversing
• Oauth script authorization
• Self post submissions
• User info
• Comment data structure
• Listing data structure

Features Todo (nonexhaustive):

• All data structures
• Comment posting
• Oauth installed app type
• Better documentation
• More reddit api implementation

Contributing

If you have ever made a pull request on github before you probably know more about it than me. I would really appreciate any help on this project, so if you have an idea on how to improve it, please feel free to submit an issue or pull request.

Example: Recursively traversing a comment tree

rust fn print_tree(listing: Listing<Comment>, level: i32) { for comment in listing { match comment { Comment::Loaded(data) => { for _ in 0..level { print!("\t"); } println!("Comment by {}", data.author); print_tree(data.replies, level + 1); }, _ => {}, } } } print_tree(tree, 0);

Example: Authorizing as Ouath Script type

rust let mut app = App::new("appnamehere", "v0.0.2", "/u/usernamehere/"); reddit.conn.auth = Some(reddit.authorize(username, password, OauthApp::Script(app_id, app_secret)).unwrap());

Note: I am by no means an experienced programmer, and there are probably extremely obvious mistakes in this code. Thankfully the inherent safety of rust makes this likely a decently stable API, but no guarantees :). This project is probably usable for a simple bot written in rust, but it's still not even close to feature complete.