https://github.com/kschiess/parslet

A small PEG based parser library. See the Hacking page in the Wiki as well.
https://github.com/kschiess/parslet

Keywords from Contributors

activerecord activejob mvc rubygem rspec rubocop sidekiq ruby-gem yardoc yard

Last synced: about 3 hours ago
JSON representation

Repository metadata

A small PEG based parser library. See the Hacking page in the Wiki as well.

• Host: GitHub
• URL: https://github.com/kschiess/parslet
• Owner: kschiess
• License: mit
• Created: 2010-03-15T08:14:24.000Z (almost 16 years ago)
• Default Branch: master
• Last Pushed: 2023-10-05T10:10:59.000Z (about 2 years ago)
• Last Synced: 2025-11-27T18:13:09.493Z (27 days ago)
• Language: Ruby
• Homepage: kschiess.github.com/parslet
• Size: 2.47 MB
• Stars: 833
• Watchers: 15
• Forks: 99
• Open Issues: 22
• Releases: 0
• Metadata Files:
  • Readme: README
  • Changelog: HISTORY.txt
  • License: LICENSE

README

          INTRODUCTION

Parslet makes developing complex parsers easy. It does so by

* providing the best error reporting possible
* not generating reams of code for you to debug

Parslet takes the long way around to make your job easier. It allows for
incremental language construction. Often, you start out small, implementing
the atoms of your language first; _parslet_ takes pride in making this
possible.

Eager to try this out? Please see the associated web site:
https://kschiess.github.io/parslet/

SYNOPSIS

  require 'parslet'
  include Parslet

  # parslet parses strings
  str('foo').
    parse('foo') # => "foo"@0

  # it matches character sets
  match['abc'].parse('a') # => "a"@0
  match['abc'].parse('b') # => "b"@0
  match['abc'].parse('c') # => "c"@0

  # and it annotates its output
  str('foo').as(:important_bit).
    parse('foo') # => {:important_bit=>"foo"@0}

  # you can construct parsers with just a few lines
  quote = str('"')
  simple_string = quote >> (quote.absent? >> any).repeat >> quote

  simple_string.
    parse('"Simple Simple Simple"') # => "\"Simple Simple Simple\""@0

  # or by making a fuss about it 
  class Smalltalk < Parslet::Parser
    root :smalltalk

    rule(:smalltalk) { statements }
    rule(:statements) { 
      # insert smalltalk parser here (outside of the scope of this readme)
    }
  end

  # and then
  Smalltalk.new.parse('smalltalk')

FEATURES

  * Tools for every part of the parser chain
  * Transformers generate Abstract Syntax Trees
  * Accelerators transform parsers, making them quite a bit faster
  * Pluggable error reporters
  * Graphviz export for your parser
  * Rspec testing support rig
  * Simply Ruby, composable and hackable

COMPATIBILITY

This library is intended to work with Ruby variants >= 1.9. I've tested it on 
MRI 1.9, rbx-head, jruby. Please report as a bug if you encounter issues.

STATUS 

Production worthy.

(c) 2010-today Kaspar Schiess

        

---

Owner metadata

• Name: Kaspar Schiess
• Login: kschiess
• Email:
• Kind: user
• Description: code, i write code
• Website: absurd.li
• Location: Bern, Switzerland
• Twitter:
• Company:
• Icon url: https://avatars.githubusercontent.com/u/2991?v=4
• Repositories: 26
• Last ynced at: 2023-04-10T05:10:58.158Z
• Profile URL: https://github.com/kschiess

---

GitHub Events

Total

• Issues event: 3
• Watch event: 20
• Issue comment event: 5
• Pull request event: 7
• Fork event: 1

Last Year

• Issues event: 3
• Watch event: 15
• Issue comment event: 5
• Pull request event: 7
• Fork event: 1

---

Committers metadata

Last synced: 1 day ago

Name	Email	Commits
Kaspar Schiess	k****s@a****i	652
Florian Hanke	f****e@g****m	17
Kaspar Schiess	k****r@p****m	12
Kaspar Schiess	k****s@t****h	9
Kaspar Schiess	k****r@a****i	7
Chris Wendt	c****t@g****m	6
Josep M. Bach	j****h@g****m	5
Rory O’Kane	r****y@r****m	4
Thomas Ingram	c****e@r****m	4
Raphael Simon	r****l@r****m	3
Kevin Olbrich	k****h@m****m	3
Mark Delk	j****l@g****m	3
Postmodern	p****3@g****m	3
meh	m****h@p****g	3
Torsten Ruger	t****n@v****i	2
Adam Prescott	a****m@a****m	2
Max Jacobson	m****x@h****t	2
0x01f7	s****7@g****m	1
Andrew Hartford	a****d@d****m	1
Jordan Ryan Reuter	j****r@s****m	1
wusuopu	a****n@l****n	1
takahashim	m****i@r****g	1
sandstrom	m****b@a****e	1
aoitaku	a****u@g****m	1
Zach Moazeni	z****i@g****m	1
Tadashi Saito	t****r@g****m	1
Sebastian Skałacki	s****e@g****m	1
Roger Braun	r****r@r****t	1
Nikita Shilnikov	ns@l****u	1
Matt Larraz	m****z	1
and 11 more...

Committer domains:

• absurd.li: 2
• pryv.com: 1
• technologyastronauts.ch: 1
• roryokane.com: 1
• ravinggenius.com: 1
• rightscale.com: 1
• mckesson.com: 1
• paranoici.org: 1
• villataika.fi: 1
• aprescott.com: 1
• hardscrabble.net: 1
• doxo.com: 1
• scimedsolutions.com: 1
• longchangjin.cn: 1
• rubycolor.org: 1
• a16m.se: 1
• rogerbraun.net: 1
• latera.ru: 1
• brachium-system.net: 1
• salsify.com: 1
• kernowsoul.com: 1
• nyh.se: 1
• hiptest.net: 1
• sprybts.com: 1

---

Issue and Pull Request metadata

Last synced: 13 days ago

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/kschiess/parslet

---

---

---

Package metadata

• Total packages: 4
• Total downloads:
  • rubygems: 150,464,302 total
• Total docker downloads: 975,581,898
• Total dependent packages: 232 (may contain duplicates)
• Total dependent repositories: 24,108 (may contain duplicates)
• Total versions: 48
• Total maintainers: 2

---

Dependencies

Score: 31.306674211135746