cc 1.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 3845aa1ea0a757e0457a34c7a5262a492f0f172b07f143cb5bb01f2e025dcfd2
+  data.tar.gz: '01603958c108049cdd77b01399ceb6d1ebdf927187b005455fa15cb106df79e9'
+SHA512:
+  metadata.gz: 15268def1cc4604f43c243fca0cb66744e64cd186d7679107aab2e7363fe85990c2c1ef6363dc567241943fdb3d730ceff405a3b56c32a1c9e8e51ced79c3f74
+  data.tar.gz: 338fd1f52a6eed257b3079e6d06b11a471d1cbaa5e326e433fc063e3b8108d65adb10c7b4f64537630c979178878983a4c84b2c2623e3a5280ff1df1d4e4cb35

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Frampt
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/LICENSE-CN.md

@@ -0,0 +1,9 @@
+MIT 许可证
+
+版权所有 (c) 2025 Frampt
+
+特此授予获得本软件及其相关文档文件（以下简称“软件”）副本的任何人，免费使用本软件的权利，包括但不限于使用、复制、修改、合并、发布、分发、再授权以及出售软件副本的权利，并允许接收本软件的人员也这样做，但需满足以下条件：
+
+上述版权声明和本许可声明必须包含在软件的所有副本或重要部分中。
+
+软件“按原样”提供，没有任何形式的保证，无论是明示还是暗示，包括但不限于对适销性、特定用途的适用性和非侵权性的保证。在任何情况下，作者或版权持有人都不对任何索赔、损害或其他责任负责，无论是在合同、侵权行为或其他行为中，因使用、履行或与软件相关的其他交易而产生。

data/README.md

@@ -0,0 +1,3 @@
+# custom-core
+
+CC

data/attribute.rb

@@ -0,0 +1,71 @@
+#coding:utf-8
+
+############################################################################################################
+# HOW TO USE                                                                                               #
+############################################################################################################
+
+=begin
+  require 'cc'
+  CC.use 'attribute'
+
+  # use Attribute module with obj[xxx]
+  class Sample
+    include Attribute
+  end
+  s1 = Sample.new
+
+  s1['name'], s1[:age] = "sample", 100
+  p s1[:name], s1['age'], s1.attrs
+
+  # use Component module with obj.xxx
+  s2 = Object.new
+  s2.extend Component
+
+  s2.link 'name' => 'sample', age: 100
+  p s2.name, s2.age, s2.coms
+=end
+
+module Attribute
+  def attrs
+    @attrs ||= Hash.new
+  end
+
+  def [] name
+    @attrs ||= Hash.new
+    return @attrs[name.to_sym]
+  end
+  
+  def []= name,value
+    @attrs ||= Hash.new
+    return @attrs[name.to_sym] = value
+  end
+end
+
+module Component
+  def coms
+    @attrs ||= Hash.new
+  end
+  
+  def method_missing name,*args
+    @attrs ||= Hash.new
+    return @attrs[name.to_sym]
+  end
+  
+  def [] name
+    @attrs ||= Hash.new
+    @attrs[name.to_sym]
+  end
+  
+  def []= name,entity
+    @attrs[name.to_sym] = entity
+  end
+  
+  def link pairs
+    @attrs ||= Hash.new
+    if pairs.class == Hash
+      pairs.each{|k,v| @attrs.merge! k.to_sym=>v }
+    else
+      @attrs.merge! pairs.class.to_sym=>pairs
+    end
+  end
+end

data/cc.rb

@@ -0,0 +1,43 @@
+#coding:utf-8
+
+$modlist = [
+  'cc',
+  'attribute',
+  'chinese',
+  'chrono',
+  'enum',
+  'exception',
+  'file',
+  'kernel',
+  'monkey-patch',
+  'number',
+  'regexp',
+  'string',
+  'tree'
+]
+
+module CC
+  module_function
+
+  def list *names
+    $modlist.each do|mod|
+      puts mod if names.include?(mod) || names.empty?
+    end
+  end
+
+  def select *args
+    if args.include?(:all)
+      $modlist.each do|mod|
+        load(mod+'.rb')
+      end
+    else
+      args.each do|arg|
+        load(arg+'.rb') if $modlist.include?(arg)
+      end
+    end
+  end
+
+  def use *args
+    select(*args)
+  end
+end

