strs_tools : unescaping

Author: wanguardd

module/core/strs_tools/task/task_plan.md

@@ -19,7 +19,7 @@
     *   ✅ Increment 3: Fix Compilation Errors
     *   ✅ Increment 4: Implement Unescaping Logic
     *   ✅ Increment 5: Implement Quoted Segment Logic
-    *   ⚫ Increment 6: Add New Tests for Unescaping and Quoting
+    *   ⏳ Increment 6: Add New Tests for Unescaping and Quoting
     *   ⚫ Increment 7: Finalization
 
 ### Permissions & Boundaries
@@ -133,9 +133,10 @@
 *   **Specification Reference:** "Acceptance Criteria" from the proposal.
 *   **Steps:**
     *   Step 1: Create a new test file: `module/core/strs_tools/tests/inc/split_test/quoting_and_unescaping_tests.rs`.
-    *   Step 2: Add this new file as a module in `module/core/strs_tools/tests/inc/split_test/mod.rs`.
-    *   Step 3: In the new test file, add a test case that is an exact copy of the MRE from the task description. Assert that the output for the quoted part is a single `Split` item with the correctly unescaped string.
-    *   Step 4: Add more test cases covering:
+    *   Step 2: Use `read_file` to load `module/core/strs_tools/tests/inc/split_test/mod.rs`.
+    *   Step 3: Use `insert_content` to add `pub mod quoting_and_unescaping_tests;` to `module/core/strs_tools/tests/inc/split_test/mod.rs`.
+    *   Step 4: In the new test file (`quoting_and_unescaping_tests.rs`), add a test case that is an exact copy of the MRE from the task description. Assert that the output for the quoted part is a single `Split` item with the correctly unescaped string.
+    *   Step 5: Add more test cases covering:
         *   Strings with no quotes.
         *   Strings with empty quoted sections (`""`).
         *   Strings with multiple, different escape sequences.

module/core/strs_tools/tests/inc/split_test/mod.rs

@@ -47,3 +47,4 @@ mod quoting_options_tests;
 mod indexing_options_tests;
 mod combined_options_tests;
 mod edge_case_tests;
+mod quoting_and_unescaping_tests;

module/core/strs_tools/tests/inc/split_test/quoting_and_unescaping_tests.rs

@@ -0,0 +1,100 @@
+//! Tests focusing on `quoting` and unescaping behavior.
+use strs_tools::string::split::*;
+
+// Test case from the original issue description
+#[test]
+fn test_mre_unescaping()
+{
+  let src = r#"sub .asset.get path:"a b""#;
+  let iter = split()
+  .src( src )
+  .delimeter( " " )
+  .quoting( true )
+  .preserving_quoting( false )
+  .perform();
+  let splits : Vec<_> = iter.map( | e | e.string ).collect();
+  assert_eq!( splits, vec![ "sub", ".asset.get", "path:a b" ] );
+}
+
+#[test]
+fn test_no_quotes()
+{
+  let src = "a b c";
+  let iter = split()
+  .src( src )
+  .delimeter( " " )
+  .quoting( true )
+  .perform();
+  let splits : Vec<_> = iter.map( | e | e.string ).collect();
+  assert_eq!( splits, vec![ "a", "b", "c" ] );
+}
+
+#[test]
+fn test_empty_quoted_sections()
+{
+  let src = r#"a "" b"#;
+  let iter = split()
+  .src( src )
+  .delimeter( " " )
+  .quoting( true )
+  .preserving_quoting( false )
+  .perform();
+  let splits : Vec<_> = iter.map( | e | e.string ).collect();
+  assert_eq!( splits, vec![ "a", "", "b" ] );
+}
+
+#[test]
+fn test_multiple_escape_sequences()
+{
+  let src = r#""\n\t\\\"""#;
+  let iter = split()
+  .src( src )
+  .delimeter( " " )
+  .quoting( true )
+  .preserving_quoting( false )
+  .perform();
+  let splits : Vec<_> = iter.map( | e | e.string ).collect();
+  assert_eq!( splits, vec![ "\n\t\\\"" ] );
+}
+
+#[test]
+fn test_quoted_at_start()
+{
+  let src = r#""a b" c"#;
+  let iter = split()
+  .src( src )
+  .delimeter( " " )
+  .quoting( true )
+  .preserving_quoting( false )
+  .perform();
+  let splits : Vec<_> = iter.map( | e | e.string ).collect();
+  assert_eq!( splits, vec![ "a b", "c" ] );
+}
+
+#[test]
+fn test_quoted_at_end()
+{
+  let src = r#"a "b c""#;
+  let iter = split()
+  .src( src )
+  .delimeter( " " )
+  .quoting( true )
+  .preserving_quoting( false )
+  .perform();
+  let splits : Vec<_> = iter.map( | e | e.string ).collect();
+  assert_eq!( splits, vec![ "a", "b c" ] );
+}
+
+#[test]
+fn test_unterminated_quote()
+{
+  let src = r#"a "b c"#;
+  let iter = split()
+  .src( src )
+  .delimeter( " " )
+  .quoting( true )
+  .preserving_quoting( false )
+  .perform();
+  let splits : Vec<_> = iter.map( | e | e.string ).collect();
+  assert_eq!( splits, vec![ "a", "b c" ] );
+}