http.rb 0.13.3 → 0.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ccdd073930399a89a9a5345bcad82b9fb08c8f4ec0ac43ac498dfeb7b9d16d36
-  data.tar.gz: a9565770affd06919fdfc4d8a82c1d3c80015c046641db788c1da75c5e8852cd
+  metadata.gz: 55e2dfad8365a9b2918a6b6da9d8ab8c6abb469b014a9ad70c44d4787607512a
+  data.tar.gz: 891e2fe083b00fac2dbbd1bc0187853318471762136f74ff61ee662468c4acfb
 SHA512:
-  metadata.gz: 27b4d41bf3b4e35476c42fe785ea3262b5d5f66c85d373e319d06b2df8e6f50af91b619148f729d2947414d300fad912d9f7f50023203a7e4968f10fbd9561e1
-  data.tar.gz: 467692c9cf9ca0941db528e5391ce796198c3533bfeb0d19fa7e54d279abfb3c96ad0f34a2fa398dd664d3a2c5aadaca06f5f242fbbaed4daf1d47c8a825debc
+  metadata.gz: 6690a4668fb76471816c3929b06fc980a4e29fb4be84493315507b6166bd2203b353b248ad070b05b7cc1059b9a8e335148eab7f39cccd149ba6a53de40436c0
+  data.tar.gz: 66474bb9db3def1e771454c4fb832e49bcccfe2732b2f6a7d8e742ea7f7b788fd22441c32a84db5667606c9a4cef7c9b628139ba2817904f559674837a2a7eaf

data/CHANGELOG.txt

@@ -1,3 +1,14 @@
+# 20250711
+# 0.14.0: + DELETE
+1. + HTTP.delete
+2. + Net::HTTP::Delete#set_headers
+3. + spec/HTTP/delete_spec.rb
+4. ~ HTTP.delete: /require/require_relative/
+5. ~ HTTP.delete: /require/require_relative/
+6. ~ HTTP::VERSION: /0.13.3/0.14.0/
+7. ~ CHANGELOG.txt
+8. ~ http.rb.gemspec: Change date.
+
 # 20250501
 # 0.13.3: Handle when there's a redirect to a URL with arguments, so as to not add an additional '?' at the end.
 1. ~ HTTP.get: Check if the args hash is empty.

data/http.rb.gemspec

@@ -3,7 +3,7 @@ require_relative './lib/HTTP/VERSION'
 Gem::Specification.new do |s|
   s.name = 'http.rb'
   s.version = HTTP::VERSION
-  s.date = '2025-05-01'
+  s.date = '2025-07-11'
 
   s.summary = "HTTP made easy."
   s.description = "HTTP is the simplest HTTP mezzanine library for Ruby.  Supply a URI, \

data/lib/HTTP/VERSION.rb

@@ -2,5 +2,5 @@
 # HTTP::VERSION
 
 module HTTP
-  VERSION = '0.13.3'
+  VERSION = '0.14.0'
 end

data/lib/HTTP/delete.rb

