rest-man 1.0.0 → 1.1.0

data/lib/restman/resource.rb

@@ -1,38 +1,5 @@
 module RestMan
-  # A class that can be instantiated for access to a RESTful resource,
-  # including authentication.
-  #
-  # Example:
-  #
-  #   resource = RestMan::Resource.new('http://some/resource')
-  #   jpg = resource.get(:accept => 'image/jpg')
-  #
-  # With HTTP basic authentication:
-  #
-  #   resource = RestMan::Resource.new('http://protected/resource', :user => 'user', :password => 'password')
-  #   resource.delete
-  #
-  # With a timeout (seconds):
-  #
-  #   RestMan::Resource.new('http://slow', :read_timeout => 10)
-  #
-  # With an open timeout (seconds):
-  #
-  #   RestMan::Resource.new('http://behindfirewall', :open_timeout => 10)
-  #
-  # You can also use resources to share common headers. For headers keys,
-  # symbols are converted to strings. Example:
-  #
-  #   resource = RestMan::Resource.new('http://some/resource', :headers => { :client_version => 1 })
-  #
-  # This header will be transported as X-Client-Version (notice the X prefix,
-  # capitalization and hyphens)
-  #
-  # Use the [] syntax to allocate subresources:
-  #
-  #   site = RestMan::Resource.new('http://example.com', :user => 'adam', :password => 'mypasswd')
-  #   site['posts/1/comments'].post 'Good article.', :content_type => 'text/plain'
-  #
+  # :include: _doc/lib/restman/resource.rdoc
   class Resource
     attr_reader :url, :options, :block
 
@@ -131,32 +98,7 @@ module RestMan
       options[:log] || RestMan.log
     end
 
-    # Construct a subresource, preserving authentication.
-    #
-    # Example:
-    #
-    #   site = RestMan::Resource.new('http://example.com', 'adam', 'mypasswd')
-    #   site['posts/1/comments'].post 'Good article.', :content_type => 'text/plain'
-    #
-    # This is especially useful if you wish to define your site in one place and
-    # call it in multiple locations:
-    #
-    #   def orders
-    #     RestMan::Resource.new('http://example.com/orders', 'admin', 'mypasswd')
-    #   end
-    #
-    #   orders.get                     # GET http://example.com/orders
-    #   orders['1'].get                # GET http://example.com/orders/1
-    #   orders['1/items'].delete       # DELETE http://example.com/orders/1/items
-    #
-    # Nest resources as far as you want:
-    #
-    #   site = RestMan::Resource.new('http://example.com')
-    #   posts = site['posts']
-    #   first_post = posts['1']
-    #   comments = first_post['comments']
-    #   comments.post 'Hello', :content_type => 'text/plain'
-    #
+    # :include: _doc/lib/restman/resource/[].rdoc
     def [](suburl, &new_block)
       case
       when block_given? then self.class.new(concat_urls(url, suburl), options, &new_block)

data/lib/restman/response.rb

@@ -6,13 +6,7 @@ module RestMan
 
     include AbstractResponse
 
-    # Return the HTTP response body.
-    #
-    # Future versions of RestMan will deprecate treating response objects
-    # directly as strings, so it will be necessary to call `.body`.
-    #
-    # @return [String]
-    #
+    # :include: _doc/lib/restman/response/body.rdoc
     def body
       # Benchmarking suggests that "#{self}" is fastest, and that caching the
       # body string in an instance variable doesn't make it enough faster to be
@@ -21,15 +15,11 @@ module RestMan
     end
 
     # Convert the HTTP response body to a pure String object.
-    #
-    # @return [String]
     def to_s
       body
     end
 
     # Convert the HTTP response body to a pure String object.
-    #
-    # @return [String]
     def to_str
       body
     end
@@ -38,14 +28,7 @@ module RestMan
       "<RestMan::Response #{code.inspect} #{body_truncated(10).inspect}>"
     end
 
-    # Initialize a Response object. Because RestMan::Response is
-    # (unfortunately) a subclass of String for historical reasons,
-    # Response.create is the preferred initializer.
-    #
-    # @param [String, nil] body The response body from the Net::HTTPResponse
-    # @param [Net::HTTPResponse] net_http_res
-    # @param [RestMan::Request] request
-    # @param [Time] start_time
+    # :include: _doc/lib/restman/response/create.rdoc
     def self.create(body, net_http_res, request, start_time=nil)
       result = self.new(body || '')
 
