cbeta 4.2.0 → 4.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e86b3e6256a56e239bd95259c3e040ce05563740aa7a53ae387bbdace4bae2e1
-  data.tar.gz: d72162f4ea8d9c0650d748b3593c3ddabe259dd295438d7aed7a474b93bfe5bf
+  metadata.gz: d87e5abf202e1a364780efea5d54761eef5a59c19ff68b17e051fdd119f0baa5
+  data.tar.gz: c1720705f1a5beabb8267568baab667973e722321a41c2b5139063f203289f04
 SHA512:
-  metadata.gz: e75dbd36ac5ececb236bac18deff9692055188456cc42afe69a99218948013943229e5f3679272491c9ff6baaac0f06654a2f1ff9965df0bb2dbff3b9d048d45
-  data.tar.gz: 644492039267b108f6d35fdf97fb937bbff1ce592d2090169171a89d94aa235e59068eb1dc92fb6ca3c10fd1afa4c0c6a8e48c87c29fff9b49fe05431ecdf4e1
+  metadata.gz: 9cf1756da5884ecb2414981f99fdabede3d7bc511b9002d62d5f9581bbe9232b037409dc6c361771eded7a5edb1cb3e720ce91cc0ceddf6060a50ea274e679fa
+  data.tar.gz: f8854526080b42a3e53e52f8b775afeaed21cd2a9a66c35947a71c0b2a7551d6860e03c1cca92f4e19f43b20c617ebf80a1a54d20750cdfe42d7c9d2fdcd90b1

data/lib/cbeta/gaiji.rb

@@ -5,6 +5,15 @@ 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 缺字資料庫
   #
   # 預設使用 gem 內建的缺字資料。也可以傳入外部檔案路徑，自行決定要使用哪一份資料，
@@ -13,6 +22,8 @@ class CBETA::Gaiji
   #
   # @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
@@ -20,10 +31,13 @@ class CBETA::Gaiji
   # @example 使用外部資料
   #   g = CBETA::Gaiji.new(
   #     gaiji_path: '/path/to/cbeta_gaiji/cbeta_gaiji.json',
-  #     sanskrit_path: '/path/to/cbeta_gaiji/cbeta_sanskrit.json'
+  #     sanskrit_path: '/path/to/cbeta_gaiji/cbeta_sanskrit.json',
+  #     data_version: '2026.R3'
   #   )
-  def initialize(gaiji_path: nil, sanskrit_path: nil)
+  def initialize(gaiji_path: nil, sanskrit_path: nil, data_version: nil)
     @us = CBETA::UnicodeService.new
+    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')
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cbeta
 version: !ruby/object:Gem::Version
-  version: 4.2.0
+  version: 4.3.0
 platform: ruby
 authors:
 - Ray Chou