cc 1.2.1 → 1.4.0

data/text-client.rb

@@ -0,0 +1,297 @@
+#!/usr/bin/env ruby
+#coding:utf-8
+
+############################################################################################################
+# text-client —— C 端：textmind 命令行传入解析                                                            #
+#                                                                                                          #
+# 移植改造自 imdoc/TextUtils 的 tm CLI 与 config.ru 使用方式：                                              #
+#   - 默认本地执行（加载同目录 text-tools.rb，不依赖任何网络与服务）                                        #
+#   - --remote URL 时走 S 端（text-server.rb）服务解析，本地/远程结果一致                                    #
+#   - 操作名与参数名和 S 端 URL 路由一一对应，Postman 集合里的用法可原样翻译成命令行                        #
+#                                                                                                          #
+# 用法：                                                                                                   #
+#   ruby text-client.rb <namespace> <op> [参数...]                                                        #
+#     namespace: type | text | list | tree                                                                 #
+#     op: 操作名（可含子路径，如 match/paragraph、draw/lines）                                             #
+#                                                                                                          #
+#   数据输入：                                                                                             #
+#     --text "字符串"     文本/类型操作输入（或 --file PATH，或管道 stdin）                                 #
+#     --list '[1,2,3]'    列表操作输入（JSON 数组）                                                         #
+#     --tree '{"a":1}'    树操作输入（JSON 对象）                                                           #
+#     布尔开关（如 --strip）出现即置 true；--patterns/--attaches/--oprands/--oprand 若以 [ 或 { 开头按 JSON  #
+#     解析，与 S 端 JSON 请求体语义对齐                                                                     #
+#                                                                                                          #
+#   通用：                                                                                                 #
+#     --remote http://127.0.0.1:9292   改走 S 端服务解析                                                   #
+#     --help                           帮助                                                                #
+#                                                                                                          #
+#   输出：JSON（与 S 端响应一致）；用法/连接错误输出到 stderr 并返回 1                                       #
+#                                                                                                          #
+# 示例：                                                                                                   #
+#   ruby text-client.rb type int --radix 2 --text 100                      # => 4                          #
+#   ruby text-client.rb text head --prefix aa --text aabbcc                # => true                       #
+#   ruby text-client.rb text match/paragraph --start a --finish b --text a1a2b3                            #
+#   echo "abedef" | ruby text-client.rb text exchange --oldtext e --newtext z                             #
+#   ruby text-client.rb list map --func "proc{|c| c * 2}" --list '[1,2,3]'  # => [2,4,6]                   #
+#   ruby text-client.rb tree + --oprand '[1,3,5]' --tree '{"a":1}'          # => {"a":1,"0":1,"1":3,"2":5}  #
+#   ruby text-client.rb --remote http://127.0.0.1:9292 text head --prefix aa --text aabbcc                  #
+############################################################################################################
+
+require_relative 'text-tools'
+require 'json'
+require 'net/http'
+
+module TextClient
+  # 结构化参数键：这些键的值以 [ 或 { 开头时按 JSON 解析（与 S 端 JSON 请求体语义对齐），
+  # 其余一律保持字符串（数字/布尔由操作端自行 to_i/判断，与 S 端一致）。
+  STRUCTURED_KEYS = %w{list tree oprand oprands patterns attaches item val}
+
+  module_function
+
+  # 结构化参数解析：结构化键的值尝试按 JSON 解析（数字/布尔/数组/对象），解析失败保持原串。
+  #
+  # @param name [String] 参数名
+  # @param value [String] 命令行参数值
+  # @return [Object] 解析结果
+  def coerce name, value
+    return value unless STRUCTURED_KEYS.include?(name) && value.is_a?(String)
+    JSON.parse(value)
+  rescue JSON::ParserError
+    value
+  end
+
+  # 解析命令行参数：--key value 成对（也接受 --key=value 写法），
+  # 值缺失或下一个也是 --开关 时视为布尔 true。
+  #
+  # @param argv [Array<String>] 参数（不含 namespace/op）
+  # @return [Hash{String => Object}] 参数表
+  def parse_params argv
+    params = {}
+    i = 0
+    while i < argv.size
+      key = argv[i]
+      if key.start_with?('--')
+        name, inline = key[2..-1].split('=', 2)
+        value = inline || argv[i+1]
+        if value.nil? || (!inline && value.start_with?('--'))
+          params[name] = true
+        else
+          params[name] = coerce(name, value)
+          i += 1 unless inline
+        end
+      end
+      i += 1
+    end
+    params
+  end
+
+  # 取文本输入：--text > --file > 管道 stdin。
+  #
+  # @param params [Hash] 参数表
+  # @return [String, nil] 文本输入
+  def fetch_text params
+    return params['text'] if params['text']
+    return File.read(params['file']) if params['file']
+    return $stdin.read unless $stdin.tty?
+    nil
+  end
+
+  # 本地执行：直接调用 text-tools 的操作符（与 S 端路由同参数同缺省）。
+  #
+  # @param ns [String] namespace（type/text/list/tree）
+  # @param op [String] 操作名（可含子路径）
+  # @param params [Hash] 参数表
+  # @return [Object] 计算结果
+  def dispatch_local ns, op, params
+    case "#{ns}/#{op}"
+    # ---- type ----
+    when 'type/int'
+      fetch_text(params).int(params['radix'] ? params['radix'].to_i : 10)
+    when 'type/float'
+      fetch_text(params).float(params['tail'] ? params['tail'].to_i : 2)
+    when 'type/precent'
+      fetch_text(params).precent(params['tail'] ? params['tail'].to_i : 2)
+    when 'type/text'
+      fetch_text(params).text((params['format'] || 'raw').to_sym)
+    when 'type/bool'
+      fetch_text(params).bool
+    # ---- text ----
+    when 'text/head'
+      fetch_text(params).head?(params['prefix'], params['strip'] || false)
+    when 'text/tail'
+      fetch_text(params).tail?(params['postfix'], params['strip'] || false)
+    when 'text/include'
+      fetch_text(params).include?(params['pattern'])
+    when 'text/empty'
+      fetch_text(params).empty?
+    when 'text/length'
+      fetch_text(params).length
+    when 'text/strip'
+      flag = (params['flag'] || 'both').to_s.downcase.to_sym
+      text = fetch_text(params)
+      flag==:both ? text.strip : flag==:left ? text.lstrip : flag==:right ? text.rstrip : text
+    when 'text/join'
+      fetch_text(params).join(params['attaches'] || [])
+    when 'text/+'
+      fetch_text(params) + (params['oprand'] || '')
+    when 'text/-'
+      fetch_text(params) - (params['oprand'] || '')
+    when 'text/*'
+      fetch_text(params) * (params['oprand'] || 1).to_s.to_i
+    when 'text/split'
+      fetch_text(params) / (params['oprand'] || ' ')
+    when 'text/cut'
+      fetch_text(params).cut(params['lidx'] ? params['lidx'].to_i : 1, params['ridx'] ? params['ridx'].to_i : 0)
+    when 'text/match'
+      text = fetch_text(params)
+      patterns = params['patterns'] || []
+      mode = (params['mode'] || 'one').to_s.downcase.to_sym
+      [:one, :all].include?(mode) ? (!patterns.first.to_s.empty? ? text.matches(patterns.first.to_s,mode) : text) :
+        text.matches(patterns,mode)
+    when 'text/exchange'
+      repeat = (params['repeat'] || 'all').to_s
+      repeat = repeat.include?('all') ? repeat.to_sym : repeat.to_i
+      fetch_text(params).exchange(params['oldtext'], params['newtext'], repeat)
+    when 'text/draw/lines'
+      rests, content = fetch_text(params).draw_lines(Regexp.new(params['preflag'].to_s), Regexp.new(params['postflag'].to_s))
+      [content, rests]
+    when 'text/match/paragraph'
+      fetch_text(params).match_paragraph(params['start'].to_s, params['finish'].to_s)
+    when 'text/match/cascade'
+      fetch_text(params).match_cascade(params['start'].to_s, params['finish'].to_s)
+    when 'text/match/xml'
+      fetch_text(params).match_xml(params['tag'].to_s)
+    # ---- list ----
+    when 'list/pop'
+      params['list'].pop
+    when 'list/push'
+      params['list'].push(params['item'])
+    when 'list/shift'
+      params['list'].shift
+    when 'list/unshift'
+      params['list'].unshift(params['item'])
+    when 'list/+'
+      params['list'] + (params['oprand'] || [])
+    when 'list/-'
+      params['list'] - (params['oprand'] || [])
+    when 'list/catch'
+      params['list'].catch(params['oprands'] || [])
+    when 'list/sub'
+      params['list'].sub(params['lidx'] ? params['lidx'].to_i : 1, params['ridx'] ? params['ridx'].to_i : 0)
+    when 'list/match'
+      repeat = params['repeat'] || 1
+      repeat = :all if repeat.to_s == 'all'
+      repeat = repeat.to_i unless repeat == :all
+      params['list'].match(repeat, &eval(params['func']))
+    when 'list/map'
+      params['list'].map(&eval(params['func']))
+    when 'list/reduce'
+      sectors = params['init'].to_s.split(":")
+      type = sectors.last.strip
+      init = sectors[0..-2].join(':')
+      iv = case type
+        when 'text';    init.strip.to_s
+        when 'integer'; init.strip.to_i
+        when 'float';   init.strip.to_f
+        when 'list';    eval(init)
+        when 'tree';    eval(init)
+        end
+      params['list'].reduce(iv, &eval(params['func']))
+    # ---- tree ----
+    when 'tree/keys'
+      params['tree'].keys
+    when 'tree/values'
+      params['tree'].values
+    when 'tree/get'
+      params['tree'][params['key'].to_s]
+    when 'tree/set'
+      params['tree'][params['key']] = params['val']
+      params['tree']
+    when 'tree/+'
+      params['tree'] + params['oprand']
+    end
+  end
+
+  # 远程执行：POST JSON 参数到 S 端（路径与操作名一致）。
+  #
+  # @param base [String] S 端地址（如 http://127.0.0.1:9292）
+  # @param ns [String] namespace
+  # @param op [String] 操作名
+  # @param params [Hash] 参数表
+  # @return [Object] 解析结果
+  def dispatch_remote base, ns, op, params
+    uri = URI("#{base}/#{ns}/#{op}")
+    body = params.reject{|k,_| %w{remote help}.include?(k) }.to_json
+    response = Net::HTTP.post(uri, body, 'Content-Type' => 'application/json')
+    raise "S 端响应 #{response.code}" unless response.code == '200'
+    JSON.parse(response.body)
+  end
+
+  # 帮助文本。
+  #
+  # @return [String]
+  def help
+    <<~HELP
+      text-client —— textmind 命令行解析（C 端）
+
+      用法: ruby text-client.rb <namespace> <op> [参数...]
+        namespace: type | text | list | tree
+        op: 操作名（可含子路径，如 match/paragraph、draw/lines）
+
+      数据输入:
+        --text "字符串"   文本/类型操作输入（或 --file PATH，或管道 stdin）
+        --list '[...]'    列表操作输入（JSON 数组）
+        --tree '{...}'    树操作输入（JSON 对象）
+
+      通用:
+        --remote URL      改走 S 端服务解析（默认本地执行）
+        --help            本帮助
+
+      示例:
+        ruby text-client.rb type int --radix 2 --text 100
+        ruby text-client.rb text head --prefix aa --text aabbcc
+        ruby text-client.rb text exchange --oldtext e --newtext z --text abedef
+        ruby text-client.rb list map --func "proc{|c| c * 2}" --list '[1,2,3]'
+        ruby text-client.rb tree + --oprand '[1,3,5]' --tree '{"a":1}'
+        echo "a1a2b3" | ruby text-client.rb text match/paragraph --start a --finish b
+        ruby text-client.rb --remote http://127.0.0.1:9292 text head --prefix aa --text aabbcc
+    HELP
+  end
+
+  # C 端命令行入口（可测试：传入 argv 与 io）。
+  #
+  # --remote 可出现在任意位置（--remote URL 或 --remote=URL 两种写法），
+  # 抽取后剩余参数的前两个位置量即 namespace 与 op。
+  #
+  # @param argv [Array<String>] 命令行参数
+  # @param io [IO] 结果输出流，默认 $stdout
+  # @return [Integer] 进程退出码
+  def run argv, io: $stdout
+    return (io.puts help; 0) if argv.empty? || argv.include?('--help')
+
+    # 归一化 --remote=URL 写法，再整对抽取 --remote，避免挤占 ns/op 位置
+    argv = argv.flat_map{|arg| arg.start_with?('--remote=') ? ['--remote', arg.split('=', 2)[1]] : [arg] }
+    remote = nil
+    if i = argv.index('--remote')
+      remote = argv[i+1]
+      argv = argv.dup.tap{|a| a.slice!(i, 2) }
+    end
+
+    ns, op, *raw_params = argv
+    return (io.puts help; 1) unless ns && op && !ns.start_with?('--')
+    params = parse_params(raw_params)
+
+    begin
+      result = remote ? dispatch_remote(remote, ns, op, params) : dispatch_local(ns, op, params)
+      io.puts result.to_json
+      return 0
+    rescue => e
+      warn "text-client: #{e.class}: #{e.message}"
+      return 1
+    end
+  end
+end
+
+if $PROGRAM_NAME == __FILE__
+  exit(TextClient.run(ARGV))
+end