Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/elixir-validation/validation
Elixir Validation library with +25 fully tested rules. (+30 coming up soon!)
https://github.com/elixir-validation/validation
Last synced: 3 months ago
JSON representation
Elixir Validation library with +25 fully tested rules. (+30 coming up soon!)
- Host: GitHub
- URL: https://github.com/elixir-validation/validation
- Owner: elixir-validation
- License: mit
- Created: 2019-09-10T13:56:29.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2019-12-16T13:50:02.000Z (almost 5 years ago)
- Last Synced: 2024-07-20T03:18:34.016Z (4 months ago)
- Language: Elixir
- Homepage: https://hexdocs.pm/validation
- Size: 394 KB
- Stars: 59
- Watchers: 2
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
---
[](https://travis-ci.org/elixir-validation/validation)
[](https://ci.appveyor.com/project/elixir-validation/validation)
[](https://coveralls.io/github/elixir-validation/validation?branch=master)
[](https://inch-ci.org/github/elixir-validation/validation)
[](https://hex.pm/packages/validation)
[](https://hex.pm/packages/validation)
[](https://github.com/elixir-validation/validation)
[](https://opensource.org/licenses/MIT)
> **Easy. Simple. Powerful. 💪**
>
> Elixir Validation library with +25 fully tested rules. *(+30 coming up soon!)*
>
> ⚠️⚠️ ️ Library under development! [Roadmap: upcoming new rules](#roadmap-30-coming-up-soon). ⚠️⚠️
# Demo
```elixir
# alias Validation, as: V
# valid data will return true
V.email?("[email protected]")
V.uuid?("e4eaaaf2-d142-11e1-b3e4-080027620cdd")
V.credit_card?("4882743696073832")
V.mac_address?("12-77-0E-42-E4-65")
V.consonants?("bcdfgh")
V.country_code?("US")
# invalid data will return false
V.language_code?("qq") # could be something like "en", "pt" or "de"
V.vowel?("bcdf") # could be something like "aeiou"
V.yes?("nope") # could be something like "yes", "yeah", "yeap"
V.is_odd?(2) # could be something like 3 or 5...
```
## Install
To use Elixir Validation, please add to your `mix.exs` and run `mix deps.get`:
```elixir
def deps do
[
{:validation, "~> 0.0.1-dev"}
]
end
```
Compatibility: Elixir 1.6+
## Documentation
To more information, please access the [full documention](https://hexdocs.pm/validation).
## Rules
##### +25 fully tested rules such as:
- [Email](https://hexdocs.pm/validation/Validation.html#email/1)
- [CreditCard (Visa, Master, other)](https://hexdocs.pm/validation/Validation.html#credit_card/1)
- [CNPJ](https://hexdocs.pm/validation/Validation.html#cnpj/1) / [CPF](https://hexdocs.pm/validation/Validation.html#cpf/1)
- [CountryCode](https://hexdocs.pm/validation/Validation.html#country_code/2) / [SubdivisionCode](https://hexdocs.pm/validation/Validation.html#subdivision_code/2)
- [Vowel](https://hexdocs.pm/validation/Validation.html#vowel/1) / [Consonants](https://hexdocs.pm/validation/Validation.html#consonant/1)
- [MacAddress](https://hexdocs.pm/validation/Validation.html#mac_address/1)
- *... and many, many more [right here!](https://hexdocs.pm/validation)*
## Roadmap: +30 coming up soon!
*Barcode, Iban, WordCount, Contains, Bic, CurrencySymbol, Isbn, Issn, Domain, Extension, Factor, Fibonacci, Finite, HexRgbColor, IdentityCard, Imei, Infinite, Ip, KeyNested, StartsWith, EndsWith, Length, Min, Max, NfeAccessKey, NoWhitespace, NotBlank, NotEmpty, Numeric, PerfectSquare, Pesel, Phone, PostalCode (us, uk, br...), PrimeNumber, Punct, Roman, Size, Slug, Space, Url, Version*
# Contribution
[Check out the list of awesome contributors.](https://github.com/elixir-validation/validation/graphs/contributors)
- *Do you want a new validation rule?* Feel free to contribute by forking the project and making a pull request.
- *Did you find a bug?* Please report on [issues](https://github.com/elixir-validation/validation/issues) proving high level of detail. Additionally, providing a failing test would help solve the issue.
# Inspiration
We highly appreciate ❤️ the [Respect\Validation](https://github.com/Respect/Validation) project. Elixir Validation was **completely** based upon this incredible project. Kudos for all contributors. We can't thank you enough.
## License
[MIT License](https://github.com/elixir-validation/validation/blob/master/LICENSE.txt) – [Matheus Gontijo](https://github.com/matheusgontijo)