reddit_api 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 534315886359d1f8cd0b3ff3f5c10491e6bfa054
+  data.tar.gz: 4127d3e358af94f0ffbb9efca924e4130142d7b8
+SHA512:
+  metadata.gz: cf17e29d9e1f191ad92b10d69fd3fd84b4fc359052a4aaf4166fc250ec8bb6b980010f058a18d461a896c3848fb68166fb285b312c9896da848e2da469fb0c5c
+  data.tar.gz: 86dec1f544fb1b4bbbba71283f224867210ea2ff31e530095cea8f5f33a840bba166b8ffeff8fd0996c51870c3b683044629d8f624efd2305e6a1faf9053d07a

data/.gitignore

@@ -0,0 +1,15 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# Ignore application configuration
+.env
+
+# Ignore todo
+todo.txt

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format d

data/.travis.yml

@@ -0,0 +1,5 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.3.1
+before_install: gem install bundler -v 1.13.5

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in reddit_api.gemspec
+gemspec

data/Guardfile

@@ -0,0 +1,19 @@
+
+guard :rspec, cmd: "bundle exec rspec" do
+  require "guard/rspec/dsl"
+  dsl = Guard::RSpec::Dsl.new(self)
+
+  # RSpec files
+  rspec = dsl.rspec
+  watch(rspec.spec_helper) { rspec.spec_dir }
+  watch(rspec.spec_support) { rspec.spec_dir }
+  watch(rspec.spec_files)
+
+  # Ruby files
+  ruby = dsl.ruby
+  watch(%r{^lib/reddit_api/(.+)\.rb$}) do |m|
+    "spec/#{m[1]}_spec.rb"
+  end
+  dsl.watch_spec_files_for(ruby.lib_files)
+
+end

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 Anthony Fuentes
+
+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.

data/README.md

