Re: [Jsonpath] I-Regexp railroad diagrams

Carsten Bormann <cabo@tzi.org> Fri, 29 April 2022 09:36 UTC

Content-Type: text/plain; charset="utf-8"
Mime-Version: 1.0 (Mac OS X Mail 13.4 \(3608.120.23.2.7\))
From: Carsten Bormann <cabo@tzi.org>
In-Reply-To: <B8585648-1D0B-44CE-8F41-725FEA3380A5@tzi.org>
Date: Fri, 29 Apr 2022 11:36:19 +0200
Cc: Tim Bray <tbray@textuality.com>, jsonpath@ietf.org
Content-Transfer-Encoding: quoted-printable
Message-Id: <C4327687-29FD-4A8C-B818-DA4946A287B9@tzi.org>
References: <CAHBU6itK5ziu6+j2vtxmPmgbFfeJi6Cmh5HoX4_ewW=7nCu+QA@mail.gmail.com> <3F8374E6-C0A7-4768-800E-09457291CCC5@tzi.org> <CANH0GbJy69qy7q1yha8wUjJk1EvvTjXqkh2GNkzVQCx7uyCeRQ@mail.gmail.com> <B8585648-1D0B-44CE-8F41-725FEA3380A5@tzi.org>
To: Glyn Normington <glyn.normington.work@gmail.com>
Archived-At: <https://mailarchive.ietf.org/arch/msg/jsonpath/0qLXq9m97jVDkTm0jXwmbplQ6Xk>
Subject: Re: [Jsonpath] I-Regexp railroad diagrams
Precedence: list


> On 2022-04-29, at 09:40, Carsten Bormann <cabo@tzi.org> wrote:
> 
> On 2022-04-29, at 09:39, Glyn Normington <glyn.normington.work@gmail.com> wrote:
>> 
>> Very good. Can we add a railroad diagram to the JSONPath spec?
> 
> Of course.  Let’s see how useful that turns out…

(As Kate mentioned on twitter, her code doesn’t do Unicode ranges yet, so I had to do some manual massaging.)

These are a few examples from the plaintext version:


   index-selector:
       │├── "[" ── S ──╮── quoted-member-name ──╭── S ── "]" ──┤│
                       │                        │
                       ╰──── element-index ─────╯

   quoted-member-name:
       │├── string-literal ──┤│

   string-literal:
       │├──╮── "\"" ──╭───────────────────╮── "\"" ──╭──┤│
           │          │                   │          │
           │          ╰── double-quoted ──╯          │
           │                                         │
           ╰─── "'" ──╭───────────────────╮── "'" ───╯
                      │                   │
                      ╰── single-quoted ──╯

   double-quoted:
       │├──╮───── unescaped ──────╭──┤│
           │                      │
           ╰──────── "'" ─────────╯
           │                      │
           ╰──── ESC ── "\"" ─────╯
           │                      │
           ╰── ESC ── escapable ──╯

Unfortunately, some of the plaintext graphs are too wide for the current RFC style guide.

Please find a full PDF version at https://www.tzi.de/~cabo/jsonpath.pdf
(A few bugs in the PDF version show up here, too.)

Grüße, Carsten

[Jsonpath] I-Regexp railroad diagrams Tim Bray
Re: [Jsonpath] I-Regexp railroad diagrams Carsten Bormann
Re: [Jsonpath] I-Regexp railroad diagrams Glyn Normington
Re: [Jsonpath] I-Regexp railroad diagrams Carsten Bormann
Re: [Jsonpath] I-Regexp railroad diagrams Carsten Bormann
Re: [Jsonpath] I-Regexp railroad diagrams Glyn Normington