v2.0.0

CHANGELOG.md

@@ -1,11 +1,26 @@
+## 2.0.0
+
+- **Breaking**:
+    - `UrlMatcher` now matches only URLs starting with http(s). (#10)
+    - `matchers` is no longer optional. (#12)
+- Non-breaking:
+    - Refactor the parser entirely. (#8)
+        - This resolves the issue that required a workaround when lookbehind assertion was used.
+    - Fix `UrlMatcher` to exclude backslashes.
+    - Add `UrlLikeMatcher` that matches URL-like strings not starting with http(s). (#10)
+        - This behaves the same way as `UrlMatcher` used to before this version.
+    - Add assertions to check matchers and patterns are not empty.
+    - Add and improve tests.
+
 ## 1.2.0-dev.2
 
-- **Breaking**
+- **Breaking**:
     - `UrlMatcher` now matches only URLs starting with http(s). (#10)
         - This also affects the behaviour of TextParser with the default matchers.
-- Add `UrlLikeMatcher` that matches URL-like strings not starting with http(s).
-    - This behaves the same way as `UrlMatcher` used to before this version.
-- Fix `UrlMatcher` to exclude backslashes.
+- Non-breaking:
+    - Fix `UrlMatcher` to exclude backslashes.
+    - Add `UrlLikeMatcher` that matches URL-like strings not starting with http(s). (#10)
+        - This behaves the same way as `UrlMatcher` used to before this version.
 
 ## 1.2.0-dev.1
 

README.md

@@ -6,7 +6,7 @@ A Dart package for parsing text flexibly according to preset or custom regular e
 
 ## Usage
 
-### Using preset matchers (URL / email address / phone number)
+### Using the preset matchers (URL / email address / phone number)
 
 The package has the following preset matchers.
 
@@ -88,7 +88,21 @@ Or use a classic way:
 final telElements = elements.map((elm) => elm.matcherType == TelMatcher).toList();
 ```
 
-### Overwriting the pattern of a preset matcher
+#### Conflict between matchers
+
+If multiple matchers have matched the string at the same position in text, the first one
+in those matchers takes precedence.
+
+```dart
+final parser = TextParser(matchers: const[UrlLikeMatcher(), EmailMatcher()]);
+final elements = await parser.parse('foo.bar@example.com');
+```
+
+In this example, `UrlLikeMatcher` matches `foo.bar` and `EmailMatcher` matches
+`foo.bar@example.com`, but `UrlLikeMatcher` is used because it is written before
+`EmailMatcher` in the matchers list.
+
+### Overwriting the pattern of an existing matcher
 
 If you want to parse only URLs and phone numbers, but treat only a sequence of eleven numbers
 after "tel:" as a phone number:
@@ -102,9 +116,6 @@ final parser = TextParser(
 );
 ```
 
-If the match patterns of multiple matchers have matched the same string at the same position
-in text, the first matcher is used for parsing the element.
-
 ### Using a custom pattern
 
 You can create a matcher with a custom pattern either with [PatternMatcher][PatternMatcher]

example/main.dart

@@ -44,7 +44,9 @@ Future<void> main() async {
 
   // A match pattern containing capturing of unnamed and named groups
   parser = TextParser(
-    matchers: const [PatternMatcher(r'(?<year>\d{4})-(\d{2})-(?<day>\d{2})')],
+    matchers: const [
+      PatternMatcher(r'(?<year>\d{4})-(\d{2})-(?<day>\d{2})'),
+    ],
   );
   elements = await parser.parse('2020-01-23', onlyMatches: true);
   elements.forEach(print);

example/pubspec.yaml

@@ -2,7 +2,7 @@ name: text_parser_example
 description: An example of text_parser.
 
 environment:
-  sdk: '>=2.18.0 <3.0.0'
+  sdk: '>=2.18.0 <4.0.0'
 
 dependencies:
   text_parser:

pubspec.yaml

@@ -1,14 +1,14 @@
 name: text_parser
 description: A Dart package for flexibly parsing text into easy-to-handle format according to multiple regular expression patterns.
-version: 1.2.0-dev.2
+version: 2.0.0
 repository: https://github.com/kaboc/dart_text_parser
 
 environment:
-  sdk: '>=2.18.0 <3.0.0'
+  sdk: '>=2.18.0 <4.0.0'
 
 dependencies:
   meta: ^1.8.0
 
 dev_dependencies:
   lints: ^2.0.1
-  test: ^1.23.1
+  test: ^1.24.3