mini_http 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 9c08f77f0d125e88a3232a1a297b02c63b58e603035eb270d6f831afc5125b60
+  data.tar.gz: 8d1c560f5a1c7c96b16958f76ef11249058948293fad0d27edcc289b07aada43
+SHA512:
+  metadata.gz: e6030620de4d5dfebda56fdb0e1a3ecad646cacfbd32c37835f66ecff9c0e5ac4ef3657e8b1da5f86635c7c996b6aed6d70cf5fabc9bf3ff42100c022f8fac4d
+  data.tar.gz: 33d519e99803cedc6227a02db5214203f46139df17b040e8a5a5a13eb2e11a16e86f40a339989856a949d1420b1c532c09b0e802a097a7123a52419ed1f84dda

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,26 @@
+AllCops:
+  TargetRubyVersion: 2.7
+  NewCops: enable
+  SuggestExtensions: false
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  EnforcedStyle: double_quotes
+
+# Allow longer blocks in tests
+Metrics/BlockLength:
+  Exclude:
+    - 'spec/**/*'
+    
+# Allow longer methods for specific cases
+Metrics/MethodLength:
+  Max: 15
+
+# Allow missing documentation for now
+Style/Documentation:
+  Enabled: false
+
+Layout/LineLength:
+  Max: 120

data/CHANGELOG.md

@@ -0,0 +1,11 @@
+## [Unreleased]
+
+## [0.1.0] - 2025-06-23
+
+- Initial release of MiniHttp
+- Support for GET, POST, PUT, DELETE requests  
+- Automatic JSON parsing and serialization
+- SSL/HTTPS support with proper certificate verification
+- Configurable timeouts
+- Response helper methods for status checking
+- No external dependencies beyond Ruby standard library

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Felipe Cicolin Rocha
+
+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

@@ -0,0 +1,130 @@
+# MiniHttp
+
+A minimal, lightweight HTTP client library for Ruby that provides a clean interface for making HTTP requests with automatic JSON handling, SSL support, and customizable timeouts.
+
+## Features
+
+- Simple API for GET, POST, PUT, and DELETE requests
+- Automatic JSON parsing and serialization
+- SSL/HTTPS support with proper certificate verification
+- Configurable timeouts
+- Response helper methods for status checking
+- No external dependencies beyond Ruby standard library
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'mini_http'
+```
+
+And then execute:
+
+```bash
+bundle install
+```
+
+Or install it yourself as:
+
+```bash
+gem install mini_http
+```
+
+## Usage
+
+### Basic GET request
+
+```ruby
+response = MiniHttp.get("https://api.example.com/users")
+
+if response.success?
+  users = response.json
+  puts users
+else
+  puts "Error: #{response.code}"
+end
+```
+
+### POST request with JSON body
+
+```ruby
+response = MiniHttp.post(
+  "https://api.example.com/users",
+  body: { name: "John", email: "john@example.com" },
+  headers: { "Authorization" => "Bearer token123" }
+)
+
+if response.success?
+  puts "User created: #{response.json}"
+end
+```
+
+### PUT request
+
+```ruby
+response = MiniHttp.put(
+  "https://api.example.com/users/1",
+  body: { name: "John Updated" },
+  timeout: 60
+)
+```
+
+### DELETE request
+
+```ruby
+response = MiniHttp.delete(
+  "https://api.example.com/users/1",
+  headers: { "Authorization" => "Bearer token123" }
+)
+```
+
+### Response methods
+
+```ruby
+response = MiniHttp.get("https://api.example.com/data")
+
+# Status checking
+response.success?       # true for 2xx status codes
+response.client_error?  # true for 4xx status codes
+response.server_error?  # true for 5xx status codes
+
+# Response data
+response.code           # HTTP status code (integer)
+response.body           # Raw response body (string)
+response.headers        # Response headers (hash)
+response.json           # Parsed JSON (hash/array, nil if not valid JSON)
+```
+
+### Customizing requests
+
+All methods support these optional parameters:
+
+- `headers`: Hash of HTTP headers
+- `timeout`: Request timeout in seconds (default: 30)
+- `body`: Request body for POST/PUT (string or object that responds to `to_json`)
+
+```ruby
+response = MiniHttp.get(
+  "https://api.example.com/data",
+  headers: {
+    "User-Agent" => "MyApp/1.0",
+    "Accept" => "application/json"
+  },
+  timeout: 45
+)
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/felipecicolin/simple_http. This project is intended to be a safe, welcoming space for collaboration.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+require "rubocop/rake_task"
+
+RuboCop::RakeTask.new
+
+task default: %i[spec rubocop]

