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
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
|
<?php
namespace Drupal\Core\Extension;
use Drupal\Component\Version\Constraint;
/**
* A value object representing dependency information.
*/
class Dependency {
/**
* The name of the dependency.
*
* @var string
*/
protected $name;
/**
* The project namespace for the dependency.
*
* @var string
*/
protected $project;
/**
* The constraint string.
*
* @var \Drupal\Component\Version\Constraint
*/
protected $constraintString;
/**
* The Constraint object from the constraint string.
*
* @var \Drupal\Component\Version\Constraint
*/
protected $constraint;
/**
* Dependency constructor.
*
* @param string $name
* The name of the dependency.
* @param string $project
* The project namespace for the dependency.
* @param string $constraint
* The constraint string. For example, '>8.x-1.1'.
*/
public function __construct($name, $project, $constraint) {
$this->name = $name;
$this->project = $project;
$this->constraintString = $constraint;
}
/**
* Gets the dependency's name.
*
* @return string
* The dependency's name.
*/
public function getName() {
return $this->name;
}
/**
* Gets the dependency's project namespace.
*
* @return string
* The dependency's project namespace.
*/
public function getProject() {
return $this->project;
}
/**
* Gets constraint string from the dependency.
*
* @return string
* The constraint string.
*/
public function getConstraintString() {
return $this->constraintString;
}
/**
* Gets the Constraint object.
*
* @return \Drupal\Component\Version\Constraint
* The Constraint object.
*/
protected function getConstraint() {
if (!$this->constraint) {
$this->constraint = new Constraint($this->constraintString, \Drupal::CORE_COMPATIBILITY);
}
return $this->constraint;
}
/**
* Determines if the provided version is compatible with this dependency.
*
* @param string $version
* The version to check, for example '4.2'.
*
* @return bool
* TRUE if compatible with the provided version, FALSE if not.
*/
public function isCompatible($version) {
return $this->getConstraint()->isCompatible($version);
}
/**
* Creates a new instance of this class from a dependency string.
*
* @param string $dependency
* A dependency string, which specifies a module or theme dependency, and
* optionally the project it comes from and a constraint string that
* determines the versions that are supported. Supported formats include:
* - 'module'
* - 'project:module'
* - 'project:module (>=version, <=version)'.
*
* @return static
*/
public static function createFromString($dependency) {
if (str_contains($dependency, ':')) {
[$project, $dependency] = explode(':', $dependency);
}
else {
$project = '';
}
$parts = explode('(', $dependency, 2);
$name = trim($parts[0]);
$version_string = isset($parts[1]) ? rtrim($parts[1], ") ") : '';
return new static($name, $project, $version_string);
}
/**
* Prevents unnecessary serialization of constraint objects.
*
* @return array
* The properties to serialize.
*/
public function __sleep(): array {
return ['name', 'project', 'constraintString'];
}
}
|
