yobi-http 0.14.0 → 0.18.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 42bdd81cec29bd949acd4b1a96698e219bc6298a71eced3aa36c8cee4b965dc4
-  data.tar.gz: f0cf545e7c5d13f5543dbbfa63e72d563d03afc12d74cdbd45c47479f14064a6
+  metadata.gz: b5994458b4f28cc4879858782a1dbc26a90f8ab77d7bf97b5a13ee7aaec13092
+  data.tar.gz: ac095c048327a1ce8260f388dcc414c647fa9f912f15ab9f43fabb1327225f69
 SHA512:
-  metadata.gz: bf2635eba8c559e6459d638dd944d315cb571833d60cffa208a7629d4d07110c86a39ac924b18639e3e94381575ea2cdbf039c70e9186006f69f11f889a8ae30
-  data.tar.gz: 98f048dbbf3512cb34782e14d26f737a06ea6ce68ca75ab2df13b158d5a8b8f00e9d7a0f7d08b0518254559ca587ee6bc5114bed543b61522816387ccab9a8be
+  metadata.gz: 9a1db1c25476849b0169d3d535d3ced35f2d14034363617211aff38f7903970d9056269231d83e8617392c66587eae32ef42fd573080bd3f5165d8b7de63f63f
+  data.tar.gz: 2ba909e076ccf9a12ff9f624ebe545675d6c540aaa248951a0ff7a5504a38d476c38b07e1fe321e5de921fd693a01be84dcee6169f6a23cde0ce7e01c3020c95

data/README.md

