twitter_labs_api 0.4.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 471a4a8a8b2f248f11d0337240451d5b5bc2fdff5601370335f0ab080038cb0a
-  data.tar.gz: 25f2097f036e2ba1b9431f5e4a01db6a062ea7507f05b648c85b9d3514c5d083
+  metadata.gz: 308afe5c20914abca1ed575f09b1e5924206034eae405886944d495fb6e4d3da
+  data.tar.gz: 5b931944828a477b39d0360d492c2fb6215b13ec12f8b953ac01533bcf822b44
 SHA512:
-  metadata.gz: df432778d2baef5046f1c0d36ddd1b96f17e58414063ce3e76f15fdb9d7f78abc82327c598bc2a0e67fc3e205a430c5e5f851e1afb16691176a5722e506fe226
-  data.tar.gz: bcad0b98629f789f004974fdc505929b7a7f42af362490a8d9bd5e3ade4389ae770e25cf1550cd46af308f3336b2c4f3018a71580e41e9f92e48d42d1aea5fca
+  metadata.gz: 12be24ffd5dfbc7b81b5bba6665cd264c39a8d9cbe828977b569285093b37e00036950db0a1b94c50fb287847897a6d8ba356bcb8b950c33197c4bda888a2a5a
+  data.tar.gz: b44d15ee5acc7a147ea3c2208c242cd45b6d5966cfbac0a2c2946b85594f73263853c4b0b45d9125567d20ffb295e33c45ae6491a2d4a0a31535a94a00b77ef7

data/.github/workflows/ruby.yml

@@ -0,0 +1,32 @@
+# This workflow uses actions that are not certified by GitHub.
+# They are provided by a third-party and are governed by
+# separate terms of service, privacy policy, and support
+# documentation.
+# This workflow will download a prebuilt Ruby version, install dependencies and run tests with Rake
+# For more information see: https://github.com/marketplace/actions/setup-ruby-jruby-and-truffleruby
+
+name: Ruby
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  test:
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Ruby
+    # To automatically get bug fixes and new Ruby versions for ruby/setup-ruby,
+    # change this to (see https://github.com/ruby/setup-ruby#versioning):
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: 2.7
+    - name: Install dependencies
+      run: bundle install
+    - name: Run tests
+      run: bundle exec rspec

data/.rspec

@@ -0,0 +1 @@
+--require spec_helper

data/CHANGELOG.md

@@ -1,3 +1,49 @@
+# 0.7.0 - 28 August 2020
+
+- Refactor interface for requesting custom response fields
+
+## Breaking Change
+
+Heads up, the argument to request fields was previously called `tweet_fields`; it is now called `fields`. 
+
+```ruby
+api.get_tweet(id: '123455683780', fields: requested_fields)
+```
+
+The `fields` parameter now supports multiple different data types (instead of just Tweet attributes). So for example, to request the URL of an embedded media item:
+
+```ruby
+requested_fields = { tweet: %w[id username], media: %w[url] }
+
+api.get_tweet(id: my_id, fields: requested_fields)
+```
+
+# 0.6.0 - 28 July 2020
+
+- Fix: broken dependency
+
+# 0.5.2 - 28 July 2020
+
+- Add `search`
+- Finish `rdoc` coverage
+
+# 0.5.1 - 28 July 2020
+
+- Add `User-Agent` request header
+- Add `hide_reply`
+
+# 0.5.0 - 27 July 2020
+
+- Refactor structure to prepare for adding additional API endpoints
+- Add `get_users_by_username`
+- Add some test coverage
+
+
+# 0.4.0 - 24 July 2020
+
+- Better exception-handling: when API returns an error, a `TwitterLabsAPI::APIError` is thrown. It has the `Net::HTTP` response as an attribute so that the error can be handled properly. See the README for an example.
+
+
 # 0.3.0 - 28 April 2020
 
 - Fix: namespace of error class

data/Gemfile

@@ -1,7 +1,13 @@
 source 'https://rubygems.org'
 
-gemspec
+group :development, :test do
+  gem 'amazing_print'
+  gem 'httplog'
+  gem 'irbtools'
+  gem 'pry'
+  gem 'rake'
+  gem 'rspec'
+  gem 'webmock'
+end
 