data/chinese.rb

@@ -0,0 +1,71 @@
+#coding:utf-8
+
+############################################################################################################
+# HOW TO USE                                                                                               #
+############################################################################################################
+
+=begin
+  require 'cc'
+  CC.use 'chinese' # immediately when loading this file
+=end
+
+class Object
+  def 等于(对象);(self.equal? 对象);end
+  def 等于?(对象);(self.equal? 对象);end
+  def 等于？(对象);(self.equal? 对象);end
+  def 不等于(对象);!(self.equal? 对象);end
+  def 不等于?(对象);!(self.equal? 对象);end
+  def 不等于？(对象);!(self.equal? 对象);end
+  def 包含(对象);self.include?(对象);end # 如果重写，覆盖本方法
+  def 包含?(对象);self.include?(对象);end
+  def 包含？(对象);self.include?(对象);end
+  def 属于(对象);对象.include?(对象);end # 如果重写，覆盖本方法
+  def 属于?(对象);对象.include?(对象);end
+  def 属于？(对象);对象.include?(对象);end
+end
+
+class Numeric
+  def 大于(对象);self>对象;end
+  def 大于?(对象);self>对象;end
+  def 大于？(对象);self>对象;end
+  def 大于等于(对象);self>=对象;end
+  def 大于等于?(对象);self>=对象;end
+  def 大于等于？(对象);self>=对象;end
+  def 小于(对象);self<对象;end
+  def 小于?(对象);self<对象;end
+  def 小于？(对象);self<对象;end
+  def 小于等于(对象);self<=对象;end
+  def 小于等于?(对象);self<=对象;end
+  def 小于等于？(对象);self<=对象;end
+  # 等于/不等于 in Object
+
+  ["时","分","秒"].each do|单位|
+    define_method 单位.to_sym do
+      return self
+    end
+  end
+end
+
+module Enumerable
+  def 包含? 其他;self.include?(其他);end # rewrite object
+  def 包含？ 其他;self.include?(其他);end # rewrite object
+end
+
+module Kernel
+  def 打印 *参数
+    send :puts,*参数
+  end
+
+  def 内视 *参数
+    send :p,*参数
+  end
+  
+  def 内视图 *参数
+    # require 'pp' # v2.5.0 build-in, no need require when v3.0.0+
+    send :pp,*参数
+  end
+  
+  def 休眠 时间
+    sleep 时间
+  end
+end

data/chrono.rb