@@ -2,29 +2,198 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
 [![Maintainability](https://qlty.sh/gh/dvinciguerra/projects/yobi-http/maintainability.svg)](https://qlty.sh/gh/dvinciguerra/projects/yobi-http)
 
-# Yobi(呼び) Http Client
+# :zap: Yobi(呼び) Http Client
 
-Yobi is a Ruby gem that provides a simple and efficient way to make HTTP requests. It is designed to be easy to use
-and flexible, allowing you to customize your requests as needed.
-
-Its a lightweight implementation of the HTTPie tool, which is a command-line HTTP client that allows you to make
-HTTP requests and view the responses in a human-friendly format.
+Yobi (呼び) is a modern HTTP client for the command line, written in Ruby, that makes interacting with APIs simple, intuitive, and fun. Inspired by HTTPie, Yobi provides an elegant way to make HTTP requests with formatted and readable output.
 
 ![](./screenshot.png)
 
+#### Main Features
+
+* Simple and intuitive interface - Natural and easy-to-remember syntax
+* Automatic formatting - JSON responses with syntax highlighting
+* Multiple authentication types - Basic, Bearer, Digest, and more
+* File download - Save responses directly to files
+* Redirect tracking - Automatically follow HTTP redirects
+* Customizable output - Control exactly what you want to see (headers, body, or both)
+* Full HTTP support - GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS
+* Offline mode - Prepare and review requests without sending them
+* No heavy dependencies - Quick installation via RubyGems
+* Raw mode - Raw output for integration with other tools
+
+
 ## Installation
 
+#### Prerequisites
+
+* Ruby >= 3.0.0
+* RubyGems (usually included with Ruby)
+
+#### Via RubyGems (Recommended)
+
+```bash
+gem install yobi-http
+```
+
+#### From Source Code
+
 ```bash
+# Clone the repository
+git clone https://github.com/dvinciguerra/yobi-http.git
+cd yobi-http
+
+# Install dependencies
+bundle install
+
+# Install the gem locally
+bundle exec rake install```bash
 gem install yobi-http
 ```
 
-## Usage
+#### Check Installation
+
+```bash
+yobi --version
+```
+
+If you receive command not found: yobi:
+
+* Ensure that the RubyGems bin directory is in your PATH.
+* Try using gem which yobi-http to locate the installation.
+
+
+## Quick Guide
+
+#### Basic Syntax
+
+```bash
+yobi [METHOD] <url> [HEADER:VALUE] [key=value] [key::value]
+```
+
+### Instant Examples
+
+```bash
+# Simple GET
+yobi https://api.github.com/users/github
+
+# POST with JSON
+yobi POST https://jsonplaceholder.typicode.com/posts \
+  title="Hello" \
+  body="World" \
+  userId=1
+
+# With authentication
+yobi -A basic -a username:password https://api.example.com/data
+
+# WITH custom header
+yobi GET https://api.example.com/data \
+  Authorization:"Bearer your_token_here"
+
+# Save response to file
+yobi https://api.example.com/data -o response.json
+
+# Use localhost shortcut
+yobi :8080/api/items
+# Expands to: http://localhost:8080/api/items
+```
+
+**JSONPlaceholder API (Testing Service)**
+
+```bash
+# Get all posts
+yobi https://jsonplaceholder.typicode.com/posts
+
+# Get specific post
+yobi https://jsonplaceholder.typicode.com/posts/1
+
+# Create new post
+yobi POST https://jsonplaceholder.typicode.com/posts \
+  title="My new post" \
+  body="This is the content" \
+  userId=1
+
+# Update post
+yobi PUT https://jsonplaceholder.typicode.com/posts/1 \
+  title="Updated title"
+
+# Delete post
+yobi DELETE https://jsonplaceholder.typicode.com/posts/1
+```
+
+**GitHub API**
+
+```bash
+# User information
+yobi https://api.github.com/users/dvinciguerra
+
+# User repositories
+yobi https://api.github.com/users/dvinciguerra/repos
+
+# With authentication (personal token)
+yobi -A bearer -a your_github_token https://api.github.com/user
+```
+
+**HTTPBin (API Testing Tool)**
+
+```bash
+# GET with query params
+yobi https://httpbin.org/get name=John age=30
+
+# POST with JSON
+yobi POST https://httpbin.org/post name=John age:=30 active:=true
+
+# Custom headers
+yobi https://httpbin.org/headers \
+  "X-Custom:value" \
+  "User-Agent:Yobi/1.0"
+
+# Basic authentication test
+yobi https://httpbin.org/basic-auth/username/password \
+  -A basic -a username:password
+
+# Simulate delay
+yobi https://httpbin.org/delay/5
+
+# Test timeout
+yobi --timeout 2 https://httpbin.org/delay/10
+```
+
+**Typical REST API**
+
+```bash
+# List resources
+yobi GET https://api.example.com/v1/users
+
+# Create resource
+yobi POST https://api.example.com/v1/users \
+  name="John Silva" \
+  email="john@example.com" \
+  department="IT"
+
+# Update resource
+yobi PUT https://api.example.com/v1/users/123 \
+  name="John da Silva" \
+  department="Development"
+
+# Partial update
+yobi PATCH https://api.example.com/v1/users/123 \
+  department="Management"
+
+# Delete resource
+yobi DELETE https://api.example.com/v1/users/123
+
+# With pagination
+yobi GET https://api.example.com/v1/users \
+  page:=1 \
+  limit:=10
+
+# With filters
+yobi GET https://api.example.com/v1/users \
+  department="IT" \
+  status="active"
+```
 
-Some examples of how to use yobi:
 
-- `yobi GET https://jsonplaceholder.typicode.com/posts/1` - Makes a GET request to the specified URL and prints the response.
-- `yobi POST https://jsonplaceholder.typicode.com/posts title="foo" body="bar" userId=1` - Makes a POST request to the specified URL with the given data and prints the response.
-- `yobi GET https://jsonplaceholder.typicode.com/posts/1 Authorization:"Bearer <token>"` - Makes a GET request to the specified URL with the given header and prints the response.
 
 ## Development
 

data/exe/yobi

@@ -16,7 +16,7 @@ require "yobi"
 # parsing arguments
 @options = {
   print: "HB", auth: nil, auth_type: "basic", verbose: false, raw: false, offline: false, follow: false, debug: false,
-  timeout: nil, download: false
+  timeout: nil, download: false, output: nil, content_type: :json
 }
 
 parser = OptionParser.new do |opts|
@@ -28,7 +28,7 @@ parser = OptionParser.new do |opts|
 
   Examples:
     yobi https://api.example.com/users
-    yobi POST https://api.example.com/users name=John age=30
+    yobi POST https://api.example.com/products name="New Product" price:=19.99 enabled:=true tags:=@tags.json
     yobi GET :8080/api/items Authorization:"Bearer $TOKEN"
     yobi -A basic -a user:pass https://api.example.com/secure-data
     yobi --raw --print B POST https://httpbin.org/anything | jq '.headers["User-Agent"]'
@@ -53,9 +53,40 @@ parser = OptionParser.new do |opts|
     @options[:raw] = true
   end
 
-  opts.on("-h", "--help", "Print this help message") do
-    puts opts
-    exit
+  opts.on("-h", "--headers", "Print only response headers") do
+    @options[:raw] = true
+    @options[:print] = "H"
+  end
+
+  opts.on("-b", "--body", "Print only response body") do
+    @options[:raw] = true
+    @options[:print] = "B"
+  end
+
+  opts.on("--status", "Print only response status code") do
+    @options[:raw] = true
+    @options[:print] = "status"
+  end
+
+  opts.on("--form", "Send data as application/x-www-form-urlencoded instead of JSON") do
+    @options[:content_type] = :form
+  end
+
+  opts.on("--multipart", "Send data as multipart/form-data instead of JSON") do
+    @options[:content_type] = :multipart
+  end
+
+  opts.on("--xml", "Send data as application/xml instead of JSON") do
+    @options[:content_type] = :xml
+  end
+
+  opts.on("--binary", "Send data as application/octet-stream instead of JSON") do
+    @options[:content_type] = :binary
+  end
+
+  opts.on("--json", "Send data as application/json (default)") do
+    # This option is implicit since JSON is the default, but we can set it explicitly if needed
+    @options[:content_type] = :json
   end
 
   opts.on("--offline", "Run in offline mode (prepare request but do not send)") do
@@ -91,6 +122,11 @@ parser = OptionParser.new do |opts|
     puts "#{Yobi.name} v#{Yobi::VERSION}"
     exit
   end
+
+  opts.on("--help", "Print this help message") do
+    puts opts
+    exit
+  end
 end
 
 parser.parse!(ARGV)
@@ -101,13 +137,14 @@ method = Yobi.args.http_method?(ARGV[0]) ? ARGV.shift : "GET"
 # resolve the URL
 url = Yobi.args.url(ARGV.shift)
 
-data = Yobi.args.parse_data(ARGV)
-headers = Yobi.args.parse_headers(ARGV)
+data = Yobi.args.parse_data(ARGV, @options)
+query = Yobi.args.parse_query(ARGV, @options)
+headers = Yobi.args.parse_headers(ARGV, @options)
 
 # prepare authentication header if auth is provided
 Yobi.args.auth_header(headers, @options) if @options[:auth]
 
-Yobi::Http.request(method, url, data: data, headers: headers, options: @options) do |http, request|
+Yobi::Http.request(method, url, data: data, headers: headers, query: query, options: @options) do |http, request|
   options = @options
 
   # follow redirects, offline, download or standard request mode
@@ -123,7 +160,9 @@ Yobi::Http.request(method, url, data: data, headers: headers, options: @options)
     end
 
   # render output
-  if options[:raw]
+  if options[:raw] && options[:print].downcase == "status"
+    print response.code
+  elsif options[:raw]
     Yobi::Renders::Raw.render(request, response, options)
   else
     Yobi::Renders::Colored.render(request, response, options)

data/lib/yobi/cli/arguments.rb

@@ -22,12 +22,16 @@ module Yobi
           end
         end
 
+        def parse_query(args, _options)
+          args.select { |arg| arg.match?(/::/) }.map.to_h { |arg| arg.split("::", 2).map(&:strip) }
+        end
+
         # rubocop:disable Metrics/AbcSize, Metrics/MethodLength, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
-        def parse_data(args)
-          args.select { |arg| arg.match?("^.*(=|:=|=@|:=@).*$") }.map.to_h do |arg|
+        def parse_data(args, _options)
+          args.select { |arg| arg.match?("^.*(={1}|:=|=@|:=@).*$") }.map do |arg|
             case arg
             when /:=@/
-              arg.split(/:=@/, 2).map do |part|
+              arg.split(":=@", 2).map do |part|
                 part = String(part)&.strip
                 File.exist?(part) ? JSON.parse(File.read(part)) : part
               end
@@ -47,15 +51,18 @@ module Yobi
             else
               arg.split("=", 2).map(&:strip)
             end
-          end
+          end.compact.to_h
         end
         # rubocop:enable Metrics/AbcSize, Metrics/MethodLength, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
 
-        def parse_headers(args)
-          { "Content-Type" => "application/json", "User-Agent" => "#{Yobi.name}/#{Yobi::VERSION}" }
-            .merge(args.select do |arg|
-                     arg.match?(/:/) && !arg.match?(/:=/)
-                   end.map.to_h { |arg| arg.split(":", 2).map(&:strip) })
+        def parse_headers(args, options)
+          content_type = content_type_for options[:content_type]
+
+          { "Content-Type" => content_type, "User-Agent" => "#{Yobi.name}/#{Yobi::VERSION}" }.merge(
+            args
+              .select { |arg| arg.match?(/:{1}/) && !arg.match?(/:=/) && !arg.match?(/::/) }
+              .map.to_h { |arg| arg.split(/:{1}/, 2).map(&:strip) }
+          )
         end
 
         def auth_header(headers, options)
@@ -73,6 +80,25 @@ module Yobi
             exit 1
           end
         end
+
+        private
+
+        def content_type_for(value)
+          case value
+          when :form
+            "application/x-www-form-urlencoded"
+          when :multipart
+            "multipart/form-data"
+          when :xml
+            "application/xml"
+          when :binary
+            "application/octet-stream"
+          when :json, nil
+            "application/json"
+          else
+            "application/json"
+          end
+        end
       end
     end
   end

data/lib/yobi/http.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require "json"
 require "net/http"
 
 module Yobi
@@ -7,10 +8,22 @@ module Yobi
   module Http
     METHODS = %w[GET POST PUT DELETE PATCH HEAD OPTIONS].freeze
 
+    CONTENT_TYPES = {
+      text: "text/plain",
+      html: "text/html",
+      form: "application/x-www-form-urlencoded",
+      multipart: "multipart/form-data",
+      xml: "application/xml",
+      binary: "application/octet-stream",
+      json: "application/json"
+    }.freeze
+
     class << self
-      # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
-      def request(method, url, data: {}, headers: {}, options: {})
+      # rubocop:disable Metrics/AbcSize, Metrics/MethodLength, Metrics/ParameterLists
+      def request(method, url, data: {}, query: {}, headers: {}, options: {})
         @uri = URI(url)
+        @uri.query = URI.encode_www_form(**query) unless query.empty?
+
         @options = options
         @method = method.capitalize
 
@@ -28,12 +41,18 @@ module Yobi
           request.body = data.to_json unless data.empty?
 
           yield(http, request) if block_given?
-        rescue Net::OpenTimeout, Net::ReadTimeout => e
-          warn "Request timed out: #{e.message}"
-          exit 1
         end
+      rescue Net::OpenTimeout, Net::ReadTimeout => e
+        warn "Timeout: #{e.message}"
+        exit 1
+      rescue SocketError, Socket::ResolutionError => e
+        warn "Network error: #{e.message}"
+        exit 1
+      rescue StandardError => e
+        warn "Error: #{e.message}"
+        exit 1
       end
-      # rubocop:enable Metrics/AbcSize, Metrics/MethodLength
+      # rubocop:enable Metrics/AbcSize, Metrics/MethodLength, Metrics/ParameterLists
 
       # rubocop:disable Metrics/ParameterLists
       def follow_redirects(response, url, method, data, headers, options)
@@ -50,7 +69,7 @@ module Yobi
       end
       # rubocop:enable Metrics/ParameterLists
 
-      # rubocop:disable Metrics/MethodLength, Metrics/AbcSize
+      # rubocop:disable Metrics/AbcSize
       def offline_mode(_request, options)
         Net::HTTP.class_eval do
           def connect; end
@@ -59,7 +78,7 @@ module Yobi
         options[:verbose] = true
 
         Net::HTTPResponse.new("1.1", "200", "OK").tap do |response|
-          response["Content-Type"] = "application/json"
+          response["Content-Type"] = CONTENT_TYPES.fetch(options[:content_type], CONTENT_TYPES[:json])
           response["Access-Control-Allow-Credentials"] = true
           response["Access-Control-Allow-Origin"] = "*"
           response["Connection"] = "close"
@@ -71,9 +90,9 @@ module Yobi
           response.instance_variable_set(:@read, true)
         end
       end
-      # rubocop:enable Metrics/MethodLength, Metrics/AbcSize
+      # rubocop:enable Metrics/AbcSize
 
-      # rubocop:disable Metrics/MethodLength, Metrics/AbcSize
+      # rubocop:disable Metrics/AbcSize
       def download(request, http, options)
         http.request(request) do |response|
           url = request.uri.to_s
@@ -93,7 +112,7 @@ module Yobi
 
         exit 0
       end
-      # rubocop:enable Metrics/MethodLength, Metrics/AbcSize
+      # rubocop:enable Metrics/AbcSize
     end
   end
 end

data/lib/yobi/version.rb

@@ -2,5 +2,5 @@
 
 module Yobi
   # Yobi gem version
-  VERSION = "0.14.0"
+  VERSION = "0.18.0"
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: yobi-http
 version: !ruby/object:Gem::Version
-  version: 0.14.0
+  version: 0.18.0
 platform: ruby
 authors:
 - Daniel Vinciguerra
 bindir: exe
 cert_chain: []
-date: 2026-02-27 00:00:00.000000000 Z
+date: 2026-03-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64