yobi-http 0.16.0 → 0.18.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3558906f242a7670158833610ad7b062bf25e308e4985804241bdba30a9d6968
-  data.tar.gz: d96e600ccdf03ebcddb0c9ce14a3a2c141fb1a1ba2ffe04ee7cdb0a1a5383c7d
+  metadata.gz: b5994458b4f28cc4879858782a1dbc26a90f8ab77d7bf97b5a13ee7aaec13092
+  data.tar.gz: ac095c048327a1ce8260f388dcc414c647fa9f912f15ab9f43fabb1327225f69
 SHA512:
-  metadata.gz: 68ec04f8b731ebc0e9f508ed332d6414292963d1dbbd97aaba96a360e930ce3d1421812d11c1031305126633db9ad012fb2f4efa6e170aba4e09e3eeef37cf3e
-  data.tar.gz: 61c69a1bfdc761df2c791396fb84a3ce5183bf24b71ffb4073fbebdbd1e86b3e5e6986fbeeb977a7c2225624d72d083270e585e0afe186030066b3dab05f0e6c
+  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

@@ -53,6 +53,21 @@ parser = OptionParser.new do |opts|
     @options[:raw] = true
   end
 
+  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
@@ -74,11 +89,6 @@ parser = OptionParser.new do |opts|
     @options[:content_type] = :json
   end
 
-  opts.on("-h", "--help", "Print this help message") do
-    puts opts
-    exit
-  end
-
   opts.on("--offline", "Run in offline mode (prepare request but do not send)") do
     @options[:offline] = true
   end
@@ -112,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)
@@ -145,7 +160,9 @@ Yobi::Http.request(method, url, data: data, headers: headers, query: query, opti
     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/http.rb

@@ -41,10 +41,16 @@ 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, Metrics/ParameterLists
 

data/lib/yobi/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: yobi-http
 version: !ruby/object:Gem::Version
-  version: 0.16.0
+  version: 0.18.0
 platform: ruby
 authors:
 - Daniel Vinciguerra