@@ -0,0 +1,162 @@
+#coding:utf-8
+require 'date'
+require 'time'
+
+############################################################################################################
+# HOW TO USE                                                                                               #
+############################################################################################################
+
+=begin
+  require 'cc'
+  CC.use 'chrono' # immediately when loading this file
+
+  timing = Time.now
+  puts [2023, 10, 10, 12, 30, 45]=="2023-10-10 12:30:45".time,
+      [2023, 10, 10, 12, 30, 45]=="2023-10-10T12:30:45".time,
+      [timing.year, timing.month, timing.day, timing.hour, timing.min, timing.sec]==(Time.now).strftime("%Y-%m-%d %H:%M:%S").time,
+      ["12", "30", "45"]=="123045".tag_to_numtime,
+      "12:30:45"=="123045".tag_to_time,
+      ["2023", "10", "10"]=="20231010".tag_to_numdate,
+      "2023-10-10"=="20231010".tag_to_date,
+      ["2023", "10", "10", "12", "30", "45"]=="20231010123045".tag_to_number,
+      "2023-10-10 12:30:45"=="20231010123045".tag_to_datetime,
+      "Tuesday"=="2023-10-10".weekday,
+      "Tuesday"==Time.new(2023, 10, 10).weekday,
+      "Tuesday"==DateTime.new(2023, 10, 10).weekday,
+      "2023-10-10"==Time.new(2023, 10, 10).date,
+      "2023-10-10"==DateTime.new(2023, 10, 10).date,
+      "12:30:45"==Time.new(2023, 10, 10, 12, 30, 45).time,
+      "12:30:45"==DateTime.new(2023, 10, 10, 12, 30, 45).time,
+      "2023-10-10 12:30:45"==Time.new(2023, 10, 10, 12, 30, 45).form,
+      "2023-10-10 12:30:45"==DateTime.new(2023, 10, 10, 12, 30, 45).form,
+      "20231010123045"==Time.new(2023, 10, 10, 12, 30, 45).tag,
+      "20231010123045"==DateTime.new(2023, 10, 10, 12, 30, 45).tag,
+      Time.new(2023, 10, 10, 12, 30, 45)==Time.form("2023-10-10 12:30:45"),
+      DateTime.new(2023, 10, 10, 12, 30, 45)==DateTime.form("2023-10-10 12:30:45"),
+      Time.new.strftime('%Y%m%d%H%M%S')==Time.tag,
+      DateTime.new.strftime('%Y%m%d%H%M%S')==DateTime.tag,
+      1==1.sec,
+      60==1.min,
+      3600==1.hour
+=end
+
+class String
+  def time
+    # date = /[0-9]+\-[0-9]+\-[0-9]+/.match(self)
+    # time = /[0-9]+\:[0-9]+\:[0-9]+/.match(self)
+    # year, month, day = date.to_s.split("-")
+    # hour, minute, second = time.to_s.split(":")
+    itime = Time.parse(self)
+    return itime.year||Time.now.year, itime.month||Time.now.month, 
+    itime.day||Time.now.day,itime.hour||Time.now.hour, 
+    itime.min||Time.now.min, itime.sec||Time.now.sec
+  end
+  
+  def tag_to_numtime
+    return [] unless self.size==6
+    return self.unpack("a2a2a2")
+  end
+  
+  def tag_to_time
+    return nil unless self.size==6
+    return self.unpack("a2a2a2").join(":")
+  end
+  
+  def tag_to_numdate
+    return [] unless self.size==8
+    return self.unpack("a4a2a2")
+  end
+  
+  def tag_to_date
+    return nil unless self.size==8
+    return self.unpack("a4a2a2").join("-")
+  end
+  
+  def tag_to_number
+    return [] unless self.size==14
+    return self[0..7].tag_to_numdate+self[-6..-1].tag_to_numtime
+  end
+  
+  def tag_to_datetime
+    return nil unless self.size==14
+    return self[0..7].tag_to_date+" "+self[-6..-1].tag_to_time
+  end
+  
+  def weekday
+    Time.form(self).weekday
+  end
+end
+
+class Time
+  def weekday
+    self.strftime('%A')
+  end
+
+  def date
+    self.strftime("%Y-%m-%d")
+  end
+  
+  def time
+    self.strftime("%H:%M:%S")
+  end
+
+  def form
+    self.strftime("%Y-%m-%d %H:%M:%S")
+  end
+
+  def tag
+    self.strftime("%Y%m%d%H%M%S")
+  end
+  
+  def self.form string
+    Time.new *string.time
+  end
+  
+  def self.tag
+    Time.new.strftime('%Y%m%d%H%M%S')
+  end
+end
+
+class DateTime
+  def weekday
+    self.strftime('%A')
+  end
+
+  def date
+    self.strftime("%Y-%m-%d")
+  end
+  
+  def time
+    self.strftime("%H:%M:%S")
+  end
+
+  def form
+    self.strftime("%Y-%m-%d %H:%M:%S")
+  end
+
+  def tag
+    self.strftime("%Y%m%d%H%M%S")
+  end
+  
+  def self.form string
+    DateTime.new *string.time
+  end
+  
+  def self.tag
+    DateTime.new.strftime('%Y%m%d%H%M%S')
+  end
+end
+
+class Integer
+  def min
+    sec = self*60
+  end
+  
+  def hour
+    sec = self*3600
+  end
+  
+  def sec
+    sec = self
+  end
+end

