cbeta 4.1.0 → 4.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0a8826c19847f81602cd7ca3fb1e976fffc20b98976fde5844134b4672d60e63
-  data.tar.gz: 06a2dc151b6623439cca6bbbf4a913fb70c1ac1f6fe8a041e8b052471b08c202
+  metadata.gz: d87e5abf202e1a364780efea5d54761eef5a59c19ff68b17e051fdd119f0baa5
+  data.tar.gz: c1720705f1a5beabb8267568baab667973e722321a41c2b5139063f203289f04
 SHA512:
-  metadata.gz: 102a0d53249646d923f2b95c1b5906c23ad6a243b31827e8c663b795448277c1cc4295d9340cdc79f73fc5c29cfc03430c0698cbae69ad4f618d051a0eab8dd4
-  data.tar.gz: 48f777330445f72f0e80c8a02c862b05a36e1ba8da6c4509ac81be5a7cab77fed0b71c8dc392b66598f47eaf438e85fe4b44eeb0401e9e6b7571e4ced99501f8
+  metadata.gz: 9cf1756da5884ecb2414981f99fdabede3d7bc511b9002d62d5f9581bbe9232b037409dc6c361771eded7a5edb1cb3e720ce91cc0ceddf6060a50ea274e679fa
+  data.tar.gz: f8854526080b42a3e53e52f8b775afeaed21cd2a9a66c35947a71c0b2a7551d6860e03c1cca92f4e19f43b20c617ebf80a1a54d20750cdfe42d7c9d2fdcd90b1

data/lib/cbeta/gaiji.rb

@@ -1,19 +1,48 @@
 require 'json'
-require 'unihan2'
 
 # 存取 CBETA 缺字資料庫
 class CBETA::Gaiji
-  
+  # 內建缺字資料所在的資料夾
+  DATA_FOLDER = File.expand_path('../data', __dir__)
+
+  # 內建缺字資料的期別（CBETA 釋出版本）
+  DATA_VERSION = '2026.R2'
+
+  # 缺字資料的期別。使用內建資料時為 {DATA_VERSION}；
+  # 使用外部資料時為呼叫者傳入的 data_version，未傳入則為 nil。
+  #
+  # @return [String, nil]
+  attr_reader :data_version
+
   # 載入 CBETA 缺字資料庫
-  def initialize
+  #
+  # 預設使用 gem 內建的缺字資料。也可以傳入外部檔案路徑，自行決定要使用哪一份資料，
+  # 例如 https://github.com/cbeta-org/cbeta_gaiji 某個版本的 cbeta_gaiji.json，
+  # 讓缺字資料版本與 gem 版本脫鉤。外部檔案必須與 cbeta_gaiji repo 的 JSON 格式相同。
+  #
+  # @param gaiji_path [String, nil] CB 缺字資料（cbeta_gaiji.json）路徑，nil 表示使用內建資料
+  # @param sanskrit_path [String, nil] 悉曇、蘭札資料（cbeta_sanskrit.json）路徑，nil 表示使用內建資料
+  # @param data_version [String, nil] 外部缺字資料的期別，供 {#data_version} 回傳；
+  #   gaiji_path、sanskrit_path 都未指定時忽略此參數，一律為 {DATA_VERSION}
+  #
+  # @example 使用內建資料
+  #   g = CBETA::Gaiji.new
+  #
+  # @example 使用外部資料
+  #   g = CBETA::Gaiji.new(
+  #     gaiji_path: '/path/to/cbeta_gaiji/cbeta_gaiji.json',
+  #     sanskrit_path: '/path/to/cbeta_gaiji/cbeta_sanskrit.json',
+  #     data_version: '2026.R3'
+  #   )
+  def initialize(gaiji_path: nil, sanskrit_path: nil, data_version: nil)
     @us = CBETA::UnicodeService.new
-    folder = File.join(File.dirname(__FILE__), '../data')
-    fn = File.join(folder, 'cbeta_gaiji.json')
-    @gaijis = JSON.parse(File.read(fn))
-    
-    fn = File.join(folder, 'cbeta_sanskrit.json')
-    h = JSON.parse(File.read(fn))
-    @gaijis.merge!(h)
+    builtin = gaiji_path.nil? && sanskrit_path.nil?
+    @data_version = builtin ? DATA_VERSION : data_version
+    gaiji_path    ||= File.join(DATA_FOLDER, 'cbeta_gaiji.json')
+    sanskrit_path ||= File.join(DATA_FOLDER, 'cbeta_sanskrit.json')
+
+    @gaijis = JSON.parse(File.read(gaiji_path))
+    @gaijis.merge!(JSON.parse(File.read(sanskrit_path)))
     
     @zzs = {}
     @uni2cb = {}

data/lib/cbeta/unicode_service.rb

@@ -1,19 +1,29 @@
+# 判斷字元收錄於哪一版 Unicode
+#
+# 使用 Ruby 內建 regexp 的 Unicode Age 屬性（\p{Age=...}）判斷。
+# Age 屬性一經指定就不會變動，所以結果不受 Ruby 版本影響。
 class CBETA::UnicodeService
-  def initialize
-    @u2 = Unihan2.new
-  end
+  # Unicode 3.0 以內
+  LEVEL1 = /\A\p{Age=3.0}+\z/
+
+  # Unicode 10.0 以內
+  LEVEL2 = /\A\p{Age=10.0}+\z/
 
+  # Unicode 3.0 以內 在 mobile 可以正確顯示
+  #
+  # @param code [String] 字元
+  # @return [Boolean]
   def level1?(code)
     return false if code.nil?
-    # Unicode 3.0 以內 在 mobile 可以正確顯示
-    v = @u2.ver(code)
-    raise "Unihan2.ver 回傳 nil, code: #{code}" if v.nil?
-    v <= 3
+    LEVEL1.match?(code)
   end
 
+  # Unicode 10 以內 在 desktop 有字型可以顯示
+  #
+  # @param code [String] 字元
+  # @return [Boolean]
   def level2?(code)
     return false if code.nil?
-    # Unicode 10 以內 在 desktop 有字型可以顯示
-    @u2.ver(code) <= 10
+    LEVEL2.match?(code)
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cbeta
 version: !ruby/object:Gem::Version
-  version: 4.1.0
+  version: 4.3.0
 platform: ruby
 authors:
 - Ray Chou
@@ -36,26 +36,6 @@ cert_chain:
   -----END CERTIFICATE-----
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
-- !ruby/object:Gem::Dependency
-  name: unihan2
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.2'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.2.0
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.2'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.2.0
 - !ruby/object:Gem::Dependency
   name: nokogiri
   requirement: !ruby/object:Gem::Requirement