FixerFactory.php 6.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235
  1. <?php
  2. declare(strict_types=1);
  3. /*
  4. * This file is part of PHP CS Fixer.
  5. *
  6. * (c) Fabien Potencier <fabien@symfony.com>
  7. * Dariusz Rumiński <dariusz.ruminski@gmail.com>
  8. *
  9. * This source file is subject to the MIT license that is bundled
  10. * with this source code in the file LICENSE.
  11. */
  12. namespace PhpCsFixer;
  13. use App\Fixers\TypeAnnotationsOnlyFixer;
  14. use PhpCsFixer\ConfigurationException\InvalidFixerConfigurationException;
  15. use PhpCsFixer\Fixer\ConfigurableFixerInterface;
  16. use PhpCsFixer\Fixer\FixerInterface;
  17. use PhpCsFixer\Fixer\WhitespacesAwareFixerInterface;
  18. use PhpCsFixer\RuleSet\RuleSetInterface;
  19. use Symfony\Component\Finder\Finder as SymfonyFinder;
  20. use Symfony\Component\Finder\SplFileInfo;
  21. /**
  22. * This overrides the default "FixerFactory" to register
  23. * Pint's custom fixers alongside the built-in ones,
  24. * ensuring they are available in parallel worker processes.
  25. *
  26. * @internal
  27. */
  28. final class FixerFactory
  29. {
  30. private FixerNameValidator $nameValidator;
  31. /**
  32. * @var list<FixerInterface>
  33. */
  34. private array $fixers = [];
  35. /**
  36. * @var array<string, FixerInterface>
  37. */
  38. private array $fixersByName = [];
  39. public function __construct()
  40. {
  41. $this->nameValidator = new FixerNameValidator;
  42. }
  43. public function setWhitespacesConfig(WhitespacesFixerConfig $config): self
  44. {
  45. foreach ($this->fixers as $fixer) {
  46. if ($fixer instanceof WhitespacesAwareFixerInterface) {
  47. $fixer->setWhitespacesConfig($config);
  48. }
  49. }
  50. return $this;
  51. }
  52. /**
  53. * @return list<FixerInterface>
  54. */
  55. public function getFixers(): array
  56. {
  57. $this->fixers = Utils::sortFixers($this->fixers);
  58. return $this->fixers;
  59. }
  60. /**
  61. * @return $this
  62. */
  63. public function registerBuiltInFixers(): self
  64. {
  65. static $builtInFixers = null;
  66. if ($builtInFixers === null) {
  67. /** @var list<class-string<FixerInterface>> */
  68. $builtInFixers = [];
  69. $finder = SymfonyFinder::create()->files()
  70. ->in(dirname(__DIR__).'/vendor/friendsofphp/php-cs-fixer/src/Fixer')
  71. ->exclude(['Internal'])
  72. ->name('*Fixer.php')
  73. ->depth(1);
  74. /** @var SplFileInfo $file */
  75. foreach ($finder as $file) {
  76. $relativeNamespace = $file->getRelativePath();
  77. $fixerClass = 'PhpCsFixer\Fixer\\'.($relativeNamespace !== '' ? $relativeNamespace.'\\' : '').$file->getBasename('.php');
  78. $builtInFixers[] = $fixerClass;
  79. }
  80. }
  81. foreach ($builtInFixers as $class) {
  82. /** @var FixerInterface */
  83. $fixer = new $class;
  84. $this->registerFixer($fixer, false);
  85. }
  86. $this->registerCustomFixers([
  87. new TypeAnnotationsOnlyFixer,
  88. ]);
  89. return $this;
  90. }
  91. /**
  92. * @param iterable<FixerInterface> $fixers
  93. * @return $this
  94. */
  95. public function registerCustomFixers(iterable $fixers): self
  96. {
  97. foreach ($fixers as $fixer) {
  98. $this->registerFixer($fixer, true);
  99. }
  100. return $this;
  101. }
  102. /**
  103. * @return $this
  104. */
  105. public function registerFixer(FixerInterface $fixer, bool $isCustom): self
  106. {
  107. $name = $fixer->getName();
  108. if (isset($this->fixersByName[$name])) {
  109. throw new \UnexpectedValueException(\sprintf('Fixer named "%s" is already registered.', $name));
  110. }
  111. if (! $this->nameValidator->isValid($name, $isCustom)) {
  112. throw new \UnexpectedValueException(\sprintf('Fixer named "%s" has invalid name.', $name));
  113. }
  114. $this->fixers[] = $fixer;
  115. $this->fixersByName[$name] = $fixer;
  116. return $this;
  117. }
  118. /**
  119. * @return $this
  120. */
  121. public function useRuleSet(RuleSetInterface $ruleSet): self
  122. {
  123. $fixers = [];
  124. $fixersByName = [];
  125. $fixerConflicts = [];
  126. $fixerNames = array_keys($ruleSet->getRules());
  127. foreach ($fixerNames as $name) {
  128. if (! \array_key_exists($name, $this->fixersByName)) {
  129. throw new \UnexpectedValueException(\sprintf('Rule "%s" does not exist.', $name));
  130. }
  131. $fixer = $this->fixersByName[$name];
  132. $config = $ruleSet->getRuleConfiguration($name);
  133. if ($config !== null) {
  134. if ($fixer instanceof ConfigurableFixerInterface) {
  135. if (\count($config) < 1) {
  136. throw new InvalidFixerConfigurationException($fixer->getName(), 'Configuration must be an array and may not be empty.');
  137. }
  138. $fixer->configure($config);
  139. } else {
  140. throw new InvalidFixerConfigurationException($fixer->getName(), 'Is not configurable.');
  141. }
  142. }
  143. $fixers[] = $fixer;
  144. $fixersByName[$name] = $fixer;
  145. $conflicts = array_values(array_intersect($this->getFixersConflicts($fixer), $fixerNames));
  146. if (\count($conflicts) > 0) {
  147. $fixerConflicts[$name] = $conflicts;
  148. }
  149. }
  150. if (\count($fixerConflicts) > 0) {
  151. throw new \UnexpectedValueException($this->generateConflictMessage($fixerConflicts));
  152. }
  153. $this->fixers = $fixers;
  154. $this->fixersByName = $fixersByName;
  155. return $this;
  156. }
  157. public function hasRule(string $name): bool
  158. {
  159. return isset($this->fixersByName[$name]);
  160. }
  161. /**
  162. * @return list<string>
  163. */
  164. private function getFixersConflicts(FixerInterface $fixer): array
  165. {
  166. return [
  167. 'blank_lines_before_namespace' => [
  168. 'no_blank_lines_before_namespace',
  169. 'single_blank_line_before_namespace',
  170. ],
  171. 'no_blank_lines_before_namespace' => ['single_blank_line_before_namespace'],
  172. 'single_import_per_statement' => ['group_import'],
  173. ][$fixer->getName()] ?? [];
  174. }
  175. /**
  176. * @param array<string, list<string>> $fixerConflicts
  177. */
  178. private function generateConflictMessage(array $fixerConflicts): string
  179. {
  180. $message = 'Rule contains conflicting fixers:';
  181. $report = [];
  182. foreach ($fixerConflicts as $fixer => $fixers) {
  183. $report[$fixer] = array_values(array_filter(
  184. $fixers,
  185. static fn (string $candidate): bool => ! \array_key_exists($candidate, $report) || ! \in_array($fixer, $report[$candidate], true),
  186. ));
  187. if (\count($report[$fixer]) > 0) {
  188. $message .= \sprintf("\n- \"%s\" with %s", $fixer, Utils::naturalLanguageJoin($report[$fixer]));
  189. }
  190. }
  191. return $message;
  192. }
  193. }