Conditions | 1 |
Paths | 1 |
Total Lines | 175 |
Code Lines | 39 |
Lines | 0 |
Ratio | 0 % |
Changes | 1 | ||
Bugs | 0 | Features | 0 |
Small methods make your code easier to understand, in particular if combined with a good name. Besides, if your method is small, finding a good name is usually much easier.
For example, if you find yourself adding comments to a method's body, this is usually a good sign to extract the commented part to a new method, and use the comment as a starting point when coming up with a good name for this new method.
Commonly applied refactorings include:
If many parameters/temporary variables are present:
1 | <?php |
||
51 | public function propertiesToBeTested() : array |
||
52 | { |
||
53 | $astLocator = (new BetterReflection())->astLocator(); |
||
54 | |||
55 | $fromLocator = new StringSourceLocator( |
||
56 | <<<'PHP' |
||
57 | <?php |
||
58 | |||
59 | class TheClass { |
||
60 | public $publicNoDocblockToNoDocblock; |
||
61 | public $publicNoDocblockToDocblock; |
||
62 | |||
63 | /** |
||
64 | * Hi |
||
65 | */ |
||
66 | public $publicNoTypeDocblockToDocblock; |
||
67 | |||
68 | /** |
||
69 | * @var int |
||
70 | */ |
||
71 | public $publicDocblockToSameDocblock; |
||
72 | |||
73 | /** |
||
74 | * @var int |
||
75 | */ |
||
76 | public $publicDocblockToDifferentDocblock; |
||
77 | |||
78 | /** |
||
79 | * @var int |
||
80 | */ |
||
81 | public $publicDocblockToNoDocblock; |
||
82 | |||
83 | /** |
||
84 | * @var int|float |
||
85 | */ |
||
86 | public $publicCompositeTypeDocblockToSameTypeDocblock; |
||
87 | |||
88 | /** |
||
89 | * @var int|float |
||
90 | */ |
||
91 | public $publicCompositeTypeDocblockToSameTypeDocblockWithDifferentSorting; |
||
92 | |||
93 | /** |
||
94 | * @var int|float |
||
95 | */ |
||
96 | public $publicCompositeTypeDocblockToDifferentCompositeTypeDocblock; |
||
97 | |||
98 | /** |
||
99 | * @var int |
||
100 | */ |
||
101 | private $privateDocblockToDifferentDocblock; |
||
102 | |||
103 | /** |
||
104 | * @var int|int |
||
105 | */ |
||
106 | private $duplicatePropertyTypesBeingDeduplicatedAreNotBcBreaks; |
||
107 | |||
108 | /** |
||
109 | * @var int |
||
110 | */ |
||
111 | private $propertyTypeBeingDuplicatedAreNotBcBreaks; |
||
112 | |||
113 | /** |
||
114 | * @var GenericType<T1, T2> |
||
115 | */ |
||
116 | public $propertyWithComplexDocblockThatCannotBeParsed; |
||
117 | } |
||
118 | PHP |
||
119 | , |
||
120 | $astLocator |
||
121 | ); |
||
122 | |||
123 | $toLocator = new StringSourceLocator( |
||
124 | <<<'PHP' |
||
125 | <?php |
||
126 | |||
127 | class TheClass { |
||
128 | public $publicNoDocblockToNoDocblock; |
||
129 | |||
130 | /** |
||
131 | * @var int |
||
132 | */ |
||
133 | public $publicNoDocblockToDocblock; |
||
134 | |||
135 | /** |
||
136 | * @var int |
||
137 | */ |
||
138 | public $publicNoTypeDocblockToDocblock; |
||
139 | |||
140 | /** |
||
141 | * @var int |
||
142 | */ |
||
143 | public $publicDocblockToSameDocblock; |
||
144 | |||
145 | /** |
||
146 | * @var float |
||
147 | */ |
||
148 | public $publicDocblockToDifferentDocblock; |
||
149 | |||
150 | public $publicDocblockToNoDocblock; |
||
151 | |||
152 | /** |
||
153 | * @var int|float |
||
154 | */ |
||
155 | public $publicCompositeTypeDocblockToSameTypeDocblock; |
||
156 | |||
157 | /** |
||
158 | * @var float|int |
||
159 | */ |
||
160 | public $publicCompositeTypeDocblockToSameTypeDocblockWithDifferentSorting; |
||
161 | |||
162 | /** |
||
163 | * @var int|float|string |
||
164 | */ |
||
165 | public $publicCompositeTypeDocblockToDifferentCompositeTypeDocblock; |
||
166 | |||
167 | /** |
||
168 | * @var float |
||
169 | */ |
||
170 | private $privateDocblockToDifferentDocblock; |
||
171 | |||
172 | /** |
||
173 | * @var int |
||
174 | */ |
||
175 | private $duplicatePropertyTypesBeingDeduplicatedAreNotBcBreaks; |
||
176 | |||
177 | /** |
||
178 | * @var int|int |
||
179 | */ |
||
180 | private $propertyTypeBeingDuplicatedAreNotBcBreaks; |
||
181 | |||
182 | /** |
||
183 | * @var GenericType<T1, T2> |
||
184 | */ |
||
185 | public $propertyWithComplexDocblockThatCannotBeParsed; |
||
186 | } |
||
187 | PHP |
||
188 | , |
||
189 | $astLocator |
||
190 | ); |
||
191 | |||
192 | $fromClassReflector = new ClassReflector($fromLocator); |
||
193 | $toClassReflector = new ClassReflector($toLocator); |
||
194 | $fromClass = $fromClassReflector->reflect('TheClass'); |
||
195 | $toClass = $toClassReflector->reflect('TheClass'); |
||
196 | |||
197 | $properties = [ |
||
198 | 'publicNoDocblockToNoDocblock' => [], |
||
199 | 'publicNoDocblockToDocblock' => [], |
||
200 | 'publicNoTypeDocblockToDocblock' => ['[BC] CHANGED: Type documentation for property TheClass#$publicNoTypeDocblockToDocblock changed from having no type to int'], |
||
201 | 'publicDocblockToSameDocblock' => [], |
||
202 | 'publicDocblockToDifferentDocblock' => ['[BC] CHANGED: Type documentation for property TheClass#$publicDocblockToDifferentDocblock changed from int to float'], |
||
203 | 'publicDocblockToNoDocblock' => ['[BC] CHANGED: Type documentation for property TheClass#$publicDocblockToNoDocblock changed from int to having no type'], |
||
204 | 'publicCompositeTypeDocblockToSameTypeDocblock' => [], |
||
205 | 'publicCompositeTypeDocblockToSameTypeDocblockWithDifferentSorting' => [], |
||
206 | 'publicCompositeTypeDocblockToDifferentCompositeTypeDocblock' => ['[BC] CHANGED: Type documentation for property TheClass#$publicCompositeTypeDocblockToDifferentCompositeTypeDocblock changed from float|int to float|int|string'], |
||
207 | 'privateDocblockToDifferentDocblock' => ['[BC] CHANGED: Type documentation for property TheClass#$privateDocblockToDifferentDocblock changed from int to float'], |
||
208 | 'duplicatePropertyTypesBeingDeduplicatedAreNotBcBreaks' => [], |
||
209 | 'propertyTypeBeingDuplicatedAreNotBcBreaks' => [], |
||
210 | 'propertyWithComplexDocblockThatCannotBeParsed' => [], |
||
211 | ]; |
||
212 | |||
213 | return TypeRestriction::array(array_combine( |
||
214 | array_keys($properties), |
||
215 | array_map( |
||
216 | /** @psalm-param list<string> $errorMessages https://github.com/vimeo/psalm/issues/2772 */ |
||
217 | static function (string $property, array $errorMessages) use ($fromClass, $toClass) : array { |
||
218 | return [ |
||
219 | TypeRestriction::object($fromClass->getProperty($property)), |
||
220 | TypeRestriction::object($toClass->getProperty($property)), |
||
221 | $errorMessages, |
||
222 | ]; |
||
223 | }, |
||
224 | array_keys($properties), |
||
225 | $properties |
||
226 | ) |
||
230 |