simply_reddit 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 63988e436474e6963cfe8ae6e2b6d576464263e3a4231d17960534e4d771f9e7
-  data.tar.gz: 8bd108b0fdec68d1ff25e1b2895c7eeacd37b2bf64c56da999a541ccdda056d6
+  metadata.gz: e2c47a3eb7e7e510061f81c05bd7d89ff41d6bc537c862d613ee8d17a23e1e44
+  data.tar.gz: f58fdb9e8f300cc94d22ce81697c6857e600bea0e30a7bd459f8e9aadf607197
 SHA512:
-  metadata.gz: a91b7eabe7606ced0f60af675fae673b60a365c2bd6378ade2b4bf8a3658c3527c80c1c21a77c28d9c3eb8eb2c6225bee9303db58f77e1eef287cfd60b6d9c19
-  data.tar.gz: cd84424bf974a22abdbf9b26bd9bc1fb2638b0b6667b7dc9050eb6e7021f7d385edea5110a390d8c20f4a6a120c2fd5c198adf637a14e6393b76e7e97e08976d
+  metadata.gz: 17143add4b23d73e7f51462ad6d018820cdfd2086b2c438f4f75dbe67b16857bdcf85b6b2c9691895232abcc460b25c0dce09c6aa94a2b50ca81b30cbda7a52d
+  data.tar.gz: 869cf82cef3132470c4ed03260c9af6a59e8190c487cb33edc400678b759204144fa0eb6461d82e938f4073c6804173bbf2b0c3a2b5db7feb44c3d288b35cdef

data/README.md

@@ -1,35 +1,37 @@
 # SimplyReddit
 
-TODO: Delete this and the text below, and describe your gem
-
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/simply_reddit`. To experiment with that code, run `bin/console` for an interactive prompt.
+A simple Ruby wrapper for the Reddit API.
 
 ## Installation
 
-TODO: Replace `UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG` with your gem name right after releasing it to RubyGems.org. Please do not do it earlier due to security reasons. Alternatively, replace this section with instructions to install your gem from git if you don't plan to release to RubyGems.org.
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'simply_reddit'
+```
 
-Install the gem and add to the application's Gemfile by executing:
+And then execute:
 
 ```bash
-bundle add UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG
+bundle install
 ```
 
-If bundler is not being used to manage dependencies, install the gem by executing:
+Or install it yourself as:
 
 ```bash
-gem install UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG
+gem install simply_reddit
 ```
 
 ## Usage
 
