packcr 0.0.7 → 0.0.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c7f6f8510a8922ec8a3f379de4470af6889a01a0f98aebf46b69f16e2c398c64
-  data.tar.gz: aa728bb984a9a343c71099fe6652b7a37c5a3a20b535ad6d5cbc29feaaa776d0
+  metadata.gz: cacf5e781ba49bcc7d755ac5ba6e348646a08e4a807efd4375ba720232262556
+  data.tar.gz: ce70800733fbc71527539174f373786489f3fdda416b5435bf8aa687de1cd321
 SHA512:
-  metadata.gz: ceee0d72c7fa96a8a71fd76d8015591f70c4ba321242966ed295522d55e37e2ce71cf8ab51bda644971f5b0ad675c4c0dbdd225e8f2eded2d5eb8f5a3957922f
-  data.tar.gz: fd819a73b1b16827316ddef020068383952cf6d188ac728f5d06157330b49b0010561552676fce3652cc90b0f838f7750242622b83d0677335e6bc6235199d4f
+  metadata.gz: f0cf28feb81c97f094f6b098656ab4ec30f312e99c84789c5e5f53cf8a520c4c63a561d48a240b7ab0699d2e063820e3b923118d33e2a9e3b5dfc2884993ac9d
+  data.tar.gz: c858ad58e577af40013bbd7438eb3c4066d0c76b0a6407c5ab051ae63a379936594da974a1c203a72659d3dcebc4794c0aaaf5beea2ab98169388a89c0c79773

data/LICENSE

@@ -0,0 +1,21 @@
+PackCR: a packrat parser generator for C as ruby library.
+
+Copyright (c) 2022 wanabe All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,73 @@
+# PackCR
+
+## Overview
+
+PackCR is a parser generator for C or Ruby.
+This library is a port of PackCC rewritten in ruby.
+The Original PackCC is https://github.com/arithy/packcc.
+
+## Usage
+
+You can get Packcr object with `Packcr.new(peg_path)` and it can generate C source and header with `Packcr#run`.
+
+Example(1):
+
+```
+$ cat ./tmp/example1.sh
+#!/bin/sh
+set -e
+cd $0/..
+cp ../packcc/examples/calc.peg calc.c.peg
+bundle exec ruby -e 'require "packcr"; Packcr.new("calc.c.peg").run'
+gcc calc.c
+echo "1 + 2 * 3 - 4 / 2" | ./a.out
+
+$ ./tmp/example1.sh
+answer=5
+```
+
+Example(2):
+
+```
+$ cat ./tmp/example2.sh
+#!/bin/sh
+set -e
+cd $0/..
+cp ../examples/calc.rb.peg .
+bundle exec ruby -e 'require "packcr"; Packcr.new("calc.rb.peg").run'
+ruby calc.rb "1 + 2 * 3 - 4 / 2"
+
+$ ./tmp/example2.sh
+answer=5
+```
+
+## Syntax
+
+The syntax is almost the same as PackCC.
+Additional syntax is shown below.
+
+**`%location` `{` _source code_ `}`**
+
+It defines your own location structure.
+It should have some definitions for C:
+
+- struct
+    - `packcr_location_t`
+- function
+    - `void packcr_location_init(packcr_location_t *lp)`
+    - `void packcr_location_forward(packcr_location_t *lp, char *buf, size_t n)`
+    - `packcr_location_t packcr_location_add(packcr_location_t l1, packcr_location_t l2)`
+    - `packcr_location_t packcr_location_sub(packcr_location_t l1, packcr_location_t l2)`
+    - (The functions can be `static` and/or `inline`)
+
+Or it should have some definitions for ruby:
+- class
+    - `Location`
+- method
+    - `Location#initialize(...)`
+    - `Location#+(loc)`
+    - `Location#-(loc)`
+    - `Location#forward(str, index, n)`
+
+Locations are captured and they can be refer with **`$`**_n_**`sl`** and **`$`**_n_**`el`**.
+You can see the examples [examples/calc_loc.peg](examples/calc_loc.peg) and [examples/calc_loc.rb.peg](examples/calc_loc.rb.peg).

data/lib/packcr/context.rb

@@ -84,7 +84,7 @@ class Packcr
     end
 
     def prefix
-      @prefix || "pcc"
+      @prefix || "packcr"
     end
 
     def pass_value_code(var)