lov

1.3.1 • Public • Published

Build Status npm version

Lightweight Object Validator (lov)

Validates objects based on validation schemas. Originally designed as a lightweight replacement for the popular Joi library (which is excellent but too heavy for use with smaller/lighter environments such as AWS Lambda).

Features

  • Programatic creation of validator objects using a fluent API
  • Automatic conversion of values (strings to numbers, etc.)
  • Lightweight with minimal dependencies
  • Low startup overhead and quick execution
  • Compatible with base Joi API
  • Node.js 4.3.2 compatible

Installation

Install via npm.

npm install lov --save

Getting Started

It's easy to start using Lov in your project:

var lov = require( 'lov' );
 
let schema = {
 
    id: lov.string().uuid().trim().required(),
 
    name: lov.string().min( 1 ).max( 100 ).required(),
 
    age: lov.number().min( 0 ).max( 120 ),
 
    address: lov.object().keys( {
 
            street: lov.string().max( 60 ).required(),
 
            street2: lov.string().max( 60 ),
 
            city: lov.string.max( 40 ).required(),
 
            state: lov.string().max( 20 ).required(),
 
            postal: lov.string().max( 20 ).uppercase().required(),
 
            country: lov.string().max( 60 ).required()
 
        }).required(),
 
    email: lov.string().email()    
};
 
let value = {
 
    id: 'f09c9ea1-114f-483a-89ef-b37d34803a79',
    name: '   Fred Smith  ',
    age: '44',
    address: {
        street: '1 Yonge Street',
        city: 'Toronto',
        state: 'ON',
        postal: 'm5e 1W7',
        country: 'Canada'
    },
    email: 'feedback@vandium.io'
}
 
let result = lov.validate( value, schema );
 
// result.error = null
// result.value = {
//
//     id: 'f09c9ea1-114f-483a-89ef-b37d34803a79',
//     name: 'Fred Smith',                              // String trimmed
//     age: 44,                                         // '44' coverted to 44
//     address: {
//         street: '1 Yonge Street',
//         city: 'Toronto',
//         state: 'ON',
//         postal: 'M5E 1W7',                           // Uppercase letters
//         country: 'Canada'
//     },
//     email: 'feedback@vandium.io'
// }

Feedback

We'd love to get feedback on how to make this tool better. Feel free to contact us at feedback@vandium.io

License

BSD-3-Clause

Package Sidebar

Install

npm i lov

Weekly Downloads

3

Version

1.3.1

License

BSD-3-Clause

Last publish

Collaborators

  • richardhyatt