@@ -55,8 +38,7 @@ module RestMan
       result
     end
 
-    # Set the String encoding according to the 'Content-Type: charset' header,
-    # if possible.
+    # :include: _doc/lib/restman/response/fix_encoding.rdoc
     def self.fix_encoding(response)
       charset = RestMan::Utils.get_encoding_from_headers(response.headers)
       encoding = nil

data/lib/restman/statuses.rb

@@ -0,0 +1,75 @@
+module RestMan
+
+  # :include: _doc/lib/restman/statuses.rdoc
+  STATUSES = {
+    100 => 'Continue',
+    101 => 'Switching Protocols',
+    102 => 'Processing', #WebDAV
+
+    200 => 'OK',
+    201 => 'Created',
+    202 => 'Accepted',
+    203 => 'Non-Authoritative Information', # http/1.1
+    204 => 'No Content',
+    205 => 'Reset Content',
+    206 => 'Partial Content',
+    207 => 'Multi-Status', #WebDAV
+    208 => 'Already Reported', # RFC5842
+    226 => 'IM Used', # RFC3229
+
+    300 => 'Multiple Choices',
+    301 => 'Moved Permanently',
+    302 => 'Found',
+    303 => 'See Other', # http/1.1
+    304 => 'Not Modified',
+    305 => 'Use Proxy', # http/1.1
+    306 => 'Switch Proxy', # no longer used
+    307 => 'Temporary Redirect', # http/1.1
+    308 => 'Permanent Redirect', # RFC7538
+
+    400 => 'Bad Request',
+    401 => 'Unauthorized',
+    402 => 'Payment Required',
+    403 => 'Forbidden',
+    404 => 'Not Found',
+    405 => 'Method Not Allowed',
+    406 => 'Not Acceptable',
+    407 => 'Proxy Authentication Required',
+    408 => 'Request Timeout',
+    409 => 'Conflict',
+    410 => 'Gone',
+    411 => 'Length Required',
+    412 => 'Precondition Failed',
+    413 => 'Payload Too Large', # RFC7231 (renamed, see below)
+    414 => 'URI Too Long', # RFC7231 (renamed, see below)
+    415 => 'Unsupported Media Type',
+    416 => 'Range Not Satisfiable', # RFC7233 (renamed, see below)
+    417 => 'Expectation Failed',
+    418 => 'I\'m A Teapot', #RFC2324
+    421 => 'Too Many Connections From This IP',
+    422 => 'Unprocessable Entity', #WebDAV
+    423 => 'Locked', #WebDAV
+    424 => 'Failed Dependency', #WebDAV
+    425 => 'Unordered Collection', #WebDAV
+    426 => 'Upgrade Required',
+    428 => 'Precondition Required', #RFC6585
+    429 => 'Too Many Requests', #RFC6585
+    431 => 'Request Header Fields Too Large', #RFC6585
+    449 => 'Retry With', #Microsoft
+    450 => 'Blocked By Windows Parental Controls', #Microsoft
+
+    500 => 'Internal Server Error',
+    501 => 'Not Implemented',
+    502 => 'Bad Gateway',
+    503 => 'Service Unavailable',
+    504 => 'Gateway Timeout',
+    505 => 'HTTP Version Not Supported',
+    506 => 'Variant Also Negotiates',
+    507 => 'Insufficient Storage', #WebDAV
+    508 => 'Loop Detected', # RFC5842
+    509 => 'Bandwidth Limit Exceeded', #Apache
+    510 => 'Not Extended',
+    511 => 'Network Authentication Required', # RFC6585
+  }
+
+end

data/lib/restman/statuses_compatibility.rb

@@ -0,0 +1,18 @@
+module RestMan
+
+  STATUSES_COMPATIBILITY = {
+    # The RFCs all specify "Not Found", but "Resource Not Found" was used in
+    # earlier RestMan releases.
+    404 => ['ResourceNotFound'],
+
+    # HTTP 413 was renamed to "Payload Too Large" in RFC7231.
+    413 => ['RequestEntityTooLarge'],
+
+    # HTTP 414 was renamed to "URI Too Long" in RFC7231.
+    414 => ['RequestURITooLong'],
+
+    # HTTP 416 was renamed to "Range Not Satisfiable" in RFC7233.
+    416 => ['RequestedRangeNotSatisfiable'],
+  }
+
+end

data/lib/restman/utils.rb

