omy.Utils.Parser.Diagnostics 2.0.0-rc.1

.NET Standard 2.0 This package targets .NET Standard 2.0. The package is compatible with this framework or higher.
This is a prerelease version of omy.Utils.Parser.Diagnostics. 
dotnet add package omy.Utils.Parser.Diagnostics --version 2.0.0-rc.1
                    


                    

                
NuGet\Install-Package omy.Utils.Parser.Diagnostics -Version 2.0.0-rc.1
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="omy.Utils.Parser.Diagnostics" Version="2.0.0-rc.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="omy.Utils.Parser.Diagnostics" Version="2.0.0-rc.1" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="omy.Utils.Parser.Diagnostics" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add omy.Utils.Parser.Diagnostics --version 2.0.0-rc.1
                    


                    

                
#r "nuget: omy.Utils.Parser.Diagnostics, 2.0.0-rc.1"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package omy.Utils.Parser.Diagnostics@2.0.0-rc.1
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=omy.Utils.Parser.Diagnostics&version=2.0.0-rc.1&prerelease
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=omy.Utils.Parser.Diagnostics&version=2.0.0-rc.1&prerelease
                    


                            Install as a Cake Tool

omy.Utils.Parser.Diagnostics

omy.Utils.Parser.Diagnostics provides the shared diagnostics model used by parser runtime and generator components in the omy.Utils ecosystem.

Purpose

Use this package when you need a common set of diagnostic primitives across parser-related tools, including:

  • diagnostic descriptors,
  • diagnostic severities,
  • diagnostic aggregation utilities.

Human-readable source-location contracts such as SourceCodeLocation and SourceCodeRange are provided by omy.Utils.Parser.Source so non-diagnostic surfaces can share them without depending on diagnostics. Runtime offset contracts such as SourceLocation and SourceSpan remain separate in that package for token and parser operations.

Typical usage

The package is typically consumed transitively by parser packages. Reference it directly when building custom tooling that needs to exchange diagnostics with omy.Utils.Parser or omy.Utils.Parser.Generators.

This package's first publication is the 2.0.0-rc.1 release candidate - there is no earlier stable version, so dotnet add package requires an explicit version (NuGet does not install a prerelease by default):

dotnet add package omy.Utils.Parser.Diagnostics --version 2.0.0-rc.1

Diagnostic code catalogue

All named descriptors are defined in the ParserDiagnostics static class and accessible via ParserDiagnostics.All (a dictionary keyed by code string).

UP0xxx — Blocking errors

Code Name Trigger
UP0001 UnexpectedToken A token did not match any expected alternative
UP0002 InvalidGrammarRoot The grammar root node is not a recognized grammar declaration
UP0003 UnknownRuleReference A rule refers to another rule that cannot be resolved
UP0004 UnknownLexerMode A lexer command references a mode that is not declared
UP0005 ParseFailure The parser failed to match input from the root rule
UP0006 InternalInconsistency An internal consistency check failed
UP0010 ImportedGrammarNotFound An import target grammar could not be located by the resolver
UP0011 ImportCycleDetected A circular dependency was found while resolving grammar imports
UP0012 ParserRuleNotAllowedInLexerGrammar A parser rule was declared inside a lexer grammar
UP0013 LexerRuleNotAllowedInParserGrammar A lexer rule was declared inside a parser grammar

UP1xxx — Unsupported / ignored / partial behavior

