release: 0.15.2

Author: Foster Guo

CHANGELOG.md

@@ -1,6 +1,23 @@
 # Changelog
 
 
+## 0.15.2 - 2026-04-11
+
+### Changed
+
+- **Python**: Batch methods (`batch_is_match`, `batch_process`, `batch_find_match`) use `PyBackedStr` for zero-copy string handling, avoiding redundant UTF-8 copies across the FFI boundary.
+- **Core**: Replace unsafe `get_unchecked` with safe indexing guarded by `assert_unchecked` hints across scan and pattern modules.
+- **Core**: Add safety assertions for bitset indexing in `DeleteMatcher`.
+- **Core**: Simplify text processing by inlining `replace_cow` functionality.
+- **Core**: Move `has_match` into `ScanState` and remove unused methods.
+- **Tooling**: Trim `cargo-all-features` allowlist to only the `perf` feature.
+
+### Documentation
+
+- Update all README Quick Start examples to use builder APIs (Python, Java, C) for consistency with Rust.
+- Remove phantom `process_iter` reference from Rust README (method was removed in 0.15.0).
+- Fix formatting in root README architecture diagram.
+
 ## 0.15.1 - 2026-04-11
 
 ### Added

Cargo.toml

@@ -13,7 +13,7 @@ readme = "README.md"
 keywords = ["text", "string", "search", "pattern", "multi"]
 license = "Apache-2.0 OR MIT"
 repository = "https://github.com/Lips7/Matcher"
-version = "0.15.1"
+version = "0.15.2"
 
 [profile.dev]
 split-debuginfo = "unpacked"

README.md

@@ -103,18 +103,14 @@ pip install matcher_py
 ```
 
 ```python
-import json
-from matcher_py import ProcessType, SimpleMatcher
-
-matcher = SimpleMatcher(
-    json.dumps({
-        ProcessType.NONE: {
-            1: "hello&world",        # AND: both must appear
-            2: "color|colour",       # OR: either spelling
-            3: r"\bcat\b",          # word boundary
-        }
-    }).encode()
-)
+from matcher_py import ProcessType, SimpleMatcherBuilder
+
+builder = SimpleMatcherBuilder()
+builder.add_word(ProcessType.NONE, 1, "hello&world")     # AND: both must appear
+builder.add_word(ProcessType.NONE, 2, "color|colour")    # OR: either spelling
+builder.add_word(ProcessType.NONE, 3, r"\bcat\b")        # word boundary
+matcher = builder.build()
+
 assert matcher.is_match("hello, world!")
 assert matcher.is_match("nice colour")
 assert not matcher.is_match("concatenate")  # "cat" not a whole word
@@ -129,10 +125,14 @@ See the [Python README](./matcher_py/README.md) for full docs.
 
 ```java
 import com.matcherjava.SimpleMatcher;
-
-// ProcessType.NONE = 1; word_id 1/2/3
-byte[] config = "{\"1\":{\"1\":\"hello&world\",\"2\":\"color|colour\",\"3\":\"\\\\bcat\\\\b\"}}".getBytes();
-try (SimpleMatcher matcher = new SimpleMatcher(config)) {
+import com.matcherjava.SimpleMatcherBuilder;
+import com.matcherjava.extensiontypes.ProcessType;
+
+try (SimpleMatcher matcher = new SimpleMatcherBuilder()
+    .add(ProcessType.NONE, 1, "hello&world")       // AND: both must appear
+    .add(ProcessType.NONE, 2, "color|colour")      // OR: either spelling
+    .add(ProcessType.NONE, 3, "\\bcat\\b")         // word boundary
+    .build()) {
     assert matcher.isMatch("hello, world!");
     assert matcher.isMatch("nice colour");
     assert !matcher.isMatch("concatenate");   // "cat" not a whole word
@@ -149,12 +149,16 @@ See the [Java README](./matcher_java/README.md) for full docs.
 ```c
 #include "matcher_c.h"
 
-// ProcessType NONE=1; word_ids 1, 2, 3
-void* m = init_simple_matcher("{\"1\":{\"1\":\"hello&world\",\"2\":\"color|colour\",\"3\":\"\\\\bcat\\\\b\"}}");
-simple_matcher_is_match(m, "hello, world!");   // true  — AND
-simple_matcher_is_match(m, "nice colour");     // true  — OR
-simple_matcher_is_match(m, "concatenate");     // false — word boundary
-drop_simple_matcher(m);
+void* builder = init_simple_matcher_builder();
+simple_matcher_builder_add_word(builder, PROCESS_TYPE_NONE, 1, "hello&world");    // AND
+simple_matcher_builder_add_word(builder, PROCESS_TYPE_NONE, 2, "color|colour");   // OR
+simple_matcher_builder_add_word(builder, PROCESS_TYPE_NONE, 3, "\\bcat\\b");      // word boundary
+void* matcher = simple_matcher_builder_build(builder);
+
+simple_matcher_is_match(matcher, "hello, world!");   // true  — AND
+simple_matcher_is_match(matcher, "nice colour");     // true  — OR
+simple_matcher_is_match(matcher, "concatenate");     // false — word boundary
+drop_simple_matcher(matcher);
 ```
 
 See the [C README](./matcher_c/README.md) for full docs.

matcher_c/Cargo.toml

@@ -17,5 +17,5 @@ name = "matcher_c"
 crate-type = ["cdylib", "rlib"]
 
 [dependencies]
-matcher_rs = { path = "../matcher_rs", version = "0.15.1", features = ["serde", "rayon"] }
+matcher_rs = { path = "../matcher_rs", version = "0.15.2", features = ["serde", "rayon"] }
 sonic-rs = "0.5.8"

matcher_java/Cargo.toml

@@ -16,6 +16,6 @@ crate-type = ["cdylib"]
 path = "src/main/rust/lib.rs"
 
 [dependencies]
-matcher_rs = { path = "../matcher_rs", version = "0.15.1", features = ["serde", "rayon"] }
+matcher_rs = { path = "../matcher_rs", version = "0.15.2", features = ["serde", "rayon"] }
 jni = "0.22.4"
 sonic-rs = "0.5.8"

matcher_java/README.md

@@ -35,7 +35,7 @@ cp target/release/libmatcher_java.dylib matcher_java/src/main/resources/  # .so
 ```xml
 <groupId>com.matcher_java</groupId>
 <artifactId>matcher_java</artifactId>
