hegeltest 0.2.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0a54df97ebf7472cdffe374debffcc13f946d48ba7a360e1537aeef8ac2f3172
-  data.tar.gz: c891a16a0babf1bae7973f84104368e26be5acfece022f8c97b80bf23e2504ba
+  metadata.gz: b20fa55081891dc4db4f8b9dd6611a39793214c74b76946da062058a9987315f
+  data.tar.gz: d495a52e3da347f8632aca40c45c68797f32fe683d67a2ab961df4d49ae33338
 SHA512:
-  metadata.gz: 13639c1de1b96f2c4ffe8fe64f2aaa942c1841f3c23aefebbe20abd01ce17b96a3edde4415f429c0db9e7cdc38cfc06d132f683088f10d01940d35c4d651f6bb
-  data.tar.gz: 68943f2ffd4fc8c1e7b2b10e8261c89f39ca206408ad17ffa60fab53f6a91eefab77eb2a8445e2c9099d5b5cc5e68ea995effa07bc9d773a9542a60bd672a648
+  metadata.gz: 336a4583feb256103314cfbd9029d5752e1e223738e9f12337541aa487cfcddd9d3d60432ca4629aca3ef068ba6238d742c244a004df751a886bcc355cc019f2
+  data.tar.gz: 1ef3026df63b5d814ddd9379af418b350b14874330af9ba449e5bd1843c1a9dee82906075da6d677351f8baa11cc300a228544b16b210534735d4fede93ddd7f

data/CHANGELOG.md

@@ -2,23 +2,69 @@
 
 ## [Unreleased]
 
