Skip to content
A tiny, friendly, C# parser construction library
C# PowerShell
Branch: develop
Clone or download

Latest commit

nblumhardt Merge pull request #155 from r1sc/develop
Fix #129 Exception when Parse.Ref occurs in Parse.Or
Latest commit 1c96077 Jun 1, 2020

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
samples Framework updates Apr 16, 2020
src Fix #129 Exception when Parse.Ref occurs in Parse.Or Jun 1, 2020
test/Sprache.Tests Framework updates Apr 16, 2020
.gitattributes add initial netcore conversion Aug 4, 2016
.gitignore Fix artifact publishing Jan 11, 2018
README.md Add my article to the list of tutorials Nov 10, 2019
Sprache.sln Small .sln file cleanup Sep 10, 2018
appveyor.yml Update build environment to VS2019 image Apr 16, 2020
build.ps1 Fix artifact publishing Jan 11, 2018
licence.txt licence. Gone with MIT Jul 19, 2012

README.md

Sprache Sprache tag on Stack Overflow Join the chat at https://gitter.im/sprache/Sprache NuGet Build status

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:

Real-world parsers built with Sprache:

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:

You can’t perform that action at this time.