Parsley 5.0.0 Staging PR

This is the PR encompassing all changes for version 5.0.0. As this is substantial new functionality, it will be previewed incrementally starting with 5.0.0-M1. When the API is completed and seems reasonable, 5.0.0-RC1 will be released to allow for testing of the release, full documentation, and ironing out of bugs. When the release is stable enough, it will be merged into master and 5.0.0 will be officially released.

High-Level Changes

This release aims to consolidate the library ready for long-term stability. This will include adjusting the API to allow for more forwards-compatible evolution.

Low-Level Changes

Major Changes

None.

Minor Changes

None.

Patch Changes

None.

Internal Changes

None.

Release Checklist

5.0.0-M1

• enforce deprecations from 4.5.0
• apply breaking changes from Parsley 5 API Consolidation #190
• closes Rename comment{Start,End} to multiLineComment{Start,End}, disallow newline characters in comment{Start,End} #168, closes Curried Chains #172, closes Mismatched string surrondings #155, closes Exponent leading-zeros should be distinct from overall literal leading zeros #211

5.0.0-M2

• generic error message support on bridges

5.0.0-M3

• fix for [BUG] labelSymbolPunctuation does nothing #227
• fix for [BUG] Merging entrenched errors at different depths drops entrenchment level #226
• introduce labelSymbol to replace the sub-configurations (which are deprecated for future removal, but still hooked in for back-compat for next few weeks)

5.0.0-M4

• added mapFilterMsg combinator to parsley.errors.combinator

5.0.0-M5

• fix regression introduced by M3, where Reasons used for labelConfig result in no error labels

5.0.0-M6

• enforce deprecation of error config stuff
• fix Americanisation of SpecializedFilter
• remove atomicChoice
• add additional diagnostics
• restore Failure as a simple case class
• rename ErrorBuilder.format to build
• add line number information to ErrorBuilder.lineInfo

5.0.0-M7 - Anton's Milestone

• add in the Console debugger frontend for parsley-debug
• divergence detection combinator in parsley-debug.
• flatten down the parsley.token packages some more.
• add in the parsley.syntax.all and parsley.quickstart objects to cut down on imports.

5.0.0-M8 - native 0.5

• switch Scala native over to 0.5

5.0.0-M9

• parsley.debug made into a package
• parsley-debug's debuggable -> debug
• debug.frontend.DebugFrontend -> debug.DebugView, with ReusableFrontend -> DebugView.Reusable and similar for SingleUse.
• remove the attachDebugger combinators, I think we'll go ahead with view-only debugging for now.
• by-name parameters instead of unit functions
• improve the string rules, and make it a PartialFunction[Any, Boolean] for ergonomics.
• remove unneeded methods of debug.util.Collector, it's a shame we'll never be able to remove it completely because of parsley.debuggable's view on it.

5.0.0-M10

• parsley.debuggable fixed for 3.5+

5.0.0-M11

• fixes use of manyTill within parsley.quick.* which is currently broken.

5.0.0-M12

• fix hide's use of observable input
• improve reference reuse

5.0.0-M13

• introduce the factory iterator combinators (Factory Iteration #258)
• introduce interactive support for DebugViews (Interactivity with parsley-debug-app #259)

5.0.0-RC1

• all new functionality has partial documentation

5.0.0

• all methods have completed documentation
• new functionality is well tested
• README.md updated to reflect new version
• documentation checked to ensure no leakage of private [parsley] members or parsley.internal.
• wiki backports complete

Milestone Migration Guide

As each milestone release may choose to make binary incompatible changes, any necessary migration required to get from one milestone to the next will be tracked here.