-gem 'activesupport'
-gem 'httplog'
-gem 'pry'
+gemspec

data/Gemfile.lock

@@ -1,7 +1,9 @@
 PATH
   remote: .
   specs:
-    twitter_labs_api (0.4.0)
+    twitter_labs_api (0.7.0)
+      activesupport (~> 6.0)
+      httplog (~> 1.4)
 
 GEM
   remote: https://rubygems.org/
@@ -12,36 +14,121 @@ GEM
       minitest (~> 5.1)
       tzinfo (~> 1.1)
       zeitwerk (~> 2.2, >= 2.2.2)
+    addressable (2.7.0)
+      public_suffix (>= 2.0.2, < 5.0)
+    alias (0.2.3)
+    amazing_print (1.2.1)
+    binding.repl (3.0.0)
+    boson (1.3.0)
+    boson-more (0.3.1)
+      boson (>= 1.3.0)
+    cd (1.0.1)
+    clipboard (1.0.6)
     coderay (1.1.3)
-    concurrent-ruby (1.1.6)
-    httplog (1.3.2)
+    concurrent-ruby (1.1.7)
+    crack (0.4.3)
+      safe_yaml (~> 1.0.0)
+    debugging (1.1.1)
+      binding.repl (~> 3.0)
+      paint (>= 0.9, < 3.0)
+    diff-lcs (1.4.4)
+    every_day_irb (2.1.0)
+      cd (~> 1.0)
+    fancy_irb (1.2.1)
+      paint (>= 0.9, < 3.0)
+      unicode-display_width (~> 1.1)
+    ffi (1.13.1)
+    g (1.7.2)
+    hashdiff (1.0.1)
+    hirb (0.7.3)
+    httplog (1.4.3)
       rack (>= 1.0)
       rainbow (>= 2.0.0)
     i18n (1.8.5)
       concurrent-ruby (~> 1.0)
+    interactive_editor (0.0.11)
+      spoon (>= 0.0.1)
+    irbtools (1.7.1)
+      alias (~> 0.2.3)
+      binding.repl (~> 3.0)
+      boson (~> 1.3.0)
+      boson-more (~> 0.3.0)
+      clipboard (~> 1.0.5)
+      coderay (~> 1.1.0)
+      debugging (~> 1.0)
+      every_day_irb (>= 1.7.1)
+      fancy_irb (>= 0.7.3)
+      g (>= 1.7.2)
+      hirb (~> 0.7, >= 0.7.3)
+      interactive_editor (>= 0.0.10)
+      method_locator (>= 0.0.4)
+      method_source (>= 0.8.2)
+      methodfinder (~> 2.0)
+      ori (~> 0.1.0)
+      os (~> 0.9)
+      paint (>= 0.8.7)
+      ruby_engine (~> 1.0)
+      ruby_info (~> 1.0)
+      ruby_version (~> 1.0)
+      wirb (>= 1.0.3)
+    method_locator (0.0.4)
     method_source (1.0.0)
+    methodfinder (2.2.1)
     minitest (5.14.1)
+    ori (0.1.0)
+    os (0.9.6)
+    paint (2.2.0)
     pry (0.13.1)
       coderay (~> 1.1)
       method_source (~> 1.0)
+    public_suffix (4.0.5)
     rack (2.2.3)
     rainbow (3.0.0)
     rake (13.0.1)
+    rspec (3.9.0)
+      rspec-core (~> 3.9.0)
+      rspec-expectations (~> 3.9.0)
+      rspec-mocks (~> 3.9.0)
+    rspec-core (3.9.2)
+      rspec-support (~> 3.9.3)
+    rspec-expectations (3.9.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.9.0)
+    rspec-mocks (3.9.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.9.0)
+    rspec-support (3.9.3)
+    ruby_engine (1.0.1)
+    ruby_info (1.0.1)
+    ruby_version (1.0.2)
+    safe_yaml (1.0.5)
+    spoon (0.0.6)
+      ffi
     thread_safe (0.3.6)
     tzinfo (1.2.7)
       thread_safe (~> 0.1)
