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
andMultilingualTextValue::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
, useDATAVALUES_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