validate
- Description
- Schema validation for Emacs-lisp
- Latest
- validate-1.0.4.tar (.sig), 2024-Mar-31, 20.0 KiB
- Maintainer
- Artur Malabarba <emacs@endlessparentheses.com>
- Atom feed
- validate.xml
- Website
- https://elpa.gnu.org/packages/validate.html
- Browse repository
- CGit or Gitweb
- Badge
To install this package from Emacs, use package-install or list-packages.
Full description
This library offers two functions that perform schema validation.
Use this is your Elisp packages to provide very informative error
messages when your users accidentally misconfigure a variable.
For instance, if everything is fine, these do the same thing:
1. (validate-variable 'cider-known-endpoints)
2. cider-known-endpoints
However, if the user has misconfigured this variable, option
1. will immediately give them an informative error message, while
option 2. won't say anything and will lead to confusing errors down
the line.
The format and language of the schemas is the same one used in the
`:type' property of a `defcustom'.
See: (info "(elisp) Customization Types")
Both functions throw a `user-error' if the value in question
doesn't match the schema, and return the value itself if it
matches. The function `validate-variable' verifies whether the value of a
custom variable matches its custom-type, while `validate-value' checks an
arbitrary value against an arbitrary schema.
Missing features: `:inline', `plist', `coding-system', `color',
`hook', `restricted-sexp'.
Old versions
| validate-1.0.2.el.lz | 2016-Nov-17 | 3.39 KiB |
| validate-1.0.0.el.lz | 2016-Oct-12 | 3.33 KiB |
| validate-0.5.el.lz | 2016-May-12 | 3.29 KiB |
| validate-0.4.el.lz | 2016-May-10 | 3.17 KiB |
| validate-0.3.el.lz | 2016-May-04 | 3.01 KiB |