ctx_parser 0.2.8 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cad3285573937eb84bc6296769943167c22e0ee3d2116bfa14ede731c01b16a8
-  data.tar.gz: df39ee74e57292f031c18eff86bd1e83f5f4ee0d4cf0662a33cede4d54fb7fad
+  metadata.gz: 492a2e200870280a1f4b2d58100e532557ac7f8b92bb3f4a84d7850089ebb80a
+  data.tar.gz: 4e9055e1be83197785f5fbedd6043a42b2568e377951916cc78921d28d9738be
 SHA512:
-  metadata.gz: 5f8f13c0eb39be188471266b3d50bd74549a74d15f62fb029a01afaad0e637c508349cf742cdb01b9213207cbe4cafc2f8e9f4d5a201ebd0aed09da4e94cf34c
-  data.tar.gz: 1accf89b2e92848fed18a51324c1bde95e4f2165db697bd2bb6718be2cc482ac4d9c901b1810d47a769104ece3c6010be66956f5770e5f5ef3e6bcf0a63b4e11
+  metadata.gz: c855bbd1456d6c6569eee7cf9834ea6914d29c942954836b87a5453386cb117f77b38e717b87a88f4d5c5662705976ca02bdb0391d15978d7c95c7aa2dd57131
+  data.tar.gz: 6043a601e4d81c530ef7f812ae66d78b61f44444574bed26cf02d7bebca3d8fa29b2f91831ca6eca67b1e1b3d66250d8252ab40a036cde57c86aa4dadb743a0c

data/CHANGELOG.md

@@ -4,6 +4,14 @@ Changes to the public contract are recorded here. Versions follow Semantic Versi
 
 ## Unreleased
 
+## 0.3.0 (2026-10-29)
+
+- Add `Result#partial?` and `#available?`; reject records on failed or unsupported results.
+
+## 0.2.9 (2026-10-24)
+
+- Correct dependency documentation to match the unconstrained ipaddr and digest declarations; applications select and validate their runtime dependency combination.
+
 ## 0.2.8 (2026-10-23)
 
 - Remove the extra minimum version requirement for the standard-library ipaddr dependency.

data/README-zh.md

@@ -21,7 +21,7 @@ gem "ctx_parser"
 
 然后执行 `bundle install`；也可直接执行 `gem install ctx_parser`。Ruby 加载入口为 `ctx_parser`，公开命名空间为 `CtxParser`；gem 包名与 Ruby 命名空间分别维护。
 
-本模块不依赖其他 Gatework 领域 gem。 gemspec 要求 `ipaddr >= 1.2.3` 以确保严格地址解析，`digest` 不设版本约束；应用应提交自己的 `Gemfile.lock`，保持部署可复现。使用本库不需要启动 Rails 或配置兄弟模块的本地路径。
+本模块不依赖其他 Gatework 领域 gem。 gemspec 声明 `ipaddr` 和 `digest`，不限制版本；运行依赖组合应由应用锁文件固定并验证；应用应提交自己的 `Gemfile.lock`，保持部署可复现。使用本库不需要启动 Rails 或配置兄弟模块的本地路径。
 
 发布产物和校验值见 [GitHub Releases](https://github.com/gatework/ctx_parser/releases)，已发布版本以 [RubyGems](https://rubygems.org/gems/ctx_parser) 为准。
 
@@ -122,3 +122,6 @@ CI 在 Linux、macOS 上执行测试、lint、示例、构建和隔离安装。`
 ## 许可证
 
 MIT，见 [LICENSE](LICENSE)。
+
+
+`Result#partial?` identifies partial parsing; `#available?` is true for complete or partial results. Failed and unsupported results cannot contain records. Availability does not establish completeness or network health.

data/README.md

@@ -21,7 +21,7 @@ gem "ctx_parser"
 
 Then run `bundle install`, or install directly with `gem install ctx_parser`. The require path is `ctx_parser` and the public namespace is `CtxParser`; package names and Ruby namespaces are intentionally separate.
 
-This package has no dependency on the other Gatework domain gems. The gemspec requires `ipaddr >= 1.2.3` for strict address parsing; `digest` has no version constraint. Applications should commit their own `Gemfile.lock` to make deployments reproducible. No Rails boot or sibling checkout paths are required.
+This package has no dependency on the other Gatework domain gems. The gemspec declares `ipaddr` and `digest` without version constraints. Select and validate the runtime dependency combination in the application lockfile. Applications should commit their own `Gemfile.lock` to make deployments reproducible. No Rails boot or sibling checkout paths are required.
 
 Release artifacts and checksums are available from [GitHub Releases](https://github.com/gatework/ctx_parser/releases). Check [RubyGems](https://rubygems.org/gems/ctx_parser) for published versions.
 
@@ -122,3 +122,6 @@ Publish dependency gems first. A Git tag, a successful build, or a workflow file
 ## License
 
 MIT. See [LICENSE](LICENSE).
+
+
+`Result#partial?` identifies partial parsing; `#available?` is true for complete or partial results. Failed and unsupported results cannot contain records. Availability does not establish completeness or network health.

data/lib/ctx_parser/result.rb

@@ -11,11 +11,18 @@ module CtxParser
       raise ArgumentError, "Records must be hashes" unless records.is_a?(Array) && records.all? { |row| row.is_a?(Hash) }
       raise ArgumentError, "Issues must be hashes" unless issues.is_a?(Array) && issues.all? { |issue| issue.is_a?(Hash) }
 
+      if %i[failed unsupported].include?(status) && records.any?
+        raise ArgumentError, "Unavailable parser results cannot contain records"
+      end
+
       super(status: status, records: Immutable.copy(records), issues: Immutable.copy(issues))
     end
 
     # 判断解析结果是否具有完整证据。
     def complete? = status == :complete
+    # 不完整事实仍可用于报告已观察到的问题。
+    def partial? = status == :partial
+    def available? = complete? || partial?
 
     # 展示对象身份与状态，避免泄露原始回显或凭据。
     def inspect = "#<#{self.class.name} status=#{status} records=#{records.size}>"

data/lib/ctx_parser/version.rb

@@ -2,5 +2,5 @@
 
 module CtxParser
   # 公开包版本，供 RubyGems 元数据和运行时调用方共用。
-  VERSION = "0.2.8"
+  VERSION = "0.3.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ctx_parser
 version: !ruby/object:Gem::Version
-  version: 0.2.8
+  version: 0.3.0
 platform: ruby
 authors:
 - Gatework contributors