http.rb 0.17.0 → 0.18.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2d9519c8ef1eb2d71220644e255d595a472ecc23248eed892a7a0bb3eee8f5e3
-  data.tar.gz: dc4da67e9c806dd30f4b0c9cc989a6d42116f4147c0bcaef7dd7eee2430f9f4a
+  metadata.gz: c8f29700e5af2badc9a6207ce6c3cf5ce189c6e282da3955535139b2014c1092
+  data.tar.gz: 121be70186382dab28df52b69f7a2e5c9501bb5891946865621250e63e85f952
 SHA512:
-  metadata.gz: 156c9ea7fe6f112d1987edce3557c60166c3f23c15b8fbb6c58cc8a6603bd1f2146eb073fc013778c5e40f4038c52c115a9ae6cf0d100b50e15615e19aa640a0
-  data.tar.gz: 9e67a7ca0e436c137591757b8ca1d61497b2b6a3649f5d7c5c9fb2266abf936b16c7949538d71dc71fd9cb7a96f792af216d5d9b40d3146f6577f1fcc2d1df3e
+  metadata.gz: b2a0ed184928d0f3656d8d9d28bcb37098759f94cf37f708c931b020c920d2d2c8f50a5a7856dcb1827759c3d8a917e5824b7266217861f21daca202533003c3
+  data.tar.gz: 22525a1fa099e471895bfe8cc660c728c3fcc52067b24849079b1f0c3c0e9ed50e64359c92d46de2aed7557b72d4855b39b93ab652a3fd2da122c9e5c3704df7

data/{CHANGELOG.txt → CHANGELOG}

@@ -1,3 +1,31 @@
+# 20260507
+# 0.18.0: Add all missing HTTP verbs; use meta-programming to define verb methods.
+1. + HTTP/verbs.rb; including:
+     + HTTP::VERBS::WITHOUT_BODY: get, delete, head, options, trace
+     + HTTP::VERBS::WITH_BODY: post, put, patch, propfind, proppatch, mkcol, copy, move, lock, unlock, report
+2. + lib/Net/HTTP/Report.rb: Add Net::HTTP::Report, which is missing from Ruby's standard library. See RFC 3253.
+3. - lib/HTTP/delete.rb
+4. - lib/HTTP/get.rb
+5. - lib/HTTP/post.rb
+6. - lib/HTTP/put.rb
+7. + String/to_const.rb
+8. + Thoran/Array/AllButFirst/all_but_first.rb
+9. + Thoran/Array/FirstX/firstX.rb
+10. + Thoran/String/ToConst/to_const.rb
+11. + LICENSE
+12. + Rakefile
+13. + spec/HTTP/head_spec.rb
+14. + spec/HTTP/propfind_spec.rb
+15. + spec/Net/HTTP/Report_spec.rb
+16. ~ HTTP::VERSION: /0.17.0/0.18.0/
+17. /CHANGELOG.txt/CHANGELOG/
+18. /TODO.txt/TODO/
+19. ~ CHANGELOG: + 0.18.0 entry
+20. ~ http.rb.gemspec: /s/spec/; - date; + Rakefile; + development_dependencies
+21. ~ Gemfile: /group :test/gemspec/
+22. ~ .gitignore: Using a common one with lots of entries.
+23. ~ README.md: /http.rb/http/; Trimmed the Description; Usage has more code blocks, making the comments Markdown sub-sections.
+
 # 20260325
 # 0.17.0: Extract HTTP.request method; consolidate set_headers.
 1. + HTTP.request: Extract common plumbing (connection, SSL, auth, redirect, response) from verb methods.

data/Gemfile

@@ -1,7 +1,5 @@
+# Gemfile
+
 source 'https://rubygems.org'
 
-group :test do
-  gem 'pry', require: true
-  gem 'rspec', require: false
-  gem 'webmock', require: false
-end
+gemspec

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 thoran
+
+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.

data/README.md

@@ -1,89 +1,94 @@
-# http.rb
+# http
 
 ## Description
 
