Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sailorproject/valua
Validation for lua! A module for making chained validations. Create your objects, append your tests, use and reuse it!
https://github.com/sailorproject/valua
Last synced: 3 months ago
JSON representation
Validation for lua! A module for making chained validations. Create your objects, append your tests, use and reuse it!
- Host: GitHub
- URL: https://github.com/sailorproject/valua
- Owner: sailorproject
- License: mit
- Created: 2014-03-11T15:01:18.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2022-10-24T17:01:46.000Z (over 2 years ago)
- Last Synced: 2024-02-14T00:55:13.489Z (12 months ago)
- Language: Lua
- Homepage:
- Size: 33.2 KB
- Stars: 79
- Watchers: 9
- Forks: 11
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-resty - valua
README
## Valua - Validation for Lua
[](https://travis-ci.org/sailorproject/valua)
[](https://coveralls.io/github/sailorproject/valua?branch=master)
A module for making chained validations. Create your objects, append your tests, use and reuse it!
Originally bundled with Sailor MVC Web Framework, now released as a separated module.
https://github.com/Etiene/sailor
This module provides tools for validating values, very useful in forms, but also usable elsewhere. It works in appended chains. Create a new validation object and start chaining your test functions. If your value fails a test, it breaks the chain and does not evaluate the rest of it. It returns a boolean and an error string (nil when tests succeeded).
Valua is also available through luarocks
````
luarocks install valua
````
#### Usage
Example 1 - Just create, chain and use:
```lua
valua:new().type("string").len(3,5)("test string!") -- false, "should have 3-5 characters"
```
Example 2 - Create, chain and later use it multiple times:
```lua
local reusable_validation = valua:new().type("string").len(3,5)
reusable_validation("test string!") -- false, "should have 3-5 characters"
reusable_validation("test!") -- true
```
#### Current validation functions
* alnum() -
Checks if string is alphanumeric.
* boolean() -
Checks if value is a boolean.
* compare(another_value) -
Checks if value is equal to another value.
* contains(substr) -
Checks if a string contains a substring.
* date() or date(format) -
Checks if a string is a valid date. Default format is UK (dd/mm/yyyy). Also checks for US and ISO formats.
* email() -
Checks if a string is a valid email address.
* empty() -
Checks if a value is empty.
* integer() -
Checks if a number is an integer;
* in_list(list) -
Checks if a value is inside an array.
* len(min,max) -
Checks if a string's length is between min and max.
* match(pattern) -
Checks if a string matches a given pattern.
* max(n) -
Checks if a number is equal or less than n.
* min(n) -
Checks if a number is equal or greater than n.
* not_empty() -
Checks if a value is not empty.
* no_white() -
Checks if a string contains no white spaces.
* number() -
Checks if a value is a number.
* string() -
Checks if a value is a string.
* type(t) -
Checks if a value is of type t.
* optional(t) -
If value is `nil` it would be accepted. If it's not `nil` it would be processed with other chained validation functions as usually done.
Copyright (c) 2014 Etiene Dalcol
http://etiene.net
http://twitter.com/etiene_d
License: MIT
Inspired by Respect Validation for PHP
https://github.com/Respect/Validation