Skip to content

clojure-emacs/parseedn

Repository files navigation

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:

(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.