https://github.com/liblouis/louis-parser
An experiment at writing a liblouis table parser based on Parsing expression grammar
https://github.com/liblouis/louis-parser
liblouis parsing-expression-grammar peg pest
Last synced: about 1 year ago
JSON representation
An experiment at writing a liblouis table parser based on Parsing expression grammar
- Host: GitHub
- URL: https://github.com/liblouis/louis-parser
- Owner: liblouis
- Created: 2019-06-17T10:17:01.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2023-03-01T16:18:54.000Z (over 3 years ago)
- Last Synced: 2025-06-21T03:08:11.536Z (about 1 year ago)
- Topics: liblouis, parsing-expression-grammar, peg, pest
- Language: Rust
- Homepage:
- Size: 49.8 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.org
Awesome Lists containing this project
README
#+title: Experimental liblouis table parser
An experiment at writing a liblouis table parser based on [[https://en.wikipedia.org/wiki/Parsing_expression_grammar][Parsing
expression grammar]], [[https://pest.rs/][pest]] and Rust
* Usage
#+BEGIN_SRC shell
$ cargo run ~/src/liblouis/tables/bengali.cti
Rule: miscellaneous_rules
Text: "include braille-patterns.cti"
Rule: include_rule
Text: "include braille-patterns.cti"
Rule: character_definition_rules
Text: "letter \x0981 3"
Rule: letter_rules
Text: "letter \x0981 3"
Rule: character_definition_rules
Text: "letter \x0982 56"
Rule: letter_rules
Text: "letter \x0982 56"
Rule: character_definition_rules
Text: "letter \x0983 6"
Rule: letter_rules
Text: "letter \x0983 6"
...
#+END_SRC
* Rationale
Many if not most of the CVEs of liblouis are rooted in the hand
crafted parsing functions of liblouis.
Moving to Rust for solid memory management and to parser generator
like pest would be of tremendeous help to avoid the buffer overflow
problems.
* Status
The grammar is pretty complete thanks to the work done on the
tree-sitter for liblouis.
The parser can handle all of the tables from the liblouis distribution
with the exception of the files that contain continuation lines
(da-dk-g16-lit.ctb, da-dk-g26-lit.ctb and da-dk-g26l-lit.ctb). Also it
fails on two tables that contain weird unicode chars inside a cotext
or match opcode (hu-hu-g2.ctb and my-g2.ctb)
* Prerequisites
- You need the [[https://www.rust-lang.org/][Rust tool chain]].
* contributing
If you have any improvements or comments please feel free to file a
pull request or an issue.
* License
Copyright (C) 2019 Swiss Library for the Blind, Visually Impaired and Print Disabled
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see
.