0.21.0 - Small fixes, small steps, big ambitions

[danon]

😎 T-Regx The Dinosaur is really proud to announce its release 0.21.0! This time we fixed a bug (yay!), and broke some stuff ;| We found that using nth() method which sometimes throws exception because of subject not matched, and sometimes because of missing items is hard to use. And, it's even not similar to other parts of library - for example all() doesn't throw exception when subject isn't matched. So we decided that nth() should treat all matches equally and not throw a dedicated exception when the subject wasn't matched. And we did the same for stream(). Worry not however, the messages remained the same, so you will know what's the reason for the exception - as a developer. But the API will be more uniform.

The detailed list of changes is in ChangeLog.md.

• Breaking changes
  • Renamed GroupLimit to GroupMatch.
  • Previously nth()/findNth() threw different exceptions when the subject wasn't matched and when the item was
    missing. Now they always throw NoSuchNthElementException (regardless of whether the subject was matched or not).
    Exception messages still remain, to inform you whether there was not enough occurrences or whether the subject
    wasn't matched.
    • match()->nth() throws NoSuchNthElementException, instead of SubjectNotMatchedException
    • match()->asInt()->nth() throws NoSuchNthElementException, instead of NoSuchStreamElementException
    • match()->stream()->nth() throws NoSuchNthElementException, instead of NoSuchStreamElementException
    • match()->group()->nth() throws NoSuchNthElementException, instead of SubjectNotMatchedException
    • match()->group()->asInt()->nth() throws NoSuchNthElementException, instead
      of NoSuchStreamElementException
    • match()->group()->stream()->nth() throws NoSuchNthElementException, instead
      of NoSuchStreamElementException
• Bug fixes
  • match()->offsets() and match()->group()->offsets() now return offsets as characters. Previously they returned
    them as bytes.
• Features
  • Added SubjectNotMatchedException.getSubject()

The detailed list of changes is also in ChangeLog.md.

Rawrrrr!

---

This discussion was created from the release 0.21.0 - Small fixes, small steps, big ambitions.