-<version>0.15.1</version>
+<version>0.15.2</version>
 ```
 
 ## Usage

matcher_java/pom.xml

@@ -6,7 +6,7 @@
 
   <groupId>com.matcher_java</groupId>
   <artifactId>matcher_java</artifactId>
-  <version>0.15.1</version>
+  <version>0.15.2</version>
 
   <name>matcher_java</name>
   <url>https://github.com/Lips7/Matcher</url>

matcher_py/Cargo.toml

@@ -18,7 +18,7 @@ name = "matcher_py"
 crate-type = ["cdylib"]
 
 [dependencies]
-matcher_rs = { path = "../matcher_rs", version = "0.15.1", features = ["serde", "rayon"] }
+matcher_rs = { path = "../matcher_rs", version = "0.15.2", features = ["serde", "rayon"] }
 pyo3 = { version = "0.28.3", features = ["extension-module"] }
 sonic-rs = "0.5.8"
 

matcher_py/README.md

@@ -75,16 +75,32 @@ print(reduce_text_process(ProcessType.DELETE_NORMALIZE, "hello, world!"))
 print(text_process(ProcessType.DELETE, "hello, world!"))
 ```
 
-### Simple Matcher Basic Usage
+### Simple Matcher — Builder (recommended)
 
-Here’s an example of how to use the `SimpleMatcher`:
+```python
+from matcher_py import ProcessType, SimpleMatcherBuilder
+
+builder = SimpleMatcherBuilder()
+builder.add_word(ProcessType.NONE, 1, "hello&world")
+builder.add_word(ProcessType.NONE, 2, "word&word~hello")
+builder.add_word(ProcessType.DELETE, 3, "hallo")
+matcher = builder.build()
+
+assert matcher.is_match("hello^&!#*#&!^#*()world")
+result = matcher.process("hello,world,word,word,hallo")
+print(result)
+```
+
+### Simple Matcher — JSON constructor
+
+You can also construct from JSON bytes if you already have them:
 
 ```python
 import json
 
 from matcher_py import ProcessType, SimpleMatcher
 
-simple_matcher = SimpleMatcher(
+matcher = SimpleMatcher(
     json.dumps(
         {
             ProcessType.NONE: {
@@ -97,32 +113,20 @@ simple_matcher = SimpleMatcher(
         }
     ).encode()
 )
-# Check if a text matches
-assert simple_matcher.is_match("hello^&!#*#&!^#*()world")
-# Perform simple processing
-result = simple_matcher.process("hello,world,word,word,hallo")
-print(result)
+assert matcher.is_match("hello^&!#*#&!^#*()world")
 ```
 
 ### OR, NOT, and Word Boundary
 
 ```python
-import json
-
-from matcher_py import ProcessType, SimpleMatcher
-
-matcher = SimpleMatcher(
-    json.dumps(
-        {
-            ProcessType.NONE: {
-                1: "color|colour",          # OR: matches either spelling
-                2: "banana~peel",           # NOT: "banana" without "peel"
-                3: r"\bcat\b",             # word boundary: whole word only
-                4: r"bright&color|colour~\bdark\b",  # combined
-            }
-        }
-    ).encode()
-)
+from matcher_py import ProcessType, SimpleMatcherBuilder
+
+builder = SimpleMatcherBuilder()
+builder.add_word(ProcessType.NONE, 1, "color|colour")                     # OR
+builder.add_word(ProcessType.NONE, 2, "banana~peel")                      # NOT
+builder.add_word(ProcessType.NONE, 3, r"\bcat\b")                         # word boundary
+builder.add_word(ProcessType.NONE, 4, r"bright&color|colour~\bdark\b")    # combined
+matcher = builder.build()
 
 assert matcher.is_match("nice colour")            # OR
 assert matcher.is_match("banana split")            # NOT (no veto)

matcher_py/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "matcher_py"
 description = "A high-performance matcher designed to solve LOGICAL and TEXT VARIATIONS problems in word matching, implemented in Rust."
-version = "0.15.1"
+version = "0.15.2"
 readme = "README.md"
 requires-python = ">=3.8"
 authors = [{ name = 'Foster Guo', email = "f975793771@gmail.com" }]