data/lib/mini_http/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+class MiniHttp
+  VERSION = "0.1.0"
+end

data/lib/mini_http.rb

@@ -0,0 +1,142 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "uri"
+require "json"
+require "openssl"
+require_relative "mini_http/version"
+
+class MiniHttp
+  class Response
+    SUCCESS_RANGE = (200..299).freeze
+    CLIENT_ERROR_RANGE = (400..499).freeze
+    SERVER_ERROR_RANGE = (500..599).freeze
+
+    attr_reader :code, :body, :headers
+
+    def initialize(net_response)
+      @code = extract_status_code(net_response)
+      @body = net_response.body
+      @headers = net_response.to_hash
+    end
+
+    def success?
+      SUCCESS_RANGE.cover?(@code)
+    end
+
+    def client_error?
+      CLIENT_ERROR_RANGE.cover?(@code)
+    end
+
+    def server_error?
+      SERVER_ERROR_RANGE.cover?(@code)
+    end
+
+    def json
+      @json ||= parse_json_safely
+    end
+
+    private
+
+    def extract_status_code(net_response)
+      net_response.code.to_i
+    end
+
+    def parse_json_safely
+      return nil if @body.nil? || @body.empty?
+
+      JSON.parse(@body)
+    rescue JSON::ParserError
+      nil
+    end
+  end
+
+  def self.get(url, headers: {}, timeout: 30)
+    make_request(:get, url, headers: headers, timeout: timeout)
+  end
+
+  def self.post(url, body: nil, headers: {}, timeout: 30)
+    make_request(:post, url, body: body, headers: headers, timeout: timeout)
+  end
+
+  def self.put(url, body: nil, headers: {}, timeout: 30)
+    make_request(:put, url, body: body, headers: headers, timeout: timeout)
+  end
+
+  def self.delete(url, headers: {}, timeout: 30)
+    make_request(:delete, url, headers: headers, timeout: timeout)
+  end
+
+  class << self
+    private
+
+    def make_request(method, url, body: nil, headers: {}, timeout: 30)
+      uri = URI(url)
+      http = build_http_client(uri, timeout)
+      request = build_request(method, uri, body, headers)
+
+      net_response = http.request(request)
+      Response.new(net_response)
+    end
+
+    def build_http_client(uri, timeout)
+      http = Net::HTTP.new(uri.host, uri.port)
+      configure_ssl(http, uri)
+      configure_timeouts(http, timeout)
+      http
+    end
+
+    def configure_ssl(http, uri)
+      return unless uri.scheme == "https"
+
+      http.use_ssl = true
+      http.verify_mode = OpenSSL::SSL::VERIFY_PEER
+    end
+
+    def configure_timeouts(http, timeout)
+      http.read_timeout = timeout
+      http.open_timeout = [timeout / 3, 10].min
+    end
+
+    def build_request(method, uri, body, headers)
+      request = create_request_object(method, uri)
+      set_headers(request, headers)
+      set_body(request, method, body)
+      request
+    end
+
+    def create_request_object(method, uri)
+      case method
+      when :get
+        Net::HTTP::Get.new(uri)
+      when :post
+        Net::HTTP::Post.new(uri)
+      when :put
+        Net::HTTP::Put.new(uri)
+      when :delete
+        Net::HTTP::Delete.new(uri)
+      else
+        raise ArgumentError, "Unsupported HTTP method: #{method}"
+      end
+    end
+
+    def set_headers(request, headers)
+      headers.each { |key, value| request[key] = value }
+    end
+
+    def set_body(request, method, body)
+      return unless body && body_allowed?(method)
+
+      request.body = serialize_body(body)
+      request["Content-Type"] ||= "application/json"
+    end
+
+    def body_allowed?(method)
+      %i[post put].include?(method)
+    end
+
+    def serialize_body(body)
+      body.is_a?(String) ? body : body.to_json
+    end
+  end
+end

metadata

@@ -0,0 +1,53 @@
+--- !ruby/object:Gem::Specification
+name: mini_http
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Felipe Cicolin Rocha
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+description: MiniHttp provides a clean, easy-to-use interface for making HTTP requests
+  with automatic JSON handling, SSL support, and customizable timeouts.
+email:
+- felipecicolinrocha@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- ".rubocop.yml"
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/mini_http.rb
+- lib/mini_http/version.rb
+homepage: https://github.com/felipecicolin/mini_http
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/felipecicolin/mini_http
+  source_code_uri: https://github.com/felipecicolin/mini_http
+  changelog_uri: https://github.com/felipecicolin/mini_http/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.7
+specification_version: 4
+summary: A minimal HTTP client library for Ruby
+test_files: []