@@ -0,0 +1,40 @@
+# RedditApi
+
+Communicate with the Reddit API painlessly.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'reddit_api'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install reddit_api
+
+## Usage
+
+1. Get Reddit API credentials by following the guide
+   [here](https://www.reddit.com/prefs/apps)
+2. Load Reddit API credentials into the environment
+  * Expected names can be found in RedditApi::Client
+3. Create instances of the RedditApi sub-api objects and make requests
+
+## Resources
+
+* [Reddit API Documentation](https://www.reddit.com/dev/api/)
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/anthonyfuentes/reddit_api.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList['test/**/*_test.rb']
+end
+
+task :default => :test

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "reddit_api"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/example_responses/comments.rb

@@ -0,0 +1,46 @@
+# Received 2-15-2017
+
+[{
+  "kind"=>"t1",
+  "data"=>{
+    "subreddit_id"=>"t5_2r0ij",
+    "edited"=>false,
+    "banned_by"=>nil,
+    "removal_reason"=>nil,
+    "link_id"=>"t3_5q4qmg",
+    "link_author"=>"spez",
+    "likes"=>nil,
+    "replies"=>"",
+    "user_reports"=>[],
+    "saved"=>false,
+    "id"=>"dcwe4m6",
+    "gilded"=>0,
+    "archived"=>false,
+    "report_reasons"=>nil,
+    "author"=>"spez",
+    "parent_id"=>"t1_dcwceu5",
+    "score"=>115,
+    "approved_by"=>nil,
+    "over_18"=>false,
+    "controversiality"=>0,
+    "body"=>"If Reddit could be killed, it'd be dead by now.",
+    "link_title"=>"Out with 2016, in with 2017",
+    "author_flair_css_class"=>nil,
+    "downs"=>0,
+    "body_html"=>"<div class=...",
+    "quarantine"=>false,
+    "subreddit"=>"announcements",
+    "name"=>"t1_dcwe4m6",
+    "score_hidden"=>false,
+    "stickied"=>false,
+    "created"=>1485401335.0,
+    "author_flair_text"=>nil,
+    "link_url"=>"https://www.reddit....",
+    "created_utc"=>1485372535.0,
+    "distinguished"=>"admin",
+    "mod_reports"=>[],
+    "num_reports"=>nil,
+    "ups"=>115}
+},
+{"kind"=>"t1", "data"=>{"subreddit_id"=>"t5_2r0ij", "edited"=>false, "banned_by"=>nil, "removal_reason"=>nil, "link_id"=>"t3_5q4qmg", "link_author"=>"spez", "likes"=>nil, "replies"=>"", "user_reports"=>[], "saved"=>false, "id"=>"dcwe4m6", "gilded"=>0, "archived"=>false, "report_reasons"=>nil, "author"=>"spez", "parent_id"=>"t1_dcwceu5", "score"=>115, "approved_by"=>nil, "over_18"=>false, "controversiality"=>0, "body"=>"If Reddit could be killed, it'd be dead by now.", "link_title"=>"Out with 2016, in with 2017", "author_flair_css_class"=>nil, "downs"=>0, "body_html"=>"<div class=\"md\"><p>If Reddit could be killed, it'd be dead by now.</p>\n</div>", "quarantine"=>false, "subreddit"=>"announcements", "name"=>"t1_dcwe4m6", "score_hidden"=>false, "stickied"=>false, "created"=>1485401335.0, "author_flair_text"=>nil, "link_url"=>"https://www.reddit.com/r/announcements/comments/5q4qmg/out_with_2016_in_with_2017/", "created_utc"=>1485372535.0, "distinguished"=>"admin", "mod_reports"=>[], "num_reports"=>nil, "ups"=>115}}
+]

data/lib/example_responses/posts.rb

@@ -0,0 +1,67 @@
+# Received 2-14-2017
+
+[{
+  "kind" => "t3",
+  "data" => {
+    "contest_mode" => false,
+    "banned_by" => nil,
+    "domain" => "self.AskReddit",
+    "subreddit" => "AskReddit",
+    "selftext_html" => "<!--...",
+    "selftext" => "[Valentine's Day](htt...",
+    "likes" => nil,
+    "suggested_sort" => "new",
+    "user_reports" => [],
+    "secure_media" => nil,
+    "link_flair_text" => "Mega Thread",
+    "id" => "5tvb1v",
+    "gilded" => 0,
+    "secure_media_embed" => {},
+    "clicked" => false,
+    "report_reasons" => nil,
+    "author" => "enantiodromia_",
+    "saved" => false,
+    "mod_reports" => [],
+    "name" => "t3_5tvb1v",
+    "score" => 638,
+    "approved_by" => nil,
+    "over_18" => false,
+    "removal_reason" => nil,
+    "hidden" => false,
+    "thumbnail" => "",
+    "subreddit_id" => "t5_2qh1i",
+    "edited" => false,
+    "link_flair_css_class" => "megathread",
+    "author_flair_css_class" => nil,
+    "downs" => 0,
+    "brand_safe" => true,
+    "archived" => false,
+    "media_embed" => {},
+    "is_self" => true,
+    "hide_score" => false,
+    "spoiler" => false,
+    "permalink" => "/r/AskReddit/com...",
+    "locked" => false,
+    "stickied" => true,
+    "created" => 1487046505.0,
+    "url" => "https://www.reddit./5...",
+    "author_flair_text" => nil,
+    "quarantine" => false,
+    "title" => "[Megathread] Valentine's Day",
+    "created_utc" => 1487017705.0,
+    "distinguished" => "moderator",
+    "media" => nil,
+    "num_comments" => 2258,
+    "visited" => false,
+    "num_reports" => nil,
+    "ups" => 638
+  }
+}, {
+  "kind" => "t3", "data" => {
+    "contest_mode" => false, "banned_by" => nil, "domain" => "self.AskReddit", "subreddit" => "AskReddit", "selftext_html" => nil, "selftext" => "", "likes" => nil, "suggested_sort" => nil, "user_reports" => [], "secure_media" => nil, "link_flair_text" => nil, "id" => "5u0azv", "gilded" => 0, "secure_media_embed" => {}, "clicked" => false, "report_reasons" => nil, "author" => "Coonark00", "saved" => false, "mod_reports" => [], "name" => "t3_5u0azv", "score" => 8245, "approved_by" => nil, "over_18" => true, "removal_reason" => nil, "hidden" => false, "thumbnail" => "", "subreddit_id" => "t5_2qh1i", "edited" => false, "link_flair_css_class" => nil, "author_flair_css_class" => nil, "downs" => 0, "brand_safe" => true, "archived" => false, "media_embed" => {}, "is_self" => true, "hide_score" => false, "spoiler" => false, "permalink" => "/r/AskReddit/comments/5u0azv/what_is_your_most_devious_would_you_rather/", "locked" => false, "stickied" => false, "created" => 1487109211.0, "url" => "https://www.reddit.com/r/AskReddit/comments/5u0azv/what_is_your_most_devious_would_you_rather/", "author_flair_text" => nil, "quarantine" => false, "title" => "What is your most devious \"Would you rather\" question?", "created_utc" => 1487080411.0, "distinguished" => nil, "media" => nil, "num_comments" => 7265, "visited" => false, "num_reports" => nil, "ups" => 8245
+  }
+}, {
+  "kind" => "t3", "data" => {
+    "contest_mode" => false, "banned_by" => nil, "domain" => "self.AskReddit", "subreddit" => "AskReddit", "selftext_html" => nil, "selftext" => "", "likes" => nil, "suggested_sort" => nil, "user_reports" => [], "secure_media" => nil, "link_flair_text" => nil, "id" => "5u2i4r", "gilded" => 0, "secure_media_embed" => {}, "clicked" => false, "report_reasons" => nil, "author" => "-oh-no", "saved" => false, "mod_reports" => [], "name" => "t3_5u2i4r", "score" => 1715, "approved_by" => nil, "over_18" => false, "removal_reason" => nil, "hidden" => false, "thumbnail" => "", "subreddit_id" => "t5_2qh1i", "edited" => false, "link_flair_css_class" => nil, "author_flair_css_class" => nil, "downs" => 0, "brand_safe" => true, "archived" => false, "media_embed" => {}, "is_self" => true, "hide_score" => false, "spoiler" => false, "permalink" => "/r/AskReddit/comments/5u2i4r/what_are_some_of_the_most_pathetic_things/", "locked" => false, "stickied" => false, "created" => 1487130279.0, "url" => "https://www.reddit.com/r/AskReddit/comments/5u2i4r/what_are_some_of_the_most_pathetic_things/", "author_flair_text" => nil, "quarantine" => false, "title" => "What are some of the most pathetic things YouTubers have done for views?", "created_utc" => 1487101479.0, "distinguished" => nil, "media" => nil, "num_comments" => 1180, "visited" => false, "num_reports" => nil, "ups" => 1715
+  }
+}]

data/lib/example_responses/subreddits.rb

@@ -0,0 +1,53 @@
+# Received 2-15-2017
+
+{
+  "banner_img"=>"http://a.thumbs.r...",
+  "user_sr_theme_enabled"=>true,
+  "submit_text_html"=>"Information only.&lt...",
+  "user_is_banned"=>nil,
+  "wiki_enabled"=>true,
+  "show_media"=>true,
+  "id"=>"2cneq",
+  "submit_text"=>"1. Submissions must be...",
+  "display_name"=>"politics",
+  "header_img"=>"http://b.thumbs.r...",
+  "description_html"=>"<!-- SC_OFF...",
+  "title"=>"Politics",
+  "collapse_deleted_comments"=>true,
+  "over18"=>false,
+  "public_description_html"=>"<!-- SC_OFF...",
+  "spoilers_enabled"=>false,
+  "icon_size"=>[256, 256],
+  "suggested_comment_sort"=>nil,
+  "icon_img"=>"http://a.thumbs.reddit...",
+  "header_title"=>"The Place for U.S. Politics",
+  "description"=>"## **Welcome to /r/Politics...",
+  "user_is_muted"=>nil,
+  "submit_link_label"=>nil,
+  "accounts_active"=>nil,
+  "public_traffic"=>true,
+  "header_size"=>[21, 16],
+  "subscribers"=>3300054,
+  "submit_text_label"=>nil,
+  "whitelist_status"=>"all_ads",
+  "lang"=>"en",
+  "user_is_moderator"=>nil,
+  "key_color"=>"",
+  "name"=>"t5_2cneq",
+  "created"=>1186406199.0,
+  "url"=>"/r/politics/",
+  "quarantine"=>false,
+  "hide_ads"=>false,
+  "created_utc"=>1186377399.0,
+  "banner_size"=>[880, 264],
+  "user_is_contributor"=>nil,
+  "accounts_active_is_fuzzed"=>nil,
+  "advertiser_category"=>"Lifestyles",
+  "public_description"=>"/r/Politics is for...",
+  "show_media_preview"=>false,
+  "comment_score_hide_mins"=>480,
+  "subreddit_type"=>"public",
+  "submission_type"=>"link",
+  "user_is_subscriber"=>nil
+}
+{"banner_img"=>"", "user_sr_theme_enabled"=>true, "submit_text_html"=>"<!-- SC_OFF --><div class=\"md\"><p>Please read <a href=\"/r/pics/about/sidebar\">the sidebar</a> before submitting</p>\n</div><!-- SC_ON -->", "user_is_banned"=>nil, "wiki_enabled"=>true, "show_media"=>true, "id"=>"2qh0u", "submit_text"=>"Please read [the sidebar](/r/pics/about/sidebar) before submitting\n\n", "display_name"=>"pics", "header_img"=>"http://b.thumbs.redditmedia.com/MfVUZn6wkAaWadas1QAInsX3excC1gp4X7Y3jm_FBiQ.png", "description_html"=>"<!-- SC_OFF --><div class=\"md\"><p>A place to share photographs and pictures. Feel free to post your own, but please <strong>read the rules first</strong> (see below), and note that we are <em>not a catch-all</em> for general images (of screenshots, comics, etc.)</p>\n\n<hr/>\n\n<h1>Spoiler code</h1>\n\n<p>Please mark spoilers like this:<br/>\n<code>[text here](/spoiler)</code></p>\n\n<p>Hover over to <a href=\"/spoiler\">read</a>.</p>\n\n<hr/>\n\n<p>Check out <a href=\"http://nt.reddit.com/r/pics\">http://nt.reddit.com/r/pics</a>!</p>\n\n<p>Check out <a href=\"/r/pics/w/takedown\">/r/pics/w/takedown</a> for help with taking down posts due to copyright or personal identifiable information reasons. </p>\n\n<hr/>\n\n<h1><a href=\"/r/pics/about/rules\">Posting Rules</a></h1>\n\n<ol>\n<li><p><strong>No screenshots or pictures of screens.  No pictures with added/superimposed text.</strong> <em>This includes <a href=\"http://en.wikipedia.org/wiki/Image_macro\">image macros</a>, comics, maps, infographics, and most diagrams. Text (e.g. a URL) serving to credit the original author is exempt.</em></p></li>\n<li><p><strong>No porn or gore.</strong> <em>NSFW content must be tagged.</em></p></li>\n<li><p><strong>No personal information.</strong> <em>This includes anything hosted on Facebook's servers, as they can be traced to the original account holder. Stalking & harassment will not be tolerated.</em> <strong><em>No missing-persons requests!</em></strong></p></li>\n<li><p><strong>Titles must follow all <a href=\"/r/pics/w/titles\">title guidelines</a>.</strong></p></li>\n<li><p><strong>Submissions must link directly to a specific image file or to a website with minimal ads.</strong> <em>We do not allow blog hosting of images ("blogspam"), but links to albums on image hosting websites are okay. URL shorteners are prohibited. URLs in image or album descriptions are prohibited.</em> </p></li>\n<li><p><strong>No animated images.</strong> <em>Please submit them to <a href=\"/r/gif\">/r/gif</a>, <a href=\"/r/gifs\">/r/gifs</a>, or <a href=\"/r/reactiongifs\">/r/reactiongifs</a> instead.</em></p></li>\n<li><p>We enforce a standard of common decency and civility here. <strong>Please be respectful to others.</strong> Personal attacks, bigotry, fighting words, otherwise inappropriate behavior or content, comments that insult or demean a specific user or group of users will be removed. Regular or egregious violations will result in a ban.</p></li>\n</ol>\n\n<ul>\n<li><p>If your submission appears to be filtered, but <strong>definitely</strong> meets the above rules, <a href=\"/message/compose?to=%23pics\">please send us a message</a> with a link to the <strong>comments section</strong> of your post (not a direct link to the image). <strong>Don't delete it</strong>  as that just makes the filter hate you! </p></li>\n<li><p>If you come across any rule violations please report the submission or  <a href=\"http://www.reddit.com/message/compose?to=%23pics\">message the mods</a> and one of us will remove it!</p></li>\n<li><p>Serial reposters may be filtered. False claims of ownership will result in a ban.</p></li>\n<li><p><strong>Professional photographer or artist?</strong> Read <a href=\"/r/pics/wiki/professionals\">these guidelines</a> for linking to your own site and obtaining 'Verified' user flair. </p></li>\n</ul>\n\n<h1>Links</h1>\n\n<p>If your post doesn't meet the above rules, consider submitting it on one of these other subreddits:</p>\n\n<h1>Subreddits</h1>\n\n<p>Below is a table of subreddits that you might want to check out!</p>\n\n<table><thead>\n<tr>\n<th>Screenshots</th>\n<th>Advice Animals</th>\n</tr>\n</thead><tbody>\n<tr>\n<td><a href=\"/r/images\">/r/images</a></td>\n<td><a href=\"/r/adviceanimals\">/r/adviceanimals</a></td>\n</tr>\n<tr>\n<td><a href=\"/r/screenshots\">/r/screenshots</a></td>\n<td><a href=\"/r/memes\">/r/memes</a></td>\n</tr>\n<tr>\n<td><a href=\"/r/desktops\">/r/desktops</a></td>\n<td><a href=\"/r/memesIRL\">/r/memesIRL</a></td>\n</tr>\n<tr>\n<td><strong>Animals</strong></td>\n<td><strong>More Animals</strong></td>\n</tr>\n<tr>\n<td><a href=\"/r/aww\">/r/aww</a></td>\n<td><a href=\"/r/rabbits\">/r/rabbits</a></td>\n</tr>\n<tr>\n<td><a href=\"/r/dogs\">/r/dogs</a></td>\n<td><a href=\"/r/BeforeNAfterAdoption\">/r/BeforeNAfterAdoption</a></td>\n</tr>\n<tr>\n<td><a href=\"/r/cats\">/r/cats</a></td>\n<td><a href=\"/r/otters\">/r/otters</a></td>\n</tr>\n<tr>\n<td><a href=\"/r/foxes\">/r/foxes</a></td>\n<td><a href=\"/r/redpandas\">/r/redpandas</a></td>\n</tr>\n<tr>\n<td><strong>GIFS</strong></td>\n<td><strong>HQ / Curated</strong></td>\n</tr>\n<tr>\n<td><a href=\"/r/gifs\">/r/gifs</a></td>\n<td><a href=\"/r/pic\">/r/pic</a></td>\n</tr>\n<tr>\n<td><a href=\"/r/catgifs\">/r/catgifs</a></td>\n<td><a href=\"/r/earthporn\">/r/earthporn</a></td>\n</tr>\n<tr>\n<td><a href=\"/r/reactiongifs\">/r/reactiongifs</a></td>\n<td><a href=\"/r/spaceporn\">/r/spaceporn</a></td>\n</tr>\n</tbody></table>\n\n<h2>Topic subreddits</h2>\n\n<p>Every now and then, we choose 2 new topics, and find some subreddits about that topic to feature!</p>\n\n<table><thead>\n<tr>\n<th>Comics</th>\n<th>Art</th>\n</tr>\n</thead><tbody>\n<tr>\n<td><a href=\"/r/comics\">/r/comics</a></td>\n<td><a href=\"/r/Art\">/r/Art</a></td>\n</tr>\n<tr>\n<td><a href=\"/r/xkcd\">/r/xkcd</a></td>\n<td><a href=\"/r/ImaginaryBestOf\">/r/ImaginaryBestOf</a></td>\n</tr>\n<tr>\n<td><a href=\"/r/comicbooks\">/r/comicbooks</a></td>\n<td><a href=\"/r/IDAP\">/r/IDAP</a></td>\n</tr>\n</tbody></table>\n</div><!-- SC_ON -->", "title"=>"Reddit Pics", "collapse_deleted_comments"=>true, "over18"=>false, "public_description_html"=>"<!-- SC_OFF --><div class=\"md\"><p>A place to share photographs and pictures.</p>\n</div><!-- SC_ON -->", "spoilers_enabled"=>true, "icon_size"=>[256, 256], "suggested_comment_sort"=>nil, "icon_img"=>"http://b.thumbs.redditmedia.com/VZX_KQLnI1DPhlEZ07bIcLzwR1Win808RIt7zm49VIQ.png", "header_title"=>"29% of statistics are made up", "description"=>"A place to share photographs and pictures. Feel free to post your own, but please **read the rules first** (see below), and note that we are *not a catch-all* for general images (of screenshots, comics, etc.)\n\n---\n\n#Spoiler code#\n\nPlease mark spoilers like this:  \n`[text here](/spoiler)`\n\nHover over to [read](/spoiler).\n\n---\nCheck out http://nt.reddit.com/r/pics!\n\nCheck out /r/pics/w/takedown for help with taking down posts due to copyright or personal identifiable information reasons. \n\n---\n#[Posting Rules](/r/pics/about/rules)#\n\n\n1. **No screenshots or pictures of screens.  No pictures with added/superimposed text.** *This includes [image macros](http://en.wikipedia.org/wiki/Image_macro), comics, maps, infographics, and most diagrams. Text (e.g. a URL) serving to credit the original author is exempt.*\n\n1. **No porn or gore.** *NSFW content must be tagged.*\n\n1. **No personal information.** *This includes anything hosted on Facebook's servers, as they can be traced to the original account holder. Stalking & harassment will not be tolerated.* ***No missing-persons requests!***\n\n1. **Titles must follow all [title guidelines](/r/pics/w/titles).**\n\n1. **Submissions must link directly to a specific image file or to a website with minimal ads.** *We do not allow blog hosting of images (\"blogspam\"), but links to albums on image hosting websites are okay. URL shorteners are prohibited. URLs in image or album descriptions are prohibited.* \n\n1. **No animated images.** *Please submit them to /r/gif, /r/gifs, or /r/reactiongifs instead.*\n\n1. We enforce a standard of common decency and civility here. **Please be respectful to others.** Personal attacks, bigotry, fighting words, otherwise inappropriate behavior or content, comments that insult or demean a specific user or group of users will be removed. Regular or egregious violations will result in a ban.\n\n* If your submission appears to be filtered, but **definitely** meets the above rules, [please send us a message](/message/compose?to=%23pics) with a link to the **comments section** of your post (not a direct link to the image). **Don't delete it**  as that just makes the filter hate you! \n\n* If you come across any rule violations please report the submission or  [message the mods](http://www.reddit.com/message/compose?to=%23pics) and one of us will remove it!\n\n* Serial reposters may be filtered. False claims of ownership will result in a ban.\n\n* **Professional photographer or artist?** Read [these guidelines](/r/pics/wiki/professionals) for linking to your own site and obtaining 'Verified' user flair. \n\n#Links#\nIf your post doesn't meet the above rules, consider submitting it on one of these other subreddits:\n\n#Subreddits\nBelow is a table of subreddits that you might want to check out!\n\nScreenshots | Advice Animals\n-----------|--------------\n/r/images | /r/adviceanimals\n/r/screenshots | /r/memes\n/r/desktops | /r/memesIRL\n**Animals** | **More Animals**\n/r/aww | /r/rabbits\n/r/dogs | /r/BeforeNAfterAdoption\n/r/cats | /r/otters\n/r/foxes | /r/redpandas\n**GIFS** | **HQ / Curated**\n/r/gifs | /r/pic\n/r/catgifs | /r/earthporn\n/r/reactiongifs | /r/spaceporn\n\n##Topic subreddits\n\nEvery now and then, we choose 2 new topics, and find some subreddits about that topic to feature!\n\nComics | Art\n-----|----------\n/r/comics | /r/Art\n/r/xkcd | /r/ImaginaryBestOf\n/r/comicbooks | /r/IDAP ", "user_is_muted"=>nil, "submit_link_label"=>"Submit an image", "accounts_active"=>nil, "public_traffic"=>true, "header_size"=>[160, 64], "subscribers"=>15349082, "submit_text_label"=>nil, "whitelist_status"=>"all_ads", "lang"=>"en", "user_is_moderator"=>nil, "key_color"=>"#222222", "name"=>"t5_2qh0u", "created"=>1201249869.0, "url"=>"/r/pics/", "quarantine"=>false, "hide_ads"=>false, "created_utc"=>1201221069.0, "banner_size"=>nil, "user_is_contributor"=>nil, "accounts_active_is_fuzzed"=>nil, "advertiser_category"=>"Lifestyles", "public_description"=>"A place to share photographs and pictures.", "show_media_preview"=>true, "comment_score_hide_mins"=>60, "subreddit_type"=>"public", "submission_type"=>"link", "user_is_subscriber"=>nil}

data/lib/reddit_api/client.rb

@@ -0,0 +1,141 @@
+require "httparty"
+
+module RedditApi
+  class Client
+
+    attr_reader :agent, :id, :password, :secret, :username, :failures
+
+    MAXIMUM_RECORDS = 100
+    MAX_FAILURES = 5
+    ERROR_CODES = (400..511)
+
+    def initialize(args = {})
+      @agent = ENV["REDDIT_AGENT"]
+      @client = args.fetch(:client, HTTParty)
+      @id = ENV["REDDIT_AGENT"]
+      @password = ENV["REDDIT_AGENT"]
+      @secret = ENV["REDDIT_AGENT"]
+      @username = ENV["REDDIT_AGENT"]
+      @base_url = "https://oauth.reddit.com/"
+      @failures = args.fetch(:failures, 0)
+      @null_response_factory = RedditApi:: NullResponse
+      @last_record = nil
+    end
+
+    def get(endpoint, count, resource_type)
+      sleep(3)
+      records = {}
+      loop do
+        new_records = request_records(endpoint, resource_type)
+        collect_records(new_records, records, count)
+        break if break_get?(records, count)
+      end
+      self.last_record = nil
+      records.keys
+    end
+
+    protected
+    attr_writer :failures, :last_record
+    private
+    attr_reader :client, :base_url, :null_response_factory, :last_record
+
+    def collect_records(new_records, collected_records, count)
+      new_records.each do |record|
+        collected_records[record] = true
+        break if collected_records.length == count
+      end
+    end
+
+    def request_records(endpoint, resource_type)
+      response = send_request(endpoint, resource_type)
+      parse_response(response)
+    end
+
+    def send_request(endpoint, resource_type)
+      url = base_url + endpoint
+      headers = generate_headers
+      query = generate_query(resource_type)
+      response = client.get(url, headers: headers, query: query)
+      response || null_response_factory.new
+    end
+
+    def parse_response(response)
+      if bad_response?(response)
+        handle_bad_response
+      else
+        handle_successful_response(response)
+      end
+    end
+
+    def bad_response?(response)
+      ERROR_CODES.cover?(response.code) || response["error"]
+    end
+
+    def handle_bad_response
+      self.failures += 1
+      []
+    end
+
+    def handle_successful_response(response)
+      if records = response["data"]["children"]
+        store_last_record(records)
+      else
+        bad_response
+      end
+    end
+
+    def store_last_record(records)
+      self.last_record = records[-1]
+      records
+    end
+
+    def break_get?(records, desired_count)
+      records.length >= desired_count || failures >= MAX_FAILURES
+    end
+
+    def generate_headers
+      access_token = generate_access_token
+      {
+        "Authorization" => "bearer #{access_token}",
+        "user-agent" => agent
+      }
+    end
+
+    def generate_query(resource_type)
+      {
+        limit: MAXIMUM_RECORDS,
+        after: generate_after(resource_type)
+      }
+    end
+
+    def generate_after(resource_type)
+      if last_record
+        build_after(resource_type)
+      else
+        nil
+      end
+    end
+
+    def build_after(resource_type)
+      prefix = TYPE_PREFIXES[resource_type]
+      last_resource_id = last_record["data"]["id"]
+      "#{prefix}_#{last_resource_id}"
+    end
+
+    def generate_access_token
+      url = "https://www.reddit.com/api/v1/access_token"
+      basic_auth = { username: id,
+                     password: secret }
+      headers = { "user-agent" => agent }
+      body = { grant_type:  "password",
+               username:  username,
+               password: password }
+      response = client.post(url,
+                             basic_auth: basic_auth,
+                             headers: headers,
+                             body: body)
+      response["access_token"]
+    end
+
+  end
+end

data/lib/reddit_api/comment.rb

@@ -0,0 +1,22 @@
+
+module RedditApi
+  class Comment
+
+    attr_reader :reddit_id, :author_name, :subreddit_name
+
+    def initialize(args = {})
+      @reddit_id = args.fetch("id", nil)
+      @author_name = args.fetch("author", nil)
+      @subreddit_name = args.fetch("subreddit", nil)
+    end
+
+    def to_h
+      {
+        reddit_id: reddit_id,
+        author_name: author_name,
+        subreddit_name: subreddit_name
+      }
+    end
+
+  end
+end

data/lib/reddit_api/comments.rb

@@ -0,0 +1,51 @@
+
+module RedditApi
+  class Comments
+
+    def initialize
+      @client = RedditApi::Client.new
+      @comment_factory = RedditApi::Comment
+    end
+
+    def most_recent_subreddits(user, count)
+      subreddits = {}
+      while subreddits.length < count
+        comments = most_recent_comments(user)
+        collect_subreddits(comments, count, subreddits)
+      end
+      subreddits.keys
+    end
+
+    def most_recent_comments(user, count = 100)
+      comments_data = most_recent_comment_data(user.username, count)
+      build_all_comments(comments_data)
+    end
+
+    private
+    attr_reader :client, :comment_factory
+
+    def most_recent_comment_data(username, count)
+      return [] if username == "[deleted]"
+      endpoint = "user/#{username}/comments.json"
+      client.get(endpoint, count, :comment)
+    end
+
+    def build_all_comments(comments_data)
+      comments_data.map! do |comment_data|
+        build_comment(comment_data)
+      end
+    end
+
+    def build_comment(comment_data)
+      comment_factory.new(comment_data["data"])
+    end
+
+    def collect_subreddits(comments, count, subreddits)
+      comments.each do |comment|
+        subreddits[comment.subreddit_name] = true
+        break if subreddits.length == count
+      end
+    end
+
+  end
+end

data/lib/reddit_api/null_response.rb

@@ -0,0 +1,10 @@
+
+module RedditApi
+  class NullResponse
+
+    def code
+      404
+    end
+
+  end
+end

data/lib/reddit_api/post.rb

@@ -0,0 +1,24 @@
+
+module RedditApi
+  class Post
+
+    attr_reader :reddit_id, :author, :subreddit, :stickied
+
+    def initialize(args = {})
+      @reddit_id = args.fetch("id", nil)
+      @author = args.fetch("author", nil)
+      @subreddit = args.fetch("subreddit", nil)
+      @stickied = args.fetch("stickied", nil)
+    end
+
+    def to_h
+      {
+        reddit_id: reddit_id,
+        author: author,
+        subreddit: subreddit,
+        stickied: stickied
+      }
+    end
+
+  end
+end

data/lib/reddit_api/posts.rb

@@ -0,0 +1,45 @@
+
+module RedditApi
+  class Posts
+
+    def initialize
+      @client = RedditApi::Client.new
+      @post_factory = RedditApi::Post
+    end
+
+    def top(subreddit, count)
+      posts_data = top_data(subreddit, count)
+      posts_data = filter_out(posts_data, :stickied_posts)
+      build_all_posts(posts_data)
+    end
+
+    private
+    attr_reader :client, :post_factory
+
+    def top_data(subreddit, count)
+      endpoint = URI.encode("r/#{subreddit.name}/hot.json")
+      client.get(endpoint, count, :post)
+    end
+
+    def filter_out(posts_data, filter)
+      send(filter, posts_data)
+    end
+
+    def stickied_posts(posts_data)
+      posts_data.select do |post_data|
+        !post_data["data"]["stickied"]
+      end
+    end
+
+    def build_all_posts(posts_data)
+      posts_data.map! do |post_data|
+        build_post(post_data)
+      end
+    end
+
+    def build_post(post_data)
+      post_factory.new(post_data["data"])
+    end
+
+  end
+end

data/lib/reddit_api/resource_type_prefixes.rb

@@ -0,0 +1,6 @@
+
+TYPE_PREFIXES = {
+  comment: "t1",
+  post: "t3",
+  subreddit: "t5"
+}

data/lib/reddit_api/subreddit.rb

@@ -0,0 +1,25 @@
+
+module RedditApi
+  class Subreddit
+    attr_reader :reddit_id, :name, :url, :description, :subscriber_count
+
+    def initialize(args = {})
+      @reddit_id = args.fetch("id", nil)
+      @name = args.fetch("display_name", nil)
+      @url = args.fetch("url", nil)
+      @description = args.fetch("public_description", nil)
+      @subscriber_count = args.fetch("subscribers", nil)
+    end
+
+    def to_h
+      {
+        reddit_id: reddit_id,
+        name: name,
+        url: url,
+        description: description,
+        subscriber_count: subscriber_count
+      }
+    end
+
+  end
+end

data/lib/reddit_api/subreddits.rb

@@ -0,0 +1,34 @@
+
+module RedditApi
+  class Subreddits
+
+    def initialize
+      @client = RedditApi::Client.new
+      @subreddit_factory = RedditApi::Subreddit
+    end
+
+    def top(count)
+      subreddits_data = top_data(count)
+      build_all_subreddits(subreddits_data)
+    end
+
+    private
+    attr_reader :client, :subreddit_factory
+
+    def top_data(count)
+      endpoint = "subreddits/popular.json"
+      client.get(endpoint, count, :subreddit)
+    end
+
+    def build_all_subreddits(subreddits_data)
+      subreddits_data.map! do |subreddit_data|
+        build_subreddit(subreddit_data)
+      end
+    end
+
+    def build_subreddit(subreddit_data)
+      subreddit_factory.new(subreddit_data["data"])
+    end
+
+  end
+end

data/lib/reddit_api/user.rb

@@ -0,0 +1,16 @@
+
+module RedditApi
+  class User
+
+    attr_reader :username
+
+    def initialize(args = {})
+      @username = args.fetch("username", nil)
+    end
+
+    def to_h
+      { username: username }
+    end
+
+  end
+end

data/lib/reddit_api/users.rb

@@ -0,0 +1,62 @@
+
+module RedditApi
+  class Users
+
+    def initialize
+      @post_api = RedditApi::Posts.new
+      @user_factory = RedditApi::User
+    end
+
+    def top_posters(subreddit, count)
+      users = {}
+      while users.length < count
+        posts = post_api.top(subreddit, count)
+        collect_users(posts, count, users)
+      end
+      users.values
+    end
+
+    private
+    attr_reader :post_api, :user_factory
+
+    def collect_users(posts, count, users)
+      usernames = get_usernames(posts, count, users)
+      user_data = format_user_data(usernames)
+      new_users = build_all_users(user_data)
+      aggregate_users(new_users, users)
+    end
+
+    def get_usernames(posts, count, users)
+      usernames = []
+      posts.each_with_index do |post, i|
+        break if (users.length + i) == count
+        usernames << post.author
+      end
+      usernames
+    end
+
+    def format_user_data(usernames)
+      usernames.map! do |username|
+        { "username" => username }
+      end
+    end
+
+    def build_all_users(users_data)
+      users_data.map! do |user_data|
+        build_user(user_data)
+      end
+    end
+
+    def build_user(user_data)
+      user_factory.new(user_data)
+    end
+
+    def aggregate_users(new_users, collected_users)
+      new_users.each do |user|
+        collected_users[user.username] = user
+      end
+    end
+
+  end
+end
+

data/lib/reddit_api/version.rb

@@ -0,0 +1,3 @@
+module RedditApi
+  VERSION = "0.1.0"
+end

data/lib/reddit_api.rb

@@ -0,0 +1,16 @@
+require "reddit_api/version"
+require "dotenv/load"
+require "reddit_api/null_response"
+require "reddit_api/resource_type_prefixes"
+require "reddit_api/client"
+require "reddit_api/subreddits"
+require "reddit_api/subreddit"
+require "reddit_api/posts"
+require "reddit_api/post"
+require "reddit_api/comments"
+require "reddit_api/comment"
+require "reddit_api/users"
+require "reddit_api/user"
+
+module RedditApi
+end

data/reddit_api.gemspec

@@ -0,0 +1,39 @@
+# coding: utf-8
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "reddit_api/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "reddit_api"
+  spec.version       = RedditApi::VERSION
+  spec.authors       = ["Anthony Fuentes"]
+  spec.email         = ["anthony.c.fuentes@gmail.com"]
+
+  spec.summary       = "Reddit API wrapper"
+  spec.description   = "A friendly inteface for the Reddit API"
+  spec.homepage      = "https://github.com/anthonyfuentes/reddit_api"
+  spec.license       = "MIT"
+
+  # Prevent pushing this gem to RubyGems.org. To allow pushes either set the "allowed_push_host"
+  # to allow pushing to a single host or delete this section to allow pushing to any host.
+  if spec.respond_to?(:metadata)
+    spec.metadata["allowed_push_host"] = "https://rubygems.org"
+  else
+    raise "RubyGems 2.0 or newer is required to protect against " \
+      "public gem pushes."
+  end
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "dotenv", "~> 2.2.0"
+  spec.add_dependency "httparty", "~> 0.14.0"
+  spec.add_development_dependency "bundler", "~> 1.13"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.5.0"
+  spec.add_development_dependency "guard-rspec", "~> 4.7.3"
+end

metadata

@@ -0,0 +1,156 @@
+--- !ruby/object:Gem::Specification
+name: reddit_api
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Anthony Fuentes
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2017-02-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: dotenv
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.2.0
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.14.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.14.0
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.5.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.5.0
+- !ruby/object:Gem::Dependency
+  name: guard-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.7.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.7.3
+description: A friendly inteface for the Reddit API
+email:
+- anthony.c.fuentes@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- Guardfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- lib/example_responses/comments.rb
+- lib/example_responses/posts.rb
+- lib/example_responses/subreddits.rb
+- lib/reddit_api.rb
+- lib/reddit_api/client.rb
+- lib/reddit_api/comment.rb
+- lib/reddit_api/comments.rb
+- lib/reddit_api/null_response.rb
+- lib/reddit_api/post.rb
+- lib/reddit_api/posts.rb
+- lib/reddit_api/resource_type_prefixes.rb
+- lib/reddit_api/subreddit.rb
+- lib/reddit_api/subreddits.rb
+- lib/reddit_api/user.rb
+- lib/reddit_api/users.rb
+- lib/reddit_api/version.rb
+- reddit_api.gemspec
+homepage: https://github.com/anthonyfuentes/reddit_api
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.1
+signing_key: 
+specification_version: 4
+summary: Reddit API wrapper
+test_files: []