Skip to content

Generic input parsing library, speaking in tongues.

License

Notifications You must be signed in to change notification settings

dev-cafe/parselglossy

Folders and files

NameName
Last commit message
Last commit date

Latest commit

eb8adcc · Nov 6, 2022
Nov 4, 2022
Aug 14, 2020
Jul 18, 2022
Sep 28, 2022
Jul 15, 2022
Mar 9, 2019
Mar 14, 2019
Jul 15, 2022
Nov 19, 2019
Apr 15, 2020
Aug 3, 2022
Jul 18, 2022
Feb 8, 2019
Nov 19, 2019
Sep 28, 2022
Aug 14, 2020
Jul 15, 2022
Jul 22, 2022
Jul 22, 2022
Aug 17, 2022
Jul 9, 2020
Jul 22, 2022

Repository files navigation

parselglossy

CI build status Documentation Status

[...] I speak with tongues more than you all;

1 Corinthians 14:18

Parse it on!

—Bobson Dugnutt, Private communication

Generic input parsing library, speaking in tongues.

parselglossy generates a fully functional Python input parsing module from a simple YAML template specification. The parser has no dependencies on external Python packages. The documentation for all input keywords is also generated in reStructuredText format from the YAML specification.

Parse all the inputs!

Requirements

  • Python 3.7 or later.

Features

  • Flexible. It can accommodate different input styles and still generate correct parsers. This is achieved by decoupling input reading and validation.
  • Extensible. We work with standard Python types and standard JSON format. Interfacing and extending to your needs is straightforward.
  • Simple. Just provide an input specification in YAML format: names of keywords/sections, defaults, documentation. The tedious bits are automatically handled for you.
  • Correct. parselglossy gives two correctness guarantees:
    1. If the YAML specification is valid, the generated parser will be correct.
    2. If validation completes, the input to your application is well-formed.

Projects using parselglossy

If your project is using parselglossy, please add a link via a pull request.