-This has been a personal library which was begun many years ago, around the middle of 2009 from what I can ascertain, though in various guises it may have been as early as late 2007.  Assuming it was the former, it was long enough ago that it actually, sadly (given the diminutive size of this perhaps), predates Faraday by about 6 months (late 2009), http.rb by well over 2 years (late 2011), although it also happens to postdate HTTParty by about a year (mid 2008).  
+For many years this was a personal library, from around the middle of 2009 from what I can ascertain, though in various guises it may have been as early as late 2007.
 
-Like many others before and after me with their respective libraries, I created it to simplify the heinous interface that is Net::HTTP.  At the time of it's original creation I was doing a lot of a webscraping and didn't want a half-dozen line setup to make simple requests.  It has stood the test of time, for me personally insofar as the interface remaining simpler than most other similar libraries, though it is also less full featured, but nevertheless for it's tiny size it packs in quite a bit.  
+Like many others before and after me with their respective libraries, I created it to simplify the heinous interface that is Net::HTTP. At the time of it's original creation I was doing a lot of a webscraping and didn't want a half-dozen line setup to make simple requests. It has stood the test of time, for me personally insofar as the interface remaining simpler than most other similar libraries, though it is also less full featured, but nevertheless for it's tiny size it packs in quite a bit.
 
-From inception to early 2013 this was used as a front-end for Mechanize for the purpose of being able to jump out of being a pure web client and to just 'go at' a resource I was after, but still return a Mechanize object so that I could then resume a web client session.  Eventually I decided to wrap Net::HTTP and then manually use Nokogiri instead, since I would either use Mechanize largely as is, or I simply wanted to make straight requests without caring about caching or cookies.  I may allow HTTP to again return Mechanize objects optionally at some point in future as that had it's benefits, but they weren't great enough for the complications it brought if I remember correctly.  
-
-Even so, through its various incarnations the goal has basically remained the same: to have a simple way of making HTTP requests in Ruby.  
-
-I'd never intended to publish this and had intended for it to remain a personal library, but decided to use it for a small project and so as it could be included with ease in a Gemfile it needed to be gemified and well here we are, rightly or wrongly.  
-
-Perhaps someone will appreciate its relative simplicity, since it is much smaller and the usage simpler than any of the other 'wrapper' libraries mentioned above at least, such that it can be read and comprehended in full in as little as a couple of minutes.  It does just enough to do most simple HTTP GET and POST requests as simply as should be.  
+Perhaps some will appreciate its relative simplicity, since it is much smaller and the usage simpler than any of the other 'wrapper' libraries, such that it can be read and comprehended in full in as little as a couple of minutes.  It does just enough to do most simple HTTP GET and POST requests as simply as should be.
 
 
 ## Installation
 
 Add this line to your application's Gemfile:
 
-    gem 'http.rb'
-
+```ruby
+gem 'http.rb'
+```
 
 And then execute:
 
-    $ bundle
-
-
-Or install it yourself as:
+```shell
+$ bundle
+```
 
-    $ gem install http.rb
+Or install it directly:
 
+```shell
+$ gem install http.rb
+```
 
 ## Usage
 
-```Ruby
-# With just a URI
+### With just a URI
 
+```ruby
 HTTP.get('http://example.com')
-HTTP.post('http://example.com') # Admittedly doing a POST without providing form data probably doesn't make much sense.
+```
 
-# With arguments only
+### With arguments only
 
+```ruby
 HTTP.get('http://example.com', {a: 1, b: 2})
 HTTP.post('http://example.com', {a: 1, b: 2})
+```
+### With JSON data
 
-# With JSON data
-
+```ruby
 HTTP.post('http://example.com', {a: 1, b: 2}, {'Content-type' => 'application/json'})
+```
 
-# With custom headers only
+### With custom headers only
 
+```ruby
 HTTP.get('http://example.com', {}, {'User-Agent'=>'Custom'})
 HTTP.post('http://example.com', {}, {'User-Agent'=>'Custom'})
+```
 
-# With options only
+### With options only
 
+```ruby
 HTTP.get('http://example.com', {}, {}, {use_ssl: true})
 HTTP.post('http://example.com', {}, {}, {use_ssl: true})
+```
 
-# With a block
+### With a block
 
+```ruby
 HTTP.get('http://example.com') do |response|
   # Do stuff with a subclass of Net::HTTPResponse here...
 end
