pyr 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e9e59c224c843ca67e681e5f25ccc13da61ec142
-  data.tar.gz: 564cf7a0cc20981bb4b49df434b50ecca8ef19f1
+  metadata.gz: 6333e6354f970dcd24da80da145b5a14b17eb53d
+  data.tar.gz: 4e4e70ab8ab3f72c411ed6966ae80df19d43038c
 SHA512:
-  metadata.gz: 0a19050c771961098b9af8875f09f2aa6b54b375fa15e26cf7577cd2e90a915cd09af1d5f63397f8ebd179137c330ca042e95091aa8641de60b8830357aaeed6
-  data.tar.gz: f562c9bce4f3315679278482753268fe4f7ea0b63eb141d007e7fe45bc8fbdb8e45ae52df9e91d107f74b56d180e1bb4a027318ff4908b52d9c8a08915369aea
+  metadata.gz: a1f47d4383710c005cd1bc62d5312d6212c42f77d8f98818512044795296d5d87bb46c7711b6fe8603f4863b72a4df8edf09f8892260cf26bc0c78dc8243b0e4
+  data.tar.gz: 91364f48240d406420d6b0fa8fc7ed39d2db5521db23854ee12e90000cfa601ed29836549c99fdbc9e87b1afa1a2465f1bb3de15f0310a233680c518c2242187

data/README.md

