cc 1.1.4 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c35c12b969222418912303a9bd84312b4b3e3a93823b1bee849ccd085b6e98ba
-  data.tar.gz: 73b5414aba0e02166ed99390133872382ed96d7efd1cd08f63abce2cd4726e69
+  metadata.gz: 9d516f93659f22c9c1cc96949b6b28a18f9b0a4488df88d0534b93e02d384ec1
+  data.tar.gz: cacf6949dfacd5676274f8189eb6f103ab10bbd8449e97d5ed719647c39fbb83
 SHA512:
-  metadata.gz: 8488d76dd5383695efc48e55afc03ea20634312e0be1a98597468c47f28f48b25afe748e6c3029ac5a21fd37824571d8ed2e9d188994e66dc3ea65ee665ce5f4
-  data.tar.gz: 4f5f1c3ea756d171ccdbaf97c43d96f189cfe531f351eee9a74f7e3850a6d4d0cfa4754f2656ccc0943ae85d2d2442dbf1e36c1f1907e8734a2f1f6d598af073
+  metadata.gz: 439bf5ca21f7ebc3ae75e9f15864e739554aed7d1020a686a1890bf75defcf7e2ce338ae9f47266eda782c8cb8589ae79b9c9581aa0bef7b9bebdebb3305a0d6
+  data.tar.gz: 82b49a5413e171490cb09f9ba0057c5efa39642c7c4814b1463fd90b272225d52e547bb23b87188797358f42f14d92a5d953aa11af6acf9e6141f816fde196ea

data/cc.rb

