This repository has been archived by the owner on Jun 27, 2020. It is now read-only.
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Sam Symons
committed
Nov 11, 2013
0 parents
commit c6873bc
Showing
182 changed files
with
22,806 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,19 @@ | ||
*.gem | ||
*.rbc | ||
.bundle | ||
.config | ||
.yardoc | ||
Gemfile.lock | ||
InstalledFiles | ||
_yardoc | ||
coverage | ||
doc/ | ||
lib/bundler/man | ||
pkg | ||
rdoc | ||
spec/reports | ||
test/tmp | ||
test/version_tmp | ||
tmp | ||
tags | ||
.env |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,5 @@ | ||
language: ruby | ||
rvm: | ||
- 1.9.2 | ||
- 1.9.3 | ||
- 2.0.0 |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1 @@ | ||
--no-private |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,18 @@ | ||
source 'https://rubygems.org' | ||
|
||
group :development do | ||
gem 'awesome_print', :require => 'ap' | ||
gem 'guard-rspec' | ||
gem 'guard-yard' | ||
gem 'pry' | ||
gem 'yard' | ||
end | ||
|
||
group :test do | ||
gem 'rspec' | ||
gem 'simplecov', :require => false | ||
gem 'vcr', '~> 2.6.0' | ||
gem 'webmock', '~> 1.12.0' | ||
end | ||
|
||
gemspec |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,11 @@ | ||
guard :rspec do | ||
watch(%r{^spec/.+_spec\.rb$}) | ||
watch(%r{^lib/(.+)\.rb$}) { |m| "spec/lib/#{m[1]}_spec.rb" } | ||
watch('spec/spec_helper.rb') { "spec" } | ||
end | ||
|
||
guard 'yard' do | ||
watch(%r{lib/.+\.rb}) | ||
watch(%r{docs/.+\.md}) | ||
watch(%r{README\.md}) | ||
end |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,22 @@ | ||
Copyright (c) 2013 Sam Symons | ||
|
||
MIT License | ||
|
||
Permission is hereby granted, free of charge, to any person obtaining | ||
a copy of this software and associated documentation files (the | ||
"Software"), to deal in the Software without restriction, including | ||
without limitation the rights to use, copy, modify, merge, publish, | ||
distribute, sublicense, and/or sell copies of the Software, and to | ||
permit persons to whom the Software is furnished to do so, subject to | ||
the following conditions: | ||
|
||
The above copyright notice and this permission notice shall be | ||
included in all copies or substantial portions of the Software. | ||
|
||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, | ||
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF | ||
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND | ||
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE | ||
LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION | ||
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION | ||
WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,147 @@ | ||
# RedditKit.rb | ||
|
||
RedditKit.rb is a [reddit API](http://www.reddit.com/dev/api) wrapper, written in Ruby. | ||
|
||
## Installation | ||
|
||
Add this to your Gemfile: | ||
|
||
gem 'redditkit', '~> 1.0' | ||
|
||
Or install it directly: | ||
|
||
gem install redditkit | ||
|
||
## Getting Started | ||
|
||
RedditKit.rb is structured closely to the wonderful [Octokit.rb](https://github.com/octokit/octokit.rb) and [Twitter](https://github.com/sferik/twitter) gems. If you're familiar with either of those, you'll feel right at home here. You can find the [project's documentation on the RedditKit website](http://redditkit.com/redditkit.rb/). | ||
|
||
RedditKit.rb is used through either the `RedditKit` module, or `RedditKit::Client` objects, like so: | ||
|
||
**Module usage:** | ||
```ruby | ||
RedditKit.sign_in 'username', 'password' | ||
subreddits = RedditKit.subscribed_subreddits | ||
``` | ||
|
||
**Instance method usage:** | ||
```ruby | ||
client = RedditKit::Client.new 'username', 'password' | ||
subreddits = client.subscribed_subreddits | ||
``` | ||
|
||
Using RedditKit.rb at the module level allows you to use a single account without having to keep track of RedditKit::Client instances. Working at the instance method level makes it possible to use multiple accounts at once, with one client object per account. | ||
|
||
> RedditKit.rb doesn't have any built-in rate limiting. reddit's API rules require that you make no more than 30 requests per minute and try to avoid requesting the same page more than once every 30 seconds. You can read up on the API rules [on their wiki page](https://github.com/reddit/reddit/wiki/API). | ||
### Authentication | ||
|
||
```ruby | ||
client = RedditKit::Client.new 'username', 'password' | ||
client.signed_in? # => true | ||
``` | ||
|
||
## More Examples | ||
|
||
**Fetch a user and check their link karma:** | ||
|
||
```ruby | ||
user = RedditKit.user 'samsymons' | ||
puts "#{user.username} has #{user.link_karma} link karma." | ||
``` | ||
|
||
**Subscribe to a subreddit:** | ||
|
||
```ruby | ||
authenticated_client = RedditKit::Client.new 'samsymons', 'password' | ||
authenticated_client.subscribe 'ruby' | ||
``` | ||
|
||
**Upvote the top post in a subreddit:** | ||
|
||
```ruby | ||
posts = authenticated_client.posts 'programming', :category => :top, :time => :all | ||
authenticated_client.upvote posts.first | ||
``` | ||
|
||
**Send private messages:** | ||
|
||
```ruby | ||
authenticated_client.send_message 'How are you?', 'amberlynns', :subject => 'Hi!' | ||
``` | ||
|
||
## Pagination | ||
|
||
Some RedditKit.rb methods accept pagination options and return `RedditKit::PaginatedResponse` objects upon completion. These options allow you to, for example, limit the number of results returned, or fetch results before/after a specific object. | ||
|
||
`RedditKit::PaginatedResponse` forwards its enumeration methods to its `results` array, so you can iterate over it like you would with a standard array. | ||
|
||
``` ruby | ||
paginated_response = RedditKit.front_page | ||
|
||
paginated_response.each do |link| | ||
# Do something with each link. | ||
end | ||
``` | ||
|
||
## Multiple Accounts | ||
|
||
## Configuration | ||
|
||
You can configure various aspects of RedditKit.rb's operation, including its default API endpoint and user agent, by setting attributes on `RedditKit::Client`. | ||
|
||
**You should set your user agent to the name and version of your app, along with your reddit username. That way, if you ever have a buggy version of your app abusing the API, the reddit admins will know who to contact.** | ||
|
||
## Contributing | ||
|
||
### Debugging | ||
|
||
Because RedditKit.rb is built atop Faraday, you can modify its middleware stack to add new behaviour. This is particularly handy for debugging as you can turn on Faraday's response logger. | ||
|
||
```ruby | ||
RedditKit.middleware = Faraday::Builder.new do |builder| | ||
builder.use Faraday::Request::UrlEncoded | ||
builder.use RedditKit::Response::RaiseError | ||
builder.use RedditKit::Response::ParseJSON | ||
builder.use Faraday::Response::Logger | ||
builder.adapter Faraday.default_adapter | ||
end | ||
``` | ||
|
||
### Writing Tests | ||
|
||
Tests assume the presence of a `.env` file at the project's root. This file should contain the following three environment variables: | ||
|
||
* `REDDITKIT_TEST_USERNAME` The username of a reddit account dedicated solely to testing. | ||
* `REDDITKIT_TEST_PASSWORD` The password for the reddit account. | ||
* `REDDITKIT_TEST_SUBREDDIT` A subreddit for which the provided reddit account has admin privileges. This subreddit should be also be dedicated to testing as the test suite will run many different methods on it, creating & deleting various resources. | ||
|
||
## Requirements | ||
|
||
Ruby 1.9.3 and Ruby 2.0.0 are officially supported. | ||
|
||
## Need Help? | ||
|
||
Open an [issue](https://github.com/samsymons/RedditKit.rb/issues), or hit me up on [Twitter](http://twitter.com/sam_symons). | ||
|
||
## License | ||
|
||
Copyright (c) 2013 Sam Symons (http://samsymons.com/) | ||
|
||
Permission is hereby granted, free of charge, to any person obtaining a copy | ||
of this software and associated documentation files (the "Software"), to deal | ||
in the Software without restriction, including without limitation the rights | ||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell | ||
copies of the Software, and to permit persons to whom the Software is | ||
furnished to do so, subject to the following conditions: | ||
|
||
The above copyright notice and this permission notice shall be included in | ||
all copies or substantial portions of the Software. | ||
|
||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR | ||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, | ||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE | ||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER | ||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, | ||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN | ||
THE SOFTWARE. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1 @@ | ||
require "bundler/gem_tasks" |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,26 @@ | ||
require 'redditkit/client' | ||
|
||
# The main RedditKit module. | ||
module RedditKit | ||
class << self | ||
|
||
# A RedditKit::Client, used when calling methods on the RedditKit module itself. | ||
# | ||
# @return [RedditKit::Client] | ||
def client | ||
@client ||= RedditKit::Client.new | ||
end | ||
|
||
def respond_to?(method_name, include_private = false) | ||
client.respond_to?(method_name, include_private) || super | ||
end | ||
|
||
private | ||
|
||
def method_missing(method_name, *args, &block) | ||
return super unless client.respond_to?(method_name) | ||
client.send(method_name, *args, &block) | ||
end | ||
|
||
end | ||
end |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,60 @@ | ||
module RedditKit | ||
|
||
# A base class for RedditKit's model objects, automatically generating attribute and predicate methods. | ||
class Base | ||
|
||
attr_reader :attributes | ||
|
||
class << self | ||
|
||
def attr_reader(*attrs) | ||
attrs.each do |attr| | ||
define_attribute_method(attr) | ||
define_predicate_method(attr) | ||
end | ||
end | ||
|
||
private | ||
|
||
def define_attribute_method(method) | ||
define_method(method) do | ||
memoize(method) do | ||
@attributes[method] | ||
end | ||
end | ||
end | ||
|
||
def define_predicate_method(method) | ||
define_method(:"#{method}?") do | ||
!!@attributes[method] | ||
end | ||
end | ||
|
||
end | ||
|
||
def initialize(attributes = {}) | ||
kind = attributes[:kind] | ||
data = attributes[:data] | ||
|
||
@attributes = data || {} | ||
@attributes[:kind] = kind | ||
end | ||
|
||
def [](method) | ||
send(method.to_sym) | ||
rescue NoMethodError | ||
nil | ||
end | ||
|
||
private | ||
|
||
def memoize(key, &block) | ||
ivar = :"@#{key}" | ||
return instance_variable_get(ivar) if instance_variable_defined?(ivar) | ||
|
||
result = block.call | ||
instance_variable_set(ivar, result) | ||
end | ||
|
||
end | ||
end |
Oops, something went wrong.