DataValues Common is a small library build on top of DataValues that provides common implementations of the DataValues, ValueParsers, ValueFormatters and ValueValidators interfaces.

It is part of the DataValues set of libraries.

On Packagist:

The recommended way to use this library is via Composer.

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

{
    "require": {
        "data-values/common": "0.3.*"
    }
}

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.

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 TravisCI, as a TravisCI configuration file is also provided in the root directory.

DataValues Common has been written by the Wikidata team, as [Wikimedia Germany] (https://wikimedia.de) employees for the Wikidata project.

• The component can now be installed together with DataValues Interfaces 0.1.5

• Added DispatchingValueParser
• Added StringNormalizer interface
• Added NullStringNormalizer
• Added StringParser
• Dropped deprecated constant DataValuesCommon_VERSION, use DATAVALUES_COMMON_VERSION instead
• Dropped ValueParserTestBase::getParserClass
• Dropped ValueParserTestBase::newParserOptions
• Made ValueParserTestBase::getInstance abstract
• Made ValueParserTestBase::invalidInputProvider abstract
• Lowered visibility of all class fields to private

• Introduced FORMAT_NAME class constants on ValueParsers in order to use them as expectedFormat
• Changed ValueParsers to pass rawValue and expectedFormat arguments when constructing a ParseException
• Installation together with DataValues 1.x is now supported

• Introduced DataValueMismatchException

• Minor code cleanup
• Improved PHPUnit bootstrap

• Added FloatParser (moved from data-values/number)
• Added IntParser (moved from data-values/number)

• Fixed link in the MediaWiki credits

Initial release with these features:

• Several DataValue implementations
  • MonolingualTextValue
  • MultilingualTextValue
• Several ValueFormatter implementations
  • StringFormatter
• Several ValueParser implementations
  • BoolParser
  • DecimalParser
  • NullParser

• DataValues Common on Packagist
• DataValues Common on TravisCI