Skip to main content
Drupal API
User account menu
  • Log in

Breadcrumb

  1. Drupal Core 11.1.x
  2. Decisions.php

class Decisions

Stores decisions on installing, removing or keeping packages

@author Nils Adermann <naderman@naderman.de> @implements \Iterator<array{0: int, 1: Rule}>

Hierarchy

  • class \Composer\DependencyResolver\Decisions implements \Composer\DependencyResolver\Iterator, \Composer\DependencyResolver\Countable

Expanded class hierarchy of Decisions

File

vendor/composer/composer/src/Composer/DependencyResolver/Decisions.php, line 21

Namespace

Composer\DependencyResolver
View source
class Decisions implements \Iterator, \Countable {
    public const DECISION_LITERAL = 0;
    public const DECISION_REASON = 1;
    
    /** @var Pool */
    protected $pool;
    
    /** @var array<int, int> */
    protected $decisionMap;
    
    /**
     * @var array<int, array{0: int, 1: Rule}>
     */
    protected $decisionQueue = [];
    public function __construct(Pool $pool) {
        $this->pool = $pool;
        $this->decisionMap = [];
    }
    public function decide(int $literal, int $level, Rule $why) : void {
        $this->addDecision($literal, $level);
        $this->decisionQueue[] = [
            self::DECISION_LITERAL => $literal,
            self::DECISION_REASON => $why,
        ];
    }
    public function satisfy(int $literal) : bool {
        $packageId = abs($literal);
        return $literal > 0 && isset($this->decisionMap[$packageId]) && $this->decisionMap[$packageId] > 0 || $literal < 0 && isset($this->decisionMap[$packageId]) && $this->decisionMap[$packageId] < 0;
    }
    public function conflict(int $literal) : bool {
        $packageId = abs($literal);
        return isset($this->decisionMap[$packageId]) && $this->decisionMap[$packageId] > 0 && $literal < 0 || isset($this->decisionMap[$packageId]) && $this->decisionMap[$packageId] < 0 && $literal > 0;
    }
    public function decided(int $literalOrPackageId) : bool {
        return ($this->decisionMap[abs($literalOrPackageId)] ?? 0) !== 0;
    }
    public function undecided(int $literalOrPackageId) : bool {
        return ($this->decisionMap[abs($literalOrPackageId)] ?? 0) === 0;
    }
    public function decidedInstall(int $literalOrPackageId) : bool {
        $packageId = abs($literalOrPackageId);
        return isset($this->decisionMap[$packageId]) && $this->decisionMap[$packageId] > 0;
    }
    public function decisionLevel(int $literalOrPackageId) : int {
        $packageId = abs($literalOrPackageId);
        if (isset($this->decisionMap[$packageId])) {
            return abs($this->decisionMap[$packageId]);
        }
        return 0;
    }
    public function decisionRule(int $literalOrPackageId) : Rule {
        $packageId = abs($literalOrPackageId);
        foreach ($this->decisionQueue as $decision) {
            if ($packageId === abs($decision[self::DECISION_LITERAL])) {
                return $decision[self::DECISION_REASON];
            }
        }
        throw new \LogicException('Did not find a decision rule using ' . $literalOrPackageId);
    }
    
    /**
     * @return array{0: int, 1: Rule} a literal and decision reason
     */
    public function atOffset(int $queueOffset) : array {
        return $this->decisionQueue[$queueOffset];
    }
    public function validOffset(int $queueOffset) : bool {
        return $queueOffset >= 0 && $queueOffset < \count($this->decisionQueue);
    }
    public function lastReason() : Rule {
        return $this->decisionQueue[\count($this->decisionQueue) - 1][self::DECISION_REASON];
    }
    public function lastLiteral() : int {
        return $this->decisionQueue[\count($this->decisionQueue) - 1][self::DECISION_LITERAL];
    }
    public function reset() : void {
        while ($decision = array_pop($this->decisionQueue)) {
            $this->decisionMap[abs($decision[self::DECISION_LITERAL])] = 0;
        }
    }
    
    /**
     * @param int<-1, max> $offset
     */
    public function resetToOffset(int $offset) : void {
        while (\count($this->decisionQueue) > $offset + 1) {
            $decision = array_pop($this->decisionQueue);
            $this->decisionMap[abs($decision[self::DECISION_LITERAL])] = 0;
        }
    }
    public function revertLast() : void {
        $this->decisionMap[abs($this->lastLiteral())] = 0;
        array_pop($this->decisionQueue);
    }
    public function count() : int {
        return \count($this->decisionQueue);
    }
    public function rewind() : void {
        end($this->decisionQueue);
    }
    
    /**
     * @return array{0: int, 1: Rule}|false
     */
    public function current() {
        return current($this->decisionQueue);
    }
    public function key() : ?int {
        return key($this->decisionQueue);
    }
    public function next() : void {
        prev($this->decisionQueue);
    }
    public function valid() : bool {
        return false !== current($this->decisionQueue);
    }
    public function isEmpty() : bool {
        return \count($this->decisionQueue) === 0;
    }
    protected function addDecision(int $literal, int $level) : void {
        $packageId = abs($literal);
        $previousDecision = $this->decisionMap[$packageId] ?? 0;
        if ($previousDecision !== 0) {
            $literalString = $this->pool
                ->literalToPrettyString($literal, []);
            $package = $this->pool
                ->literalToPackage($literal);
            throw new SolverBugException("Trying to decide {$literalString} on level {$level}, even though {$package} was previously decided as " . $previousDecision . ".");
        }
        if ($literal > 0) {
            $this->decisionMap[$packageId] = $level;
        }
        else {
            $this->decisionMap[$packageId] = -$level;
        }
    }
    public function toString(?Pool $pool = null) : string {
        $decisionMap = $this->decisionMap;
        ksort($decisionMap);
        $str = '[';
        foreach ($decisionMap as $packageId => $level) {
            $str .= ($pool !== null ? $pool->literalToPackage($packageId) : $packageId) . ':' . $level . ',';
        }
        $str .= ']';
        return $str;
    }
    public function __toString() : string {
        return $this->toString();
    }

}

Members

Title Sort descending Modifiers Object type Summary
Decisions::$decisionMap protected property @var array&lt;int, int&gt;
Decisions::$decisionQueue protected property
Decisions::$pool protected property @var Pool
Decisions::addDecision protected function
Decisions::atOffset public function
Decisions::conflict public function
Decisions::count public function
Decisions::current public function
Decisions::decide public function
Decisions::decided public function
Decisions::decidedInstall public function
Decisions::decisionLevel public function
Decisions::decisionRule public function
Decisions::DECISION_LITERAL public constant
Decisions::DECISION_REASON public constant
Decisions::isEmpty public function
Decisions::key public function
Decisions::lastLiteral public function
Decisions::lastReason public function
Decisions::next public function
Decisions::reset public function
Decisions::resetToOffset public function
Decisions::revertLast public function
Decisions::rewind public function
Decisions::satisfy public function
Decisions::toString public function
Decisions::undecided public function
Decisions::valid public function
Decisions::validOffset public function
Decisions::__construct public function
Decisions::__toString public function

API Navigation

  • Drupal Core 11.1.x
  • Topics
  • Classes
  • Functions
  • Constants
  • Globals
  • Files
  • Namespaces
  • Deprecated
  • Services
RSS feed
Powered by Drupal