Module Parsing.String.Replace

Copied from
https://github.com/jamesdbrock/purescript-parsing-replace

Author: jamesdbrock

CHANGELOG.md

@@ -46,6 +46,8 @@ Breaking changes:
 New features:
 
 - Add the `anyTill` primitive `String` combinator. (#186 by @jamesdbrock)
+- Add the `Parsing.String.Replace` module, copied from
+  https://github.com/jamesdbrock/purescript-parsing-replace (#188 by @jamesdbrock)
 
 Bugfixes:
 

README.md

@@ -130,7 +130,6 @@ There are lots of other great monadic parsing tutorials on the internet.
 ## Related Packages
 
 - [__`parsing-dataview`__](https://pursuit.purescript.org/packages/purescript-parsing-dataview) primitive parsers for binary parsing of `ArrayBuffer`.
-- [__`parsing-replace`__](https://pursuit.purescript.org/packages/purescript-parsing-replace) for finding text patterns, and also replacing or splitting on the found patterns.
 - [__`datetime-parsing`__](https://pursuit.purescript.org/packages/purescript-datetime-parsing) for parsing dates and times.
 
 ## Documentation

bower.json

@@ -24,6 +24,7 @@
     "purescript-maybe": "master",
     "purescript-newtype": "master",
     "purescript-numbers": "master",
+    "purescript-nullable": "main",
     "purescript-prelude": "master",
     "purescript-record": "master",
     "purescript-strings": "master",
@@ -35,6 +36,8 @@
     "purescript-unsafe-coerce": "master"
   },
   "devDependencies": {
-    "purescript-assert": "master"
+    "purescript-assert": "master",
+    "purescript-effect": "master",
+    "purescript-node-process": "master"
   }
 }

packages.dhall

@@ -1,5 +1,4 @@
 let upstream =
       https://raw.githubusercontent.com/purescript/package-sets/prepare-0.15/src/packages.dhall
-        sha256:b1c6d06132b7cbf1e93b1e5343044fba1604b50bfbe02d8f80a3002e71569c59
 
 in  upstream

spago-dev.dhall

@@ -11,11 +11,14 @@ in conf //
 { sources = [ "src/**/*.purs", "test/**/*.purs", "bench/**/*.purs" ]
 , dependencies = conf.dependencies #
   [ "assert"
+  , "bifunctors"
   , "console"
   , "enums"
   , "effect"
   , "psci-support"
   , "minibench"
+  , "node-process"
+  , "nonempty"
   , "exceptions"
   , "string-parsers"
   , "partial"

spago.dhall

@@ -4,6 +4,7 @@
 , dependencies =
   [ "arrays"
   , "control"
+  , "effect"
   , "either"
   , "enums"
   , "foldable-traversable"
@@ -15,14 +16,17 @@
   , "maybe"
   , "newtype"
   , "numbers"
+  , "nullable"
   , "partial"
   , "prelude"
+  , "st"
   , "strings"
   , "tailrec"
   , "transformers"
   , "tuples"
   , "unfoldable"
   , "unicode"
+  , "unsafe-coerce"
   ]
 , packages = ./packages.dhall
 , sources = [ "src/**/*.purs" ]

src/Parsing/String.purs

@@ -98,7 +98,7 @@ anyChar :: forall m. ParserT String m Char
 anyChar = satisfy (const true)
 
 -- | Match any Unicode character.
--- | Always succeeds.
+-- | Always succeeds when any input remains.
 anyCodePoint :: forall m. ParserT String m CodePoint
 anyCodePoint = satisfyCodePoint (const true)
 
@@ -290,9 +290,19 @@ consumeWith f = ParserT
 -- | Will fail if no section of the input is parseable. To backtrack the input
 -- | stream on failure, combine with `tryRethrow`.
 -- |
+-- | This combinator works like
+-- | [Data.String.takeWhile](https://pursuit.purescript.org/packages/purescript-strings/docs/Data.String#v:takeWhile)
+-- | or
+-- | [Data.String.Regex.search](https://pursuit.purescript.org/packages/purescript-strings/docs/Data.String.Regex#v:search)
+-- | and it allows using a parser for the pattern search.
+-- |
 -- | This combinator is equivalent to `manyTill_ anyCodePoint`, but it will be
 -- | faster because it returns a slice of the input `String` for the
 -- | section preceding the parse instead of a `List CodePoint`.
+-- |
+-- | Be careful not to look too far
+-- | ahead; if the phrase parser looks to the end of the input then `anyTill`
+-- | could be *O(n²)*.
 anyTill
   :: forall m a
    . Monad m