wrest 0.0.9 → 0.1.0

data/examples/delicious.rb

@@ -12,10 +12,14 @@ require 'pp'
 
 Wrest.logger = Logger.new(STDOUT)
 Wrest.logger.level = Logger::DEBUG  # Set this to Logger::INFO or higher to disable request logging
+# Wrest.use_curl
 
 # This example demonstrates the usage of GET, POST, PUT and
 # DELETE over HTTPS. Its also shows how Wrest::Uris can have
-# paths extended making accessing an API easy as pie.
+# paths extended making accessing an API easy as pie. 
+#
+# Do remember to change the username and password on line 47
+# before running this example.
 #
 # API reference: http://delicious.com/help/api
 class Delicious
@@ -32,7 +36,7 @@ class Delicious
   end
   
   def bookmark(parameters)
-    @uri['/add'].post('', {}, parameters)
+    @uri['/add'].post_form(parameters)
   end
   
   def delete(parameters)
@@ -42,6 +46,8 @@ end
 
 account = Delicious.new :username => 'kaiwren', :password => 'fupupp1es'
 
+puts '*'*20 + "Creating bookmark tagged Rails" + '*'*20
+
 pp account.bookmark(
     :url => 'http://blog.sidu.in/search/label/ruby',
     :description => 'The Ruby related posts on my blog!',
@@ -49,14 +55,18 @@ pp account.bookmark(
     :tags => 'ruby hacking'
   ).deserialise
   
-puts '', '*'*70, ''
+puts '*'*20 + "Listing bookmarks tagged Rails on a certain date" + '*'*20
 
 pp account.bookmarks(:tag => 'rails', :dt => '20090712').deserialise
 
-puts '', '*'*70, ''
+puts '*'*20 + "Listing recent bookmarks" + '*'*20
+
+pp account.recent(:tag => 'ruby').deserialise["posts"]["post"].collect{|bookmark| bookmark['href']}
+
+puts '*'*20 + "Deleting the bookmark we just created" + '*'*20
 
-pp recently_saved_uris = account.recent(:tag => 'ruby').deserialise["posts"]["post"].collect{|bookmark| bookmark['href']}
+pp account.delete(:url => 'http://blog.sidu.in/search/label/ruby').deserialise
 
-puts '', '*'*70, ''
+puts '*'*20 + "Listing recent bookmarks" + '*'*20
 
-pp account.delete(:url => 'http://blog.sidu.in/search/label/ruby').deserialise
+pp account.recent(:tag => 'ruby').deserialise["posts"]["post"].collect{|bookmark| bookmark['href']}

data/examples/facebook.rb

@@ -0,0 +1,101 @@
+# Copyright 2009 Sidu Ponnappa
+
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
+# Unless required by applicable law or agreed to in writing, software distributed under the License
+# is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and limitations under the License.
+
+require File.expand_path(File.dirname(__FILE__) + "/../lib/wrest")
+require 'digest/md5'
+
+Wrest.logger = Logger.new(STDOUT)
+Wrest.logger.level = Logger::DEBUG  # Set this to Logger::INFO or higher to disable request logging
+# Wrest.use_curl
+
+include Wrest
+
+# This example demonstrates fetching a Facebook user's public profile
+# given his or her Facebook UID. It also shows how strings in the 
+# deserialised response can be easily converted into other objects 
+# using Wrest's typecast feature.
+
+module Facebook
+  # This key and secret are both fake. To get your own key and secret, create a
+  # Facebook application at http://www.facebook.com/developers/apps.php
+  Config ={
+    :key => '8be7dc2e480d8bf21a58915bad8c362e',
+    :secret => '1a4638b19c393b540fda796f936a25d4',
+    :restserver => 'http://api.facebook.com/restserver.php'
+  }
+    
+  module API
+    Defaults = {
+      'v' => '1.0',
+      'format' => 'XML',
+      'api_key' => Config[:key]
+    }
+    
+    def self.signature_for(params)
+      # http://wiki.developers.facebook.com/index.php/How_Facebook_Authenticates_Your_Application
+      request_str = params.keys.sort.map{|k| "#{k}=#{params[k]}" }.join
+      Digest::MD5.hexdigest(request_str + Config[:secret])
+    end
+    
+    def self.invoke(args)
+      args = API::Defaults.merge(args)
+      Config[:restserver].to_uri.post_form(args.merge('sig' => Facebook::API.signature_for(args))).deserialise
+    end
+  end
+  
+  class Profile
+    include Components::Container
+    typecast  :uid        => as_integer,
+              :pic_square => lambda{|pic_square| pic_square.to_uri}
+
+    Fields = %w(
+      uid
+      first_name
+      last_name
+      name
+      pic_square
+    ).join(', ')
+    
+    def self.find(fcbk_uid)
+      hash = Facebook::API.invoke({
+        'method' => 'facebook.users.getInfo', 
+        'fields' => Profile::Fields,
+        'uids' => fcbk_uid
+      })
+      
+      if hash['error_response']
+        Facebook::Error.new hash['error_response']
+      else
+        self.new hash["users_getInfo_response"]["user"]
+      end
+    end
+  end
+  
+  class Error
+    include Components::Container
+    typecast :error_code => as_integer
+  end
+end
+
+puts 'Fetching public profile for Facebook user 699497090.' 
+puts 'Note that we use Wrest\'s typecast feature to convert the uid and pic_square fields in the case of a valid result, and the error_msg and error_code fields in the case of an Error to appropriate types from simple strings.'
+puts
+
+profile = Facebook::Profile.find('699497090')
+
+puts "Field\t\t\tData\t\t\tClass"
+
+if profile.is_a? Facebook::Error
+  puts "Error\t\t\t#{profile.error_msg}\t\t\t#{profile.error_msg.class}"
+  puts "Code\t\t\t#{profile.error_code}\t\t\t#{profile.error_code.class}"
+else
+  puts "UID\t\t\t#{profile.uid}\t\t\t#{profile.uid.class}"
+  puts "Name\t\t\t#{profile.first_name}\t\t\t#{profile.first_name.class}"
+  puts "Pic Url\t\t\t#{profile.pic_square}\t\t\t#{profile.pic_square.class}"
+end  

data/examples/keep_alive.rb

@@ -0,0 +1,37 @@
+# Copyright 2009 Sidu Ponnappa
+
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
+# Unless required by applicable law or agreed to in writing, software distributed under the License
+# is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and limitations under the License.
+
+require File.expand_path(File.dirname(__FILE__) + "/../lib/wrest")
+require 'pp'
+
+Wrest.logger = Logger.new(STDOUT)
+Wrest.logger.level = Logger::DEBUG  # Set this to Logger::INFO or higher to disable request logging
+include Wrest
+
+
+# This is a basic example demonstrating using keep-alive connections.
+# Observe the requests logs - they will look something like this:
+# --> (GET 12207030 12546830) http://github.com:80/api/v1/json/kaiwren
+#
+# The second number after the GET is a hash identifying the connection used.
+# You will notice that all requests have the same hash therefore use the same connection.
+
+Http::Session.new('http://github.com/api/v1/json') do |s|
+  puts "Response Connection Header - a response token of 'Keep-Alive' indicates that the server has created a keep-alive connection"
+  puts
+  puts s.get('/kaiwren')['Connection']
+  puts s.get('/niranjan')['Connection']
+  
+  puts
+  puts '*' * 10
+  puts
+  
+  pp s.get('/kaiwren').deserialise
+  pp s.get('/niranjan').deserialise
+end

data/examples/twitter.rb

@@ -31,7 +31,7 @@ class Twitter
   end
   
   def post(text)
-    Tweet.new @uri['/statuses/update.json'].post('', {'User-Agent' => "Wrest/#{Wrest::VERSION::STRING}"}, {:status => text}).deserialise
+    Tweet.new @uri['/statuses/update.json'].post('', {'User-Agent' => "Wrest/#{Wrest::VERSION::STRING}"}, :status => text).deserialise
   end  
 end
 
@@ -40,7 +40,7 @@ class TwitterUser
   # for the deserialised data from a response.
   #
   # All the keys in the hash are exposed as methods.
-  include Wrest::Components::AttributesContainer
+  include Wrest::Components::Container
 
   # We'd prefer the user's profile url to be
   # a Wrest::Uri rather than a String, wouldn't we?
@@ -52,7 +52,7 @@ class TwitterUser
 end
 
 class Tweet
-  include Wrest::Components::AttributesContainer
+  include Wrest::Components::Container
 
   typecast  :user => lambda{|user| TwitterUser.new(user) }
 end

data/examples/twitter_public_timeline.rb

@@ -13,13 +13,20 @@ require 'pp'
 Wrest.logger = Logger.new(STDOUT)
 Wrest.logger.level = Logger::DEBUG  # Set this to Logger::INFO or higher to disable request logging
 
+# Optionally uncomment the following line to use the significantly faster libcurl library.
+# This uses the patron gem - (sudo) gem install patron
+# IMPORTANT: Libcurl support is currently in alpha and is both incomplete and unstable!
+# Wrest.use_curl
 
-# This is a basic example demonstrating GET and json deserialisation.
+# This is a basic example demonstrating GET and json deserialisation. The timeout field is optional, of course (it defaults to 60), but you can reduce it to a low number like 1 to force the request to timeout.
 
-response = 'http://twitter.com/statuses/public_timeline.json'.to_uri.get
+response = 'http://twitter.com/statuses/public_timeline.json'.to_uri(:timeout => 5).get
 
 puts "Code: #{response.code}"
 puts "Message: #{response.message}"
 puts "Headers: #{response.headers.inspect}"
-puts "Body: #{response.body.inspect}"
-puts "Deserialised: #{response.deserialise.inspect}"
+puts
+puts "Deserialised Body: #{response.deserialise.inspect}"
+puts '*' * 50
+puts '*' * 50
+puts "Body: #{response.body.inspect}"

data/examples/wow_realm_status.rb

@@ -12,10 +12,16 @@ require File.expand_path(File.dirname(__FILE__) + "/../lib/wrest")
 Wrest.logger = Logger.new(STDOUT)
 Wrest.logger.level = Logger::DEBUG  # Set this to Logger::INFO or higher to disable request logging
 
+# Optionally uncomment the following line to use the significantly faster libcurl library.
+# This uses the patron gem - (sudo) gem install patron
+# IMPORTANT: Libcurl support is currently in alpha and is both incomplete and unstable!
+# Wrest.use_curl
+
+
 include Wrest
 
 class Realm
-  include Components::AttributesContainer
+  include Components::Container
 
   typecast  :t => lambda{|type| 
                     case type
@@ -54,7 +60,7 @@ realms = "http://www.worldofwarcraft.com/realmstatus/status.xml".to_uri.get.dese
 
 puts "Status of Nagrand: #{realms.find{|realm| realm.name == 'Nagrand'}.status}"
 puts
-puts "All Available Realms:"
+puts "Listing All Available Realms:"
 puts
 puts "Realm\tLoad\tType"
 puts "-----------"

data/lib/wrest/components/{attributes_container → container}/alias_accessors.rb

@@ -8,7 +8,7 @@
 # See the License for the specific language governing permissions and limitations under the License.
 
 module Wrest
-  module Components::AttributesContainer
+  module Components::Container
     module AliasAccessors
       def self.included(klass) #:nodoc:
         klass.extend AliasAccessors::ClassMethods
@@ -33,7 +33,7 @@ module Wrest
         # sevice/resource.
         #
         # For example, lets say that a particular resource exposes a
-        # User's age as 'a' and sex as s. Typically, you'd have to access it as
+        # User's age as 'a' and sex as 's'. Typically, you'd have to access it as
         # user.a and user.s whereas you's like to access it as user.age and user.sex.
         # This is where alias_accessors comes into the picture. Your User class would
         # look somethig like this:
@@ -44,8 +44,8 @@ module Wrest
         #    alias_accessors  :a => :age,
         #                     :s => :sex
         #  end
-        # This would create the methods user.age, user.age= and user.age? which delegate
-        # to user.a, user.a= and user.a? respectively. Ditto for s to sex.
+        # This would create the methods user.age, user.age= and user.age? which delegates
+        # to user.a, user.a= and user.a? respectively.
         #
         # See examples/wow_realm_status.rb for a working example.
         # 

data/lib/wrest/components/{attributes_container → container}/typecaster.rb

@@ -8,7 +8,7 @@
 # See the License for the specific language governing permissions and limitations under the License.
 
 module Wrest
-  module Components::AttributesContainer
+  module Components::Container
     # An extension to AttributesContainer that adds support for
     # specifying how the values associated with certain attribute keys
     # should be typecast.

data/lib/wrest/components/{attributes_container.rb → container.rb}

@@ -8,12 +8,12 @@
 # See the License for the specific language governing permissions and limitations under the License.
 
 module Wrest
-  module Components::AttributesContainer
+  module Components::Container
   end
 end
 
-require "#{WREST_ROOT}/wrest/components/attributes_container/typecaster"
-require "#{WREST_ROOT}/wrest/components/attributes_container/alias_accessors"
+require "#{Wrest::Root}/wrest/components/container/typecaster"
+require "#{Wrest::Root}/wrest/components/container/alias_accessors"
 
 module Wrest::Components
 
@@ -55,13 +55,13 @@ module Wrest::Components
   #  coin = ShenCoin.new(:id => '5', :chi_count => 500, :owner => 'Kai Wren')
   #  coin.id    # => 5
   #  coin.owner # => 'Kai Wren'
-  module AttributesContainer
+  module Container
     def self.included(klass) #:nodoc:
-      klass.extend AttributesContainer::ClassMethods
-      klass.extend AttributesContainer::Typecaster::Helpers
+      klass.extend Container::ClassMethods
+      klass.extend Container::Typecaster::Helpers
       klass.class_eval do 
-        include AttributesContainer::InstanceMethods
-        include AttributesContainer::AliasAccessors
+        include Container::InstanceMethods
+        include Container::AliasAccessors
       end  
     end
 
@@ -88,9 +88,9 @@ module Wrest::Components
       def always_has(*attribute_names)
         attribute_names.each do |attribute_name|
           self.class_eval(
-          AttributesContainer.build_attribute_getter(attribute_name) +
-          AttributesContainer.build_attribute_setter(attribute_name) +
-          AttributesContainer.build_attribute_queryer(attribute_name)
+          Container.build_attribute_getter(attribute_name) +
+          Container.build_attribute_setter(attribute_name) +
+          Container.build_attribute_queryer(attribute_name)
           )
         end
       end
@@ -104,9 +104,20 @@ module Wrest::Components
       # Remember that using typecast carries a performance penalty.
       # See Wrest::Components::AttributesContainer::Typecaster for the actual docs.
       def typecast(cast_map)
-        self.class_eval{ include Wrest::Components::AttributesContainer::Typecaster }
+        self.class_eval{ include Wrest::Components::Container::Typecaster }
         self.typecast cast_map
       end
+      
+      # This is the name of the class in snake-case, with any parent
+      # module names removed.
+      #
+      # The class will use as the root element when
+      # serialised to xml after replacing underscores with hyphens.
+      #
+      # This method can be overidden should you need a different name.
+      def element_name
+        @element_name ||= self.name.demodulize.underscore.underscore
+      end
     end
 
     module InstanceMethods
@@ -119,7 +130,26 @@ module Wrest::Components
       def initialize(attributes = {})
         @attributes = attributes.symbolize_keys
       end
-
+      
+      # A translator is a anything that knows how to serialise a
+      # Hash. It must needs have a method named 'serialise' that
+      # accepts a hash and configuration options, and returns the serialised 
+      # result (leaving the hash unchanged, of course).
+      #
+      # Examples for JSON and XML can be found under Wrest::Components::Translators.
+      # These serialised output of these translators will work out of the box for Rails 
+      # applications; you may need to roll your own for anything else.
+      #
+      # Note: When serilising to XML, if you want the name of the class as the name of the root node
+      # then you should use the AttributesContainer#to_xml helper.
+      def serialise_using(translator, options = {})
+        translator.serialise(@attributes, options)
+      end
+      
+      def to_xml(options = {})
+        serialise_using(Wrest::Components::Translators::Xml, {:root => self.class.element_name}.merge(options))
+      end
+      
       def [](key)
         @attributes[key.to_sym]
       end
@@ -140,11 +170,11 @@ module Wrest::Components
         if @attributes.include?(attribute_name.to_sym) || method_name.last == '=' || method_name.last == '?'
           case method_name.last
           when '='
-            self.instance_eval AttributesContainer.build_attribute_setter(attribute_name)
+            self.instance_eval Container.build_attribute_setter(attribute_name)
           when '?'
-            self.instance_eval AttributesContainer.build_attribute_queryer(attribute_name)
+            self.instance_eval Container.build_attribute_queryer(attribute_name)
           else
-            self.instance_eval AttributesContainer.build_attribute_getter(attribute_name)
+            self.instance_eval Container.build_attribute_getter(attribute_name)
           end
           send(method_sym, *arguments)
         else

data/lib/wrest/components/mutators.rb

@@ -33,7 +33,7 @@ module Wrest
   end
 end
 
-require "#{WREST_ROOT}/wrest/components/mutators/base"
-require "#{WREST_ROOT}/wrest/components/mutators/xml_simple_type_caster"
-require "#{WREST_ROOT}/wrest/components/mutators/xml_mini_type_caster"
-require "#{WREST_ROOT}/wrest/components/mutators/camel_to_snake_case"
+require "#{Wrest::Root}/wrest/components/mutators/base"
+require "#{Wrest::Root}/wrest/components/mutators/xml_simple_type_caster"
+require "#{Wrest::Root}/wrest/components/mutators/xml_mini_type_caster"
+require "#{Wrest::Root}/wrest/components/mutators/camel_to_snake_case"

data/lib/wrest/components/translators/json.rb

@@ -17,8 +17,8 @@ module Wrest
         ActiveSupport::JSON.decode(response.body)
       end
 
-      def serialise(hash)
-        ActiveSupport::JSON.encode(hash)
+      def serialise(hash, options = {})
+        hash.to_json(options)
       end
     end
   end

data/lib/wrest/components/translators/xml.rb

@@ -13,10 +13,11 @@ module Wrest
       extend self
 
       def deserialise(response)
-        ActiveSupport::XmlMini.parse(response.body)
+        Hash.from_xml(response.body)
       end
 
-      def serialise(hash)
+      def serialise(hash, options = {})
+        hash.to_xml(options)
       end
     end
   end

data/lib/wrest/components/translators.rb

@@ -23,6 +23,6 @@ module Wrest
   end
 end
 
-require "#{WREST_ROOT}/wrest/components/translators/xml"
-require "#{WREST_ROOT}/wrest/components/translators/json"
-require "#{WREST_ROOT}/wrest/components/translators/content_types"
+require "#{Wrest::Root}/wrest/components/translators/xml"
+require "#{Wrest::Root}/wrest/components/translators/json"
+require "#{Wrest::Root}/wrest/components/translators/content_types"

data/lib/wrest/components.rb

@@ -15,6 +15,6 @@ module Wrest
   end
 end
 
-require "#{WREST_ROOT}/wrest/components/attributes_container"
-require "#{WREST_ROOT}/wrest/components/mutators"
-require "#{WREST_ROOT}/wrest/components/translators"
+require "#{Wrest::Root}/wrest/components/container"
+require "#{Wrest::Root}/wrest/components/mutators"
+require "#{Wrest::Root}/wrest/components/translators"

data/lib/wrest/core_ext/hash.rb

@@ -1,4 +1,4 @@
-require "#{WREST_ROOT}/wrest/core_ext/hash/conversions"
+require "#{Wrest::Root}/wrest/core_ext/hash/conversions"
 
 class Hash #:nodoc:
   include Wrest::CoreExt::Hash::Conversions

data/lib/wrest/core_ext/string.rb

@@ -1,4 +1,4 @@
-require "#{WREST_ROOT}/wrest/core_ext/string/conversions"
+require "#{Wrest::Root}/wrest/core_ext/string/conversions"
 
 class String #:nodoc:
   include Wrest::CoreExt::String::Conversions

data/lib/wrest/curl/delete.rb

@@ -0,0 +1,23 @@
+# Copyright 2009 Sidu Ponnappa
+
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
+# Unless required by applicable law or agreed to in writing, software distributed under the License
+# is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and limitations under the License.
+
+module Wrest::Curl
+  class Delete < Request
+    def initialize(wrest_uri, parameters = {}, headers = {}, options = {})
+      super(
+            wrest_uri, 
+            :delete, 
+            parameters,
+            nil,
+            headers,
+            options
+          )
+    end
+  end
+end

data/lib/wrest/curl/get.rb

@@ -0,0 +1,23 @@
+# Copyright 2009 Sidu Ponnappa
+
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
+# Unless required by applicable law or agreed to in writing, software distributed under the License
+# is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and limitations under the License.
+
+module Wrest::Curl
+  class Get < Request
+    def initialize(wrest_uri, parameters = {}, headers = {}, options = {})
+      super(
+        wrest_uri,
+        :get,
+        parameters,
+        nil,
+        headers,
+        options
+      )
+    end
+  end
+end

data/lib/wrest/curl/options.rb

@@ -0,0 +1,16 @@
+# Copyright 2009 Sidu Ponnappa
+
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
+# Unless required by applicable law or agreed to in writing, software distributed under the License
+# is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and limitations under the License.
+
+module Wrest::Curl
+  class Options < Request
+    def initialize(*args)
+      raise Wrest::Exceptions::UnsupportedHttpVerb, 'Options'
+    end
+  end
+end

data/lib/wrest/curl/post.rb

@@ -0,0 +1,23 @@
+# Copyright 2009 Sidu Ponnappa
+
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
+# Unless required by applicable law or agreed to in writing, software distributed under the License
+# is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and limitations under the License.
+
+module Wrest::Curl
+  class Post < Request
+    def initialize(wrest_uri, body = '', headers = {}, parameters = {}, options = {})
+      super(
+        wrest_uri,
+        :post,
+        parameters,
+        body,
+        headers,
+        options
+      )
+    end
+  end
+end

data/lib/wrest/curl/put.rb

@@ -0,0 +1,23 @@
+# Copyright 2009 Sidu Ponnappa
+
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
+# Unless required by applicable law or agreed to in writing, software distributed under the License
+# is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and limitations under the License.
+
+module Wrest::Curl
+  class Put < Request
+    def initialize(wrest_uri, body = '', headers = {}, parameters = {}, options = {})
+      super(
+        wrest_uri,
+        :put,
+        parameters,
+        body,
+        headers,
+        options
+      )
+    end
+  end
+end