-HTTP.post('http://example.com') do |response|
-  # Do stuff with a subclass of Net::HTTPResponse here...
-end
+```
 
-# With the lot
+### With the lot
 
-HTTP.get('http://example.com', {a: 1, b: 2}, {'User-Agent'=>'Custom'}, {use_ssl: true}) do |response|
-  # Do stuff with a subclass of Net::HTTPResponse here...
-end
+```ruby
 HTTP.post('http://example.com', {a: 1, b: 2}, {'User-Agent'=>'Custom'}, {use_ssl: true}) do |response|
   # Do stuff with a subclass of Net::HTTPResponse here...
 end
+```
 
-# Preventing redirections
+### Preventing redirections
 
+```ruby
 HTTP.get('http://example.com', {}, {}, {no_redirect: true})
 # => #<Net::HTTPResponse @code=3xx>
+```
 
-# Response status predicate methods
+### Response status predicate methods
 
+```ruby
 # 1xx
 response = HTTP.get('http://example.com')
 response.informational?
@@ -126,23 +131,26 @@ response.server_error?
 # => true
 response.error?
 # => true
+```
 
-# Including it in a class
+### Including it in a class
 
+```ruby
 class A
   include HTTP
   def a
     get('http://example.com')
   end
 end
+```
 
-# Extending a class
+### Extending a class
 
+```ruby
 class A
   extend HTTP
   get('http://example.com')
 end
