Update Text.replace and Text.replace_all.

[wdanilo]

This task is automatically imported from the old Task Issue Board and it was originally created by James Dunkerley.
Original issue is here.

---

Building on top of the new Regex.compile this ticket is to add replace and replace_all to the Pattern object and then retire all the old Regex modules. Note: this will include implementing replacing special target strings.

The replace function loses the ability to target the last instance.

## Find and replace the first instance of `term` in `self`, returning the new
   Text value.

   Arguments:
   - term: The term or pattern to find within `self`. 
   - replacement: What to replace the term matched with.
     If using regular expressions, then the special replacement patterns can be
     used (see below for details).
   - case_sensitivity: Specifies if the text values should be compared case
     sensitively.
   - use_regex: Enable using regular expressions.

   ! Special Replacement Patterns

     The following patterns are supported:

     - `$$`: Inserts an `$`
     - `$&`: Inserts the matched substring.
     - `$n`: Inserts the `n`th (1-indexed) capturing group.
     - `$name`: Inserts the named capturing group called `name`.

   > Example
     Find the first matching section and replace.

         example_replace =
             "abcdefabcdef".replace "abc" "xyz" == "xyzdefabcdef"

   > Example
     Find the first substring matching the regex and replace.

         example_replace =
             "aabbbbccccaabcaaaa".replace "a[ab]c" "def" use_regex=True == "aabbbbccccadefaaaa"

   > Example
     Find the first substring matching the regex and replace with a special pattern.

         example_replace =
             "aabbbbccccaabcaaaa".replace "a([ab]+)c" "_$1_" use_regex=True == "a_bbbb_cccaabcaaaa"
Text.replace : Text -> Text -> Case_Sensitivity -> Boolean -> Text
Text.replace self term="find" replacement="replace" case_sensitivity=Case_Sensitivity.Sensitive use_regex=False =

## Find and replace all instances of `term` in `self`, returning the new Text
   value.

   Arguments:
   - term: The term or pattern to find within `self`. 
   - replacement: What to replace the term matched with.
     If using regular expressions, then the special replacement patterns can be
     used (see below for details).
   - case_sensitivity: Specifies if the text values should be compared case
     sensitively.
   - use_regex: Enable using regular expressions.

   ! Special Replacement Patterns

     The following patterns are supported:

     - `$$`: Inserts an `$`
     - `$&`: Inserts the matched substring.
     - `$n`: Inserts the `n`th (1-indexed) capturing group.
     - `$name`: Inserts the named capturing group called `name`.

   > Example
     Find the all matching sections and replace.

         example_replace_all =
             "abcdefabcdef".replace_all "abc" "xyz" == "xyzdefxyzdef"

   > Example
     Find the all substrings matching the regex and replace.

         example_replace_all =
             "aabbbbccccaabcaaaa".replace_all "a[ab]+c" "def" use_regex=True == "adefcccadefaaaa"

   > Example
     Find the first substring matching the regex and replace with a special pattern.

         example_replace =
             "aabbbbccccaabcaaaa".replace_all "a([ab]+)c" "_$1_" use_regex=True == "a_bbbb_ccca_b_aaaa"
Text.replace_all : Text -> Text -> Case_Sensitivity -> Boolean -> Text
Text.replace_all self term="find" replacement="replace" case_sensitivity=Case_Sensitivity.Sensitive use_regex=False =

[enso-bot]

Greg Travis reports a new STANDUP for today (2023-03-10):

Progress: find, find_all It should be finished by 2023-03-15.

Next Day: Regex tests

[enso-bot]

Greg Travis reports a new STANDUP for today (2023-03-13):

Progress: Regex_2_Specs, replace It should be finished by 2023-03-15.

Next Day: replace

[enso-bot]

Greg Travis reports a new STANDUP for today (2023-03-14):

Progress: replace, previous PR comments It should be finished by 2023-03-15.

Next Day: tests

[enso-bot]

Greg Travis reports a new 🔴 DELAY for today (2023-03-15):

