clova.core — clova 0.46.0

The core namespace contains all of the built in validators and the defvalidator macro.

The only other public functions are

• validation-set
• validate
• valid?
• results
• as-validator

You can view more information in the [readme] (https://github.com/markwoodhall/clova/blob/master/README.md). There are also example validation scenarios here.

The API documentation is available here.

You can also view [blog posts] (http://markw.xyz/tags/clova/) about clova.

=? clj/s

(=? value v)

Check an input value to see if it is equal to v using the regular = function.

It is worthwhile using =date? for validating date equality, since it has support for parsing string dates and comparing DateTime objects.

=date? clj/s

(=date? value d & [opt])

Check an input value to see if it is chronoligically equal to d. Where d is either the string representation of a date or one of [java.util.Date org.joda.time.DateTime] or [js/Date goog.date.Date goog.date.DateTime]

Optionally, takes a map argument and makes use of the following keys:

• :formatter You can use one of the built in ISO8601 formatters from clj-time or cljs-time. You can also define your own custom format string.

after? clj/s

(after? value d & [opt])

Check an input value to see if it is chronoligically after d. Where d is either the string representation of a date or one of [java.util.Date org.joda.time.DateTime] or [js/Date goog.date.Date goog.date.DateTime]

Optionally, takes a map argument and makes use of the following keys:

• :formatter You can use one of the built in ISO8601 formatters from clj-time or cljs-time. You can also define your own custom format string.

all? clj/s

(all? value col)

Check an input value to see if it matches a given collection of predicates. Predicates can be concrete values or they can be functions, they can be single items or collections.

(all? true [true (fn [v] (= true v))]) (all? true (fn [v] (= true v)))

alphanumeric? clj/s

(alphanumeric? value)

Checks an input value to see if it is alphanumeric. Alphanumeric is defined as [a-zA-Z0-9*$], if you need to customise this you can use the matches? validator with a custom regex.

as-validator clj/s

(as-validator f)

(as-validator f
              {:keys [default-message allow-missing-key?]
               :or {default-message "%s is %s but this is not a valid value."
                    allow-missing-key? true}
               :as m})

Takes a function f and applies optional m as meta data around it. f should be accept a first argument as the value to validate.

When m is present the following keys are taken and used as meta data to declare a validator:

• :default-message The default message template to be used when validation fails.
• :allow-missing-key? Should validation fail if the :target key is not present.

When m is not specified suitable defaults are used.

before? clj/s

(before? value d & [opt])

Check an input value to see if it is chronoligically before d. Where d is either the string representation of a date or one of [java.util.Date org.joda.time.DateTime] or [js/Date goog.date.Date goog.date.DateTime]

Optionally, takes a map argument and makes use of the following keys:

• :formatter You can use one of the built in ISO8601 formatters from clj-time or cljs-time. You can also define your own custom format string.

between? clj/s

(between? value lower upper)

Checks an input value to see if it is between lower and upper.

credit-card? clj/s

(credit-card? value)

Chacks an input value to see if it is a "valid" credit card number based on the Luhn algorithm.

date? clj/s

(date? value & [opt])

Checks an input value to see if it is a date.

If value is a string then it is parsed using clj-time or cljs-time.

If value is not a string but is one of [java.util.Date org.joda.time.DateTime] or [js/Date goog.date.Date goog.date.DateTime] then it will be considered a date?.

Optionally, takes a map argument and makes use of the following keys:

• :formatter You can use one of the built in ISO8601 formatters from clj-time or cljs-time. You can also define your own custom format string.

defvalidator clj/s macro

(defvalidator doc-string fname validator-meta-data args & body)

Wraps body in a function and defines it with meta data used to support the validation process. Works using a similar pattern to defn.

email? clj/s

(email? value)

Checks an input value to see if it is a valid email address

exists? clj/s

(exists? value col)

Checks for the presence of an item in a collection.

greater? clj/s

(greater? value lower)

Checks an input value to see if it is greater than lower.

length? clj/s

(length? value l)

Check an input value to see if it has a length equal to l. Work on sequences and strings.

lesser? clj/s

(lesser? value lower)

Checks an input value to see if it is less than lower.

longer? clj/s

(longer? value l)

Check an input value to see if it has a length longer than l. Work on sequences and strings.

matches? clj/s

(matches? value regex)

Checks a string representation of value against regex and returns true if value matches the regex. If value is not a match then returns nil.

negative? clj/s

(negative? value)

Checks an input value to see if it is a negative number.

not-empty? clj/s

(not-empty? value)

Checks for the presence of an empty string.

not-exists? clj/s

(not-exists? value col)

Checks for the non presence of an item in a collection.

not-nil? clj/s

(not-nil? value)

Checks for the presence of a non nil value.

numeric? clj/s

(numeric? value)

Checks an input value to see if it is numeric.

one-of? clj/s

(one-of? value col)

Checks an input value to see if it is one of the items in a col

positive? clj/s

(positive? value)

Checks an input value to see if it is a positive number.

post-code? clj/s

(post-code? value)

Checks an input value to see if it is a valid uk post code.

required? clj/s

(required? value)

Checks for the presence of a key based on the default value of ::key-not-found? for a missing key.

results clj/s

(results v-set m)

Takes a validation set and applies it to m. This is just a shorthand method over the validate function and returns only the validation results.

shorter? clj/s

(shorter? value l)

Check an input value to see if it has a length shorter than l. Work on sequences and strings.

stringy? clj/s

(stringy? value)

Checks an input value to see if it is a string

url? clj/s

(url? value)

Checks an input value to see if it is a valid url.

valid? clj/s

(valid? v-set m)

Takes a validation set and applies it to m. This is just a shorthand method over the validate function and returns only a truthy or falsy value indicating the validation status.

validate clj/s

(validate v-set m)

(validate v-set
          m
          {:keys [default-message-fn short-circuit? defaults only-failures?]
           :or {default-message-fn (fn [v-type value args target default] nil)
                short-circuit? false
                defaults {}
                only-failures? false}})

Takes a validation set and applies it to m. Returns the original map m transposed with error messages for non validating keys, also adds :clova.core/valid? with either a truthy or falsy value and :clova.core/results which is a sequence of validation failure messages, if applicable.

Optionally takes a map of options:

:default-message-fn can be specified to override the default validation messages. If specified the function will be called and receive the validator type as an argument. If the result of calling the function is anything but nil it will be used as the default validation message.

:short-circuit? when true no further validators for the validation set will be processed. The default is false and therefore to process all validators.

validation-set clj/s

(validation-set col)

(validation-set col {:keys [key-fn]})

Takes a sequence (col) that represents keys to validate and the functions used to validate them.

e.g. [:email email? :post-code post-code?]

It is also possible to specify keys to traverse nested maps.

e.g. using [[:user :credentials :name] [matches? #"someregex"]] we can define a validation function to target the :name key in a map like {:user {:credentials {:name "username" }}}

Returns a sequence of functions merged with meta data used by the validation.

zip-code? clj/s

(zip-code? value)

Checks an input value to see if it is a valid zip code.