data/enum.rb

@@ -0,0 +1,47 @@
+#coding:utf-8
+
+############################################################################################################
+# HOW TO USE                                                                                               #
+############################################################################################################
+
+=begin
+  require 'cc'
+  CC.use 'enum' # immediately when loading this file
+
+  puts "Enumberable objects could be classified by customize criterions:"
+  pp (1..10).classify{|x|x%3}
+
+  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])
+=end
+
+module Enumerable
+  def classify (&block)
+    hash = {}
+    self.each do|x|
+      result = block.call(x)
+      (hash[result] ||= []) << x
+    end
+    return hash
+  end
+
+  def add_head *one
+    new_array = []
+    self.each do|item|
+      new_array << ( item.instance_of?(Array) ? one+item : one+[item] )
+    end
+    return new_array
+  end
+
+  def add_tail *one
+    new_array = []
+    self.each do|item|
+      new_array << ( item.instance_of?(Array) ? item+one : [item]+one )
+    end
+    return new_array
+  end
+
+  alias :unfold_head :add_head
+  alias :unfold_tail :add_tail
+end

data/exception.rb

@@ -0,0 +1,91 @@
+#coding:utf-8
+
+############################################################################################################
+# HOW TO USE                                                                                               #
+############################################################################################################
+
+=begin
+  require 'cc'
+  CC.use 'exception' # immediately when loading this file
+
+  begin
+    raise "When trigger an error."
+  rescue => exp
+    puts exp.info
+  end
+
+  obj = Object.new
+  obj.extend Insight
+
+  puts "\nWhen calling unknown methods:"
+  obj.some_method()
+  obj.another_method("hello", 1, "world")
+  puts obj.unknown_callings.inspect
+
+  @person = Object.new
+  class << @person
+    def first_name() 'A' end
+    def last_name()  'Z' end
+  end
+
+  puts "\nWhen calling an unknown method, it will return nil:"
+  p @person.try(:name)
+  
+  puts "\nWhen calling a definite process, it will try to run:"
+  p @person.try{|p|"#{p.first_name} #{p.last_name}"}
+
+  puts "\nWhen calling a defect process, it will respond to rescue:"
+  taste proc: proc{1/0}, rescue: proc{p 'Here is final presentation.'}
+=end
+
+class Exception
+  def self.text instance
+    return "SystemError:"+
+    "#{instance.backtrace[0]}: #{instance.message}(#{instance.class})"+
+    "#{"\n\tfrom "<<instance.backtrace[1..-1].map{|i|i.encode("UTF-8")}.join("\n")}" if instance.is_a?(Exception)
+  end
+
+  def info
+    return self.class.text(self)
+  end
+end
+
+module Insight
+  def unknown_callings
+    @unknown_callings ||= []
+  end
+  
+  def method_missing name,*args
+    @unknown_callings ||= []
+    @unknown_callings << "#{name}(#{args.join(",")})"
+    warn "Unknown calling: #{@unknown_callings[-1]}"
+  end
+end
+
+class Object
+  def try(*a, &b)
+    if a.empty? && block_given?
+      yield self
+    else
+      public_send(*a, &b) if respond_to?(a.first)
+    end
+  end
+end
+
+class NilClass
+  def try(*args)
+    nil
+  end
+end
+
+def taste transacation={} # proc: λ{}, rescue: λ{}, params: *arguments
+  process = transacation[:proc]
+  recover = transacation[:rescue] || lambda{}
+  params  = transacation[:params] || []
+  begin
+    process.call
+  rescue Exception => exp
+    puts Exception.text(exp)
+    recover.call(*params)
+  end
+end