Summary: There is 1 day delay in implementation of the Update Text.replace and Text.replace_all. (#5122) task.
It will cause 0 days delay for the delivery of this weekly plan.

Delay Cause: brutal merge problems

[enso-bot]

Greg Travis reports a new STANDUP for today (2023-03-15):

Progress: replace, previous PR comments It should be finished by 2023-03-16.

Next Day: tests

[enso-bot]

Greg Travis reports a new 🔴 DELAY for today (2023-03-16):

Summary: There is 1 day delay in implementation of the Update Text.replace and Text.replace_all. (#5122) task.
It will cause 0 days delay for the delivery of this weekly plan.

Delay Cause: more unicode/grapheme trickiness

Possible solutions: confirm theory and decide if want to expand to grapheme

[enso-bot]

Greg Travis reports a new STANDUP for today (2023-03-16):

Progress: replace Text.replace with new replace. Update tests. Debugging unicode/grapheme weirdness It should be finished by 2023-03-17.

Next Day: decide about grapheme weirdness

[enso-bot]

Greg Travis reports a new 🔴 DELAY for today (2023-03-17):

Summary: There is 1 day delay in implementation of the Update Text.replace and Text.replace_all. (#5122) task.
It will cause 0 days delay for the delivery of this weekly plan.

Delay Cause: fixed grapheme expansion bug; docs; cleanup

[enso-bot]

Greg Travis reports a new STANDUP for today (2023-03-17):

Progress: fixed grapheme expansion bug; docs; cleanup It should be finished by 2023-03-18.

Next Day: more small tasks

[enso-bot]

Greg Travis reports a new 🔴 DELAY for today (2023-03-20):

Summary: There is 1 day delay in implementation of the Update Text.replace and Text.replace_all. (#5122) task.
It will cause 0 days delay for the delivery of this weekly plan.

Delay Cause: Need LRU cache for Replacer

[enso-bot]

Greg Travis reports a new 🔴 DELAY for today (2023-03-20):

Summary: There is 2 day delay in implementation of the Update Text.replace and Text.replace_all. (#5122) task.
It will cause 0 days delay for the delivery of this weekly plan.

Delay Cause: Need LRU cache for Replacer

[enso-bot]

Greg Travis reports a new STANDUP for today (2023-03-20):

Progress: Implemented LRU cache for replacer It should be finished by 2023-03-21.

Next Day: review

[enso-bot]

Greg Travis reports a new 🔴 DELAY for today (2023-03-21):

Summary: There is 1 day delay in implementation of the Update Text.replace and Text.replace_all. (#5122) task.
It will cause 0 days delay for the delivery of this weekly plan.

Delay Cause: More review stuff

[enso-bot]

Greg Travis reports a new STANDUP for today (2023-03-21):

Progress: More review stuff It should be finished by 2023-03-22.

Next Day: review

[enso-bot]

Greg Travis reports a new 🔴 DELAY for today (2023-03-22):

Summary: There is 1 day delay in implementation of the Update Text.replace and Text.replace_all. (#5122) task.
It will cause 0 days delay for the delivery of this weekly plan.

Delay Cause: More review stuff

[enso-bot]

Greg Travis reports a new STANDUP for today (2023-03-22):

Progress: Making things consistent across all regex methods It should be finished by 2023-03-23.

Next Day: more of the same

[enso-bot]

Greg Travis reports a new 🔴 DELAY for today (2023-03-23):

Summary: There is 1 day delay in implementation of the Update Text.replace and Text.replace_all. (#5122) task.
It will cause 0 days delay for the delivery of this weekly plan.

Delay Cause: More review stuff

[enso-bot]

Greg Travis reports a new STANDUP for today (2023-03-23):

Progress: Trying to run Table_Tests It should be finished by 2023-03-24.

Next Day: more of the same

[enso-bot]

Greg Travis reports a new 🔴 DELAY for today (2023-03-24):

Summary: There is 1 day delay in implementation of the Update Text.replace and Text.replace_all. (#5122) task.
It will cause 0 days delay for the delivery of this weekly plan.

Delay Cause: table tests failing

[enso-bot]

Greg Travis reports a new STANDUP for today (2023-03-24):

Progress: table tests working It should be finished by 2023-03-25.

Next Day: final review

[enso-bot]

Greg Travis reports a new 🔴 DELAY for today (2023-03-27):

Summary: There is 2 day delay in implementation of the Update Text.replace and Text.replace_all. (#5122) task.
It will cause 0 days delay for the delivery of this weekly plan.

Delay Cause: waiting for approval

[enso-bot]

Greg Travis reports a new STANDUP for today (2023-03-27):

Progress: split; removing old regex code; book club It should be finished by 2023-03-27.

Next Day: removing old regex code