+## [0.3.0] - 2026-10-14
+
+### Engine: libhegel 0.45.4 (was 0.45.1)
+
+The [libhegel 0.45.4 release notes](https://github.com/hegeldev/hegel-rust/releases/tag/libhegel-v0.45.4)
+describe 0.45.4 alone. The
+[engine changelog](https://github.com/hegeldev/hegel-rust/blob/libhegel-v0.45.4/hegel-c/CHANGELOG.md)
+describes each engine release after 0.45.1, up to 0.45.4.
+
+Each platform gem carries `libhegel` 0.45.4. The engine only adds to its C
+interface, and these bindings do not use the additions. The engine
+changes these results for a caller:
+
+- A run that generates no valid test case now raises `Hegel::Error` with a
+  message that starts with `Unsatisfiable`, also when
+  `suppress_health_check:` holds `:filter_too_much` or
+  `:test_cases_too_large`. Before, such a run passed. A test that rejects
+  every case and expects to pass must now draw at least one valid case.
+- `from_regex` records each drawn string as one choice that the pattern
+  constrains. A failure shrinks inside the pattern, so
+  `from_regex("(?:bbbb|a)", fullmatch: true)` now shrinks to `"a"`, where
+  it stopped at `"bbbb"` before. The example database drops a failure that
+  an earlier engine saved for a `from_regex` draw, so the first run after
+  the update does not replay it.
+- `from_regex` rejects a look-behind of variable width, such as
+  `(?<=a*)b`, with `Hegel::Error`, as Python's `re` does.
+- `\w`, `\d`, `\s`, and case-insensitive matching in `from_regex` follow
+  Unicode 17.0. Before, they followed Unicode 15.1.
+- A run stops when its test-case budget or its budget of invalid cases is
+  spent. Before, it could also stop after ten rejected cases in a row that
+  it had seen before.
+
 ## [0.2.1] - 2026-10-08
 
-Each platform gem carries `libhegel` 0.45.1, up from 0.45.0. A caller has
-nothing to change. The engine now reads a NULL string buffer with length
-zero as the empty string, and it rejects a NULL buffer with a nonzero
-length. These bindings send neither case, so a drawn value does not
-change: `from_regex("", fullmatch: true)` draws `""` on both engines.
+### Engine: libhegel 0.45.1 (was 0.45.0)
+
+The [libhegel 0.45.1 release notes](https://github.com/hegeldev/hegel-rust/releases/tag/libhegel-v0.45.1)
+describe the engine changes.
+
+Each platform gem carries `libhegel` 0.45.1. A caller has nothing to
+change. The engine now reads a NULL string buffer with length zero as the
+empty string, and it rejects a NULL buffer with a nonzero length. These
+bindings send neither case, so a drawn value does not change:
+`from_regex("", fullmatch: true)` draws `""` on both engines.
 
 ## [0.2.0] - 2026-10-07
 
+### Engine: libhegel 0.45.0 (was 0.32.5)
+
+The [libhegel 0.45.0 release notes](https://github.com/hegeldev/hegel-rust/releases/tag/libhegel-v0.45.0)
+describe 0.45.0 alone. The
+[engine changelog](https://github.com/hegeldev/hegel-rust/blob/libhegel-v0.45.0/hegel-c/CHANGELOG.md)
+describes each engine release after 0.32.5, up to 0.45.0.
+
+Each platform gem carries `libhegel` 0.45.0. The engine changed its C
+interface in several places between the two, and these bindings follow
+each change. The sections below list what that changes for a caller.
+
+### Ruby
+
 The floor is Ruby 3.4. A project on Ruby 3.3 stays on 0.1.1. See
 [ADR 0017](docs/adr/0017-raise-the-ruby-floor-to-3-4.md).
 
-Each platform gem carries `libhegel` 0.45.0, up from 0.32.5. The engine
-changed its C interface in several places between the two, and these
-bindings follow each change.
-
 ### Changes a caller has to make
 
 `Hegel.test` no longer takes `stateful_step_count:`. Pass `step_count:` to
@@ -128,6 +174,7 @@ The engine is called through the `ffi` gem. Each platform gem carries the
 matching `libhegel` 0.32.5 build. The platform-independent gem carries none,
 so a run on it needs `HEGEL_LIBHEGEL_PATH` pointing at a local build.
 
+[0.3.0]: https://github.com/meganemura/hegel-ruby/releases/tag/v0.3.0
 [0.2.1]: https://github.com/meganemura/hegel-ruby/releases/tag/v0.2.1
 [0.2.0]: https://github.com/meganemura/hegel-ruby/releases/tag/v0.2.0
 [0.1.1]: https://github.com/meganemura/hegel-ruby/releases/tag/v0.1.1

data/lib/hegel/libhegel_version.rb

@@ -5,5 +5,5 @@ module Hegel
   # Hegel::VERSION (the gem's own release): hegel-go and hegel-typescript keep
   # the two separate too, so bumping the pinned engine can land as its own
   # commit without also releasing a new gem version.
-  LIBHEGEL_VERSION = "0.45.1"
+  LIBHEGEL_VERSION = "0.45.4"
 end

data/lib/hegel/runner.rb

@@ -178,9 +178,9 @@ module Hegel
     # Pulls test cases from +run+ until hegel_next_test_case reports none
     # left (a nil out-parameter, not an error). Never counts iterations
     # itself: test_cases bounds generation, not how many times shrinking
-    # and rejected cases call the body. Measured against libhegel 0.45.0, a
+    # and rejected cases call the body. Measured against libhegel 0.45.4, a
     # run configured for 20 test cases whose body rejected nearly every case
-    # took 1040 to 1537 iterations. +stats+ does its own, different counting
+    # took 475 to 1607 iterations. +stats+ does its own, different counting
     # -- see GenerationStats above.
     def drive(impl, ctx, run, stats, captures, &block)
       loop do

data/lib/hegel/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Hegel
-  VERSION = "0.2.1"
+  VERSION = "0.3.0"
 end

data/skills/hegel-ruby/references/ruby/reference.md

@@ -494,12 +494,12 @@ expose) are not available in this binding; `codec:`, `min_codepoint:`, and
 `max_codepoint:` are the alphabet controls it exposes today.
 
 Other generators cover most character-set jobs. These results were measured
-with libhegel 0.45.0:
+with libhegel 0.45.4:
 
 | Job | Generator | Measured output |
 |---|---|---|
-| Characters to include | `from_regex("[ぁ-んA-Z0-9]{1,5}", fullmatch: true)` | `"ぁ"`, `"Hわ9ごう"`; 30 draws all matched the pattern |
-| Characters to exclude | `from_regex("[^,\\t\\n]{0,6}", fullmatch: true)` | `""`, `"\u008FBՔ\u0014੐C"`; 30 draws contained no comma, tab, or newline |
+| Characters to include | `from_regex("[ぁ-んA-Z0-9]{1,5}", fullmatch: true)` | `"0"`, `"ぢ3"`, `"るJこ"`; 30 draws all matched the pattern |
+| Characters to exclude | `from_regex("[^,\\t\\n]{0,6}", fullmatch: true)` | `""`, `"\u0010ùóR'<"`; 30 draws contained no comma, tab, or newline |
 | A contiguous block | `text(min_codepoint: 0x300, max_codepoint: 0x36F)` | Every character of 100 draws was in U+0300 through U+036F |
 | An arbitrary alphabet | `arrays(sampled_from(%w[ß a İ]), max_size: 4).map(&:join)` | 30 draws, each built only from `ß`, `a`, and `İ` |
 
@@ -1219,11 +1219,18 @@ value already in the shape you need):
 
 ```ruby
 result = Hegel.test(test_cases: 20, suppress_health_check: [:filter_too_much], verbosity: :quiet) do |tc|
-  tc.draw(integers.filter { |_n| false })
+  tc.draw(integers(min_value: 0, max_value: 1_000_000).filter(&:zero?))
 end
 result # => nil
 ```
 
+The suppressed check does not let a run pass with no valid input. A
+predicate that never holds, such as `integers.filter { |_n| false }`,
+still raises `Hegel::Error`, with a message that starts with
+`"Unsatisfiable: unable to satisfy the test's assumptions."` Since libhegel
+0.45.2, the engine ends every run that generates no valid test case this
+way.
+
 ## Gotchas
 
 1. **Float defaults include NaN and infinity when unbounded.** `floats` with

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hegeltest
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.0
 platform: ruby
 authors:
 - meganemura