NonGNU ELPA - parseedn

parseedn

Description
Clojure/EDN parser
Latest
parseedn-1.2.1.tar (.sig), 2024-Mar-31, 40.0 KiB
Maintainer
Arne Brasseur <arne@arnebrasseur.net>
Atom feed
parseedn.xml
Website
http://www.github.com/clojure-emacs/parseedn
Browse ELPA's repository
CGit or Gitweb
Badge

To install this package from Emacs, use package-install or list-packages.

Full description

CircleCI MELPA MELPA Stable

EDN parser for Emacs Lisp

parseedn is an Emacs Lisp library for parsing EDN data. It uses parseclj's shift-reduce parser internally.

EDN and Emacs Lisp have some important differences that make translation from one to the other not transparent (think representing an EDN map into Elisp, or being able to differentiate between false and nil in Elisp). Because of this, parseedn takes certain decisions when parsing and transforming EDN data into Elisp data types. For more information please refer to parseclj DESIGN.md document.

Lastly, parseedn is in alpha stage, so its API is subject to change.

Installation

Available on the major package.el community maintained repos - MELPA Stable and MELPA repos.

MELPA Stable is the recommended repo as it has the latest stable version. MELPA has a development snapshot for users who don't mind (infrequent) breakage but don't want to run from a git checkout.

You can install parseedn using the following command:

M-x package-install [RET] parseedn [RET]

or if you'd rather keep it in your dotfiles:

el (unless (package-installed-p 'parseedn) (package-install 'parseedn))

If the installation doesn't work try refreshing the package list:

M-x package-refresh-contents

Usage

  • parseedn-read

    Read content from the current buffer as EDN and transforms it into an Emacs Lisp value.

  • parseedn-read-str str

    Read STR as EDN and transfroms it into an Emacs Lisp value.

  • parseedn-print datum

    Inserts DATUM as EDN Into the current buffer. DATUM can be any Emacs Lisp value.

  • parseedn-print-str datum

    Returns a string containing DATUM as EDN. DATUM can be any Emacs Lisp value.

Prior art

edn.el is an EDN-to-elisp parser based on the PEG parser generator library.

License

© 2017-2023 Arne Brasseur

Distributed under the terms of the GNU General Public License 3.0 or later. See LICENSE.

Old versions

parseedn-1.2.0.tar.lz2023-Sep-297.72 KiB
parseedn-1.1.0.tar.lz2022-Feb-075.42 KiB
parseedn-1.0.6.tar.lz2021-Dec-285.08 KiB

News

1.2.1 (2023-12-03)

  • Update parseclj to 1.1.1.

1.2.0 (2023-09-29)

  • #12: Allow empty vectors to be printed.
  • #14: avoid C stack overflows.
  • #15: correctly process empty hashmaps.
  • #17: Add support for namespaced maps.

1.1.0 (2022-02-07)

  • #11 Support a default-data-reader for tagged literals
  • Via parseclj: support bigint

1.0.6 (2021-10-13)

  • Make sure parseedn and parseclj versions are in sync

1.0.5 (2021-10-13)

  • #10 Replace cl-case with cond

1.0.4 (2021-09-30)

  • Drop use of (map-merge 'alist) for older Emacsen

1.0.3 (2021-09-29)

  • Follow upstream parseclj versioning

1.0.2 (2021-09-29)

  • Follow upstream parseclj versioning

1.0.0 (2021-09-27)

Added

  • Added print handler for #uuid and #inst

0.2.0 (2020-09-09 / d25ebc5)

Added

  • Add support for alist, plist and an explicit error for unsupported dotted pair notation.

Fixed

  • Fix printing of hash-maps with multiple entries.

0.1.0 (2019-03-31 / ddf824b)

Initial release of parseedn