Code Name Trigger
UP1001 ImportParsedButNotResolved An import directive was recognized but not resolved at runtime
UP1002 TokensBlockIgnored A tokens { ... } block is recognized but not mapped into the model
UP1003 ChannelsBlockIgnored A channels { ... } block is recognized but not mapped into the model
UP1004 ActionIgnored A top-level @... action block is recognized but not executed
UP1005 InlineActionStoredNotExecuted An inline parser action is stored but not executed at runtime
UP1006 SemanticPredicateNotEnforced A {...}? predicate is recognized but not evaluated; it always succeeds
UP1007 RuleReturnsIgnored A returns [...] clause is parsed but stored only as raw text (ReturnsPartiallyApplied is a compatibility alias)
UP1008 RuleLocalsIgnored A rule locals [...] clause is not given typed or implicit runtime semantics; generated C# opt-in lifecycle execution only allocates untyped null frame entries
UP1023 RuleExceptionMetadataIgnored Rule throws / catch / finally metadata is recognized but ignored by the current runtime model
UP1009 RuntimeGeneratorMismatch A feature behaves differently between the runtime and the source generator
UP1010 DirectLeftRecursionDetected Direct left recursion was detected and restructured during rule resolution
UP1011 IndirectLeftRecursionNotSupported Indirect left recursion is not supported and raises GrammarValidationException
UP1012 LeftRecursiveRuleWithoutBaseAlternative A left-recursive rule defines no non-recursive (base) alternative
UP1013 AmbiguousAlternativesPruned Structurally equivalent alternatives were pruned; the lower-priority winner is kept
UP1014 StaticDuplicateAlternativeRemoved A duplicate alternative was eliminated at resolution time
UP1015 ParseBranchPruned A parse branch was discarded during runtime best-match selection
UP1016 ParseMemoHit A cached result was reused for a (rule, position, precedence) triple
UP1017 ParseMemoMiss No cached result existed for a (rule, position, precedence) triple
UP1018 LeftRecursivePrecedencePartiallySupported Left-recursive precedence predicates are only partially handled
UP1019 UnsupportedAntlrLanguageOptionIgnored The ANTLR4 language option is not supported and is silently ignored
UP1020 UnsupportedLexerCommand A lexer command was parsed but is outside the currently supported command set

UP5xxx — Warnings (recovery / best-effort)

Code Name Trigger
UP5001 BestEffortRecoveryUsed Best-effort recovery was applied during parsing
UP5002 ExpectedTokenMissing Reserved for missing-token recovery diagnostics when an expected token is absent
UP5003 FallbackStrategyUsed A fallback parsing strategy was activated
UP5004 TrailingTokensAfterParse Unconsumed tokens remain after the root rule matched; Parse() returns an ErrorNode
UP5005 AmbiguousConstructResolvedHeuristically An ambiguous construct was resolved by heuristic rather than by grammar priority

UP8xxx — Informational

Code Name Trigger
UP8001 DefaultBehaviorApplied A grammar construct fell back to a built-in default behavior
UP8002 ImportedRuleIgnoredBecauseAlreadyDefined An imported rule was skipped because the entry grammar already defines the same name

PARSER0xx — Runtime safety guards

These codes are emitted by ParserEngine when built-in loop-termination guards activate.

Code Name Trigger
PARSER001 ParserStateCycleDetected A repeated parser state (same rule, position, and alternative) was detected and skipped to prevent infinite recursion
PARSER002 NonProgressiveQuantifierStopped A quantifier iteration matched without consuming any token; the loop is stopped
PARSER003 NonProgressiveLeftRecursionStopped A left-recursive extension produced no token progress; the seed-and-extend loop is stopped

UP9xxx — Debug traces

These codes are emitted only when a DiagnosticBag is passed to the parse call; they are not emitted in production builds unless explicitly requested.

Code Name Trigger
UP9001 EnteringRule The engine entered a parser rule
UP9002 LeavingRule The engine finished a parser rule
UP9003 TokenMatched A token was consumed by a lexer rule reference
UP9004 BacktrackingUsed The cursor was restored after a failed alternative
UP9005 ParserStateRejected A parser state was rejected by a safety guard
UP5006 DefaultBehaviorApplied A grammar construct fell back to a default behavior

Embedded ANTLR code diagnostics

Shared embedded-code diagnostics are available for runtime, generator, and tooling boundaries:

  • UP1024 EmbeddedCodeLanguageUnsupported
  • UP1025 EmbeddedCodeCompilerNotConfigured
  • UP1026 EmbeddedCodeCompilationFailed
  • UP1027 EmbeddedCodePreservedNotCompiled
  • UP1028 EmbeddedCodeExecutionDisabled

These diagnostics describe language support, compilation, and execution boundaries for embedded ANTLR code. They do not imply embedded-code execution is implemented.

  • omy.Utils.Parser
  • omy.Utils.Parser.Generators

See the repository root README for installation and package selection guidance.

Versioned API documentation

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on omy.Utils.Parser.Diagnostics:

Package Downloads
omy.Utils.Parser

Universal Parser - A self-describing parser framework. Reads ANTLR4 grammar files and builds parse trees for any source file. The ANTLR4 grammar reader is itself built using the same metamodel objects.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
2.0.0-rc.1 82 8/28/2026