ice-jade 0.1.0 → 0.6.0

data/lib/ice_jade/cradle/yaml_server.rb

@@ -0,0 +1,109 @@
+# frozen_string_literal: true
+
+require 'yaml'
+require_relative 'server'
+
+module IceJade
+  module Cradle
+    # YAML 配置驱动的 Cradle 实例
+    #
+    # 通过载入 YAML 配置文件，启动定制化的 HTTP 测试服务器。
+    # 与内置 Cradle 服务器独立，专注于通过配置快速搭建测试端点。
+    #
+    # @example 配置启动
+    #   instance = IceJade::Cradle::YAMLServer.new('config/cradle/poster_test.yml')
+    #   instance.start
+    #
+    class YAMLServer
+      attr_reader :config, :server
+
+      # 预定义路由处理器（按 handler 名称引用）
+      # 每个 lambda 接收 (request, route_cfg) 两个参数，返回 [status, headers, body]
+      HANDLERS = {
+        # 回显 JSON 请求体：method / path / content_type / headers / body
+        'echo_json' => lambda { |req, _cfg|
+          body = {
+            method: req.method,
+            path: req.path,
+            content_type: req.content_type,
+            headers: req.headers,
+            body: req.parsed_body
+          }
+          [200, { 'Content-Type' => 'application/json' }, JSON.generate(body)]
+        },
+
+        # 回显 form-urlencoded 数据
+        'echo_form' => lambda { |req, _cfg|
+          [200, { 'Content-Type' => 'application/json' },
+           JSON.generate(form: req.parsed_body)]
+        },
+
+        # 回显 multipart 上传：files（含文件名/大小/类型） + 普通字段
+        'echo_upload' => lambda { |req, _cfg|
+          files_info = req.files.transform_values do |v|
+            { filename: v[:filename], size: v[:data].bytesize,
+              content_type: v[:content_type] }
+          end
+          [200, { 'Content-Type' => 'application/json' },
+           JSON.generate(files: files_info, fields: req.form_data)]
+        },
+
+        # 静态响应：直接返回 YAML 中配置的 status / headers / body
+        'static' => lambda { |_req, cfg|
+          status = cfg['status'] || 200
+          headers = cfg['headers'] || { 'Content-Type' => 'application/json' }
+          body = cfg['body'] || '{}'
+          [status, headers, body]
+        },
+
+        # 延迟响应：按 URL 参数 :seconds 或 YAML 中 delay 字段等待
+        'delay' => lambda { |req, cfg|
+          seconds = req.route_params['seconds'] || cfg['delay'] || 1
+          sleep(seconds.to_f)
+          [200, { 'Content-Type' => 'application/json' },
+           JSON.generate(delayed: true)]
+        }
+      }.freeze
+
+      # @param config_path [String] YAML 配置文件路径
+      def initialize(config_path)
+        @config = YAML.load_file(config_path)
+        @config['host'] ||= '127.0.0.1'
+        @config['port'] ||= 8765
+        @server = Cradle::Server.new(
+          port: @config['port'],
+          host: @config['host'],
+          silent: true
+        )
+        setup_routes
+      end
+
+      # 启动服务器（阻塞）
+      def start
+        @server.start
+      end
+
+      # 停止服务器
+      def stop
+        @server.stop
+      end
+
+      private
+
+      def setup_routes
+        (@config['routes'] || []).each do |route_cfg|
+          method = (route_cfg['method'] || 'ALL').to_s.upcase
+          path   = route_cfg['path']
+          handler_name = route_cfg['handler'] || 'static'
+          handler = HANDLERS[handler_name]
+
+          next unless handler
+
+          @server.route(method, path) do |req|
+            handler.call(req, route_cfg)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ice_jade/cradle.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require_relative 'cradle/server'
+require_relative 'cradle/yaml_server'

data/lib/ice_jade/poster/client.rb