@@ -10,6 +10,7 @@ $modlist = [
   'file',
   'kernel',
   'monkey-patch',
+  'shell-tools',
   'number',
   'regexp',
   'string',

data/enum.rb

@@ -14,6 +14,51 @@
   puts "Enumberable objects could be added head or tail:"
   pp [ 1 , [2],  3 ].unfold_head( :a, :b, :c )
   pp [[1],  2 , [3]].unfold_tail(*[:x, :y, :z])
+
+  puts "Hash could project and serialize on a subscope as a sub hash or array:"
+  {a: 1 ,b: 2,c: 3}.project(:a, :c) # => {:a=>1, :c=>3}
+  {a: 1 ,b: 2,c: 3}.serialize(:a, :c) # => [1, 3]
+
+  puts "Array could mapping with a subscope as a key-val array:"
+  a = [[1,2,3], [4,5,6], [7,8]]
+  a.mapping [:a, :b, :c] # => [{:a=>1, :b=>2, :c=>3}, {:a=>4, :b=>5, :c=>6}, {:a=>7, :b=>8, :c=>nil}]
+  a.mapping [:a, :d] # => [{:a=>1, :d=>2}, {:a=>4, :d=>5}, {:a=>7, :d=>8}]
+
+  puts "Building a RangeTree to query a range of records:"
+  pp(rt = RangeTree.new(records = [
+    [[1, 3], :a],
+    [[2, 4], :b],
+    [[2, 7], :c],
+    [[6],    :d],
+    [[4, 5], :e],
+    [[8],    :f],
+    [[10],   :g],
+    :y,
+    :z
+  ]))
+  # {1=>{3=>[:a]},
+  #  2=>{4=>[:b], 7=>[:c]},
+  #  6=>{6=>[:d]},
+  #  4=>{5=>[:e]},
+  #  8=>{8=>[:f]},
+  #  10=>{10=>[:g]},
+  #  0=>{0=>[:y, :z]}}
+
+  pp rt.query( Range.new(1,2) )
+  # ["complete", {[1, 3]=>[:a]}]
+
+  pp rt.query( [4,7] )
+  # ["complete", {[2, 7]=>[:c]}]
+
+  pp rt.query( 6 )
+  # ["complete", {[2, 7]=>[:c], [6, 6]=>[:d]}]
+
+  pp rt.query( [1,6] )
+  # ["partial",
+  #  {[1, 3]=>[:a], [2, 4]=>[:b], [2, 7]=>[:c], [6, 6]=>[:d], [4, 5]=>[:e]}]
+
+  pp rt.query( :a )
+  # ["unformal", {[0, 0]=>[]}]
 =end
 
 module Enumerable
@@ -75,3 +120,99 @@ class Array
     return new_records
   end
 end
+
+class RangeTree < Hash
+  attr_reader :a
+
+  # Records := [ [Range|Point, Record] | Record, ... ]
+  def initialize records
+      merge records
+  end
+
+  def merge records
+      records.each do|record|
+          head, rest = record
+          if head.is_a?(Range)
+              starter, finisher = head.min, head.max
+          elsif head.is_a?(Array)
+              starter, finisher = head.sort.first, head.sort.last
+          elsif head.is_a?(Numeric)
+              starter, finisher = head, head
+          else
+              starter, finisher, rest = 0, 0, record
+          end
+          self[starter] ||= {}
+          self[starter][finisher] ||= []
+          self[starter][finisher] << rest
+          self[starter][finisher].uniq!
+      end
+      @start_keys = self.keys.sort
+  end
+
+  def update_key
+      @start_keys = self.keys.sort
+  end
+
+  def unikey target
+      if target.is_a?(Range)
+          skey, fkey = target.min, target.max
+      elsif target.is_a?(Array)
+          skey, fkey = target.sort.first, target.sort.last
+      elsif target.is_a?(Numeric)
+          skey, fkey = target, target
+      else
+          skey, fkey = 0, 0
+      end
+      return skey, fkey
+  end
+
+  def locate target
+      skey, fkey = unikey(target)
+      keys = []
+      start_keys = self.keys.sort
+      candi_keys = start_keys.select{|sk|sk<=skey}
+      candi_keys.each do|candi_key|
+          finish_keys = self[candi_key].keys.sort
+          cand_keys = finish_keys.select{|fk|fk>=fkey}.map{|cand_key|[candi_key, cand_key]}
+          keys += cand_keys
+      end
+      return keys
+  end
+
+  def search target
+      keys = []
+      skey, fkey = unikey(target)
+      self.each do|sk, candis|
+          candis.each do|fk, cands|
+              next if fkey < sk || fk < skey
+              keys << [sk,fk]
+          end
+      end
+      return keys
+  end
+
+  def index target
+      keys = locate(target)
+      if keys.empty?
+          return 'partial', search(target)
+      elsif keys==[[0,0]]
+          return 'unformal', [[0,0]]
+      else
+          return 'complete', keys
+      end
+  end
+
+  def query target
+      result = {}
+      state, keys = index(target)
+      keys.each do|keyp|
+          sk, fk = keyp
+          result[keyp] = self[sk][fk]
+      end
+      if state=='unformal'
+          self[0] ||= {}
+          result[[0,0]] = (self[0][0]||[]).include?(target) ? target : []
+      end
+      return state, result
+  end
+end

data/shell-tools.rb

@@ -0,0 +1,264 @@
+#!/usr/bin/env ruby
+# encoding: utf-8
+
+require 'io/console'
+
+class ProgressBar
+  # 预设主题
+  THEMES = {
+    classic: { fill: '█', empty: '░', left: '[', right: ']', arrow: '>' },
+    modern:  { fill: '●', empty: '○', left: '', right: '', arrow: '▶' },
+    blocks:  { fill: '■', empty: '□', left: '│', right: '│', arrow: '▶' },
+    dots:    { fill: '◉', empty: '◎', left: '⟨', right: '⟩', arrow: '→' },
+    minimal: { fill: '=', empty: '-', left: '[', right: ']', arrow: '>' },
+    hearts:  { fill: '♥', empty: '♡', left: ' ', right: ' ', arrow: '💕' }
+  }
+
+  attr_reader :total, :current, :start_time
+
+  def initialize(total, title: "Processing", theme: :modern, width: 40, show_percentage: true, show_eta: true, color: true)
+    @total = total
+    @current = 0
+    @title = title
+    @theme = THEMES[theme] || THEMES[:modern]
+    @width = width
+    @show_percentage = show_percentage
+    @show_eta = show_eta
+    @color = color
+    @start_time = Time.now
+    @last_update = 0
+    @mutex = Mutex.new
+    
+    # ANSI 颜色代码
+    @colors = {
+      reset:   "\e[0m",
+      bold:    "\e[1m",
+      green:   "\e[32m",
+      yellow:  "\e[33m",
+      blue:    "\e[34m",
+      magenta: "\e[35m",
+      cyan:    "\e[36m",
+      gray:    "\e[90m"
+    }
+    
+    # 隐藏光标
+    print "\e[?25l"
+  end
+
+  # 更新进度
+  def update(step = 1)
+    @mutex.synchronize do
+      @current += step
+      @current = @total if @current > @total
+      refresh if should_refresh?
+    end
+  end
+
+  # 直接设置进度
+  def set(value)
+    @mutex.synchronize do
+      @current = [[value, @total].min, 0].max
+      refresh
+    end
+  end
+
+  # 完成进度条
+  def finish(message: "Done!")
+    @mutex.synchronize do
+      @current = @total
+      refresh
+      puts  # 换行
+      show_cursor
+      puts colorize(message, :green) unless message.empty?
+    end
+  end
+
+  # 显示统计信息
+  def stats
+    elapsed = Time.now - @start_time
+    rate = @current / elapsed rescue 0
+    {
+      total: @total,
+      current: @current,
+      percentage: (@current.to_f / @total * 100).round(1),
+      elapsed: format_time(elapsed),
+      eta: format_time(eta),
+      rate: rate.round(2)
+    }
+  end
+
+  # 清理资源
+  def dispose
+    show_cursor
+  end
+
+  private
+
+  def should_refresh?
+    now = Time.now.to_f
+    return false if now - @last_update < 0.05  # 限制刷新率 20fps
+    @last_update = now
+    true
+  end
+
+  def refresh
+    percentage = @current.to_f / @total
+    filled = (percentage * @width).round
+    empty = @width - filled
+
+    bar = @theme[:fill] * filled + 
+          (@current < @total ? @theme[:arrow] : @theme[:fill]) + 
+          @theme[:empty] * [empty - 1, 0].max
+
+    # 构建输出字符串
+    parts = []
+    
+    # 标题
+    parts << colorize(sprintf("%-15s", @title), :bold)
+    
+    # 进度条
+    bar_color = percentage >= 1.0 ? :green : (percentage > 0.5 ? :cyan : :yellow)
+    parts << "#{@theme[:left]}#{colorize(bar, bar_color)}#{@theme[:right]}"
+    
+    # 百分比
+    if @show_percentage
+      parts << colorize(sprintf("%6.1f%%", percentage * 100), :magenta)
+    end
+    
+    # 计数
+    parts << colorize("[#{@current}/#{@total}]", :gray)
+    
+    # ETA
+    if @show_eta && @current > 0 && @current < @total
+      parts << colorize("ETA: #{format_time(eta)}", :blue)
+    end
+
+    # 清除行并输出
+    print "\r\e[K" + parts.join(' ')
+    $stdout.flush
+  end
+
+  def eta
+    return 0 if @current == 0
+    elapsed = Time.now - @start_time
+    remaining = @total - @current
+    (elapsed / @current) * remaining
+  end
+
+  def format_time(seconds)
+    return "0s" if seconds < 1
+    if seconds < 60
+      "#{seconds.round}s"
+    elsif seconds < 3600
+      "#{(seconds / 60).floor}m #{(seconds % 60).round}s"
+    else
+      "#{(seconds / 3600).floor}h #{((seconds % 3600) / 60).floor}m"
+    end
+  end
+
+  def colorize(text, color)
+    return text unless @color
+    "#{@colors[color]}#{text}#{@colors[:reset]}"
+  end
+
+  def show_cursor
+    print "\e[?25h"
+  end
+end
+
+# 辅助方法（用于示例中的颜色输出）
+def colorize(text, color)
+  colors = { green: "\e[32m", yellow: "\e[33m", gray: "\e[90m", reset: "\e[0m" }
+  "#{colors[color]}#{text}#{colors[:reset]}"
+end
+
+=begin
+  # ==================== 使用示例 ====================
+  puts "🚀 Ruby Fancy Progress Bar Demo"
+  puts "=" * 50
+
+  # 示例 1: 基础用法
+  puts "\n📊 示例 1: 基础文件处理"
+  bar = ProgressBar.new(100, title: "Downloading", theme: :modern)
+  100.times do |i|
+    sleep(0.03)  # 模拟工作
+    bar.update
+  end
+  bar.finish(message: "✅ 下载完成!")
+
+  # 示例 2: 不同主题展示
+  puts "\n🎨 示例 2: 主题展示"
+  [:classic, :blocks, :dots, :minimal].each do |theme_name|
+    bar = ProgressBar.new(50, title: theme_name.to_s, theme: theme_name, width: 30)
+    50.times do
+      sleep(0.02)
+      bar.update
+    end
+    bar.finish(message: "")
+  end
+
+  # 示例 3: 批量任务处理（带错误处理）
+  puts "\n📁 示例 3: 批量文件处理"
+  files = (1..20).map { |n| "file_#{n}.txt" }
+  bar = ProgressBar.new(files.size, title: "Processing", theme: :hearts, color: true)
+  processed = []
+  files.each do |file|
+    sleep(0.1)  # 模拟处理时间
+    processed << file
+    bar.update
+    # 模拟偶尔的错误
+    if rand < 0.1
+      print "\n⚠️  #{colorize("警告: #{file} 处理异常", :yellow)}"
+    end
+  end
+  bar.finish(message: "✨ 处理了 #{processed.size} 个文件")
+
+  # 示例 4: 嵌套进度条（多阶段任务）
+  puts "\n🏗️  示例 4: 多阶段构建任务"
+  phases = [
+    { name: "Compiling", items: 30 },
+    { name: "Testing", items: 20 },
+    { name: "Packaging", items: 15 }
+  ]
+  phases.each do |phase|
+    puts "\n阶段: #{phase[:name]}"
+    bar = ProgressBar.new(phase[:items], title: phase[:name], theme: :modern)
+    phase[:items].times do
+      sleep(0.05)
+      bar.update
+    end
+    bar.finish(message: "")
+  end
+  puts colorize("🎉 所有阶段完成!", :green)
+
+  # 示例 5: 实时速度显示（大数据处理）
+  puts "\n⚡ 示例 5: 大数据处理（带实时统计）"
+  total_items = 1000
+  bar = ProgressBar.new(total_items, title: "BigData", theme: :blocks, width: 50)
+  total_items.times do |i|
+    sleep(0.01)  # 模拟快速处理
+    # 每 100 个显示一次统计
+    if i % 100 == 0 && i > 0
+      s = bar.stats
+      print "\n   #{colorize("速度: #{s[:rate]} items/s | 已用: #{s[:elapsed]} | 剩余: #{s[:eta]}", :gray)}"
+    end
+    bar.update
+  end
+  bar.finish
+
+  # 示例 6: 手动控制进度（非均匀任务）
+  puts "\n🎮 示例 6: 手动进度控制（非均匀任务）"
+  bar = ProgressBar.new(100, title: "Uploading", theme: :dots)
+  # 模拟不同大小的文件上传
+  uploads = [10, 25, 5, 30, 20, 10]
+  uploads.each_with_index do |size, idx|
+    sleep(0.3)  # 模拟上传时间
+    bar.set(bar.current + size)
+    print "\n   上传了 chunk_#{idx + 1}.bin (#{size}MB)"
+  end
+  bar.finish(message: "上传完成")
+  # 确保光标显示
+  print "\e[?25h"
+  puts "\n" + "=" * 50
+  puts "✨ 所有演示完成! 你可以复制 ProgressBar 类到你的项目中使用。"
+=end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cc
 version: !ruby/object:Gem::Version
-  version: 1.1.4
+  version: 1.2.0
 platform: ruby
 authors:
 - Matt
@@ -32,6 +32,7 @@ files:
 - monkey-patch.rb
 - number.rb
 - regexp.rb
+- shell-tools.rb
 - string.rb
 - tree.rb
 homepage: https://github.com/ChenMeng1365/custom-core