@@ -4,55 +4,21 @@ module RestMan
   # Various utility methods
   module Utils
 
-    # Return encoding from an HTTP header hash.
-    #
-    # We use the RFC 7231 specification and do not impose a default encoding on
-    # text. This differs from the older RFC 2616 behavior, which specifies
-    # using ISO-8859-1 for text/* content types without a charset.
-    #
-    # Strings will use the default encoding when this method returns nil. This
-    # default is likely to be UTF-8 for Ruby >= 2.0
-    #
-    # @param headers [Hash<Symbol,String>]
-    #
-    # @return [String, nil] Return the string encoding or nil if no header is
-    #   found.
-    #
-    # @example
-    #   >> get_encoding_from_headers({:content_type => 'text/plain; charset=UTF-8'})
-    #   => "UTF-8"
-    #
+    # :include: _doc/lib/restman/utils/get_encoding_from_headers.rdoc
     def self.get_encoding_from_headers(headers)
       type_header = headers[:content_type]
       return nil unless type_header
 
-      # TODO: remove this hack once we drop support for Ruby 2.0
-      if RUBY_VERSION.start_with?('2.0')
-        _content_type, params = deprecated_cgi_parse_header(type_header)
-
-        if params.include?('charset')
-          return params.fetch('charset').gsub(/(\A["']*)|(["']*\z)/, '')
-        end
-
+      begin
+        _content_type, params = cgi_parse_header(type_header)
+      rescue HTTP::Accept::ParseError
+        return nil
       else
-
-        begin
-          _content_type, params = cgi_parse_header(type_header)
-        rescue HTTP::Accept::ParseError
-          return nil
-        else
-          params['charset']
-        end
+        params['charset']
       end
     end
 
-    # Parse a Content-Type like header.
-    #
-    # Return the main content-type and a hash of params.
-    #
-    # @param [String] line
-    # @return [Array(String, Hash)]
-    #
+    # :include: _doc/lib/restman/utils/cgi_parse_header.rdoc
     def self.cgi_parse_header(line)
       types = HTTP::Accept::MediaTypes.parse(line)
 
@@ -63,165 +29,12 @@ module RestMan
       [types.first.mime_type, types.first.parameters]
     end
 
-    # Parse semi-colon separated, potentially quoted header string iteratively.
-    #
-    # @private
-    #
-    # @deprecated This method is deprecated and only exists to support Ruby
-    #   2.0, which is not supported by HTTP::Accept.
-    #
-    # @todo remove this method when dropping support for Ruby 2.0
-    #
-    def self._cgi_parseparam(s)
-      return enum_for(__method__, s) unless block_given?
-
-      while s[0] == ';'
-        s = s[1..-1]
-        ends = s.index(';')
-        while ends && ends > 0 \
-              && (s[0...ends].count('"') -
-                  s[0...ends].scan('\"').count) % 2 != 0
-          ends = s.index(';', ends + 1)
-        end
-        if ends.nil?
-          ends = s.length
-        end
-        f = s[0...ends]
-        yield f.strip
-        s = s[ends..-1]
-      end
-      nil
-    end
-
-    # Parse a Content-Type like header.
-    #
-    # Return the main content-type and a hash of options.
-    #
-    # This method was ported directly from Python's cgi.parse_header(). It
-    # probably doesn't read or perform particularly well in ruby.
-    # https://github.com/python/cpython/blob/3.4/Lib/cgi.py#L301-L331
-    #
-    # @param [String] line
-    # @return [Array(String, Hash)]
-    #
-    # @deprecated This method is deprecated and only exists to support Ruby
-    #   2.0, which is not supported by HTTP::Accept.
-    #
-    # @todo remove this method when dropping support for Ruby 2.0
-    #
-    def self.deprecated_cgi_parse_header(line)
-      parts = _cgi_parseparam(';' + line)
-      key = parts.next
-      pdict = {}
-
-      begin
-        while (p = parts.next)
-          i = p.index('=')
-          if i
-            name = p[0...i].strip.downcase
-            value = p[i+1..-1].strip
-            if value.length >= 2 && value[0] == '"' && value[-1] == '"'
-              value = value[1...-1]
-              value = value.gsub('\\\\', '\\').gsub('\\"', '"')
-            end
-            pdict[name] = value
-          end
-        end
-      rescue StopIteration
-      end
-
-      [key, pdict]
-    end
-
-    # Serialize a ruby object into HTTP query string parameters.
-    #
-    # There is no standard for doing this, so we choose our own slightly
-    # idiosyncratic format. The output closely matches the format understood by
-    # Rails, Rack, and PHP.
-    #
-    # If you don't want handling of complex objects and only want to handle
-    # simple flat hashes, you may want to use `URI.encode_www_form` instead,
-    # which implements HTML5-compliant URL encoded form data.
-    #
-    # @param [Hash,ParamsArray] object The object to serialize
-    #
-    # @return [String] A string appropriate for use as an HTTP query string
-    #
-    # @see {flatten_params}
-    #
-    # @see URI.encode_www_form
-    #
-    # @see See also Object#to_query in ActiveSupport
-    # @see http://php.net/manual/en/function.http-build-query.php
-    #   http_build_query in PHP
-    # @see See also Rack::Utils.build_nested_query in Rack
-    #
-    # Notable differences from the ActiveSupport implementation:
-    #
-    # - Empty hash and empty array are treated the same as nil instead of being
-    #   omitted entirely from the output. Rather than disappearing, they will
-    #   appear to be nil instead.
-    #
-    # It's most common to pass a Hash as the object to serialize, but you can
-    # also use a ParamsArray if you want to be able to pass the same key with
-    # multiple values and not use the rack/rails array convention.
-    #
-    # @since 2.0.0
-    #
-    # @example Simple hashes
-    #   >> encode_query_string({foo: 123, bar: 456})
-    #   => 'foo=123&bar=456'
-    #
-    # @example Simple arrays
-    #   >> encode_query_string({foo: [1,2,3]})
-    #   => 'foo[]=1&foo[]=2&foo[]=3'
-    #
-    # @example Nested hashes
-    #   >> encode_query_string({outer: {foo: 123, bar: 456}})
-    #   => 'outer[foo]=123&outer[bar]=456'
-    #
-    # @example Deeply nesting
-    #   >> encode_query_string({coords: [{x: 1, y: 0}, {x: 2}, {x: 3}]})
-    #   => 'coords[][x]=1&coords[][y]=0&coords[][x]=2&coords[][x]=3'
-    #
-    # @example Null and empty values
-    #   >> encode_query_string({string: '', empty: nil, list: [], hash: {}})
-    #   => 'string=&empty&list&hash'
-    #
-    # @example Nested nulls
-    #   >> encode_query_string({foo: {string: '', empty: nil}})
-    #   => 'foo[string]=&foo[empty]'
-    #
-    # @example Multiple fields with the same name using ParamsArray
-    #   >> encode_query_string(RestMan::ParamsArray.new([[:foo, 1], [:foo, 2], [:foo, 3]]))
-    #   => 'foo=1&foo=2&foo=3'
-    #
-    # @example Nested ParamsArray
-    #   >> encode_query_string({foo: RestMan::ParamsArray.new([[:a, 1], [:a, 2]])})
-    #   => 'foo[a]=1&foo[a]=2'
-    #
-    #   >> encode_query_string(RestMan::ParamsArray.new([[:foo, {a: 1}], [:foo, {a: 2}]]))
-    #   => 'foo[a]=1&foo[a]=2'
-    #
+    # :include: _doc/lib/restman/utils/encode_query_string.rdoc
     def self.encode_query_string(object)
       flatten_params(object, true).map {|k, v| v.nil? ? k : "#{k}=#{v}" }.join('&')
     end
 
-    # Transform deeply nested param containers into a flat array of [key,
-    # value] pairs.
-    #
-    # @example
-    #   >> flatten_params({key1: {key2: 123}})
-    #   => [["key1[key2]", 123]]
-    #
-    # @example
-    #   >> flatten_params({key1: {key2: 123, arr: [1,2,3]}})
-    #   => [["key1[key2]", 123], ["key1[arr][]", 1], ["key1[arr][]", 2], ["key1[arr][]", 3]]
-    #
-    # @param object [Hash, ParamsArray] The container to flatten
-    # @param uri_escape [Boolean] Whether to URI escape keys and values
-    # @param parent_key [String] Should not be passed (used for recursion)
-    #
+    # :include: _doc/lib/restman/utils/flatten_params.rdoc
     def self.flatten_params(object, uri_escape=false, parent_key=nil)
       unless object.is_a?(Hash) || object.is_a?(ParamsArray) ||
              (parent_key && object.is_a?(Array))
@@ -257,16 +70,7 @@ module RestMan
       }
     end
 
-    # Encode string for safe transport by URI or form encoding. This uses a CGI
-    # style escape, which transforms ` ` into `+` and various special
-    # characters into percent encoded forms.
-    #
-    # This calls URI.encode_www_form_component for the implementation. The only
-    # difference between this and CGI.escape is that it does not escape `*`.
-    # http://stackoverflow.com/questions/25085992/
-    #
-    # @see URI.encode_www_form_component
-    #
+    # :include: _doc/lib/restman/utils/escape.rdoc
     def self.escape(string)
       URI.encode_www_form_component(string)
     end

data/lib/restman/version.rb

@@ -1,5 +1,5 @@
 module RestMan
-  VERSION_INFO = [1, 0, 0].freeze
+  VERSION_INFO = [1, 1, 0].freeze
   VERSION = VERSION_INFO.map(&:to_s).join('.').freeze
 
   def self.version

data/lib/restman.rb

@@ -2,64 +2,35 @@ require 'net/http'
 require 'openssl'
 require 'stringio'
 require 'uri'
+require 'active_method'
 
 require File.dirname(__FILE__) + '/restman/version'
+require File.dirname(__FILE__) + '/restman/statuses'
+require File.dirname(__FILE__) + '/restman/statuses_compatibility'
 require File.dirname(__FILE__) + '/restman/platform'
-require File.dirname(__FILE__) + '/restman/exceptions'
+require File.dirname(__FILE__) + '/restman/exception'
+require File.dirname(__FILE__) + '/restman/exceptions/exception_with_response'
+require File.dirname(__FILE__) + '/restman/exceptions/request_failed'
+require File.dirname(__FILE__) + '/restman/exceptions/exceptions_map'
+require File.dirname(__FILE__) + '/restman/exceptions/timeout'
+require File.dirname(__FILE__) + '/restman/exceptions/server_broke_connection'
 require File.dirname(__FILE__) + '/restman/utils'
+require File.dirname(__FILE__) + '/restman/request/init'
+require File.dirname(__FILE__) + '/restman/request/transmit'
 require File.dirname(__FILE__) + '/restman/request'
 require File.dirname(__FILE__) + '/restman/abstract_response'
 require File.dirname(__FILE__) + '/restman/response'
 require File.dirname(__FILE__) + '/restman/raw_response'
 require File.dirname(__FILE__) + '/restman/resource'
 require File.dirname(__FILE__) + '/restman/params_array'
+require File.dirname(__FILE__) + '/restman/params_array/process_pair'
 require File.dirname(__FILE__) + '/restman/payload'
-require File.dirname(__FILE__) + '/restman/windows'
-
-# This module's static methods are the entry point for using the REST client.
-#
-#   # GET
-#   xml = RestMan.get 'http://example.com/resource'
-#   jpg = RestMan.get 'http://example.com/resource', :accept => 'image/jpg'
-#
-#   # authentication and SSL
-#   RestMan.get 'https://user:password@example.com/private/resource'
-#
-#   # POST or PUT with a hash sends parameters as a urlencoded form body
-#   RestMan.post 'http://example.com/resource', :param1 => 'one'
-#
-#   # nest hash parameters
-#   RestMan.post 'http://example.com/resource', :nested => { :param1 => 'one' }
-#
-#   # POST and PUT with raw payloads
-#   RestMan.post 'http://example.com/resource', 'the post body', :content_type => 'text/plain'
-#   RestMan.post 'http://example.com/resource.xml', xml_doc
-#   RestMan.put 'http://example.com/resource.pdf', File.read('my.pdf'), :content_type => 'application/pdf'
-#
-#   # DELETE
-#   RestMan.delete 'http://example.com/resource'
-#
-#   # retrieve the response http code and headers
-#   res = RestMan.get 'http://example.com/some.jpg'
-#   res.code                    # => 200
-#   res.headers[:content_type]  # => 'image/jpg'
-#
-#   # HEAD
-#   RestMan.head('http://example.com').headers
-#
-# To use with a proxy, just set RestMan.proxy to the proper http proxy:
-#
-#   RestMan.proxy = "http://proxy.example.com/"
-#
-# Or inherit the proxy from the environment:
-#
-#   RestMan.proxy = ENV['http_proxy']
-#
-# For live tests of RestMan, try using http://rest-test.heroku.com, which echoes back information about the rest call:
-#
-#   >> RestMan.put 'http://rest-test.heroku.com/resource', :foo => 'baz'
-#   => "PUT http://rest-test.heroku.com/resource with a 7 byte payload, content type application/x-www-form-urlencoded {\"foo\"=>\"baz\"}"
-#
+require File.dirname(__FILE__) + '/restman/payload/base'
+require File.dirname(__FILE__) + '/restman/payload/multipart'
+require File.dirname(__FILE__) + '/restman/payload/streamed'
+require File.dirname(__FILE__) + '/restman/payload/url_encoded'
+
+# :include: _doc/lib/restman.rdoc
 module RestMan
 
   def self.get(url, headers={}, &block)
@@ -90,8 +61,7 @@ module RestMan
     Request.execute(:method => :options, :url => url, :headers => headers, &block)
   end
 
-  # A global proxy URL to use for all requests. This can be overridden on a
-  # per-request basis by passing `:proxy` to RestMan::Request.
+  # :include: _doc/lib/restman/proxy.rdoc
   def self.proxy
     @proxy ||= nil
   end
@@ -101,24 +71,17 @@ module RestMan
     @proxy_set = true
   end
 
-  # Return whether RestMan.proxy was set explicitly. We use this to
-  # differentiate between no value being set and a value explicitly set to nil.
-  #
-  # @return [Boolean]
-  #
+  # :include: _doc/lib/restman/proxy_set?.rdoc
   def self.proxy_set?
     @proxy_set ||= false
   end
 
-  # Setup the log for RestMan calls.
-  # Value should be a logger but can can be stdout, stderr, or a filename.
-  # You can also configure logging by the environment variable RESTCLIENT_LOG.
+  # :include: _doc/lib/restman/log=.rdoc
   def self.log= log
     @@log = create_log log
   end
 
-  # Create a log that respond to << like a logger
-  # param can be 'stdout', 'stderr', a string (then we will log to that file) or a logger (then we return it)
+  # :include: _doc/lib/restman/create_log.rdoc
   def self.create_log param
     if param
       if param.is_a? String
@@ -164,14 +127,13 @@ module RestMan
 
   @@before_execution_procs = []
 
-  # Add a Proc to be called before each request in executed.
-  # The proc parameters will be the http request and the request params.
+  # :include: _doc/lib/restman/add_before_execution_proc.rdoc
   def self.add_before_execution_proc &proc
     raise ArgumentError.new('block is required') unless proc
     @@before_execution_procs << proc
   end
 
-  # Reset the procs to be called before each request is executed.
+  # :include: _doc/lib/restman/reset_before_execution_procs.rdoc
   def self.reset_before_execution_procs
     @@before_execution_procs = []
   end

data/matrixeval.yml

@@ -4,6 +4,8 @@ project_name: rest_man
 parallel_workers: number_of_processors
 commands:
   - jruby
+  - rubycritic
+  - rdoc
 #   - ps
 #   - top
 #   - an_additional_command
@@ -12,16 +14,25 @@ commands:
 matrix:
   ruby:
     variants:
+      - key: 2.6
+        container:
+          image: ruby:2.6.10
       - key: 2.7
         container:
           image: ruby:2.7.6
       - key: 3.0
-        default: true
         container:
           image: ruby:3.0.4
       - key: 3.1
         container:
           image: ruby:3.1.0
+      - key: 3.2
+        default: true
+        container:
+          image: ruby:3.2.2
+      - key: 3.3
+        container:
+          image: ruby:3.3.0-preview1
       - key: jruby-9.3
         container:
           image: hoppergee/jruby:9.3.7-dev
@@ -29,6 +40,13 @@ matrix:
             PATH: "/opt/jruby/bin:/app/bin:/bundle/bin:$PATH"
             JRUBY_OPTS: "--dev -X-C --debug"
             JAVA_OPTS: "-client -XX:+TieredCompilation -XX:TieredStopAtLevel=1"
+      - key: jruby-9.4
+        container:
+          image: hoppergee/jruby:9.4.2-dev
+        env:
+            PATH: "/opt/jruby/bin:/app/bin:/bundle/bin:$PATH"
+            JRUBY_OPTS: "--dev -X-C --debug"
+            JAVA_OPTS: "-client -XX:+TieredCompilation -XX:TieredStopAtLevel=1"
       #   mounts:
       #     - /a/path/need/to/mount:/a/path/mount/to