README

DataValues Validators is a small library that contains common ValueValidator implementations.

It is part of the DataValues set of libraries.

On Packagist:

Installation

The recommended way to use this library is via Composer.

Composer

To add this package as a local, per-project dependency to your project, simply add a dependency on data-values/validators to your project's composer.json file. Here is a minimal example of a composer.json file that just defines a dependency on version 1.0 of this package:

{
    "require": {
        "data-values/validators": "1.0.*"
    }
}

Manual

Get the code of this package, either via git, or some other means. Also get all dependencies. You can find a list of the dependencies in the "require" section of the composer.json file. Then take care of autoloading the classes defined in the src directory.

Tests

This library comes with a set up PHPUnit tests that cover all non-trivial code. You can run these tests using the PHPUnit configuration file found in the root directory. The tests can also be run via Github Actions.

Authors

DataValues Validators has been written by the Wikidata team, as Wikimedia Germany employees for the Wikidata project.

It is based upon and contains a lot of code written by Jeroen De Dauw for the Maps and Semantic MediaWiki projects.

Release notes

1.0.0 (2021-01-22)

• Added compatibility with data-values/data-values 3.x
• Added compatibility with data-values/interfaces 1.x

0.1.3 (2018-08-02)

• Made component installable with DataValues 2.x
• Removed MediaWiki integration

0.1.2 (2014-10-09)

• Made component installable with DataValues 1.x

0.1.1 (2014-03-27)

• Changed autoloading from PSR-0 to PSR-4
• Added tests for DimensionValidator

0.1.0 (2013-11-17)

Initial release with these features:

• DimensionValidator
• ListValidator
• NullValidator
• RangeValidator
• StringValidator
• TitleValidator

Links

• DataValues Validators on Packagist
• DataValues Validators on ScrutinizerCI