@@ -0,0 +1,54 @@
+# HTTP/delete.rb
+# HTTP.delete
+
+require 'net/http'
+require 'openssl'
+require 'uri'
+
+require_relative '../Hash/x_www_form_urlencode'
+require_relative '../Net/HTTP/set_options'
+require_relative '../Net/HTTP/Delete/set_headers'
+require_relative '../Net/HTTPResponse/StatusPredicates'
+require_relative '../URI/Generic/use_sslQ'
+
+module HTTP
+
+  def delete(uri, args = {}, headers = {}, options = {}, &block)
+    uri = uri.is_a?(URI) ? uri : URI.parse(uri)
+    http = Net::HTTP.new(uri.host, uri.port)
+    no_redirect = options.delete(:no_redirect)
+    options[:use_ssl] ||= uri.use_ssl?
+    options[:verify_mode] ||= OpenSSL::SSL::VERIFY_NONE
+    http.options = options
+    if args.empty?
+      request_object = Net::HTTP::Delete.new(uri.request_uri)
+    else
+      request_object = Net::HTTP::Delete.new(uri.request_uri + '?' + args.x_www_form_urlencode)
+    end
+    request_object.headers = headers
+    request_object.basic_auth(uri.user, uri.password) if uri.user
+    response = http.request(request_object)
+    if response.code =~ /^3/
+      if block_given? && no_redirect
+        yield response
+      elsif no_redirect
+        return response
+      end
+      redirect_uri = URI.parse(response.header['location'])
+      if redirect_uri.scheme
+        response = get(response.header['location'], {}, {}, options, &block)
+      else
+        new_location = "http://#{uri.host}:#{uri.port}#{response.header['location']}"
+        response = get(new_location, {}, {}, options, &block)
+      end
+    end
+    if block_given?
+      yield response
+    else
+      response
+    end
+  end
+
+  module_function :delete
+
+end

data/lib/Net/HTTP/Delete/set_headers.rb

@@ -0,0 +1,14 @@
+# Net/HTTP/Delete/set_headers.rb
+# Net::HTTP::Delete#set_headers
+
+# 20250710
+# 0.0.0
+
+class Net::HTTP::Delete
+
+  def set_headers(headers = {})
+    headers.each{|k,v| self[k] = v}
+  end
+  alias_method :headers=, :set_headers
+
+end

data/spec/HTTP/delete_spec.rb