+    unicode-display_width (1.7.0)
+    webmock (3.8.3)
+      addressable (>= 2.3.6)
+      crack (>= 0.3.2)
+      hashdiff (>= 0.4.0, < 2.0.0)
+    wirb (2.2.1)
+      paint (>= 0.9, < 3.0)
     zeitwerk (2.4.0)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
-  activesupport
+  amazing_print
   bundler (~> 2.0)
   httplog
+  irbtools
   pry
-  rake (~> 13.0)
+  rake
+  rspec
   twitter_labs_api!
+  webmock
 
 BUNDLED WITH
    2.1.4

data/README.md

@@ -1,13 +1,15 @@
 # twitter-labs-api
 
+[![Labs v2](https://img.shields.io/static/v1?label=Twitter%20API&message=Developer%20Labs%20v2&color=192430&style=flat&logo=Twitter)](https://developer.twitter.com/en/docs/labs/overview/versioning)
+
 A basic implementation of a Twitter Labs API client as a handy Ruby [gem](https://rubygems.org/gems/twitter_labs_api). This project uses the v2 endpoints announced [here](https://twittercommunity.com/t/releasing-a-new-version-of-labs-endpoints/134219/3).
 
 ## Usage
 
 ### Prerequisite
-All one needs is a Twitter [bearer token](https://developer.twitter.com/en/docs/basics/authentication/oauth-2-0/bearer-tokens) to get started.
+All one needs is a Twitter [bearer token](https://developer.twitter.com/en/docs/basics/authentication/oauth-2-0/bearer-tokens) to get started. The bearer token is available on the 'Tokens and Keys' page within your app's dashboard on the [Twitter for Developers](https://developer.twitter.com/) site.
 
-One easy way to get a bearer token is to use [this method](https://www.rubydoc.info/gems/twitter/Twitter/REST/Client#bearer_token%3F-instance_method) from https://github.com/sferik/twitter.
+Alternatively, one can get a bearer token using [this method](https://www.rubydoc.info/gems/twitter/Twitter/REST/Client#bearer_token%3F-instance_method) from https://github.com/sferik/twitter.
 
 ### Setup
 
@@ -19,7 +21,7 @@ gem install twitter_labs_api
 
 #### Getting a Tweet by ID
 ```ruby
-requre `twitter_labs_api`
+require `twitter_labs_api`
 
 api = TwitterLabsAPI.new(bearer_token: 'YOUR-BEARER-TOKEN')
 
@@ -30,19 +32,18 @@ api.get_tweet(id: '1234671272602193920')
 
 #### Specifying which fields to include in the response
 
-By default, the gem requests the 'default' fields for each entity. See the [API Reference](https://developer.twitter.com/en/docs/labs/tweets-and-users/api-reference) for available fields. One can customize the response payload like so:
+By default, the gem requests the 'default' fields for each entity. See the [API Reference](https://developer.twitter.com/en/docs/labs/tweets-and-users/api-reference) for available fields. One can customize the response payload, depending on the requested resource.
 
+For example, to request the URL of a Tweet's embedded media item:
 ```ruby
-my_fields = %w[id author_id created_at text]
-
-api.get_tweet(id: '1235508591232090112', tweet_fields: my_fields)
+requested_fields = { tweet: %w[id username], media: %w[url] }
 
->> {"author_id"=>"229708614", "created_at"=>"2020-03-05T10:12:57.000Z", "id"=>"1235508591232090112", "text"=>"Hot take: coronavirus will not boost remote work in the long run because spur-of-the-moment work-from-home for in-person companies is likely to be a shitshow."}
+api.get_tweet(id: my_id, fields: requested_fields)
 ```
 
 #### API Errors
 
-Sometimes the API will respond with an error, for example `429 Too Many Requests`. The gem will throw an error with the `Net::HTTP` response as an attribute for proper exception-handling by the consuming app:
+Sometimes the API will respond with an error, for example, `429 Too Many Requests`. The gem will throw an error with the `Net::HTTP` response as an attribute for proper exception-handling by the consuming app:
 
 ```ruby
 def my_twitter_request
@@ -58,14 +59,24 @@ end
 ### Status
 Currently, the following endpoints are implemented:
 
-- `TwitterLabsAPI#get_tweet` - Retrieve a single Tweet object with an `id`
-- `TwitterLabsAPI#get_tweets` - Retrieve multiple Tweets with a collection of `ids`
-- `TwitterLabsAPI#get_user` - Retrieve a single user object with an `id`
-- `TwitterLabsAPI#get_users` - Retrieve multiple user objects with a collection of `ids`
+#### Tweets
+
+- `TwitterLabsAPI#get_tweet` ([docs](https://developer.twitter.com/en/docs/labs/tweets-and-users/api-reference/get-tweets-id)) - Retrieve a single Tweet object with an `id`
+- `TwitterLabsAPI#get_tweets` ([docs](https://developer.twitter.com/en/docs/labs/tweets-and-users/api-reference/get-tweets)) - Retrieve multiple Tweets with a collection of `ids`
+- `TwitterLabsAPI#hide_reply` ([docs](https://developer.twitter.com/en/docs/labs/hide-replies/api-reference/put-hidden)) - Hide a reply by referencing it's `id`; must be in a conversation belonging to the authenticating user
+- `TwitterLabsAPI#search` ([docs](https://developer.twitter.com/en/docs/labs/recent-search/api-reference/get-recent-search)) - Returns Tweets from the last 7 days that match a search query.
+
+#### Users
+
+- `TwitterLabsAPI#get_user` ([docs](https://developer.twitter.com/en/docs/labs/tweets-and-users/api-reference/get-users-id)) - Retrieve a single user object with an `id`
+- `TwitterLabsAPI#get_users` ([docs](https://developer.twitter.com/en/docs/labs/tweets-and-users/api-reference/get-users)) - Retrieve multiple user objects with a collection of `ids`
+- `TwitterLabsAPI#get_users_by_username` ([docs](https://developer.twitter.com/en/docs/labs/tweets-and-users/api-reference/get-users)) - Retrieve multiple user objects with a collection of `usernames`
 
 ## Roadmap
 
-Since this project is initially driven by my own usage of the API, I will focus on implementing and refinining the Tweets, Users, and Metrics endpoints. If this repo gets enough interest, I might implement the other endpoints and create a proper `.gemspec`. And of course, contributions are welcome :)
+Currently focused on implementing support for all v2 endpoints; if there is enough interest, I will add v1 endpoint support as well.
+
+And of course, contributions are welcome :)
 
 ## Dependencies
 

data/bin/specs

@@ -0,0 +1 @@
+bundle exec rspec

data/lib/twitter_labs_api.rb

@@ -2,119 +2,13 @@ require 'json'
 require 'net/http'
 require 'uri'
 require 'active_support/core_ext/hash/indifferent_access'
-
-DEFAULT_TWEET_FIELDS = %w[id author_id created_at lang public_metrics].freeze
-DEFAULT_USER_FIELDS = %w[name username].freeze
+require_relative 'twitter_labs_api/client'
 
 # A basic implementation of a Twitter Labs API client.
-class TwitterLabsAPI
-  attr_accessor :bearer_token, :debug, :api_response, :parsed_response
-
-  class APIError < StandardError
-    DEFAULT_MESSAGE = 'Twitter Labs API error, check the response attribute'.freeze
-
-    attr_reader :response
-
-    def initialize(msg = DEFAULT_MESSAGE, response = nil)
-      @response = response
-
-      super(msg)
+module TwitterLabsAPI
+  class << self
+    def new(bearer_token:, debug: false)
+      Client.new(bearer_token: bearer_token, debug: debug)
     end
   end
-
-  def initialize(bearer_token:, debug: false)
-    @bearer_token = bearer_token
-    @debug = debug
-    require 'httplog' if debug
-  end
-
-  # @param [String] :id the ID of the requested Tweet
-  # @param [Array<String>] :tweet_fields (["id", "author_id", "created_at", "lang", "public_metrics"]) the list of fields to retrieve for the given tweet
-  def get_tweet(id:, tweet_fields: DEFAULT_TWEET_FIELDS)
-    url = "https://api.twitter.com/labs/2/tweets/#{id}"
-    params = {
-      'tweet.fields' => tweet_fields.join(',')
-    }.compact
-
-    make_request(url: url, params: params)
-  end
-
-  # @param [Array<String>] :ids the collection of requested Tweet IDs
-  # @param [Array<String>] :tweet_fields (["id", "author_id", "created_at", "lang", "public_metrics"]) the list of fields to retrieve for the given tweet
-  def get_tweets(ids:, tweet_fields: DEFAULT_TWEET_FIELDS)
-    url = 'https://api.twitter.com/labs/2/tweets'
-    params = {
-      'ids' => ids.join(','),
-      'tweet.fields' => tweet_fields.join(',')
-    }.compact
-
-    make_request(url: url, params: params, is_collection: true)
-  end
-
-  # @param [String] :id the ID of the requested User
-  # @param [Array<String>] :user_fields (["name", "username"]) the list of fields to retrieve for the given User
-  def get_user(id:, user_fields: DEFAULT_USER_FIELDS)
-    url = "https://api.twitter.com/labs/2/users/#{id}"
-    params = {
-      'user.fields' => user_fields.join(',')
-    }.compact
-
-    make_request(url: url, params: params)
-  end
-
-  # @param [Array<String>] :ids the collection of requested User IDs
-  # @param [Array<String>] :user_fields (["name", "username"]) the list of fields to retrieve for the given User
-  def get_users(ids:, user_fields: DEFAULT_USER_FIELDS)
-    url = 'https://api.twitter.com/labs/2/users'
-    params = {
-      'ids' => ids.join(','),
-      'user.fields' => user_fields.join(',')
-    }.compact
-
-    make_request(url: url, params: params, is_collection: true)
-  end
-
-  private
-
-  def make_request(url:, params: {}, is_collection: false)
-    uri = URI.parse(url)
-    uri.query = URI.encode_www_form(params)
-    request = Net::HTTP::Get.new(uri)
-    request['Authorization'] = "Bearer #{bearer_token}"
-    req_options = { use_ssl: uri.scheme == 'https' }
-
-    self.api_response = Net::HTTP.start(uri.hostname, uri.port, req_options) do |http|
-      http.request(request)
-    end
-
-    raise_http_error unless api_response.is_a?(Net::HTTPSuccess)
-
-    self.parsed_response = JSON.parse(api_response.body)
-
-    handle_api_error if error_response?
-
-    is_collection ? handle_collection : handle_single
-  end
-
-  def error_response?
-    parsed_response.key?('errors')
-  end
-
-  def handle_single
-    parsed_response['data'].with_indifferent_access
-  end
-
-  def handle_collection
-    parsed_response['data'].map(&:with_indifferent_access)
-  end
-
-  def raise_http_error
-    raise(APIError.new("#{api_response.code} #{api_response.msg}", api_response))
-  end
-
-  def handle_api_error
-    error = parsed_response['errors'].first
-
-    raise APIError.new("#{error['title']}: #{error['detail']} #{error['type']}", api_response)
-  end
 end

data/lib/twitter_labs_api/api_error.rb

@@ -0,0 +1,13 @@
+module TwitterLabsAPI
+  class APIError < StandardError
+    DEFAULT_MESSAGE = 'Twitter Labs API error, check the response attribute'.freeze
+  
+    attr_reader :response
+  
+    def initialize(msg = DEFAULT_MESSAGE, response = nil)
+      @response = response
+  
+      super(msg)
+    end
+  end  
+end

data/lib/twitter_labs_api/client.rb

@@ -0,0 +1,73 @@
+require_relative 'version'
+require_relative 'api_error'
+require_relative 'resources/tweet'
+require_relative 'resources/user'
+
+module TwitterLabsAPI
+  class Client
+    include Resources::Tweet
+    include Resources::User
+
+    attr_accessor :bearer_token, :debug, :api_response, :parsed_response
+
+    def initialize(bearer_token:, debug: false)
+      @bearer_token = bearer_token
+      @debug = debug
+      require 'httplog' if debug
+    end
+
+    private
+
+    def make_request(url:, params: {}, is_collection: false, method: :get)
+      uri = URI.parse(url)
+      uri.query = URI.encode_www_form(params)
+      request = http_adapter(method).new(uri)
+      request['Authorization'] = "Bearer #{bearer_token}"
+      request['User-Agent'] = "twitter_labs_api gem #{TwitterLabsAPI::VERSION}"
+      req_options = { use_ssl: uri.scheme == 'https' }
+
+      self.api_response = Net::HTTP.start(uri.hostname, uri.port, req_options) do |http|
+        http.request(request)
+      end
+  
+      raise_http_error unless api_response.is_a?(Net::HTTPSuccess)
+  
+      self.parsed_response = JSON.parse(api_response.body)
+  
+      handle_api_error if error_response?
+  
+      is_collection ? handle_collection : handle_single
+    end
+
+    def http_adapter(method)
+      case method
+      when :put
+        Net::HTTP::Put
+      else
+        Net::HTTP::Get
+      end
+    end
+
+    def error_response?
+      parsed_response.key?('errors')
+    end
+  
+    def handle_single
+      parsed_response['data'].with_indifferent_access
+    end
+  
+    def handle_collection
+      parsed_response['data'].map(&:with_indifferent_access)
+    end
+  
+    def raise_http_error
+      raise(APIError.new("#{api_response.code} #{api_response.msg}", api_response))
+    end
+  
+    def handle_api_error
+      error = parsed_response['errors'].first
+  
+      raise APIError.new("#{error['title']}: #{error['detail']} #{error['type']}", api_response)
+    end
+  end
+end

data/lib/twitter_labs_api/resources/tweet.rb

@@ -0,0 +1,58 @@
+module TwitterLabsAPI
+  module Resources
+    module Tweet
+      DEFAULT_TWEET_FIELDS = %w[id author_id created_at lang public_metrics].freeze
+      DEFAULT_FIELDS = { tweet: DEFAULT_TWEET_FIELDS }.freeze
+
+      # Returns a variety of information about a single Tweet specified by the requested ID.
+      # @param [String] :id the ID of the requested Tweet
+      # @param [Hash] :fields a hash for fields to include in the response payload; 
+      #
+      #     e.g.: { tweet: %w[id username], media: %w[url] }
+      # @return Hash an object with requested tweet fields
+      def get_tweet(id:, fields: DEFAULT_FIELDS)
+        url = "https://api.twitter.com/labs/2/tweets/#{id}"
+        params = ParamsService.from_fields(fields)
+
+        make_request(url: url, params: params)
+      end
+
+      # Returns a variety of information about the Tweet specified by the requested ID or list of IDs.
+      # @param [Array<String>] :ids the collection of requested Tweet IDs
+      # @param [Hash] :fields a hash for fields to include in the response payload; 
+      #
+      #     e.g.: { tweet: %w[id username], media: %w[url] }
+      # @return [Array<Hash>] of tweet objects with the requested tweet fields
+      def get_tweets(ids:, fields: DEFAULT_FIELDS)
+        url = 'https://api.twitter.com/labs/2/tweets'
+        params = ParamsService.from_fields(fields)
+        params.merge!({ ids: ids.join(',') })
+
+        make_request(url: url, params: params, is_collection: true)
+      end
+
+      # Hides or unhides a reply to a Tweet.
+      # @param [String] :id the ID of the requested Tweet; must belong to a conversation by the authenticated user
+      # @return boolean indicating the hidden status of the requested tweet
+      def hide_reply(id:)
+        url = "https://api.twitter.com/labs/2/tweets/#{id}/hidden"
+
+        make_request(url: url, method: :put)[:hidden]
+      end
+
+      # The Labs recent search endpoint returns Tweets from the last 7 days that match a search query.
+      # @param [String] :query the search query
+      # @param [Hash] :fields a hash for fields to include in the response payload; 
+      #
+      #     e.g.: { tweet: %w[id username], media: %w[url] }
+      # @return [Array<Hash>] of tweet objects with the requested tweet fields
+      def search(query:, fields: DEFAULT_FIELDS)
+        url = 'https://api.twitter.com/labs/2/tweets/search'
+        params = ParamsService.from_fields(fields)
+        params.merge!({ query: query })
+
+        make_request(url: url, params: params, is_collection: true)
+      end
+    end
+  end
+end

data/lib/twitter_labs_api/resources/user.rb

@@ -0,0 +1,49 @@
+module TwitterLabsAPI
+  module Resources
+    module User
+      DEFAULT_USER_FIELDS = %w[id name username].freeze
+      DEFAULT_FIELDS = { user: DEFAULT_USER_FIELDS }.freeze
+
+      # Returns a variety of information about a single more user specified by the requested ID.
+      # @param [String] :id the ID of the requested User
+      # @param [Hash] :fields  a hash for fields to include in the response payload; 
+      #
+      #  e.g.: { user: %w[id name username] }
+      # @return Hash an object with requested user fields
+      def get_user(id:, fields: DEFAULT_FIELDS)
+        url = "https://api.twitter.com/labs/2/users/#{id}"
+        params = ParamsService.from_fields(fields)
+
+        make_request(url: url, params: params)
+      end
+
+      # Returns a variety of information about one or more Users specified by the requested IDs.
+      # @param [Array<String>] :ids the collection of requested User IDs
+      # @param [Hash] :fields  a hash for fields to include in the response payload; 
+      #
+      #  e.g.: { user: %w[id name username] }
+      # @return [Array<Hash>] of user objects with the requested user fields
+      def get_users(ids:, fields: DEFAULT_FIELDS)
+        url = 'https://api.twitter.com/labs/2/users'
+        params = ParamsService.from_fields(fields)
+        params.merge!({ ids: ids.join(',') })
+
+        make_request(url: url, params: params, is_collection: true)
+      end
+
+      # Returns a variety of information about one or more Users specified by the requested usernames.
+      # @param [Array<String>] :usernames the collection of requested Usernames
+      # @param [Hash] :fields  a hash for fields to include in the response payload; 
+      #
+      #  e.g.: { user: %w[id name username] }
+      # @return [Array<Hash>] of user objects with the requested user fields
+      def get_users_by_usernames(usernames:, fields: DEFAULT_FIELDS)
+        url = 'https://api.twitter.com/labs/2/users/by'
+        params = ParamsService.from_fields(fields)
+        params.merge!({ usernames: usernames.join(',') })
+
+        make_request(url: url, params: params, is_collection: true)
+      end
+    end
+  end
+end

data/lib/twitter_labs_api/services/params_service.rb

@@ -0,0 +1,15 @@
+class ParamsService
+  # Convert user-passed fields hash to query params
+  # @param [Hash] :fields A hash of requested fields; see API Reference for details
+  # @return [Hash] A hash of query params for consumption by API client
+  # @example
+  #     input: { tweet: %w[id username], media: ['url'] }
+  #     output: { 'tweet.fields' => 'id,username', 'media.fields' => 'url }
+  def self.from_fields(fields)
+    fields.keys.inject({}) do |memo, key|
+      memo["#{key}.fields"] = fields[key].join(',')
+
+      memo
+    end
+  end
+end

data/lib/twitter_labs_api/version.rb

@@ -1,3 +1,3 @@
-class TwitterLabsAPI
-  VERSION = '0.4.0'.freeze
+module TwitterLabsAPI
+  VERSION = '0.7.0'.freeze
 end

data/twitter-labs-api.gemspec

@@ -25,6 +25,9 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
+  spec.add_dependency 'activesupport', '~> 6.0'
+  spec.add_dependency 'httplog', '~> 1.4'
+
   spec.add_development_dependency 'bundler', '~> 2.0'
   spec.add_development_dependency 'rake', '~> 13.0'
 end

metadata

@@ -1,15 +1,43 @@
 --- !ruby/object:Gem::Specification
 name: twitter_labs_api
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.7.0
 platform: ruby
 authors:
 - tomholford
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-07-24 00:00:00.000000000 Z
+date: 2020-08-27 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: httplog
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -45,7 +73,9 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/workflows/ruby.yml"
 - ".gitignore"
+- ".rspec"
 - CHANGELOG.md
 - Gemfile
 - Gemfile.lock
@@ -54,7 +84,13 @@ files:
 - Rakefile
 - bin/console
 - bin/setup
+- bin/specs
 - lib/twitter_labs_api.rb
+- lib/twitter_labs_api/api_error.rb
+- lib/twitter_labs_api/client.rb
+- lib/twitter_labs_api/resources/tweet.rb
+- lib/twitter_labs_api/resources/user.rb
+- lib/twitter_labs_api/services/params_service.rb
 - lib/twitter_labs_api/version.rb
 - twitter-labs-api.gemspec
 homepage: https://github.com/tomholford/twitter-labs-api