Skip to content

CHANGELOG.md

Latest commit

 

History

History
116 lines (82 loc) · 5.61 KB

CHANGELOG.md

File metadata and controls

116 lines (82 loc) · 5.61 KB

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

[2.0.0] - 2020-08-30

Major version increase due to Java 9 changes that prevent RegExPlus from making Matcher cloneable.

Version 2.0.0 can be used with Java 8 and above

Added

  • MatchResult.getEntry default method

Changed

  • MatchResult no longer implements Iterable (Matcher still does though)
  • Creates lots of default methods in MatchResult to handle basic functionality (makes easier to implement MatchResult interface)

Fixed

  • Matcher.toMatchResult ClassCastException in Java 9

Removed

  • Matcher.clone (no longer cloneable, since cannot clone java.util.regex.Matcher)
  • Matcher.isMatchResult (since now it would always return false and is no longer needed)
  • Matcher.size (returned the number of matches - not frequently used)
  • MatcherResult.size (returned number of groups)

[1.1.0] - 2020-07-12

Java 9 and above should use version 2.x.y due to bug in 1.x.y version (casting the Matcher.toMatchResult back to a Matcher, which is no longer valid starting with Java 9

Added

  • asPredicate method
    • asPredicate() mimics what Java added in Java 8
    • Static asPredicate(String)
      • Takes String regex and creates Predicate
      • Uses getThreadLocal to reuse the Matcher, while ensuring each Thread has it's own (since they are not thread-safe)

[1.0.0] - 2020-07-10

  • Initial Maven release

Added

  • Method getThreadLocal

[0.4] - 2013-12-21

  • Escape '}' in regular expressions (required for Android, but not for Java, but still honored in Java)

  • Added Pattern.getGroupCounts public method to return unmodifiable map of group name to group counts Improved synchronization of pattern cache when compiling a pattern

  • Fix for bug using library in Android with quote block (\Q...\E) and including comments (lines that start with "#") with has comments flag (?x)

[0.3] - 2013-09-22

  • Optimized Matcher.matched / group methods and Pattern.literal

[0.2] - 2010-05-16

Added

  • Patterns can now be lazily compiled. Previously, only serialized Patterns were lazily compiled (to mimic Java's Pattern class).

  • The default is to not lazily compile Patterns (to mimic Java)

  • Patterns are now cached when compiled or when converted from a java.util.regex.Pattern to an info.codesaway.util.regex.Pattern, via the Pattern.valueOf method.

  • Introduced embedded flags for VERIFY_GROUPS (?v) and PERL_OCTAL (?o)

  • Integer group indexes can now be passed as Strings where a group or group name is taken.

    • If a group is named the same as the number (e.g. "(?<1>group 1)"), it is treated as a group name
    • Otherwise, it is treated as a group index

  • Added basic subroutine support - both named/unnamed groups

  • Added (?(DEFINE)...) condition from PCRE

  • Added (*FAIL) and (*F) verbs from PCRE - always fail

  • Pattern.literal - returns regex to match literal text; like quote, but escapes each character (so regex can be used in a regex tool which doesn't support \Q..\E blocks)

  • MatchResult (and Matcher) implement Iterable

  • MatchResult now contains pattern() method (from Matcher)

  • matchResult.isMatchResult instance method, to allow detecting whether an MatchResult is a Matcher or a MatchResult (which although has the class name of Matcher, is immutable, since it has no mutator methods and is a static copy of a Matcher)

  • Added methods to make using RegExPlus that make RegExPlus much more Groovy, and behave like Java regexes do in Groovy

    • getAt(int) has been implemented to mimic the groovy functionality (gets the nth match).
      • For a Matcher, this differs from Groovy, which returns a List; however, you can still use the double array syntax, due to how the overloading was implemented - differently for Matcher and MatchResult
      • For a matchResult, getAt is an alias for group(int); this differs from
    • getAt(String) is an alias for group(String), and always returns the specified group, for both Matchers and MatchResults

  • Added methods hasGroup to test whether a group exists in a pattern / matcher

  • Overloaded "matched" methods to allow testing if a group matched without throwing an error if the group doesn't exist

    • Can be used to test if a group matched, even if the group doesn't exist in the pattern
    • Useful for dynamically built patterns which may not always have the same capture groups

  • getReplacement method - able to replace capture groups in replacement string with their group value

Fixed

  • Can now correctly compile the empty string. Due to an optimization, the empty string was incorrectly compiled

    • For example, Pattern.compile("").groupCount(""); would return a NullPointerException
    • It now (correctly) returns 0, since there are zero groups.

  • The website now mentions the version of the library, which is also specified in this change log.

  • In Java 5, inside a character class escapes ampersands '&', when placed in a \Q..\E block, fixes Java bug (work on wording)

  • Some numeric ranges were incorrect, for example, (?Z[100..199]) would incorrectly match 0 to 99 - the leading 1 was dropped

  • Better organized code, moved inner classes to separate files when possible.

  • Added Pattern.getNaturalComparator, which sorts using Pattern.naturalCompareTo (natural string comparator)

  • Fixed bug with Matcher.keySet and entrySet methods

[0.1]

Initial release.