-
 ```
 
 ## Allowed values for the options hash
@@ -239,8 +247,12 @@ verify_mode
 
 ## Contributing
 
-1. Fork it ( https://github.com/thoran/HTTP/fork )
+1. Fork it ( https://github.com/thoran/http/fork )
 2. Create your feature branch (`git checkout -b my-new-feature`)
 3. Commit your changes (`git commit -am 'Add some feature'`)
 4. Push to the branch (`git push origin my-new-feature`)
 5. Create a new pull request
+
+## Licence
+
+MIT

data/Rakefile

@@ -0,0 +1,9 @@
+# Rakefile
+
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.verbose = false
+end
+
+task default: :spec

data/http.rb.gemspec

@@ -1,26 +1,43 @@
 require_relative './lib/HTTP/VERSION'
 
-Gem::Specification.new do |s|
-  s.name = 'http.rb'
-  s.version = HTTP::VERSION
-  s.date = '2026-03-25'
+class Gem::Specification
+  def development_dependencies=(gems)
+    gems.each{|gem| add_development_dependency(*gem)}
+  end
+end
+
+Gem::Specification.new do |spec|
+  spec.name = 'http.rb'
+  spec.version = HTTP::VERSION
 
-  s.summary = "HTTP made easy."
-  s.description = "HTTP is the simplest HTTP mezzanine library for Ruby.  Supply a URI, \
+  spec.summary = "HTTP made easy."
+  spec.description = "HTTP is the simplest HTTP mezzanine library for Ruby.  Supply a URI, \
     some optional query arguments, some optional headers, and some \
     Net::HTTP options, and that's it!"
-  s.author = 'thoran'
-  s.email = 'code@thoran.com'
-  s.homepage = "http://github.com/thoran/HTTP"
 
-  s.files = [
-    'CHANGELOG.txt',
+  spec.author = 'thoran'
+  spec.email = 'code@thoran.com'
+  spec.homepage = "http://github.com/thoran/HTTP"
+  spec.license = 'MIT'
+
+  spec.required_ruby_version = '>= 2.7'
+  spec.require_paths = ['lib']
+
+  spec.files = [
+    'http.rb.gemspec',
+    'CHANGELOG',
     'Gemfile',
+    'LICENSE',
+    'Rakefile',
     'README.md',
-    'http.rb.gemspec',
     Dir['lib/**/*.rb'],
-    Dir['spec/**/*.rb']
+    Dir['spec/**/*.rb'],
   ].flatten
 
-  s.require_paths = ['lib']
+  spec.development_dependencies = %w{
+    pry
+    rake
+    rspec
+    webmock
+  }
 end

data/lib/HTTP/VERSION.rb

@@ -2,5 +2,5 @@
 # HTTP::VERSION
 
 module HTTP
-  VERSION = '0.17.0'
+  VERSION = '0.18.0'
 end

data/lib/HTTP/verbs.rb

@@ -0,0 +1,49 @@
+# HTTP/verbs.rb
+# HTTP.verb
+
+require 'json'
+require 'net/http'
+
+require_relative '../Hash/x_www_form_urlencode'
+require_relative '../Net/HTTP/Report'
+require_relative './request'
+require_relative '../String/to_const'
+
+module HTTP
+  module VERBS
+    WITHOUT_BODY = %i{get delete head options trace}
+    WITH_BODY = %i{post put patch propfind proppatch mkcol copy move lock unlock report}
+  end
+
+  VERBS::WITHOUT_BODY.each do |verb|
+    define_method(verb) do |uri, args = {}, headers = {}, options = {}, &block|
+      uri = uri.is_a?(URI) ? uri : URI.parse(uri)
+      request_uri = uri.request_uri
+      unless args.empty?
+        request_uri += '?' + args.x_www_form_urlencode
+      end
+      request_object = "Net::HTTP::#{verb.to_s.capitalize}".to_const.new(request_uri)
+      request(uri, request_object, headers, options, &block)
+    end
+
+    module_function verb
+  end
+
+  VERBS::WITH_BODY.each do |verb|
+    define_method(verb) do |uri, data = {}, headers = {}, options = {}, &block|
+      uri = uri.is_a?(URI) ? uri : URI.parse(uri)
+      request_object = "Net::HTTP::#{verb.to_s.capitalize}".to_const.new(uri.request_uri)
+      content_type = headers.find{|k, v| k.downcase == 'content-type'}&.last.to_s
+      if data.is_a?(String)
+        request_object.body = data
+      elsif content_type.start_with?('application/json')
+        request_object.body = JSON.dump(data)
+      else
+        request_object.form_data = data
+      end
+      request(uri, request_object, headers, options, &block)
+    end
+
+    module_function verb
+  end
+end

data/lib/Net/HTTP/Report.rb

@@ -0,0 +1,14 @@
+# Net/HTTP/Report.rb
+# Net::HTTP::Report
+
+require 'net/http'
+
+module Net
+  class HTTP
+    class Report < Net::HTTPRequest
+      METHOD = 'REPORT'
+      REQUEST_HAS_BODY = true
+      RESPONSE_HAS_BODY = true
+    end
+  end
+end

data/lib/String/to_const.rb

@@ -0,0 +1,7 @@
+# String/to_const.rb
+# String#to_const
+
+# 20250819
+# 0.2.0
+
+require 'Thoran/String/ToConst/to_const'

data/lib/Thoran/Array/AllButFirst/all_but_first.rb

@@ -0,0 +1,28 @@
+# Thoran/Array/AllButFirst/all_but_first.rb
+# Thoran::Array::AllButFirst#all_but_first
+
+# 20141223
+# 0.1.0
+
+# Description: This returns a copy of the receiving array with the first element removed.  
+
+# Changes:
+# 1. + Thoran namespace.
+
+require 'Thoran/Array/FirstX/firstX'
+
+module Thoran
+  module Array
+    module AllButFirst
+
+      def all_but_first
+        d = self.dup
+        d.first!
+        d
+      end
+
+    end
+  end
+end
+
+Array.send(:include, Thoran::Array::AllButFirst)

data/lib/Thoran/Array/FirstX/firstX.rb

@@ -0,0 +1,32 @@
+# Thoran/Array/FirstX/firstX.rb
+# Thoran::Array::FirstX#first!
+
+# 20180804
+# 0.3.3
+
+# Description: Sometimes it makes more sense to treat arrays this way.
+
+# Changes since 0.2:
+# 1. Added the original version 0.1.0 of the implementation to the later 0.1.0!
+# 0/1
+# 2. Switched the tests to spec-style.
+# 1/2
+# 3. Added a test for the state of the array afterward, since this is meant to be an in place change.
+# 2/3
+# 4. Added tests for the extended functionality introduced in the first version 0.1.0.
+
+module Thoran
+  module Array
+    module FirstX
+
+      def first!(n = 1)
+        return_value = []
+        n.times{return_value << self.shift}
+        return_value.size == 1 ? return_value[0] : return_value
+      end
+
+    end
+  end
+end
+
+Array.send(:include, Thoran::Array::FirstX)

data/lib/Thoran/String/ToConst/to_const.rb

@@ -0,0 +1,47 @@
+# Thoran/String/ToConst/to_const.rb
+# Thoran::String::ToConst#to_const
+
+# 20141223
+# 0.2.0
+
+# Description: This takes a string and returns a constant, with unlimited namespacing.
+
+# History: Derived from Object#to_const 0.3.0, and superceding Object#to_const.
+
+# Changes:
+# 1. + Thoran namespace.
+
+# Todo:
+# 1. This only works for two levels of constants.  Three and you're stuffed.  So, this needs to be recursive...
+#   Done iteratively as of 0.1.0.
+# 2. Make this work for symbols.  However, this will only work if there's no namespacing.  ie. :A is OK, but :A::B is not.
+
+# Discussion:
+# 1. Should this go separately into classes for which ::const_get will work and be removed from Object?  Done as of 0.1.0.
+
+require 'Thoran/Array/AllButFirst/all_but_first'
+
+module Thoran
+  module String
+    module ToConst
+
+      def to_const
+        if self =~ /::/
+          constants = self.split('::')
+          constant = Object.const_get(constants.first)
+          constants = constants.all_but_first
+          until constants.empty? do
+            constant = constant.const_get(constants.shift)
+          end
+        else
+          constant = Object.const_get(self)
+        end
+        constant
+      end
+      alias_method :to_constant, :to_const
+
+    end
+  end
+end
+
+String.send(:include, Thoran::String::ToConst)

data/lib/{HTTP.rb → http.rb}

@@ -4,7 +4,4 @@
 lib_dir = File.expand_path(File.join(__FILE__, '..'))
 $LOAD_PATH.unshift(lib_dir) unless $LOAD_PATH.include?(lib_dir)
 
-require 'HTTP/get'
-require 'HTTP/post'
-require 'HTTP/put'
-require 'HTTP/delete'
+require 'HTTP/verbs'

data/spec/HTTP/delete_spec.rb

@@ -1,7 +1,7 @@
 # spec/HTTP/delete_spec.rb
 
 require_relative '../spec_helper'
-require 'HTTP/delete'
+require 'http'
 
 describe ".delete" do
   context "with uri-only supplied" do

data/spec/HTTP/get_spec.rb

@@ -1,7 +1,7 @@
 # spec/HTTP/get_spec.rb
 
 require_relative '../spec_helper'
-require 'HTTP/get'
+require 'http'
 
 describe ".get" do
   context "with uri-only supplied" do

data/spec/HTTP/head_spec.rb

@@ -0,0 +1,118 @@
+# spec/HTTP/head_spec.rb
+
+require_relative '../spec_helper'
+require 'http'
+
+describe ".head" do
+  context "with uri-only supplied" do
+    before do
+      stub_request(:head, 'http://example.com/path').
+        to_return(status: 200, body: '', headers: {'Content-Type' => 'text/html'})
+    end
+
+    context "uri as a string" do
+      let(:uri){'http://example.com/path'}
+
+      it "returns a successful response" do
+        response = HTTP.head(uri)
+        expect(response.success?).to eq(true)
+      end
+    end
+
+    context "uri as a URI" do
+      let(:uri){URI.parse('http://example.com/path')}
+
+      it "returns a successful response" do
+        response = HTTP.head(uri)
+        expect(response.success?).to eq(true)
+      end
+    end
+  end
+
+  context "with args supplied" do
+    let(:uri){'http://example.com/path'}
+
+    before do
+      stub_request(:head, 'http://example.com/path?a=1&b=2').
+        to_return(status: 200, body: '', headers: {})
+    end
+
+    it "appends query parameters" do
+      response = HTTP.head(uri, {a: 1, b: 2})
+      expect(response.success?).to eq(true)
+    end
+  end
+
+  context "with headers supplied" do
+    let(:uri){'http://example.com/path'}
+
+    before do
+      stub_request(:head, 'http://example.com/path').
+        with(headers: {'User-Agent' => 'Rspec'}).
+        to_return(status: 200, body: '', headers: {})
+    end
+
+    it "sets the headers on the request" do
+      response = HTTP.head(uri, {}, {'User-Agent' => 'Rspec'})
+      expect(response.success?).to eq(true)
+    end
+  end
+
+  context "with options supplied" do
+    let(:uri){'http://example.com/path'}
+
+    before do
+      stub_request(:head, 'https://example.com:80/path').
+        to_return(status: 200, body: '', headers: {})
+    end
+
+    it "sets the use_ssl option on the Net::HTTP instance" do
+      response = HTTP.head(uri, {}, {}, {use_ssl: true})
+      expect(response.success?).to eq(true)
+    end
+  end
+
+  context "with block supplied" do
+    let(:uri){'http://example.com/path'}
+
+    before do
+      stub_request(:head, 'http://example.com/path').
+        to_return(status: 200, body: '', headers: {})
+    end
+
+    it "yields an instance of Net::HTTPResponse" do
+      expect{|b| HTTP.head(uri, &b)}.to yield_with_args(Net::HTTPResponse)
+    end
+  end
+
+  context "with redirection" do
+    let(:request_uri){'http://example.com/path'}
+    let(:redirect_uri){'http://redirected.com'}
+
+    before do
+      stub_request(:head, request_uri).
+        to_return(status: 301, headers: {'location' => redirect_uri})
+      stub_request(:get, redirect_uri).
+        to_return(status: 200, body: '', headers: {})
+    end
+
+    it "follows the redirect" do
+      response = HTTP.head(request_uri)
+      expect(response.success?).to eq(true)
+    end
+  end
+
+  context "no_redirect true" do
+    let(:request_uri){'http://example.com/path'}
+
+    before do
+      stub_request(:head, request_uri).
+        to_return(status: 301, headers: {'location' => 'http://redirected.com'})
+    end
+
+    it "returns the redirect response" do
+      response = HTTP.head(request_uri, {}, {}, {no_redirect: true})
+      expect(response.redirection?).to eq(true)
+    end
+  end
+end

data/spec/HTTP/post_spec.rb

@@ -1,7 +1,7 @@
 # spec/HTTP/post_spec.rb
 
 require_relative '../spec_helper'
-require 'HTTP/post'
+require 'http'
 
 describe ".post" do
   context "with uri-only supplied" do

data/spec/HTTP/propfind_spec.rb

@@ -0,0 +1,122 @@
+# spec/HTTP/propfind_spec.rb
+
+require_relative '../spec_helper'
+require 'http'
+
+describe ".propfind" do
+  context "with uri-only supplied" do
+    before do
+      stub_request(:propfind, 'http://example.com/dav/').
+        to_return(status: 207, body: '<multistatus/>', headers: {})
+    end
+
+    context "uri as a string" do
+      let(:uri){'http://example.com/dav/'}
+
+      it "returns a response" do
+        response = HTTP.propfind(uri)
+        expect(response.code).to eq('207')
+      end
+    end
+
+    context "uri as a URI" do
+      let(:uri){URI.parse('http://example.com/dav/')}
+
+      it "returns a response" do
+        response = HTTP.propfind(uri)
+        expect(response.code).to eq('207')
+      end
+    end
+  end
+
+  context "with an XML body" do
+    let(:uri){'http://example.com/dav/'}
+    let(:xml) do
+      '<?xml version="1.0" encoding="UTF-8"?><d:propfind xmlns:d="DAV:"><d:prop><d:displayname/></d:prop></d:propfind>'
+    end
+
+    before do
+      stub_request(:propfind, 'http://example.com/dav/').
+        with(body: xml).
+        to_return(status: 207, body: '<multistatus/>', headers: {})
+    end
+
+    it "sends the XML body" do
+      response = HTTP.propfind(uri, xml, {'Content-Type' => 'application/xml'})
+      expect(response.code).to eq('207')
+    end
+  end
+
+  context "with headers supplied" do
+    let(:uri){'http://example.com/dav/'}
+
+    before do
+      stub_request(:propfind, 'http://example.com/dav/').
+        with(headers: {'Depth' => '1', 'Content-Type' => 'application/xml'}).
+        to_return(status: 207, body: '<multistatus/>', headers: {})
+    end
+
+    it "sets the headers on the request" do
+      response = HTTP.propfind(uri, {}, {'Depth' => '1', 'Content-Type' => 'application/xml'})
+      expect(response.code).to eq('207')
+    end
+  end
+
+  context "with options supplied" do
+    let(:uri){'http://example.com/dav/'}
+
+    before do
+      stub_request(:propfind, 'https://example.com:80/dav/').
+        to_return(status: 207, body: '<multistatus/>', headers: {})
+    end
+
+    it "sets the use_ssl option on the Net::HTTP instance" do
+      response = HTTP.propfind(uri, {}, {}, {use_ssl: true})
+      expect(response.code).to eq('207')
+    end
+  end
+
+  context "with block supplied" do
+    let(:uri){'http://example.com/dav/'}
+
+    before do
+      stub_request(:propfind, 'http://example.com/dav/').
+        to_return(status: 207, body: '<multistatus/>', headers: {})
+    end
+
+    it "yields an instance of Net::HTTPResponse" do
+      expect{|b| HTTP.propfind(uri, &b)}.to yield_with_args(Net::HTTPResponse)
+    end
+  end
+
+  context "with redirection" do
+    let(:request_uri){'http://example.com/dav/'}
+    let(:redirect_uri){'http://redirected.com/dav/'}
+
+    before do
+      stub_request(:propfind, request_uri).
+        to_return(status: 301, headers: {'location' => redirect_uri})
+      stub_request(:get, redirect_uri).
+        to_return(status: 200, body: '', headers: {})
+    end
+
+    it "follows the redirect" do
+      response = HTTP.propfind(request_uri)
+      expect(response.success?).to eq(true)
+    end
+  end
+
+  context "no_redirect true" do
+    let(:request_uri){'http://example.com/dav/'}
+
+    before do
+      stub_request(:propfind, request_uri).
+        to_return(status: 301, headers: {'location' => 'http://redirected.com/dav/'})
+    end
+
+    it "returns the redirect response" do
+      response = HTTP.propfind(request_uri, {}, {}, {no_redirect: true})
+      expect(response.redirection?).to eq(true)
+    end
+  end
+end

data/spec/HTTP/put_spec.rb

@@ -1,7 +1,7 @@
 # spec/HTTP/put_spec.rb
 
 require_relative '../spec_helper'
-require 'HTTP/put'
+require 'http'
 
 describe ".put" do
   context "with uri-only supplied" do

data/spec/Net/HTTP/Report_spec.rb

@@ -0,0 +1,22 @@
+# spec/Net/HTTP/Report_spec.rb
+
+require_relative '../../spec_helper'
+require 'Net/HTTP/Report'
+
+describe Net::HTTP::Report do
+  it "is a subclass of Net::HTTPRequest" do
+    expect(Net::HTTP::Report).to be <= Net::HTTPRequest
+  end
+
+  it "has the correct METHOD" do
+    expect(Net::HTTP::Report::METHOD).to eq('REPORT')
+  end
+
+  it "accepts a body" do
+    expect(Net::HTTP::Report::REQUEST_HAS_BODY).to eq(true)
+  end
+
+  it "expects a response body" do
+    expect(Net::HTTP::Report::RESPONSE_HAS_BODY).to eq(true)
+  end
+end

metadata

@@ -1,14 +1,70 @@
 --- !ruby/object:Gem::Specification
 name: http.rb
 version: !ruby/object:Gem::Version
-  version: 0.17.0
+  version: 0.18.0
 platform: ruby
 authors:
 - thoran
 bindir: bin
 cert_chain: []
-date: 2026-03-25 00:00:00.000000000 Z
-dependencies: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: HTTP is the simplest HTTP mezzanine library for Ruby.  Supply a URI,     some
   optional query arguments, some optional headers, and some     Net::HTTP options,
   and that's it!
@@ -17,30 +73,38 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- CHANGELOG.txt
+- CHANGELOG
 - Gemfile
+- LICENSE
 - README.md
+- Rakefile
 - http.rb.gemspec
-- lib/HTTP.rb
 - lib/HTTP/VERSION.rb
-- lib/HTTP/delete.rb
-- lib/HTTP/get.rb
-- lib/HTTP/post.rb
-- lib/HTTP/put.rb
 - lib/HTTP/request.rb
+- lib/HTTP/verbs.rb
 - lib/Hash/x_www_form_urlencode.rb
+- lib/Net/HTTP/Report.rb
 - lib/Net/HTTP/set_options.rb
 - lib/Net/HTTPRequest/set_headers.rb
 - lib/Net/HTTPResponse/StatusPredicates.rb
+- lib/String/to_const.rb
 - lib/String/url_encode.rb
+- lib/Thoran/Array/AllButFirst/all_but_first.rb
+- lib/Thoran/Array/FirstX/firstX.rb
+- lib/Thoran/String/ToConst/to_const.rb
 - lib/URI/Generic/use_sslQ.rb
+- lib/http.rb
 - spec/HTTP/delete_spec.rb
 - spec/HTTP/get_spec.rb
+- spec/HTTP/head_spec.rb
 - spec/HTTP/post_spec.rb
+- spec/HTTP/propfind_spec.rb
 - spec/HTTP/put_spec.rb
+- spec/Net/HTTP/Report_spec.rb
 - spec/spec_helper.rb
 homepage: http://github.com/thoran/HTTP
-licenses: []
+licenses:
+- MIT
 metadata: {}
 rdoc_options: []
 require_paths:
@@ -49,14 +113,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '2.7'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.8
+rubygems_version: 4.0.11
 specification_version: 4
 summary: HTTP made easy.
 test_files: []

data/lib/HTTP/delete.rb

@@ -1,21 +0,0 @@
-# HTTP/delete.rb
-# HTTP.delete
-
-require 'net/http'
-
-require_relative '../Hash/x_www_form_urlencode'
-require_relative './request'
-
-module HTTP
-  def delete(uri, args = {}, headers = {}, options = {}, &block)
-    uri = uri.is_a?(URI) ? uri : URI.parse(uri)
-    request_uri = uri.request_uri
-    unless args.empty?
-      request_uri += '?' + args.x_www_form_urlencode
-    end
-    request_object = Net::HTTP::Delete.new(request_uri)
-    request(uri, request_object, headers, options, &block)
-  end
-
-  module_function :delete
-end

data/lib/HTTP/get.rb

@@ -1,21 +0,0 @@
-# HTTP/get.rb
-# HTTP.get
-
-require 'net/http'
-
-require_relative '../Hash/x_www_form_urlencode'
-require_relative './request'
-
-module HTTP
-  def get(uri, args = {}, headers = {}, options = {}, &block)
-    uri = uri.is_a?(URI) ? uri : URI.parse(uri)
-    request_uri = uri.request_uri
-    unless args.empty?
-      request_uri += '?' + args.x_www_form_urlencode
-    end
-    request_object = Net::HTTP::Get.new(request_uri)
-    request(uri, request_object, headers, options, &block)
-  end
-
-  module_function :get
-end

data/lib/HTTP/post.rb

@@ -1,25 +0,0 @@
-# HTTP/post.rb
-# HTTP.post
-
-require 'json'
-require 'net/http'
-
-require_relative './request'
-
-module HTTP
-  def post(uri, data = {}, headers = {}, options = {}, &block)
-    uri = uri.is_a?(URI) ? uri : URI.parse(uri)
-    request_object = Net::HTTP::Post.new(uri.request_uri)
-    content_type = headers.find{|k, v| k.downcase == 'content-type'}&.last.to_s
-    if data.is_a?(String)
-      request_object.body = data
-    elsif content_type.start_with?('application/json')
-      request_object.body = JSON.dump(data)
-    else
-      request_object.form_data = data
-    end
-    request(uri, request_object, headers, options, &block)
-  end
-
-  module_function :post
-end

data/lib/HTTP/put.rb

@@ -1,25 +0,0 @@
-# HTTP/put.rb
-# HTTP.put
-
-require 'json'
-require 'net/http'
-
-require_relative './request'
-
-module HTTP
-  def put(uri, data = {}, headers = {}, options = {}, &block)
-    uri = uri.is_a?(URI) ? uri : URI.parse(uri)
-    request_object = Net::HTTP::Put.new(uri.request_uri)
-    content_type = headers.find{|k, v| k.downcase == 'content-type'}&.last.to_s
-    if data.is_a?(String)
-      request_object.body = data
-    elsif content_type.start_with?('application/json')
-      request_object.body = JSON.dump(data)
-    else
-      request_object.form_data = data
-    end
-    request(uri, request_object, headers, options, &block)
-  end
-
-  module_function :put
-end