/usr/share/php/Hamcrest/FeatureMatcher.php is in php-hamcrest 2.0.0-0ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67  | <?php
namespace Hamcrest;
/*
 Copyright (c) 2009 hamcrest.org
 */
/**
 * Supporting class for matching a feature of an object. Implement
 * <code>featureValueOf()</code> in a subclass to pull out the feature to be
 * matched against.
 */
abstract class FeatureMatcher extends TypeSafeDiagnosingMatcher
{
    private $_subMatcher;
    private $_featureDescription;
    private $_featureName;
    /**
     * Constructor.
     *
     * @param string $type
     * @param string $subtype
     * @param \Hamcrest\Matcher $subMatcher The matcher to apply to the feature
     * @param string $featureDescription Descriptive text to use in describeTo
     * @param string $featureName Identifying text for mismatch message
     */
    public function __construct($type, $subtype, Matcher $subMatcher, $featureDescription, $featureName)
    {
        parent::__construct($type, $subtype);
        $this->_subMatcher = $subMatcher;
        $this->_featureDescription = $featureDescription;
        $this->_featureName = $featureName;
    }
    /**
     * Implement this to extract the interesting feature.
     *
     * @param mixed $actual the target object
     *
     * @return mixed the feature to be matched
     */
    abstract protected function featureValueOf($actual);
    public function matchesSafelyWithDiagnosticDescription($actual, Description $mismatchDescription)
    {
        $featureValue = $this->featureValueOf($actual);
        if (!$this->_subMatcher->matches($featureValue)) {
            $mismatchDescription->appendText($this->_featureName)
                                                    ->appendText(' was ')->appendValue($featureValue);
            return false;
        }
        return true;
    }
    final public function describeTo(Description $description)
    {
        $description->appendText($this->_featureDescription)->appendText(' ')
                                ->appendDescriptionOf($this->_subMatcher)
                             ;
    }
}
 |