@@ -1,7 +1,7 @@
 # PYR
 [![Code Climate](https://codeclimate.com/github/msimonborg/pyr/badges/gpa.svg)](https://codeclimate.com/github/msimonborg/pyr)
 
-PYR makes integrating data from the Phone Your Rep API into your Ruby project as easy as pie.
+PYR makes integrating data from the [Phone Your Rep API](https://www.github.com/phoneyourrep/phone-your-rep-api) into your Ruby project as easy as pie.
 
 ## Installation
 
@@ -25,15 +25,18 @@ Or install it yourself as:
 ```ruby
 response = PYR.call :reps do |r|
   r.lat  = 44.5588028
-  r.long = -72.57784149999999
+  r.long = -72.5778415
 end
 
+response.uri
+=> "https://phone-your-rep.herokuapp.com/api/beta/reps?lat=44.5588028&long=-72.5778415&"
+
 ## or ##
 
-response = PYR.call(:reps) do { |r| r.address = 'Vermont' }
+response = PYR.call(:reps) { |r| r.address = 'Vermont' }
 
 response.uri
-=> "https://phone-your-rep.herokuapp.com/api/beta/reps?lat=44.5588028&long=-72.57784149999999&"
+=> "https://phone-your-rep.herokuapp.com/api/beta/reps?address=Vermont&"
 
 response.code
 => 200
@@ -56,11 +59,11 @@ reps.first.official_full
 reps.first.office_locations_count
 => 3
 
-reps.first.office_locations.first.city
-=> "St. Johnsbury"
+reps.first.office_locations.first.phone
+=> "802-748-9269"
 ```
 
-### Query the full index and narrowing with scopes
+### Querying the full index and narrowing with scopes
 ```ruby
 response = PYR.call :reps
 
@@ -79,10 +82,10 @@ reps.democratic.senators.count
 => 46
 
 reps.where official_full: 'Bernard Sanders'
-=> #<PYR::RepRelation [#<PYR::Rep id: 435, self: "https://phone-your-rep.herokuapp.com/api/beta/reps/S000033", state: {"self"=>"https://phone-your-rep.herokuapp.com/states/50", "state_code"=>"50", "name"=>"Vermont", "abbr"=>"VT"}, district: nil, active: true, bioguide_id: "S000033", official_full: "Bernard Sanders", role: "United States Senator", party: "Independent", senate_class: "01", last: "Sanders", first: "Bernard", middle: nil, nickname: "Bernie", suffix: nil, contact_form: "http://www.sanders.senate.gov/contact/", url: "https://www.sanders.senate.gov", photo: "https://phoneyourrep.github.io/images/congress/450x550/S000033.jpg", twitter: "SenSanders", facebook: "senatorsanders", youtube: "senatorsanders", instagram: nil, googleplus: nil, twitter_id: "29442313", facebook_id: nil, youtube_id: "UCD_DaKNac0Ta-2PeHuoQ1uA", instagram_id: nil, office_locations_count: 3>]>
+=> #<PYR::RepRelation [#<PYR::Rep id: 428, self: "https://phone-your-rep.herokuapp.com/api/beta/reps/S000033", state: #<PYR::State:0x007fdb11d42580>, district: nil, active: true, bioguide_id: "S000033", official_full: "Bernard Sanders", role: "United States Senator", party: "Independent", senate_class: "01", last: "Sanders", first: "Bernard", middle: nil, nickname: "Bernie", suffix: nil, contact_form: "http://www.sanders.senate.gov/contact/", url: "https://www.sanders.senate.gov", photo: "https://phoneyourrep.github.io/images/congress/450x550/S000033.jpg", twitter: "SenSanders", facebook: "senatorsanders", youtube: "senatorsanders", instagram: nil, googleplus: nil, twitter_id: "29442313", facebook_id: nil, youtube_id: "UCD_DaKNac0Ta-2PeHuoQ1uA", instagram_id: nil, office_locations_count: 3>]>
 
-reps.independent.where { |r| r.state['name'] == 'Vermont' }.first
-=> #<PYR::Rep id: 435, self: "https://phone-your-rep.herokuapp.com/api/beta/reps/S000033", state: {"self"=>"https://phone-your-rep.herokuapp.com/states/50", "state_code"=>"50", "name"=>"Vermont", "abbr"=>"VT"}, district: nil, active: true, bioguide_id: "S000033", official_full: "Bernard Sanders", role: "United States Senator", party: "Independent", senate_class: "01", last: "Sanders", first: "Bernard", middle: nil, nickname: "Bernie", suffix: nil, contact_form: "http://www.sanders.senate.gov/contact/", url: "https://www.sanders.senate.gov", photo: "https://phoneyourrep.github.io/images/congress/450x550/S000033.jpg", twitter: "SenSanders", facebook: "senatorsanders", youtube: "senatorsanders", instagram: nil, googleplus: nil, twitter_id: "29442313", facebook_id: nil, youtube_id: "UCD_DaKNac0Ta-2PeHuoQ1uA", instagram_id: nil, office_locations_count: 3>
+reps.independent.where { |r| r.state.name == 'Vermont' }.first
+=> #<PYR::Rep id: 428, self: "https://phone-your-rep.herokuapp.com/api/beta/reps/S000033", state: #<PYR::State:0x007fdb11d42580>, district: nil, active: true, bioguide_id: "S000033", official_full: "Bernard Sanders", role: "United States Senator", party: "Independent", senate_class: "01", last: "Sanders", first: "Bernard", middle: nil, nickname: "Bernie", suffix: nil, contact_form: "http://www.sanders.senate.gov/contact/", url: "https://www.sanders.senate.gov", photo: "https://phoneyourrep.github.io/images/congress/450x550/S000033.jpg", twitter: "SenSanders", facebook: "senatorsanders", youtube: "senatorsanders", instagram: nil, googleplus: nil, twitter_id: "29442313", facebook_id: nil, youtube_id: "UCD_DaKNac0Ta-2PeHuoQ1uA", instagram_id: nil, office_locations_count: 3>
 ```
 
 ### Querying by ID
@@ -105,7 +108,7 @@ office.office_id == PYR.call(office).objects.first.office_id
 ```ruby
 rep = PYR.call(:reps) { |r| r.address = 'vermont' }.objects.representatives.first
 
-uri = rep.district['self']
+uri = rep.district.self
 => "https://phone-your-rep.herokuapp.com/api/beta/districts/5000"
 
 district = PYR.call(uri).objects.first

data/lib/pyr.rb

@@ -1,5 +1,25 @@
 # frozen_string_literal: true
 
+# Copyright (c) 2017 M. Simon Borg
+
+# 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.
+
 require 'pyr/param'
 require 'pyr/parser'
 require 'pyr/resource'
@@ -20,9 +40,79 @@ require 'pyr/version'
 
 # PYR provides an easy interface to the Phone Your Rep API,
 # converting the data payloads into Plain Old Ruby Objects.
+# There is one class method on the PYR module, ::call.
+#
+# The method takes two arguments: :resource and :id. The resource
+# is the API resource, or controller name, that you want to
+# query. The name must be in plural form. The options are 'reps',
+# 'office_locations', 'states', 'districts', and 'zctas' (Zip Code
+# Tabulation Areas).
+#
+# The :id is the primary key id of a particular object. Each
+# resource has its own data attribute as ID.
+#
+#   ids = {
+#     reps: :bioguide_id,
+#     office_locations: :office_id,
+#     states: :state_code,
+#     districts: :full_code,
+#     zctas: :zcta
+#   }
+#
+# The ::call method takes a block, to which it yields an object
+# inherited from the PYR::Resource class. You can then pass params to
+# the PYR::Resource object. The particular descendant of PYR::Resource,
+# and therefore the available params, depends on the resource/controller
+# that you are querying.
+#
+# The return value of ::call is an instance of the PYR::Response class.
+# You can call these methods on the object:
+
+#   #objects => A collection, similar to an ActiveRecord Relation, of
+#               objects descended from the PYR::ResponseObject superclass,
+#               which have getter methods for each data attribute.
+#               The objects may be nested inside other PYR::ResponseObjects,
+#               e.g. a :rep has_one :state and has_many :office_locations.
+#               The collection can be iterated over, and can be queried
+#               similarly to how you would query in ActiveRecord, using the
+#               #where method, which can take hash syntax for checking equality
+#               of discreet attributes, or block syntax if you need to do
+#               more complex comparisons. Some scopes are also available
+#               depending on the resource, e.g. `reps.democratic.senators`
+#
+#   #uri => The URI that the request was sent to.
+#
+#   #body => The raw JSON data response
+#
+#   #code => The HTTP status code e.g. 200
+#
+#   #message => The HTTP status message e.g. 'OK'
+#
+#   #controller => The API controller that was hit e.g. :reps, :zctas etc...
+#
+#   #headers => A hash containing the HTTP response headers
+#
+# ==== Examples
+#
+#   response = PYR.call(:reps) { |r| r.address = 'vermont' }
+#
+#   response.body # => { ... }
+#   response.uri # => 'https://phone-your-rep.herokuapp.com/api/beta/reps?address=vermont'
+#   reps = response.objects
+#   reps.count # => 3
+#   reps.independent.senators.first.official_full # => "Bernard Sanders"
+#
+#   response = PYR.call :reps
+#
+#   response.objects.count # => 536
+#   independent_senators = response.objects.independent.senators
+#   vt_fav_son = independent_senators.where { |r| r.state.abbr == 'VT' }.first
+#   vt_fav_son.official_full # => "Bernard Sanders"
 module PYR
-  API_BASE_URL = 'https://phone-your-rep.herokuapp.com/api/beta/'
+  # The base URI for all requests
+  API_BASE_URI = 'https://phone-your-rep.herokuapp.com/api/beta/'
 
+  # The API resources available to query
   PYR_RESOURCES = %i[
     reps
     office_locations
@@ -31,19 +121,35 @@ module PYR
     zctas
   ].freeze
 
+  # ActiveSupport::Inflector is used to identify possible PYR
+  # objects nested in the JSON data response.
+  #
+  # The inflector thinks the plural of 'zcta' is 'zcta', so we
+  # register the correct inflection.
   ActiveSupport::Inflector.inflections do |inflect|
     inflect.irregular 'zcta', 'zctas'
   end
 
+  # The main API interface. All the objects you will need to work
+  # with are returned by this method.
+  #
+  # Arguments can be:
+  #
+  # a particular PYR::ResponseObject itself to query that object's 'self' url;
+  #
+  # a valid Phone Your Rep URI beginning with the API_BASE_URI string value;
+  #
+  # or, perhaps most commonly, a resource name (String or Symbol) with
+  # optional ID(String).
   def self.call(resource, id = nil)
     if resource.is_a?(ResponseObject)
       request_object = { response_object: resource }
-    elsif resource.to_s.include? API_BASE_URL
+    elsif resource.to_s.include? API_BASE_URI
       request_object = { base_url: resource }
     else
       resource = Request.build(resource, id)
       yield resource if block_given?
-      request_object = { base_url: API_BASE_URL, resource: resource }
+      request_object = { base_url: API_BASE_URI, resource: resource }
     end
     Response.new request_object
   end

data/lib/pyr/param.rb

@@ -1,25 +1,29 @@
 # frozen_string_literal: true
 
 module PYR
-  # Handles string conversion for request params.
+  # Defines the #to_s method for request params.
   # Will handle the conversion differently depending on if
   # it is an ID param e.g. controller/:id
   class Param
+    # www.example.com/path?name=value
     attr_reader :name, :value
 
+    # Set the param `name` and `value`, and whether it's an ID
     def initialize(name, value, id: nil)
-      @id = id == true ? true : false
+      @id    = !id.nil?
       @name  = name
       @value = value
     end
 
+    # Is the param an ID param?
     def id?
       @id
     end
 
+    # Format the param for the URI
     def to_s
       url_value = value.to_s.tr('#;\'""', '').gsub(' ', '%20')
-      id? ? "/#{value}" : "#{name}=#{url_value}&"
+      id? ? "/#{value}" : "#{name}=#{url_value}"
     end
   end
 end

data/lib/pyr/resource.rb

@@ -2,10 +2,23 @@
 
 module PYR
   # Resource and its subclasses accept attribute params and,
-  # in conjunction with the Param class,
-  # convert them to a URI friendly string
+  # in conjunction with instances of the Param class,
+  # convert them to a URI friendly string.
+  # When a block is passed to `PYR.call(name)`, it yields
+  # a Resource object, on which param setter methods can be
+  # called. The exact type of Resource that is yielded depends
+  # on the name that is passed to the method.
+  #
+  # === Example
+  #
+  #   PYR.call(:reps) do |r| # yielding an instance of PYR::Resource::Reps
+  #     r.address = 'Somewhere in the USA' # The `address` param is available
+  #   end
   class Resource
-    attr_reader :id, :controller
+    # Read the `id`
+    attr_reader :id
+    # Read the `controller`
+    attr_reader :controller
 
     def initialize(controller, id)
       @controller = controller
@@ -17,11 +30,11 @@ module PYR
     end
 
     def to_s
-      "#{controller}#{params}"
+      "#{controller}#{id}?#{params.map(&:to_s).join('&')}"
     end
 
     def params
-      "#{id}?"
+      @params ||= []
     end
   end
 end

data/lib/pyr/resources/reps.rb

@@ -2,28 +2,73 @@
 
 module PYR
   class Resource
-    # Request object for sending requests to the /reps resource of the API
+    # Resource object for sending requests to the /reps resource of the API
     class Reps < Resource
-      attr_reader :lat, :long, :address, :generate
+      # Read the lat param
+      attr_reader :lat
+      # Read the long param
+      attr_reader :long
+      # Read the address param
+      attr_reader :address
+      # Read the generate param
+      attr_reader :generate
 
-      def params
-        "#{id}?#{lat}#{long}#{address}#{generate}"
+      # Set the lat param : float
+      # Needs to be accompanied by :long.
+      #
+      # Usage:
+      #   PYR.call :reps do |r|
+      #     r.lat  = 45.0
+      #     r.long = -70.0
+      #   end
+      def lat=(float)
+        @lat = Param.new(:lat, float)
+        params << @lat
       end
 
-      def lat=(value)
-        @lat = Param.new(:lat, value)
+      # Set the long param : float
+      # Needs to be accompanied by :lat.
+      #
+      # Usage:
+      #   PYR.call :reps do |r|
+      #     r.lat  = 45.0
+      #     r.long = -70.0
+      #   end
+      #
+      # Resulting URI: 'https://phone-your-rep.herokuapp.com/api/beta/reps?lat=45.0&long=-45.0'
+      def long=(float)
+        @long = Param.new(:long, float)
+        params << @long
       end
 
-      def long=(value)
-        @long = Param.new(:long, value)
+      # Set the address param : string
+      # :lat and :long take precedence
+      #
+      # Usage:
+      #   PYR.call(:reps) { |r| r.address = '123 Main St., USA'}
+      #
+      # Resulting URI: 'https://phone-your-rep.herokuapp.com/api/beta/reps?lat=45.0&long=-45.0'
+      def address=(string)
+        @address = Param.new(:address, string)
+        params << @address
       end
 
-      def address=(value)
-        @address = Param.new(:address, value)
-      end
-
-      def generate=(value)
-        @generate = Param.new(:generate, value)
+      # Set the generate param : boolean
+      #
+      # By default making a call to the full :reps index will return a cached
+      # JSON file. The cached file is updated regularly (usually every day).
+      # However, if you want to generate a fresh response directly from the
+      # database, you can set :generate to true. The response will be much
+      # slower, and in most cases will never be necessary. Has no effect
+      # when used with either :address or :lat/:long
+      #
+      # Usage:
+      #   PYR.call(:reps) { |r| r.generate = true }
+      #
+      # Resulting URI: 'https://phone-your-rep.herokuapp.com/api/beta/reps?generate=true'
+      def generate=(boolean)
+        @generate = Param.new(:generate, boolean)
+        params << @generate
       end
     end
   end

data/lib/pyr/resources/zctas.rb

@@ -2,16 +2,15 @@
 
 module PYR
   class Resource
-    # Request object for sending requests to the /zctas resource of the API
+    # Resource object for sending requests to the /zctas resource of the API
     class Zctas < Resource
+      # Read the reps param value
       attr_reader :reps
 
-      def params
-        "#{id}?#{reps}"
-      end
-
+      # Set the 'reps' param value
       def reps=(value)
         @reps = Param.new(:reps, value)
+        params << @reps
       end
     end
   end

data/lib/pyr/response.rb

@@ -18,7 +18,7 @@ module PYR
         @controller = resource.controller
         @uri        = "#{base_url}#{resource}"
       elsif base_url
-        @controller = base_url.sub(API_BASE_URL, '').split('/').first
+        @controller = base_url.sub(API_BASE_URI, '').split('/').first
         @uri        = base_url
       elsif response_object
         @controller = response_object.controller

data/lib/pyr/response_object.rb

@@ -1,28 +1,66 @@
 # frozen_string_literal: true
 
+# The LazyRecord gem provides hash and block constructor syntax,
+# attribute, association, and scope definition macros, and object
+# collections. It gives objects an API similar to ActiveRecord,
+# turning the raw JSON response into a collection of associated
+# Ruby objects.
 require 'lazy_record'
 
 module PYR
   # The ResponseObject is the parent class of all objects instantiated
   # from the response body.
   class ResponseObject < LazyRecord::Base
-    def initialize(opts = {})
+    # Pass in an options hash to instantiate the object and set the data
+    # attributes. First iterates through the hash converting nested hashes
+    # and arrays of hashes into other PYR::ResponseObjects if possible.
+    # Hash keys that are not defined as attributes with `lr_attr_accessor`
+    # or `lr_has_many` will not be accessible in the parent object.
+    def initialize(opts = {}, &block)
       new_opts = opts.each_with_object({}) do |(key, val), memo|
-        memo[key] = if PYR_RESOURCES.include?(key.to_sym)
-                      objectify(key, val)
-                    else
-                      val
-                    end
+        memo[key] = convert_json_object_to_pyr_resource(key, val) || val
       end
-      super(new_opts)
+      super(new_opts, &block)
     end
 
+    # The controller name, based on the object's class name.
+    def controller
+      @controller ||= self.class.to_s.split('::').last.tableize
+    end
+
+    private
+
+    # If the attribute key is a valid plural or singular resource,
+    # e.g. `"reps"` or `"rep"`, use the values as options hashes to
+    # instantiate PYR::ResponseObjects.
+    def convert_json_object_to_pyr_resource(key, val)
+      if resources_include?(key) && val.is_a?(Array)
+        objectify(key, val)
+      elsif resources_include_singular?(key) && val.is_a?(Hash)
+        new_response_object(key, val)
+      end
+    end
+
+    # Check the `PYR_RESOURCES` constant for the plural version of `name`
+    def resources_include_singular?(name)
+      resources_include?(name.to_s.pluralize)
+    end
+
+    # Check the `PYR_RESOURCES` constant for `name`
+    def resources_include?(name)
+      PYR_RESOURCES.include?(name.to_sym)
+    end
+
+    # Iterate over an array and instantiate a PYR::ResponseObject from
+    # each item in the collection.
     def objectify(name, array)
-      array.map { |obj| "PYR::#{name.classify}".constantize.new(obj) }
+      array.map { |obj| "PYR::#{name.to_s.classify}".constantize.new(obj) }
     end
 
-    def controller
-      @controller ||= self.class.to_s.split('::').last.tableize
+    # Instantiate a single PYR::ResponseObject from an options hash.
+    def new_response_object(name, opts)
+      "PYR::#{name.to_s.classify}".constantize.new(opts)
     end
+    # end private
   end
 end

data/lib/pyr/response_objects/district.rb

@@ -3,6 +3,21 @@
 module PYR
   # The District is the response object that carries the data for
   # a single congressional district.
+  #
+  # Responds to the following attribute methods:
+  #
+  #   #self => The object's direct URI path
+  #
+  #   #full_code => Concatenation of the `state_code` and `district_code`.
+  #                 A unique 4 digit identifier for each Congressional District,
+  #                 and the primary key ID of the object.
+  #
+  #   #code => 2 digit district identifier. Not unique. The state must
+  #            provide context to indicate the exact district.
+  #            e.g. Minnesota's 4th district
+  #
+  #   #state_code => Unique 2 digit code for the State that contains
+  #                  the district.
   class District < ResponseObject
     lr_attr_accessor :self, :full_code, :code, :state_code
   end

data/lib/pyr/response_objects/office_location.rb

@@ -6,6 +6,9 @@ module PYR
   # for a single office location, which in turn is associated to a
   # rep in a `:rep has_many :office_locations` relationship.
   class OfficeLocation < ResponseObject
+    lr_scope :capitol, -> { where office_type: 'capitol' }
+    lr_scope :district, -> { where office_type: 'district' }
+
     lr_attr_accessor :self,
                      :city,
                      :rep,
@@ -28,8 +31,5 @@ module PYR
                      :v_card_link,
                      :downloads,
                      :qr_code_link
-
-    lr_scope :capitol, -> { where office_type: 'capitol' }
-    lr_scope :district, -> { where office_type: 'district' }
   end
 end

data/lib/pyr/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
-module PYR
-  VERSION = '0.1.0'
+module PYR # :nodoc:
+  VERSION = '0.2.0'
 end

data/pyr.gemspec

@@ -20,10 +20,6 @@ Gem::Specification.new do |spec|
   spec.homepage      = 'https://www.github.com/msimonborg/pyr'
   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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pyr
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - M. Simon Borg
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-04-10 00:00:00.000000000 Z
+date: 2017-04-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty