cc 1.1.5 → 1.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1f4f552fd0a586d4321f95a788b210de1ae859f187f03ff92dff524c16021d49
-  data.tar.gz: 857478152baa7bc3ced3d103f8f8eb6797989563d7242e25dc7b7e1564b98be2
+  metadata.gz: 4fc0484d6d2387f8043520b7981b52be8968f1a233cf5e110395a2dcc9ab5fa8
+  data.tar.gz: 88f19e9a08e517ccdebb8d9f5d8dbb8afec0dd675d6b0c6df057c40703d75993
 SHA512:
-  metadata.gz: de7cb9814ffcc3b8acae9c5ad48b5a46e61d7524a28c4cd44ae7a8bd6de7ae8374bfb19474cd0cfcd7174e399c11acf1867a3bd48fb959f526bdf6cc113a8e9b
-  data.tar.gz: 81d1bcb0123efe87e9a037364cfc4da673ccf6804b0bcadab97f4da30d9385ac3c9035c5f61a65894169bde84aad2487c8f3f47e87c3c47d690714d5b2d349bf
+  metadata.gz: 371bdf3d14c78623c029bd58aff0002383f256dc9346ab5f6586b0ad7920690c9698338d1d73ccbffcab07019d0c9a132ced0365d6f7198c3c7040371329900e
+  data.tar.gz: 874c41883cb25ddf44790b37d8b7589ef5ff87bb07e25d5d7908f2553dedb3b9cc96af751a7886902839e3e7084931cdd1a30b547c8c6c43a63721bf0b4af6b8

data/cc.rb

@@ -10,10 +10,12 @@ $modlist = [
   'file',
   'kernel',
   'monkey-patch',
+  'shell-tools',
   'number',
   'regexp',
   'string',
   'tree',
+  'trace',
   'logic'
 ]
 

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

data/trace.rb

