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 1.0 of this package:

{
    "require": {
        "data-values/common": "^1.0.0"
    }
}

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.

For tests only

composer test

For style checks only

composer cs

For a full CI run

composer ci

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

• Added TrimmingStringNormalizer
• Removed the DATAVALUES_COMMON_VERSION constant
• The StringFormatter constructor does not accept options any more

• The component can now be installed together with DataValues 2.x

• Fixed version number not updated before.

• Deprecated MonolingualTextValue::newFromArray and MultilingualTextValue::newFromArray
• MismatchingDataValueTypeException no longer modifies custom error messages in its constructor
• Updated minimal required PHP version from 5.3 to 5.5.9
• Updated the MediaWiki entry point to use the extension.json format

• 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

• Added MismatchingDataValueTypeException

• 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