@@ -0,0 +1,247 @@
+# spec/HTTP/delete_spec.rb
+
+require_relative '../spec_helper'
+require 'HTTP/delete'
+
+describe ".delete" do
+  context "with uri-only supplied" do
+    before do
+      stub_request(:delete, 'http://example.com/path').
+        with(headers: {'Accept'=>'*/*', 'Accept-Encoding'=>'gzip;q=1.0,deflate;q=0.6,identity;q=0.3', 'User-Agent'=>'Ruby'}).
+          to_return(status: 200, body: '', headers: {})
+    end
+
+    context "uri as a string" do
+      let(:uri){'http://example.com/path'}
+      let(:parsed_uri){URI.parse(uri)}
+      let(:net_http_object){Net::HTTP.new(parsed_uri.host, parsed_uri.port)}
+
+      it "creates an instance of URI" do
+        expect(URI).to receive(:parse).with(uri).and_return(parsed_uri)
+        response = HTTP.delete(uri)
+        expect(response.success?).to eq(true)
+      end
+
+      it "creates a new Net::HTTP object" do
+        expect(Net::HTTP).to receive(:new).with(parsed_uri.host, parsed_uri.port).and_return(net_http_object)
+        response = HTTP.delete(uri)
+        expect(response.success?).to eq(true)
+      end
+    end
+
+    context "uri as a URI" do
+      let(:uri_string){'http://example.com/path'}
+      let(:uri){URI.parse(uri_string)}
+      let(:net_http_object){Net::HTTP.new(uri.host, uri.port)}
+
+      it "returns an instance of URI" do
+        expect(uri).to eq(uri)
+        HTTP.delete(uri)
+      end
+
+      it "creates a new Net::HTTP object" do
+        expect(Net::HTTP).to receive(:new).with(uri.host, uri.port).and_return(net_http_object)
+        response = HTTP.delete(uri)
+        expect(response.success?).to eq(true)
+      end
+    end
+  end
+
+  context "with args supplied" do
+    let(:uri){'http://example.com/path'}
+    let(:parsed_uri){URI.parse(uri)}
+    let(:args) do; {a: 1, b: 2}; end
+    let(:x_www_form_urlencoded_arguments) do; args.x_www_form_urlencode; end
+    let(:get_argument){parsed_uri.request_uri + '?' + x_www_form_urlencoded_arguments}
+    let(:request_object){Net::HTTP::Delete.new(get_argument)}
+
+    before do
+      stub_request(:delete, 'http://example.com/path?a=1&b=2').
+        with(headers: {'Accept'=>'*/*', 'Accept-Encoding'=>'gzip;q=1.0,deflate;q=0.6,identity;q=0.3', 'User-Agent'=>'Ruby'}).
+          to_return(status: 200, body: '', headers: {})
+    end
+
+    it "x_www_form_urlencode's the args" do
+      expect(args).to receive(:x_www_form_urlencode).and_return(x_www_form_urlencoded_arguments)
+      response = HTTP.delete(uri, args)
+      expect(response.success?).to eq(true)
+    end
+
+    it "creates a new Net::HTTP::Delete object" do
+      expect(Net::HTTP::Delete).to receive(:new).with(get_argument).and_return(request_object)
+      response = HTTP.delete(uri, args)
+      expect(response.success?).to eq(true)
+    end
+  end
+
+  context "with headers supplied" do
+    let(:uri){'http://example.com/path'}
+    let(:parsed_uri){URI.parse(uri)}
+    let(:headers) do; {'User-Agent' => 'Rspec'}; end
+    let(:get_argument){parsed_uri.request_uri}
+    let(:request_object){Net::HTTP::Delete.new(get_argument)}
+
+    before do
+      stub_request(:delete, 'http://example.com/path').
+        with(headers: {'Accept'=>'*/*', 'Accept-Encoding'=>'gzip;q=1.0,deflate;q=0.6,identity;q=0.3', 'User-Agent'=>'Rspec'}).
+          to_return(status: 200, body: '', headers: {})
+    end
+
+    it "sets the headers on the request object" do
+      allow(Net::HTTP::Delete).to receive(:new).with(get_argument).and_return(request_object)
+      response = HTTP.delete(uri, {}, headers)
+      expect(request_object['User-Agent']).to eq('Rspec')
+      expect(response.success?).to eq(true)
+    end
+  end
+
+  context "with options supplied" do
+    let(:uri){'http://example.com/path'}
+    let(:parsed_uri){URI.parse(uri)}
+    let(:net_http_object){Net::HTTP.new(parsed_uri.host, parsed_uri.port)}
+    let(:options) do; {use_ssl: true}; end
+
+    before do
+      stub_request(:delete, 'https://example.com:80/path').
+        with(headers: {'Accept'=>'*/*', 'Accept-Encoding'=>'gzip;q=1.0,deflate;q=0.6,identity;q=0.3', 'User-Agent'=>'Ruby'}).
+          to_return(status: 200, body: '', headers: {})
+    end
+
+    it "sets the use_ssl option on the Net::HTTP instance" do
+      allow(Net::HTTP).to receive(:new).with(parsed_uri.host, parsed_uri.port).and_return(net_http_object)
+      response = HTTP.delete(uri, {}, {}, options)
+      expect(net_http_object.instance_variable_get(:@use_ssl)).to be_truthy
+      expect(response.success?).to eq(true)
+    end
+  end
+
+  context "with block supplied" do
+    let(:uri){'http://example.com/path'}
+
+    before do
+      stub_request(:delete, 'http://example.com/path').
+        with(headers: {'Accept'=>'*/*', 'Accept-Encoding'=>'gzip;q=1.0,deflate;q=0.6,identity;q=0.3', 'User-Agent'=>'Ruby'}).
+          to_return(status: 200, body: '', headers: {})
+    end
+
+    it "yields an instance of Net::HTTPResponse" do
+      expect{|b| HTTP.delete(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(:get, redirect_uri).
+        with(headers: {'Accept'=>'*/*', 'Accept-Encoding'=>'gzip;q=1.0,deflate;q=0.6,identity;q=0.3', 'User-Agent'=>'Ruby'}).
+          to_return(status: 200, body: '', headers: {})
+    end
+
+    context "via 301" do
+      before do
+        stub_request(:delete, request_uri).
+          with(headers: {'Accept'=>'*/*', 'Accept-Encoding'=>'gzip;q=1.0,deflate;q=0.6,identity;q=0.3', 'User-Agent'=>'Ruby'}).
+            to_return(status: 301, body: '', headers: {'location' => redirect_uri})
+      end
+
+      it "does a redirect" do
+        expect(HTTP).to receive(:delete).once.with(request_uri).and_call_original
+        expect(HTTP).to receive(:get).once.with(redirect_uri, {}, {}, {use_ssl: false, verify_mode: 0}).and_call_original
+        response = HTTP.delete(request_uri)
+        expect(response.success?).to eq(true)
+      end
+    end
+
+    context "via 302" do
+      before do
+        stub_request(:delete, request_uri).
+          with(headers: {'Accept'=>'*/*', 'Accept-Encoding'=>'gzip;q=1.0,deflate;q=0.6,identity;q=0.3', 'User-Agent'=>'Ruby'}).
+            to_return(status: 302, body: '', headers: {'location' => redirect_uri})
+      end
+
+      it "does a redirect" do
+        expect(HTTP).to receive(:delete).once.with(request_uri).and_call_original
+        expect(HTTP).to receive(:get).once.with(redirect_uri, {}, {}, {use_ssl: false, verify_mode: 0}).and_call_original
+        response = HTTP.delete(request_uri)
+        expect(response.success?).to eq(true)
+      end
+    end
+  end
+
+  context "with path only redirection" do
+    let(:request_uri){'http://example.com/path'}
+    let(:redirect_path){'/new_path'}
+    let(:redirect_uri){"http://example.com:80#{redirect_path}"}
+
+    before do
+      stub_request(:get, redirect_uri).
+        with(headers: {'Accept'=>'*/*', 'Accept-Encoding'=>'gzip;q=1.0,deflate;q=0.6,identity;q=0.3', 'User-Agent'=>'Ruby'}).
+          to_return(status: 200, body: '', headers: {})
+    end
+
+    context "via 301" do
+      before do
+        stub_request(:delete, request_uri).
+          with(headers: {'Accept'=>'*/*', 'Accept-Encoding'=>'gzip;q=1.0,deflate;q=0.6,identity;q=0.3', 'User-Agent'=>'Ruby'}).
+            to_return(status: 301, body: '', headers: {'location' => redirect_path})
+      end
+
+      it "does a redirect" do
+        expect(HTTP).to receive(:delete).once.with(request_uri).and_call_original
+        expect(HTTP).to receive(:get).once.with(redirect_uri, {}, {}, {use_ssl: false, verify_mode: 0}).and_call_original
+        response = HTTP.delete(request_uri)
+        expect(response.success?).to eq(true)
+      end
+    end
+
+    context "via 302" do
+      before do
+        stub_request(:delete, request_uri).
+          with(headers: {'Accept'=>'*/*', 'Accept-Encoding'=>'gzip;q=1.0,deflate;q=0.6,identity;q=0.3', 'User-Agent'=>'Ruby'}).
+            to_return(status: 302, body: '', headers: {'location' => redirect_path})
+      end
+
+      it "does a redirect" do
+        expect(HTTP).to receive(:delete).once.with(request_uri).and_call_original
+        expect(HTTP).to receive(:get).once.with(redirect_uri, {}, {}, {use_ssl: false, verify_mode: 0}).and_call_original
+        response = HTTP.delete(request_uri)
+        expect(response.success?).to eq(true)
+      end
+    end
+  end
+
+  context "no_redirect true" do
+    let(:request_uri){'http://example.com/path'}
+    let(:redirect_uri){'http://redirected.com'}
+
+    context "via 301" do
+      before do
+        stub_request(:delete, request_uri).
+          with(headers: {'Accept'=>'*/*', 'Accept-Encoding'=>'gzip;q=1.0,deflate;q=0.6,identity;q=0.3', 'User-Agent'=>'Ruby'}).
+            to_return(status: 301, body: '', headers: {'location' => redirect_uri})
+      end
+
+      it "doesn't redirect" do
+        expect(HTTP).to receive(:delete).once.with(request_uri, {}, {}, {no_redirect: true}).and_call_original
+        response = HTTP.delete(request_uri, {}, {}, {no_redirect: true})
+        expect(response.redirection?).to eq(true)
+      end
+    end
+
+    context "via 302" do
+      before do
+        stub_request(:delete, request_uri).
+          with(headers: {'Accept'=>'*/*', 'Accept-Encoding'=>'gzip;q=1.0,deflate;q=0.6,identity;q=0.3', 'User-Agent'=>'Ruby'}).
+            to_return(status: 302, body: '', headers: {'location' => redirect_uri})
+      end
+
+      it "doesn't redirect" do
+        expect(HTTP).to receive(:delete).once.with(request_uri, {}, {}, {no_redirect: true}).and_call_original
+        response = HTTP.delete(request_uri, {}, {}, {no_redirect: true})
+        expect(response.redirection?).to eq(true)
+      end
+    end
+  end
+end

data/spec/HTTP/get_spec.rb

@@ -1,9 +1,6 @@
 # spec/HTTP/get_spec.rb
 
-spec_dir = File.expand_path(File.join(__FILE__, '..', '..'))
-$LOAD_PATH.unshift(spec_dir) unless $LOAD_PATH.include?(spec_dir)
-
-require 'spec_helper'
+require_relative '../spec_helper'
 require 'HTTP/get'
 
 describe ".get" do
@@ -81,7 +78,7 @@ describe ".get" do
     let(:uri){'http://example.com/path'}
     let(:parsed_uri){URI.parse(uri)}
     let(:headers) do; {'User-Agent' => 'Rspec'}; end
-    let(:get_argument){parsed_uri.request_uri + '?'}
+    let(:get_argument){parsed_uri.request_uri}
     let(:request_object){Net::HTTP::Get.new(get_argument)}
 
     before do

data/spec/HTTP/post_spec.rb

@@ -1,9 +1,6 @@
 # spec/HTTP/post_spec.rb
 
-spec_dir = File.expand_path(File.join(__FILE__, '..', '..'))
-$LOAD_PATH.unshift(spec_dir) unless $LOAD_PATH.include?(spec_dir)
-
-require 'spec_helper'
+require_relative '../spec_helper'
 require 'HTTP/post'
 
 describe ".post" do

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: http.rb
 version: !ruby/object:Gem::Version
-  version: 0.13.3
+  version: 0.14.0
 platform: ruby
 authors:
 - thoran
 bindir: bin
 cert_chain: []
-date: 2025-05-01 00:00:00.000000000 Z
+date: 2025-07-11 00:00:00.000000000 Z
 dependencies: []
 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,
@@ -23,15 +23,18 @@ files:
 - http.rb.gemspec
 - lib/HTTP.rb
 - lib/HTTP/VERSION.rb
+- lib/HTTP/delete.rb
 - lib/HTTP/get.rb
 - lib/HTTP/post.rb
 - lib/Hash/x_www_form_urlencode.rb
+- lib/Net/HTTP/Delete/set_headers.rb
 - lib/Net/HTTP/Get/set_headers.rb
 - lib/Net/HTTP/Post/set_headers.rb
 - lib/Net/HTTP/set_options.rb
 - lib/Net/HTTPResponse/StatusPredicates.rb
 - lib/String/url_encode.rb
 - lib/URI/Generic/use_sslQ.rb
+- spec/HTTP/delete_spec.rb
 - spec/HTTP/get_spec.rb
 - spec/HTTP/post_spec.rb
 - spec/spec_helper.rb
@@ -52,7 +55,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.8
+rubygems_version: 3.6.9
 specification_version: 4
 summary: HTTP made easy.
 test_files: []