úÎ!8yP„      !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~€‚ƒ(c) Colin Woodbury, 2015 - 2020BSD3"Colin Woodbury <colin@fosskers.ca>None79;SXvì:versionsA synonym for the more verbose  megaparsec error type.versionsmDevelopers use a number of symbols to seperate groups of digits/letters in their version numbers. These are:&A colon (:). Often denotes an "epoch". A hyphen (-).EA plus (+). Stop using this outside of metadata if you are. Example:  10.2+0.93+1-1.An underscore (_). Stop using this if you are.versionsA (Complex) Mess. This is a  descriptiveQ parser, based on examples of stupidly crafted version numbers used in the wild.[Groups of letters/numbers, separated by a period, can be further separated by the symbols _-+:Unfortunately, VChunk=s cannot be used here, as some developers have numbers like 1.003.04 which make parsers quite sad.Some 6 values have a shape that is tantalizingly close to a  . Example: 1.6.0a+2014+m872b87e73dfb-1O. For values like these, we can extract the semver-compatible values out with 9, etc..Not guaranteed to have well-defined ordering (Ord:) behaviour, but so far internal tests show consistency. 9C, etc., are used internally where appropriate to enhance accuracy. versions.A (General) Version. Not quite as ideal as a Y, but has some internal consistancy from version to version. Generally conforms to the x.x.x-x% pattern, and may optionally have an epoch1. These are prefixes marked by a colon, like in 1:2.3.4. Examples of Version that are not SemVer&: 0.25-2, 8.u51-1, 20150826-1, 1:2.3.4versionspA PVP version number specific to the Haskell ecosystem. Like SemVer this is a prescriptive scheme, and follows  https://pvp.haskell.org/ the PVP spec.5Legal PVP values are of the form: MAJOR(.MAJOR.MINOR) Example: 1.2.3 Extra Rules:  Each component must be a number.lOnly the first MAJOR component is actually necessary. Otherwise, there can be any number of components.  1.2.3.4.5.6.7 is legal.²Unlike SemVer there are two MAJOR components, and both indicate a breaking change. The spec otherwise designates no special meaning to components past the MINOR position.versionsQA logical unit of a version number. Can consist of multiple letters and numbers.versionsaA single unit of a Version. May be digits or a string of characters. Groups of these are called ?s, and are the identifiers separated by periods in the source.versionsKAn (Ideal) version number that conforms to Semantic Versioning. This is a  prescriptive0 parser, meaning it follows the SemVer standard.<Legal semvers are of the form: MAJOR.MINOR.PATCH-PREREL+META Example: 1.2.3-r1+commithash Extra Rules: Pre-release versions have lower! precedence than normal versions.2Build metadata does not affect version precedence.=PREREL and META strings may only contain ASCII alphanumerics.For more information, see http://semver.orgversions,Version types which sanely and safely yield >-like information about themselves. For instances other than # itself however, these optics may not` yield anything, depending on the actual value being traversed. Hence, the optics here are all $s. Consider the    1.2.3.4.58. We can imagine wanting to increment the minor number: +» "1.2.3.4.5" & minor %~ (+ 1) "1.3.3.4.5" -But of course something like this would fail: +» "1.e.3.4.5" & minor %~ (+ 1) "1.e.3.4.5" However! +» "1.e.3.4.5" & major %~ (+ 1) "2.e.3.4.5" versions MAJOR.minor.patch-prerel+metaversions major.MINOR.patch-prerel+meta versions major.minor.PATCH-prerel+meta!versions major.minor.patch-PREREL+meta"versions major.minor.patch-prerel+META#versions(A Natural Transformation into an proper .$versions:Simple Traversals compatible with both lens and microlens.%versions6Simple Lenses compatible with both lens and microlens.&versionsôA top-level Versioning type. Acts as a wrapper for the more specific types. This allows each subtype to have its own parser, and for said parsers to be composed. This is useful for specifying custom behaviour for when a certain parser fails.*versionsShort-hand for detecting a .+versionsShort-hand for detecting a  .,versionsShort-hand for detecting a .„versions Convert a  to a  .…versions Convert a   to a .†versionsBSpecial logic for when semver-like values can be extracted from a (. This avoids having to "downcast" the  into a J before comparing, and in some cases can offer better comparison results.-versions,Traverse some Text for its inner versioning. `» "1.2.3" & _Versioning . _Ideal . patch %~ (+ 1) -- or just: "1.2.3" & patch %~ (+ 1) "1.2.4" .versions(Traverse some Text for its inner SemVer./versions)Traverse some Text for its inner Version.0versions&Traverse some Text for its inner Mess.4versionsSmart constructor for a  made of digits.5versionsSmart constructor for a  made of letters.‡versionsSet a   's epoch to ˆ.9versions/Try to extract the "major" version number from , as if it were a .:versions/Try to extract the "minor" version number from , as if it were a .;versions/Try to extract the "patch" version number from , as if it were a .<versionsOkay, fine, say ;& couldn't find a nice value. But some hes have a "proper" patch-plus-release-candidate value in their patch position, which is parsable as a . Example: 1.6.0a+2014+m872b87e73dfb-1 We should be able to extract 0a safely.=versionsParse a piece of ‰ into either an (Ideal) , a (General)  , or a (Complex) .>versionsParse a &>. Assumes the version number is the last token in the string.?versions!Parse a (Ideal) Semantic Version.@versionsInternal megaparsec parser of ?.ŠversionsDParse a group of digits, which can't be lead by a 0, unless it is 0.‹versions Handling 0Q is a bit tricky. We can't allow runs of zeros in a chunk, since a version like 1.000.1 would parse as 1.0.1.AversionsParse a (Haskell) , as defined above.BversionsInternal megaparsec parser of A.CversionsParse a (General)  , as defined above.DversionsInternal megaparsec parser of C.EversionsParse a (Complex) , as defined above.FversionsInternal megaparsec parser of E.GversionsAConvert any parsed Versioning type to its textual representation.Hversions Convert a $ back to its textual representation.Iversions Convert a $ back to its textual representation.Jversions Convert a  $ back to its textual representation.Kversions Convert a $ back to its textual representation.Œversions Analogous to  and Žk. If a given Foldable is empty, a default value is returned. Else, a function is applied to that Foldable.versionsFlip an Ordering.Pversions2Build metadata does not affect version precedence.Qversions>Two SemVers are equal if all fields except metadata are equal.Xversions Customized.^versionsComparison of Ideals is always well defined.If comparison of General&s is well-defined, then comparison of Ideal and General9 is well-defined, as there exists a perfect mapping from Ideal to General.If comparison of Complex'es is well-defined, then comparison of General and ComplexB is well defined for the same reason. This implies comparison of Ideal and Complex is also well-defined.L  ! "#$%&)'(*+,-./0123456789:;<=>?@ABCDEFGHIJKL&)'(*+,  9:;<45=?ACE>@BDFGHIJK%$! "#-./0123867      !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~€‚ƒ„…†‡ˆ‰Š‹ŒŽ‘‰’“‰”•–—%versions-3.5.4-2zHJjOVFbSsBb6fxGk5jpq Data.Versions'megaparsec-8.0.0-BFw8gNuiOzWGglmtIkYt5XText.Megaparsec.ErrorerrorBundlePretty ParsingErrorVSepVColonVHyphenVPlusVUnderMessVLeafVNodeVersion_vEpoch_vChunks_vRelPVP _pComponentsVChunkVUnitDigitsStrSemVer_svMajor_svMinor_svPatch _svPreRel_svMetaSemanticmajorminorpatchreleasemetasemantic Traversal'Lens' VersioningIdealGeneralComplexisIdeal isGeneral isComplex _Versioning_SemVer_Version_Mess_Ideal_General_Complexdigitsstr_Digits_Strepoch messMajor messMinor messPatchmessPatchChunk versioning versioning'semversemver'pvppvp'versionversion'messmess'prettyV prettySemVer prettyPVP prettyVer prettyMess $fMonoidVUnit$fSemigroupVUnit$fMonoidSemVer$fSemigroupSemVer $fOrdSemVer $fEqSemVer$fSemanticSemVer$fSemanticText $fSemanticPVP $fMonoidPVP$fSemigroupPVP$fSemanticVersion $fOrdVersion$fMonoidVersion$fSemigroupVersion$fSemanticMess $fOrdMess$fSemanticVersioning$fOrdVersioning $fEqVUnit $fShowVUnit $fReadVUnit $fOrdVUnit$fGenericVUnit $fNFDataVUnit$fHashableVUnit $fShowSemVer$fGenericSemVer$fNFDataSemVer$fHashableSemVer$fEqPVP$fOrdPVP $fShowPVP $fGenericPVP $fNFDataPVP $fHashablePVP $fEqVersion $fShowVersion$fGenericVersion$fNFDataVersion$fHashableVersion$fEqVSep $fShowVSep $fGenericVSep $fNFDataVSep$fHashableVSep$fEqMess $fShowMess $fGenericMess $fNFDataMess$fHashableMess$fEqVersioning$fShowVersioning$fGenericVersioning$fNFDataVersioning$fHashableVersioningvFromSmFromV semverAndMesswipebase GHC.MaybeNothing text-1.2.3.1Data.Text.InternalTextdigitsPchunkfoldable Data.Maybemaybe Data.Eithereitheropposite