-TODO: Write usage instructions here
-
-## Development
+```ruby
+require 'simply_reddit'
 
-After checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
-
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
-
-## Contributing
-
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/simply_reddit.
+client = SimplyReddit.client(
+  client_id: 'your_client_id',
+  secret: 'your_client_secret',
+  username: 'your_username',
+  password: 'your_password'
+)
+```
+```

data/Rakefile

@@ -1,4 +1,10 @@
 # frozen_string_literal: true
 
 require "bundler/gem_tasks"
-task default: %i[]
+
+desc "Run tests"
+task :test do
+  ruby "test/simply_reddit_test.rb"
+end
+
+task default: [:test]

data/lib/simply_reddit/base_client.rb

@@ -0,0 +1,68 @@
+require "faraday"
+
+class SimplyReddit::BaseClient
+  # Response struct to wrap API responses
+  Response = Struct.new(:status, :headers, :body)
+
+  def initialize(base_url:, adapter: Faraday.default_adapter, headers: {})
+    @base_url = base_url
+    @adapter = adapter
+    @default_headers = headers
+    @connection = nil
+  end
+
+  # HTTP methods
+  def get(path, params = {})
+    response = connection.get(path, params)
+    wrap_response(response)
+  end
+
+  def post(path, body = {})
+    response = connection.post(path, body)
+    wrap_response(response)
+  end
+
+  def put(path, body = {})
+    response = connection.put(path, body)
+    wrap_response(response)
+  end
+
+  def delete(path, params = {})
+    response = connection.delete(path, params)
+    wrap_response(response)
+  end
+
+  protected
+
+  def configure_connection(conn)
+    conn.request :json
+    conn.response :json, content_type: "application/json"
+  end
+
+  def connection_headers
+    @default_headers
+  end
+
+  private
+
+  def wrap_response(faraday_response)
+    Response.new(
+      body: faraday_response.body,
+      status: faraday_response.status,
+      headers: faraday_response.headers
+    )
+  end
+
+  def connection
+    @connection ||= Faraday.new do |conn|
+      conn.url_prefix = @base_url
+      conn.adapter @adapter
+
+      connection_headers.each do |key, value|
+        conn.headers[key] = value
+      end
+
+      configure_connection(conn)
+    end
+  end
+end

data/lib/simply_reddit/client.rb

@@ -0,0 +1,63 @@
+require "faraday"
+require_relative "base_client"
+require_relative "subreddit"
+require_relative "user"
+
+class SimplyReddit::Client < SimplyReddit::BaseClient
+  BASE_URL = "https://oauth.reddit.com"
+  DEFAULT_GRANT_TYPE = "client_credentials"
+  USER_AGENT = "Ruby:SimplyReddit:v#{SimplyReddit::VERSION} (by unknown)"
+
+  def initialize(client_id:, secret:, username:, password:, adapter: Faraday.default_adapter)
+    @user_agent = USER_AGENT
+    @client_id = client_id
+    @secret = secret
+    @username = username
+    @password = password
+    @access_token = request_access_token
+    
+    super(
+      base_url: BASE_URL,
+      adapter: adapter,
+      headers: {
+        "User-Agent" => @user_agent,
+        "Authorization" => "Bearer #{@access_token}"
+      }
+    )
+  end
+
+  def subreddit(name)
+    SimplyReddit::Subreddit.new(client: self, name: name)
+  end
+
+  def user(username)
+    SimplyReddit::User.new(client: self, username: username)
+  end
+
+  def me
+    get("/api/v1/me")
+  end
+
+  private
+
+  def request_access_token(grant_type = DEFAULT_GRANT_TYPE, options = {})
+    endpoint = "https://www.reddit.com/api/v1/access_token"
+
+    auth_connection = Faraday.new do |conn|
+      conn.headers['User-Agent'] = @user_agent
+      conn.request :authorization, :basic, @client_id, @secret
+      conn.response :json, content_type: "application/json"
+    end
+    
+    response = auth_connection.post(endpoint) do |req|
+      req.body = URI.encode_www_form({
+        grant_type: grant_type,
+        username: @username,
+        password: @password
+      })
+    end
+    
+    response.body["access_token"]
+  end
+end
+

data/lib/simply_reddit/subreddit.rb

@@ -0,0 +1,26 @@
+class SimplyReddit::Subreddit
+  def initialize(client:, name:)
+    @client = client
+    @name = name
+  end
+
+  def hot(limit: 25)
+    @client.get("/r/#{@name}/hot", limit: limit)
+  end
+
+  def new(limit: 25)
+    @client.get("/r/#{@name}/new", limit: limit)
+  end
+
+  def top(limit: 25, t: 'day')
+    @client.get("/r/#{@name}/top", limit: limit, t: t)
+  end
+
+  def rising(limit: 25)
+    @client.get("/r/#{@name}/rising", limit: limit)
+  end
+
+  def about
+    @client.get("/r/#{@name}/about")
+  end
+end

data/lib/simply_reddit/user.rb

@@ -0,0 +1,18 @@
+class SimplyReddit::User
+  def initialize(client:, username:)
+    @client = client
+    @username = username
+  end
+
+  def about
+    @client.get("/user/#{@username}/about")
+  end
+
+  def posts(limit: 25, sort: 'new')
+    @client.get("/user/#{@username}/submitted", limit: limit, sort: sort)
+  end
+
+  def comments(limit: 25, sort: 'new')
+    @client.get("/user/#{@username}/comments", limit: limit, sort: sort)
+  end
+end

data/lib/simply_reddit/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SimplyReddit
-  VERSION = "0.1.0"
+  VERSION = "0.1.2"
 end

data/lib/simply_reddit.rb

@@ -2,9 +2,23 @@
 
 require_relative "simply_reddit/version"
 
+
 module SimplyReddit
+  autoload :BaseClient, "simply_reddit/base_client"
+  autoload :Client, "simply_reddit/client"
+  autoload :Subreddit, "simply_reddit/subreddit"
+  autoload :User, "simply_reddit/user"
+
   class Error < StandardError; end
-  def self.hi
-    puts "hello world"
+
+  # Convenience method for creating a client
+  def self.client(client_id:, secret:, username:, password:, **options)
+    Client.new(
+      client_id: client_id,
+      secret: secret,
+      username: username,
+      password: password,
+      **options
+    )
   end
 end

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: simply_reddit
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.2
 platform: ruby
 authors:
 - Ken Lu
+autorequire: 
 bindir: exe
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2025-08-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -23,6 +24,7 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 2.13.4
+description: 
 email:
 - kenlu519@gmail.com
 executables: []
@@ -32,6 +34,10 @@ files:
 - README.md
 - Rakefile
 - lib/simply_reddit.rb
+- lib/simply_reddit/base_client.rb
+- lib/simply_reddit/client.rb
+- lib/simply_reddit/subreddit.rb
+- lib/simply_reddit/user.rb
 - lib/simply_reddit/version.rb
 - sig/simply_reddit.rbs
 homepage: https://github.com/kenyounot123/simply_reddit
@@ -39,6 +45,7 @@ licenses: []
 metadata:
   homepage_uri: https://github.com/kenyounot123/simply_reddit
   source_code_uri: https://github.com/kenyounot123/simply_reddit
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -53,7 +60,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 3.3.26
+signing_key: 
 specification_version: 4
 summary: A simple reddit api wrapper
 test_files: []