@@ -0,0 +1,248 @@
+# frozen_string_literal: true
+
+require 'net/http'
+require 'json'
+require 'uri'
+require 'securerandom'
+require_relative '../response'
+require_relative '../error'
+
+module IceJade
+  module Poster
+    # 通用 HTTP POST 客户端
+    #
+    # 零外部依赖，支持 JSON / Form / Multipart 三种常用提交方式，
+    # 内置超时控制、指数退避重试、统一 Response 包装，与 Quantum 模块风格一致。
+    #
+    # @example 基础用法
+    #   poster = IceJade::Poster::Client.new(
+    #     base_url: 'https://api.example.com',
+    #     headers:  { 'Authorization' => 'Bearer token' },
+    #     timeout:  30
+    #   )
+    #   resp = poster.post_json('/users', { name: 'Alice' })
+    #   puts resp.data if resp.success?
+    #
+    class Client
+      attr_reader :base_url, :default_headers, :timeout, :open_timeout, :max_retries
+
+      # @param base_url     [String, nil] 基础 URL，后续请求可传相对路径
+      # @param headers      [Hash] 默认请求头（每次请求自动合并，同名会被覆盖）
+      # @param timeout      [Integer] 读取超时（秒），默认 60
+      # @param open_timeout [Integer] 连接超时（秒），默认 10
+      # @param max_retries  [Integer] 超时后最大重试次数，默认 2
+      def initialize(base_url: nil, headers: {}, timeout: 60, open_timeout: 10, max_retries: 2)
+        @base_url = base_url ? base_url.to_s.chomp('/') : nil
+        @default_headers = normalize_headers(headers)
+        @timeout = timeout
+        @open_timeout = open_timeout
+        @max_retries = max_retries
+      end
+
+      # ------------------------------------------------------------------
+      # 通用 POST
+      # ------------------------------------------------------------------
+
+      # 发送通用 POST 请求
+      #
+      # @param url          [String]  完整 URL 或相对路径（需先设置 base_url）
+      # @param body         [String, Hash, nil] 请求体；Hash 会根据 content_type 自动序列化
+      # @param headers      [Hash]    额外请求头（与默认头合并，同名覆盖）
+      # @param content_type [String]  Content-Type，默认 application/json
+      # @return [IceJade::Response]
+      def post(url, body = nil, headers: {}, content_type: 'application/json')
+        uri = build_uri(url)
+        merged_headers = merge_headers(default_headers, normalize_headers(headers))
+        req = build_request(uri, body, content_type, merged_headers)
+        execute(uri, req)
+      end
+
+      # ------------------------------------------------------------------
+      # 快捷方法
+      # ------------------------------------------------------------------
+
+      # POST JSON（API 调用最常用）
+      # @param url    [String]
+      # @param params [Hash] 请求参数，自动转为 JSON
+      # @param headers [Hash] 额外请求头
+      # @return [IceJade::Response]
+      def post_json(url, params = {}, headers = {})
+        post(url, params, headers: headers, content_type: 'application/json')
+      end
+
+      # POST Form（传统表单提交）
+      # @param url    [String]
+      # @param params [Hash] 请求参数，自动转为 URL-encoded
+      # @param headers [Hash] 额外请求头
+      # @return [IceJade::Response]
+      def post_form(url, params = {}, headers = {})
+        post(url, params, headers: headers, content_type: 'application/x-www-form-urlencoded')
+      end
+
+      # POST Multipart（文件上传）
+      #
+      # @param url     [String]
+      # @param params  [Hash] 支持文件字段（值为本地文件路径字符串）
+      #   示例: { file: '/path/to/file.png', purpose: 'image' }
+      # @param headers [Hash] 额外请求头
+      # @return [IceJade::Response]
+      def post_multipart(url, params = {}, headers = {})
+        uri = build_uri(url)
+        body, boundary = build_multipart(params)
+        merged_headers = merge_headers(default_headers, normalize_headers(headers))
+        merged_headers['Content-Type'] = "multipart/form-data; boundary=#{boundary}"
+
+        req = Net::HTTP::Post.new(uri)
+        apply_headers(req, merged_headers)
+        req.body = body
+
+        execute(uri, req)
+      end
+
+      private
+
+      def build_uri(url)
+        if base_url && !url.to_s.start_with?('http')
+          URI.parse("#{base_url}#{url}")
+        else
+          URI.parse(url.to_s)
+        end
+      end
+
+      def build_request(uri, body, content_type, headers)
+        req = Net::HTTP::Post.new(uri)
+        apply_headers(req, headers)
+
+        case content_type.to_s
+        when /application\/json/
+          req['Content-Type'] = 'application/json'
+          req.body = body.is_a?(Hash) ? JSON.generate(body) : body.to_s
+        when /application\/x-www-form-urlencoded/
+          req['Content-Type'] = 'application/x-www-form-urlencoded'
+          req.body = body.is_a?(Hash) ? URI.encode_www_form(body) : body.to_s
+        else
+          req['Content-Type'] = content_type
+          req.body = body.is_a?(String) ? body : body.to_s
+        end
+
+        req
+      end
+
+      def apply_headers(req, headers)
+        headers.each do |k, v|
+          req[k.to_s] = v.to_s
+        end
+      end
+
+      def normalize_headers(h)
+        h.transform_keys(&:to_s).transform_values(&:to_s)
+      end
+
+      def merge_headers(base, extra)
+        base.merge(extra)
+      end
+
+      def execute(uri, request)
+        http = Net::HTTP.new(uri.host, uri.port)
+        http.use_ssl = uri.scheme == 'https'
+        http.open_timeout = open_timeout
+        http.read_timeout = timeout
+
+        retries = 0
+        begin
+          response = http.request(request)
+          Response.new(adapt_response(response))
+        rescue Net::OpenTimeout, Net::ReadTimeout => e
+          retries += 1
+          if retries <= max_retries
+            sleep(2**retries)
+            retry
+          end
+          Response.new({ 'ok' => false, 'code' => 0,
+                         'message' => "Timeout after #{max_retries} retries: #{e.message}", 'data' => nil })
+        rescue StandardError => e
+          Response.new({ 'ok' => false, 'code' => 0, 'message' => e.message, 'data' => nil })
+        ensure
+          http.finish if http.started?
+        end
+      end
+
+      # 内置 HTTP 状态码文本（兼容各 Ruby 版本）
+      HTTP_STATUS_TEXT = {
+        100 => 'Continue', 101 => 'Switching Protocols',
+        200 => 'OK', 201 => 'Created', 202 => 'Accepted',
+        204 => 'No Content',
+        301 => 'Moved Permanently', 302 => 'Found', 304 => 'Not Modified',
+        400 => 'Bad Request', 401 => 'Unauthorized', 403 => 'Forbidden',
+        404 => 'Not Found', 405 => 'Method Not Allowed',
+        429 => 'Too Many Requests',
+        500 => 'Internal Server Error', 502 => 'Bad Gateway',
+        503 => 'Service Unavailable'
+      }.freeze
+
+      def adapt_response(response)
+        body = response.body.to_s
+        code = response.code.to_i
+
+        data = begin
+                 JSON.parse(body)
+               rescue JSON::ParserError
+                 body
+               end
+
+        {
+          'ok' => code >= 200 && code < 300,
+          'code' => code,
+          'message' => HTTP_STATUS_TEXT[code] || 'Unknown',
+          'data' => data
+        }
+      end
+
+      def build_multipart(params)
+        boundary = "----IceJadePosterBoundary#{SecureRandom.hex(16)}"
+        body = +"".b
+
+        params.each do |key, value|
+          if value.is_a?(String) && File.exist?(value)
+            filename = File.basename(value)
+            file_data = File.binread(value)
+            mime = mime_type(filename)
+            body << "--#{boundary}\r\n"
+            body << %(Content-Disposition: form-data; name="#{key}"; filename="#{filename}") << "\r\n"
+            body << "Content-Type: #{mime}" << "\r\n\r\n"
+            body << file_data.b
+            body << "\r\n"
+          else
+            body << "--#{boundary}\r\n"
+            body << %(Content-Disposition: form-data; name="#{key}") << "\r\n\r\n"
+            body << value.to_s
+            body << "\r\n"
+          end
+        end
+
+        body << "--#{boundary}--\r\n"
+        [body, boundary]
+      end
+
+      def mime_type(filename)
+        ext = File.extname(filename).downcase
+        case ext
+        when '.png'            then 'image/png'
+        when '.jpg', '.jpeg'   then 'image/jpeg'
+        when '.gif'            then 'image/gif'
+        when '.webp'           then 'image/webp'
+        when '.bmp'            then 'image/bmp'
+        when '.pdf'            then 'application/pdf'
+        when '.txt'            then 'text/plain'
+        when '.json'           then 'application/json'
+        when '.zip'            then 'application/zip'
+        when '.doc'            then 'application/msword'
+        when '.docx'           then 'application/vnd.openxmlformats-officedocument.wordprocessingml.document'
+        when '.xls'            then 'application/vnd.ms-excel'
+        when '.xlsx'           then 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
+        else                        'application/octet-stream'
+        end
+      end
+    end
+  end
+end

