Loic.sprache.Sprache 1.0.0

.NET 5.0

dotnet add package Loic.sprache.Sprache --version 1.0.0

NuGet\Install-Package Loic.sprache.Sprache -Version 1.0.0

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="Loic.sprache.Sprache" Version="1.0.0" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="Loic.sprache.Sprache" Version="1.0.0" />
                    

                            Directory.Packages.props

<PackageReference Include="Loic.sprache.Sprache" />
                    

                            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 Loic.sprache.Sprache --version 1.0.0

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: Loic.sprache.Sprache, 1.0.0"

#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 Loic.sprache.Sprache@1.0.0

#: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=Loic.sprache.Sprache&version=1.0.0
                    

                            Install as a Cake Addin

#tool nuget:?package=Loic.sprache.Sprache&version=1.0.0
                    

                            Install as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Sprache

Sprache is a simple, lightweight library for constructing parsers directly in C# code.

It doesn't compete with "industrial strength" language workbenches - it fits somewhere in between regular expressions and a full-featured toolset like ANTLR.

Sprache

Usage

Unlike most parser-building frameworks, you use Sprache directly from your program code, and don't need to set up any build-time code generation tasks. Sprache itself is a single tiny assembly.

A simple parser might parse a sequence of characters:

// Parse any number of capital 'A's in a row
var parseA = Parse.Char('A').AtLeastOnce();

Sprache provides a number of built-in functions that can make bigger parsers from smaller ones, often callable via Linq query comprehensions:

Parser<string> identifier =
    from leading in Parse.WhiteSpace.Many()
    from first in Parse.Letter.Once().Text()
    from rest in Parse.LetterOrDigit.Many().Text()
    from trailing in Parse.WhiteSpace.Many()
    select first + rest;

var id = identifier.Parse(" abc123  ");

Assert.AreEqual("abc123", id);

Examples and Tutorials

The best place to start is this introductory article.

Examples included with the source demonstrate:

Tutorials explaining Sprache:

Overview of Sprache methods, long guide by Justing Pealing
A great CodeProject article by Alexey Yakovlev (and in Russian)
Mike Hadlow's example of parsing connection strings
Alexey Golub's article on monadic parser combinators that shows how to build a JSON parser using Sprache

Real-world parsers built with Sprache:

The template parser in Octostache, the variable substitution language of Octopus Deploy
The XAML binding expression parser in OmniXaml, the cross-platform XAML implementation
Parts of the filter expression parser in Seq, a structured log server for .NET
The connection string parser in EasyNetQ, a .NET API for RabbitMQ
ApexSharp parser, a two-way Apex to C# transpiler (Salesforce programming language)
Sprache appears in the credits for JetBrains ReSharper

Background

Parser combinators are covered extensively on the web. The original paper describing the monadic implementation by Graham Hutton and Eric Meijer is very readable. Sprache was originally written by Nicholas Blumhardt and grew out of some exercises in Hutton's Haskell book.

The implementation of Sprache draws on ideas from:

Product	Compatible and additional computed target framework versions.
.NET	net5.0 is compatible. 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.

Product

.NET

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

net5.0
- No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version	Downloads	Last Updated
1.0.0	0	7/31/2021

Loic.sprache.Sprache 1.0.0

Sprache

Usage

Examples and Tutorials

Background

net5.0

NuGet packages

GitHub repositories