NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
NuGet
NuGet, #959 most downloaded on NuGet
Parlot is a fast, lightweight and simple to use .NET parser combinator.
Latest stable
2.3.1
Last release 13 days ago
09 Nov 2026
Ships unpredictably
gaps range from 8 days to 7 months
Nearly every release is documented
notes for 57 of the last 60 stable releases
1 version withdrawn
withdrawn after publishing
127 years old
66 releases · first in 1900
Drag across the ruler to compare, or tap a release to open it.
Keep a rejected factory from breaking the other factories of a project by @sebastienros in #499
Full Changelog: v2.3.0...v2.3.1
Full Changelog: https://github.com/sebastienros/parlot/compare/v2.3.0...v2.3.1
Report the C# errors of grammar files by @sebastienros in #493
Full Changelog: v2.2.1...v2.3.0
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Full Changelog: https://github.com/sebastienros/parlot/compare/v2.2.1...v2.3.0
Refresh the benchmarks, and fix the stack overflow of generated tables with a binary tightest level by @sebastienros in #489
Full Changelog: v2.2.0...v2.2.1
Dispatch choices on the prefixes of their alternatives by @sebastienros in #456
Full Changelog: v2.1.0...v2.2.0
Full Changelog: https://github.com/sebastienros/parlot/compare/v2.1.0...v2.2.0
Add skip, except, separated and cardinality parser operators by @sebastienros in #433
Full Changelog: v2.0.0...v2.1.0
Full Changelog: https://github.com/sebastienros/parlot/compare/v2.0.0...v2.1.0
Parlot 2.0 replaces runtime compilation with a source generator that emits parsers needing no Parlot dependency. It also adds stream parsing, parser d
Parlot 2.0 replaces runtime compilation with a source generator that emits parsers needing no Parlot dependency. It also adds stream parsing, parser diagnostics, new combinators, and a large set of correctness and performance fixes.
Packages:
Parlot: the runtime library.Parlot.SourceGenerator: the analyzer that generates parsers at build time.Parser<T>.Compile(), ParseContext.CompilationThreshold, ParseContext.DefaultCompilationThreshold and the FastExpressionCompiler dependency are gone. Use source generation for the fastest path. (#317).parlot.cs files, and [GenerateParser(nameof(TryParse))] implements a matching static partial bool TryParse(string input, [configuration], out T value). Reference Parlot.SourceGenerator explicitly. Interceptors are no longer used, and generated APIs no longer return Parser<T>. (#339)ZeroOrOne returns IReadOnlyList<T>: the list is empty on a miss and holds one item on a match. The default-value overload is removed; use Optional().Then(static o => o.OrSome(defaultValue)). (#359)If<C, S, T> is removed. If now takes a guard or two branches with a Func<bool>, Func<ParseContext, bool> or a typed-context predicate. (#331)Start/End positions follow one rule: only '\n' ends a line. Empty Optional, ZeroOrOne, ZeroOrMany and Separated results, and failed Else results, are reported at the cursor. (#426)ZeroOrMany, OneOrMany, Separated and LeftAssociative stop when the inner parser makes no progress, instead of looping. (#324, #387)Parlot.Generated types. (#339, #336)net472 and netstandard2.0 consumers are supported, and an optional CancellationToken parameter is available on entry points (#341)If/Select branches chosen at runtime (#331)TextReader entry points for stream parsing (#368)TextBefore, Identifier and Pattern (#428)DiscardResult for skipped parsers (#370)Deferred parsers (#427)TextReader/Stream: Parse(TextReader), TryParse, ParseAsync, TryParseAsync, ParseManyAsync returning IAsyncEnumerable<T>, and Commit() cuts. A compacting buffer keeps only the text the parser can still backtrack to. See docs/streaming.md. (#368)[GenerateParser(..., Diagnostics = true)] and the parlot-explorer tool, which records and replays parses (#371)Hexadecimal<T>(), Octal<T>() and Binary<T>() parsers (#322); TryParseNumber supports the hex and binary styles (#404)ParseContext.MaxRecursionDepth (#323)Separated adds removeEmptyEntries, allowLeadingSeparator and allowTrailingSeparator (#360), plus min/max bounds. ZeroOrMany and OneOrMany take a max bound. (#361)LeftAssociative and RightAssociative, so one constructor can handle many operators (#362)Parsers.Eof() parser (#406)Identifier, IdentifierLiteral, late-bound Deferred, Eof<T>, Error<T> and Switch<T,U> (#422, #430)Unary operators, Pattern(minSize: 0), null quote chars, backslash-delimited strings, 1.e5, culture-sensitive Text, and more (#425)Eof, Switch, AnyCharBefore and ReadDecimal fail (#384, #388)AnyCharBefore only jumps when the delimiter starts with its expected chars (#386)AdvanceNoNewLines reaches the end of the text (#382)IdentifierLiteral rejects new lines (#408)AnyOf seekability defects (#320)Text materialization or second ordinal comparison (#363, #374)SkipWhiteSpace wrappers from the OneOf lookup groups (#378); OneOf iterates arrays (#379) and has a cleaner constructor (#423)Identifier, Pattern and ReadWhile (#380); AnyCharBefore reads the text once downlevel (#381)StringLiteral scans each string for escapes once (#421)AGENTS.md (#319)Thanks to @lahma and @SimonCropp for their contributions to this release.
Full Changelog: v1.5.8...v2.0.0
Parlot 1.6.0 is a 1.x maintenance release. It brings the fixes and runtime optimizations from the 2.0 line to the 1.x branch, and makes compiled parse
Parlot 1.6.0 is a 1.x maintenance release. It brings the fixes and runtime optimizations from the 2.0 line to the 1.x branch, and makes compiled parsers behave like runtime parsers.
ParseContext.MaxRecursionDepth (#416, from #323)ICompilable support for IdentifierLiteral, SearchValuesCharLiteral, ListOfChars and WhiteSpaceParser (#420)Identifier, IdentifierLiteral, late-bound Deferred parsers, Eof<T>, Error<T> and Switch<T,U> are now seekable, so OneOf can build lookup tables over more grammars (#431, from #422 and #430)Deferred and Unary, plus fixes for TextLiteral, Identifier, PatternLiteral, TextBefore and Separated (#420)Unary operators, Pattern(minSize: 0), a null quote char at the end of the text, backslash-delimited strings, ReadAnyOf at the end of the text, numbers like 1.e5, and culture-sensitive Text literals (#431, from #425)Start/End positions are consistent: only '\n' ends a line. Empty Optional, ZeroOrOne, ZeroOrMany and Separated results, and failed Else results, are reported at the cursor (#431, from #426)IdentifierLiteral rejects new lines in both char sets (#410, from #408)AnyOf seekability defects (#417, from #320)TextLiteral comparisons and string allocations (#418, from #363 and #374)SkipWhiteSpace wrappers from the OneOf lookup groups (#412, from #378)StringLiteral scans each string for escapes only once (#431, from #421)OneOf constructor and ToString() (#431, from #423)Full Changelog: v1.5.12...v1.6.0
[release/1.x] Add standalone EOF parser while preserving .Eof() rollback by @sebastienros in #407
Full Changelog: v1.5.11...v1.5.12
Full Changelog: https://github.com/sebastienros/parlot/compare/v1.5.11...v1.5.12
Fix release/1.x build by @sebastienros in #376
All backport PRs were originially done by @SimonCropp
Full Changelog: v1.5.10...v1.5.11
[release/1.x] Remove runtime Immutable dependency below .NET 10 by @sebastienros in #337
Full Changelog: v1.5.8...v1.5.9
Full Changelog: https://github.com/sebastienros/parlot/compare/v1.5.8...v1.5.9
Fix duplicate parser lookups by @sebastienros in #302
Full Changelog: v1.5.7...v1.5.8
Full Changelog: https://github.com/sebastienros/parlot/compare/v1.5.7...v1.5.8
Bump the all-dependencies group with 2 updates by @dependabot [bot] in #290
Full Changelog: v1.5.6...v1.5.7
Full Changelog: https://github.com/sebastienros/parlot/compare/v1.5.6...v1.5.7
Bump the all-dependencies group with 3 updates by @dependabot[bot] in https://github.com/sebastienros/parlot/pull/284
Full Changelog: https://github.com/sebastienros/parlot/compare/v1.5.5...v1.5.6
Implement ISeekable in WhiteSpaceLiteral by @sebastienros in https://github.com/sebastienros/parlot/pull/285
Full Changelog: https://github.com/sebastienros/parlot/compare/v1.5.4...v1.5.5
Add Keyword parser by @sebastienros in https://github.com/sebastienros/parlot/pull/282
Full Changelog: https://github.com/sebastienros/parlot/compare/v1.5.3...v1.5.4
Bump the all-dependencies group with 1 update by @dependabot[bot] in https://github.com/sebastienros/parlot/pull/272
Full Changelog: https://github.com/sebastienros/parlot/compare/v1.5.2...v1.5.3
Add WithWhiteSpaceParser() extension for custom whitespace handling by @Copilot in https://github.com/sebastienros/parlot/pull/260
Full Changelog: https://github.com/sebastienros/parlot/compare/v1.5.1...v1.5.2
Remove one allocation when parsing quoted strings by @sebastienros in https://github.com/sebastienros/parlot/pull/252
Full Changelog: https://github.com/sebastienros/parlot/compare/v1.5.0...v1.5.1
Add Select parser by @sebastienros in https://github.com/sebastienros/parlot/pull/250
Full Changelog: https://github.com/sebastienros/parlot/compare/v1.4.3...v1.5.0
Guard parser expression compilation behind IsDynamicCodeSupported check by @ZingBallyhoo in https://github.com/sebastienros/parlot/pull/244
Full Changelog: https://github.com/sebastienros/parlot/compare/v1.4.2...v1.4.3
NoneOf should not be seekable by @sebastienros in https://github.com/sebastienros/parlot/pull/241
Full Changelog: https://github.com/sebastienros/parlot/compare/v1.4.1...v1.4.2
Improve docs for Decimal vs Number by @sebastienros in https://github.com/sebastienros/parlot/pull/232
Full Changelog: https://github.com/sebastienros/parlot/compare/v1.4.0...v1.4.1
Remove ISeekable from Else/ElseError by @sebastienros in https://github.com/sebastienros/parlot/pull/216
Optional and add post-fixed cardinality operators by @sebastienros in https://github.com/sebastienros/parlot/pull/217Full Changelog: https://github.com/sebastienros/parlot/compare/v1.3.6...v1.4.0
Bump the all-dependencies group with 3 updates by @dependabot in https://github.com/sebastienros/parlot/pull/208
Full Changelog: https://github.com/sebastienros/parlot/compare/v1.3.5...v1.3.6
AnyOf should not be seekable if optional by @sebastienros in https://github.com/sebastienros/parlot/pull/207
Full Changelog: https://github.com/sebastienros/parlot/compare/v1.3.4...v1.3.5
Additional support for string literals by @MattEdwardsWaggleBee in https://github.com/sebastienros/parlot/pull/202
Full Changelog: https://github.com/sebastienros/parlot/compare/v1.3.3...v1.3.4
Bump the all-dependencies group across 1 directory with 5 updates by @dependabot in https://github.com/sebastienros/parlot/pull/198
Full Changelog: https://github.com/sebastienros/parlot/compare/v1.3.2...v1.3.3
Fix escaped numbers parsing by @sebastienros in https://github.com/sebastienros/parlot/pull/192
Full Changelog: https://github.com/sebastienros/parlot/compare/v1.3.1...v1.3.2
Fix OneOf parsers merge loosing SkipWhiteSpace by @sebastienros in https://github.com/sebastienros/parlot/pull/191
Full Changelog: https://github.com/sebastienros/parlot/compare/v1.3.0...v1.3.1
Fix Seekable by @sebastienros in https://github.com/sebastienros/parlot/pull/185
Full Changelog: https://github.com/sebastienros/parlot/compare/v1.2.3...v1.3.0
Fix identifier parser regression by @sebastienros in https://github.com/sebastienros/parlot/pull/183
Full Changelog: https://github.com/sebastienros/parlot/compare/v1.2.2...v1.2.3
Improve compilation performance by @sebastienros in https://github.com/sebastienros/parlot/pull/180
Full Changelog: https://github.com/sebastienros/parlot/compare/v1.2.1...v1.2.2
Fix compilation explosion in OneOf by @sebastienros in https://github.com/sebastienros/parlot/pull/179
Full Changelog: https://github.com/sebastienros/parlot/compare/v1.2.0...v1.2.1
Bump the all-dependencies group with 2 updates by @dependabot in https://github.com/sebastienros/parlot/pull/174
Full Changelog: https://github.com/sebastienros/parlot/compare/v1.1.0...v1.2.0
Update benchmark results by @sebastienros in https://github.com/sebastienros/parlot/pull/148
ExpressionHelper.TextSpan_ToString to prevent multiple copies at NumberLiteralBase<T> by @gumbarros in https://github.com/sebastienros/parlot/pull/167Full Changelog: https://github.com/sebastienros/parlot/compare/v1.0.2...v1.1.0
Add DecodeString(ReadOnlySpan) by @sebastienros in https://github.com/sebastienros/parlot/pull/144
Full Changelog: https://github.com/sebastienros/parlot/compare/v1.0.1...v1.0.2
Remove unnecessary System.Collections.Immutable dependency by @lahma in https://github.com/sebastienros/parlot/pull/140
Full Changelog: https://github.com/sebastienros/parlot/compare/v1.0.0...v1.0.1
Create Number parser by @sebastienros in https://github.com/sebastienros/parlot/pull/132
ref modifier on ParseResult<> by @atifaziz in https://github.com/sebastienros/parlot/pull/96Full Changelog: https://github.com/sebastienros/parlot/compare/v0.0.28...v1.0.0
Implement associative parsers by @sebastienros in https://github.com/sebastienros/parlot/pull/116
Full Changelog: https://github.com/sebastienros/parlot/compare/v0.0.27...v0.0.28
Create dependabot.yml by @sebastienros in https://github.com/sebastienros/parlot/pull/99
Full Changelog: https://github.com/sebastienros/parlot/compare/v0.0.26...v0.0.27
Configure Mend Bolt for GitHub by @mend-bolt-for-github in https://github.com/sebastienros/parlot/pull/90
ElseError example in documentation by @atifaziz in https://github.com/sebastienros/parlot/pull/95Full Changelog: https://github.com/sebastienros/parlot/compare/v0.0.25...v0.0.26
Test .NET 7.0 support by @sebastienros in https://github.com/sebastienros/parlot/pull/76
Full Changelog: https://github.com/sebastienros/parlot/compare/v0.0.24...v0.0.25
Fix docs by @hishamco in https://github.com/sebastienros/parlot/pull/74
Full Changelog: https://github.com/sebastienros/parlot/compare/v0.0.23...v0.0.24
Move FEC to private assets by @sebastienros in https://github.com/sebastienros/parlot/pull/65
Full Changelog: https://github.com/sebastienros/parlot/compare/v0.0.22...v0.0.23
Fix OneOf compilation and tests by @sebastienros in https://github.com/sebastienros/parlot/pull/64
Full Changelog: https://github.com/sebastienros/parlot/compare/v0.0.21...v0.0.22
Tiered compilation and whitespace performance by @sebastienros in https://github.com/sebastienros/parlot/pull/62
Full Changelog: https://github.com/sebastienros/parlot/compare/v0.0.20...v0.0.21
Fix compiled lookups by @sebastienros in https://github.com/sebastienros/parlot/pull/61
Full Changelog: https://github.com/sebastienros/parlot/compare/v0.0.19...v0.0.20
Fix typos in EOF parser doc summary by @atifaziz in https://github.com/sebastienros/parlot/pull/56
Full Changelog: https://github.com/sebastienros/parlot/compare/v0.0.18...v0.0.19
Update README.md by @hishamco in https://github.com/sebastienros/parlot/pull/53
Use ParseContext.SkipWhiteSpace in compiled mode
ParseContext.SkipWhiteSpace in compiled modeFix blank space position reset in Terms
TermsSkipWhiteSpace parserNothing published for this version
Nothing published for this version
Whitespace() fails if no white space is found
Add option to fail when WhiteSpace is empty
Pattern parser for pattern matching on chars
Pattern parser for pattern matching on charsCapture parser to capture the TextSpan of another parserTextSpanNothing published for this version
Removed \0 from escaped sequences
\0 from escaped sequencesEmpty parserNonWhiteSpace parserWhen parser back-tracking- Fixes unicode string escaping
Fix bugs in netstandard2.0 target
One column per quarter.