data/lib/ice_jade/poster.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require_relative 'poster/client'

data/lib/ice_jade/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module IceJade
-  VERSION = '0.1.0'
+  VERSION = '0.6.0'
 end

data/lib/ice_jade.rb

@@ -9,3 +9,5 @@ require_relative 'ice_jade/response'
 require_relative 'ice_jade/client_base'
 require_relative 'ice_jade/quantum/client'
 require_relative 'ice_jade/quantum/message'
+require_relative 'ice_jade/poster'
+require_relative 'ice_jade/cradle'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ice-jade
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Frampt
@@ -9,18 +9,34 @@ bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
-description: A lightweight Ruby SDK for IM robot messaging.
+description: A lightweight Ruby SDK featuring Quantum (IM robot messaging) and Poster
+  (zero-dependency HTTP POST client with JSON/Form/Multipart support).
 email:
 - 18995691365@189.cn
-executables: []
+executables:
+- cradle
+- cradle-instance
 extensions: []
 extra_rdoc_files: []
 files:
 - LICENSE
 - README.md
+- bin/cradle
+- bin/cradle-instance
+- config/cradle/poster_test.yml
+- examples/comparison_poster.rb
+- examples/cradle_usage.rb
+- examples/poster_usage.rb
+- examples/quantum_usage.rb
+- lib/http_poster.rb
 - lib/ice_jade.rb
 - lib/ice_jade/client_base.rb
+- lib/ice_jade/cradle.rb
+- lib/ice_jade/cradle/server.rb
+- lib/ice_jade/cradle/yaml_server.rb
 - lib/ice_jade/error.rb
+- lib/ice_jade/poster.rb
+- lib/ice_jade/poster/client.rb
 - lib/ice_jade/quantum/client.rb
 - lib/ice_jade/quantum/message.rb
 - lib/ice_jade/response.rb
@@ -45,5 +61,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 4.0.10
 specification_version: 4
-summary: IM webhook & outgoing-callback SDK
+summary: IM webhook SDK & general-purpose HTTP POST client
 test_files: []