Class: HTTP::Response
- Inherits:
-
Object
- Object
- HTTP::Response
- Extended by:
- Forwardable
- Includes:
- Headers::Mixin
- Defined in:
- lib/http/response.rb,
lib/http/response/body.rb,
lib/http/response/parser.rb,
lib/http/response/status.rb,
lib/http/response/status/reasons.rb
Defined Under Namespace
Constant Summary collapse
- STATUS_CODES =
Deprecated.
Will be removed in 1.0.0 Use Status::REASONS
Status::REASONS
- SYMBOL_TO_STATUS_CODE =
Deprecated.
Will be removed in 1.0.0
Hash[STATUS_CODES.map { |k, v| [v.downcase.gsub(/\s|-/, "_").to_sym, k] }].freeze
Instance Attribute Summary collapse
- #body ⇒ Body readonly
- #status ⇒ Status readonly
- #uri ⇒ URI? readonly
Attributes included from Headers::Mixin
Instance Method Summary collapse
-
#charset ⇒ String?
Charset of response (if any).
-
#code ⇒ Fixnum
(also: #status_code)
Status code.
-
#content_type ⇒ HTTP::ContentType
Parsed Content-Type header.
- #cookies ⇒ Object
-
#flush ⇒ Response
Flushes body and returns self-reference.
-
#initialize(status, version, headers, body, uri = nil) ⇒ Response
constructor
rubocop:disable ParameterLists.
-
#inspect ⇒ Object
Inspect a response.
-
#mime_type ⇒ String?
MIME type of response (if any).
-
#parse(as = nil) ⇒ Object
Parse response body with corresponding MIME type adapter.
- #readpartial ⇒ Object
-
#reason ⇒ String?
Status message.
-
#to_a ⇒ Array(Fixnum, Hash, String)
Returns an Array ala Rack:
[status, headers, body]
. -
#to_s ⇒ String
(also: #to_str)
Eagerly consume the entire body as a string.
Methods included from Headers::Mixin
Constructor Details
#initialize(status, version, headers, body, uri = nil) ⇒ Response
rubocop:disable ParameterLists
33 34 35 36 37 38 39 |
# File 'lib/http/response.rb', line 33 def initialize(status, version, headers, body, uri = nil) # rubocop:disable ParameterLists @version = version @body = body @uri = uri && HTTP::URI.parse(uri) @status = HTTP::Response::Status.new status @headers = HTTP::Headers.coerce(headers || {}) end |
Instance Attribute Details
Instance Method Details
#charset ⇒ String?
Charset of response (if any)
93 94 95 |
# File 'lib/http/response.rb', line 93 def charset @charset ||= content_type.charset end |
#code ⇒ Fixnum Also known as: status_code
Returns status code.
47 |
# File 'lib/http/response.rb', line 47 def_delegator :status, :code |
#content_type ⇒ HTTP::ContentType
Parsed Content-Type header
79 80 81 |
# File 'lib/http/response.rb', line 79 def content_type @content_type ||= ContentType.parse headers[Headers::CONTENT_TYPE] end |
#cookies ⇒ Object
97 98 99 100 101 |
# File 'lib/http/response.rb', line 97 def @cookies ||= headers.each_with_object CookieJar.new do |(k, v), jar| jar.parse(v, uri) if k == Headers::SET_COOKIE end end |
#flush ⇒ Response
Flushes body and returns self-reference
71 72 73 74 |
# File 'lib/http/response.rb', line 71 def flush body.to_s self end |
#inspect ⇒ Object
Inspect a response
114 115 116 |
# File 'lib/http/response.rb', line 114 def inspect "#<#{self.class}/#{@version} #{code} #{reason} #{headers.to_h.inspect}>" end |
#mime_type ⇒ String?
MIME type of response (if any)
86 87 88 |
# File 'lib/http/response.rb', line 86 def mime_type @mime_type ||= content_type.mime_type end |
#parse(as = nil) ⇒ Object
Parse response body with corresponding MIME type adapter.
109 110 111 |
# File 'lib/http/response.rb', line 109 def parse(as = nil) MimeType[as || mime_type].decode to_s end |
#readpartial ⇒ Object
59 |
# File 'lib/http/response.rb', line 59 def_delegator :body, :readpartial |
#reason ⇒ String?
Returns status message.
43 |
# File 'lib/http/response.rb', line 43 def_delegator :status, :reason |
#to_a ⇒ Array(Fixnum, Hash, String)
Returns an Array ala Rack: [status, headers, body]
64 65 66 |
# File 'lib/http/response.rb', line 64 def to_a [status.to_i, headers.to_h, body.to_s] end |
#to_s ⇒ String Also known as: to_str
Returns eagerly consume the entire body as a string.
54 |
# File 'lib/http/response.rb', line 54 def_delegator :body, :to_s |