orca 0.0.2

A Reddit API client for Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50

# 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.