@@ -0,0 +1,327 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+# encoding: UTF-8
+
+=begin
+| 关键特性 | 说明　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　  |
+|---------|---------------------------------------------------------------|
+| 追踪功能 | TracePoint 是 Ruby 内置的追踪 API，性能比 `set_trace_func` 更好 |
+| 层级缩进 | 通过 `call_depth` 显示调用层级，便于阅读                        |
+| 对象信息 | 记录类名、object_id、inspect 结果、集合 size 等                   |
+| 局部变量 | 在每一行记录当前的局部变量状态                                   |
+| 参数追踪 | 方法调用时记录传入的参数                                        |
+| 源码显示 | 显示当前执行的源代码行                                          |
+| 安全截断 | 超长字符串自动截断，防止日志爆炸                                 |
+
+※注意： `trace_lines: true` 会追踪每一行代码，性能开销较大，适合调试小段代码；只追踪方法调用（默认）性能更好，适合生产环境追踪。
+
+# 使用方法:
+require 'cc'
+CC.use 'trace'
+ExecutionTracer.enable! # log_path: 'execution.log', trace_lines: false, max_depth: 100
+hello(:world)
+ExecutionTracer.disable!
+
+# 设置环境变量调用：
+`EXECUTION_TRACER_AUTO_START=true EXECUTION_TRACER_LOG=my_trace.log EXECUTION_TRACER_TRACE_LINES=true ruby 自定义脚本.rb`
+=end
+
+require 'json'
+require 'date'
+
+module ExecutionTracer
+  class << self
+    attr_reader :logger, :enabled, :log_file, :call_depth
+    
+    def enable!(log_path: 'execution.log', trace_lines: false, max_depth: 100)
+      return if @enabled
+      
+      time = Time.now
+      @logger = []
+      @logger << {
+        'time' => time,
+        'event' => "Execution Trace Start",
+        'version' => RUBY_VERSION,
+        'process-id' => Process.pid,
+        'log-path' => log_path
+      }
+
+      @log_file = File.open(log_path, 'a')
+      @log_file.puts "\n" + "="*80
+      @log_file.puts "[#{time}] Execution Trace Start"
+      @log_file.puts "Ruby Version: #{RUBY_VERSION}"
+      @log_file.puts "Process PID: #{Process.pid}"
+      @log_file.puts "="*80 + "\n"
+      @log_file.flush
+      
+      @enabled = true
+      @call_depth = 0
+      @max_depth = max_depth
+      
+      setup_tracepoint(trace_lines)
+      
+      puts "[ExecutionTracer] 已启用，日志写入: #{File.absolute_path(log_path)}"
+    end
+    
+    def disable!
+      return unless @enabled
+      
+      time = Time.now
+      @logger ||= []
+      @logger << {
+        'time' => time,
+        'event' => "Execution Trace End",
+        'process-id' => Process.pid
+      }
+
+      @tracepoint&.disable
+      @enabled = false
+      
+      @log_file.puts "\n" + "="*80
+      @log_file.puts "[#{time}] Execution Trace End"
+      @log_file.puts "="*80 + "\n"
+      @log_file.close
+      
+      puts "[ExecutionTracer] 已禁用，日志已保存"
+    end
+    
+    def log(message)
+      return unless @enabled && @log_file
+      @log_file.puts(message.encode("UTF-8"))
+      @log_file.flush
+    end
+    
+    private
+    
+    def setup_tracepoint(trace_lines)
+      events = [:call, :return, :c_call, :c_return]
+      events << :line if trace_lines
+      
+      @tracepoint = TracePoint.new(*events) do |tp|
+        next if internal_file?(tp.path)
+        next if @call_depth > @max_depth
+        
+        case tp.event
+        when :call, :c_call
+          @call_depth += 1
+          log_method_call(tp)
+        when :return, :c_return
+          log_method_return(tp)
+          @call_depth -= 1
+        when :line
+          log_line_execution(tp)
+        end
+      end
+      
+      @tracepoint.enable
+    end
+    
+    def log_method_call(tp)
+      receiver = tp.self
+      method_name = tp.method_id
+      file = tp.path
+      line = tp.lineno
+      defined_class = tp.defined_class
+      
+      # 收集对象信息
+      object_info = extract_object_info(receiver)
+      
+      # 收集参数信息（如果可能）
+      args_info = extract_arguments(tp.binding) if tp.binding
+      
+      indent = "  " * [@call_depth - 1, 0].max
+      log_message = format_log_entry(
+        event: "CALL",
+        indent: indent,
+        file: file,
+        line: line,
+        method: "#{defined_class}##{method_name}",
+        object: object_info,
+        args: args_info
+      )
+      
+      log(log_message)
+    end
+    
+    def log_method_return(tp)
+      receiver = tp.self
+      method_name = tp.method_id
+      file = tp.path
+      line = tp.lineno
+      
+      object_info = extract_object_info(receiver)
+      return_value = safe_inspect(tp.return_value) if tp.respond_to?(:return_value)
+      
+      indent = "  " * [@call_depth - 1, 0].max
+      log_message = format_log_entry(
+        event: "RETURN",
+        indent: indent,
+        file: file,
+        line: line,
+        method: "#{tp.defined_class}##{method_name}",
+        object: object_info,
+        return: return_value
+      )
+      
+      log(log_message)
+    end
+    
+    def log_line_execution(tp)
+      file = tp.path
+      line = tp.lineno
+      
+      # 获取当前行的代码（如果文件可读）
+      source_line = read_source_line(file, line)
+      
+      # 获取局部变量信息
+      local_vars = extract_local_variables(tp.binding) if tp.binding
+      
+      log_message = format_log_entry(
+        event: "LINE",
+        indent: "  " * (@call_depth < 0 ? @call_depth*(-1) : @call_depth),
+        file: file,
+        line: line,
+        source: source_line,
+        locals: local_vars
+      )
+      
+      log(log_message)
+    end
+    
+    def extract_object_info(obj)
+      info = {
+        class: obj.class.name,
+        object_id: obj.object_id,
+        inspect: safe_inspect(obj)
+      }
+      
+      # 如果是集合类型，记录大小
+      if obj.respond_to?(:size)
+        info[:size] = obj.size rescue "N/A"
+      end
+      
+      # 如果是字符串，记录长度
+      if obj.is_a?(String)
+        info[:length] = obj.length
+        info[:encoding] = obj.encoding.name
+      end
+      
+      # 如果是数字，记录值
+      if obj.is_a?(Numeric)
+        info[:value] = obj
+      end
+      
+      info
+    rescue => e
+      { error: "无法提取对象信息: #{e.message}" }
+    end
+    
+    def extract_arguments(binding_context)
+      return nil unless binding_context
+      
+      # 尝试获取方法参数（Ruby 2.7+ 支持）
+      if binding_context.respond_to?(:local_variables)
+        vars = binding_context.local_variables
+        args = {}
+        vars.each do |var|
+          begin
+            args[var] = safe_inspect(binding_context.local_variable_get(var))
+          rescue
+            args[var] = "<unreadable>"
+          end
+        end
+        args
+      end
+    rescue => e
+      { error: e.message }
+    end
+    
+    def extract_local_variables(binding_context)
+      return nil unless binding_context
+      
+      vars = {}
+      binding_context.local_variables.each do |var|
+        begin
+          value = binding_context.local_variable_get(var)
+          vars[var] = {
+            class: value.class.name,
+            inspect: safe_inspect(value)[0..100] # 限制长度
+          }
+        rescue => e
+          vars[var] = { error: e.message }
+        end
+      end
+      vars
+    rescue => e
+      { error: e.message }
+    end
+    
+    def format_log_entry(**data)
+      timestamp = Time.now.strftime("%Y-%m-%d %H:%M:%S.%3N")
+      indent = data.delete(:indent) || ""
+      event = data.delete(:event)
+      
+      @logger ||= []
+      record = {"time"=>timestamp, "indent"=>indent.strip, "event"=>event}
+
+      # 构建格式化的日志行
+      lines = ["[#{timestamp}] #{indent}[#{event}]"]
+      
+      data.each do |key, value|
+        next if value.nil?
+        
+        formatted_value = case value
+        when Hash
+          value.map { |k, v| "#{k}=#{truncate(v.to_s, 80)}" }.join(", ")
+        when String
+          truncate(value, 100)
+        else
+          truncate(value.to_s, 100)
+        end
+        
+        record[key] = formatted_value
+        lines << "  #{key}: #{formatted_value}"
+      end
+      
+      @logger << record
+      lines.map{|line|line.encode("UTF-8")}.join("\n")
+    end
+    
+    def read_source_line(file, line_num)
+      return nil unless File.exist?(file)
+      
+      File.readlines(file)[line_num - 1]&.strip
+    rescue => e
+      "<无法读取: #{e.message}>"
+    end
+    
+    def safe_inspect(obj)
+      obj.inspect
+    rescue => e
+      "<inspect error: #{e.message}>"
+    end
+    
+    def truncate(str, max_len)
+      str.length > max_len ? str[0...max_len] + "..." : str
+    end
+    
+    def internal_file?(path)
+      return true if path.nil? || path.empty?
+      return true if path.start_with?('<internal:')
+      return true if path.include?('/ruby/')
+      return true if path.include?('execution_tracer.rb') # 忽略追踪器本身
+      false
+    end
+  end
+end
+
+# 自动启动（如果设置了环境变量）
+if ENV['EXECUTION_TRACER_AUTO_START']
+  ExecutionTracer.enable!(
+    log_path: ENV['EXECUTION_TRACER_LOG'] || 'execution.log',
+    trace_lines: ENV['EXECUTION_TRACER_TRACE_LINES'] == 'true'
+  )
+end
+
+# 注册退出钩子
+at_exit { ExecutionTracer.disable! if ExecutionTracer.enabled }

metadata

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