Adds the --preset option to the validate command

Author: raphaelstolt

CHANGELOG.md

@@ -7,6 +7,11 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
 
 ## [Unreleased]
 
+## [v4.7.0] - 2025-08-29
+
+### Added
+- New `preset` option for the validate command. Closes [#53](https://github.com/raphaelstolt/lean-package-validator/issues/53).
+
 ## [v4.6.0] - 2025-08-27
 
 ### Added

README.md

@@ -147,6 +147,9 @@ The `--enforce-alignment` option will enforce a strict alignment of export-ignor
 in the `.gitattributes` file and fail validation if they aren't aligned. Per __default__
 no alignment is enforced.
 
+The `--preset=[<preset>]` option will use a predefined set of glob pattern.
+Available presets are `PHP`, `Python`, `Rust`, `JavaScript`, and `Go`. With `PHP` being the default.
+
 The `--validate-git-archive` option will validate that no common repository artifacts slip
 into the release/dist archive file. It will do so by creating a `temporary archive` from the
 current Git `HEAD` and inspecting its content. With a set `--keep-license` option a license

phpstan.neon.dist

@@ -19,3 +19,4 @@ parameters:
         - '#TMock#'
         - '#unknown class#'
         - '#set_error_handler expects#'
+        - '#getPresetByLanguageName#'

src/Analyser.php

@@ -2,10 +2,10 @@
 
 namespace Stolt\LeanPackage;
 
-use PHPStan\Type\Php\DateIntervalDynamicReturnTypeExtension;
 use Stolt\LeanPackage\Exceptions\InvalidGlobPattern;
 use Stolt\LeanPackage\Exceptions\InvalidGlobPatternFile;
 use Stolt\LeanPackage\Exceptions\NonExistentGlobPatternFile;
+use Stolt\LeanPackage\Exceptions\PresetNotAvailable;
 use Stolt\LeanPackage\Presets\Finder;
 
 class Analyser
@@ -47,7 +47,7 @@ class Analyser
     private string $globPattern;
 
     /**
-     * The preferred end of line sequence
+     * The preferred end-of-line sequence
      *
      * @var string
      */
@@ -128,7 +128,7 @@ class Analyser
     private string $keepGlobPattern = '';
 
     /**
-     * Whether to align the export-ignores on create or overwrite
+     * Whether to align the export-ignores on creation or overwrite
      * or not.
      *
      * @var boolean
@@ -961,8 +961,9 @@ public function hasCompleteExportIgnores(): bool
 
         $actualExportIgnores = $this->getPresentExportIgnores();
 
+        $staleExportIgnores = [];
+
         if ($this->isStaleExportIgnoresComparisonEnabled()) {
-            $staleExportIgnores = [];
             $unfilteredExportIgnores = $this->getPresentExportIgnores(false);
             foreach ($unfilteredExportIgnores as $unfilteredExportIgnore) {
                 if (false === \file_exists($unfilteredExportIgnore)) {
@@ -983,4 +984,12 @@ public function hasCompleteExportIgnores(): bool
 
         return \array_values($expectedExportIgnores) === \array_values($actualExportIgnores);
     }
+
+    /**
+     * @throws PresetNotAvailable
+     */
+    public function setGlobPatternFromPreset(string $preset): void
+    {
+        $this->globPattern = '{' . \implode(',', $this->finder->getPresetGlobByLanguageName($preset)) . '}*';
+    }
 }

src/Commands/ValidateCommand.php

@@ -17,6 +17,7 @@
 use Stolt\LeanPackage\Exceptions\InvalidGlobPatternFile;
 use Stolt\LeanPackage\Exceptions\NoLicenseFilePresent;
 use Stolt\LeanPackage\Exceptions\NonExistentGlobPatternFile;
+use Stolt\LeanPackage\Exceptions\PresetNotAvailable;
 use Stolt\LeanPackage\Helpers\InputReader;
 use Symfony\Component\Console\Command\Command;
 use Symfony\Component\Console\Input\InputArgument;
@@ -33,6 +34,8 @@ final class ValidateCommand extends Command
      */
     protected string $defaultLpvFile = WORKING_DIRECTORY . DIRECTORY_SEPARATOR . '.lpv';
 
+    protected string $defaultPreset = 'Php';
+
     /**
      * Package analyser.
      *
@@ -108,6 +111,7 @@ protected function configure(): void
             . 'export-ignored';
         $globPatternFileDescription = 'Use this file with glob patterns '
             . 'to match artifacts which should be export-ignored';
+        $presetDescription = 'Use the glob pattern of the given language preset';
 
         $keepLicenseDescription = 'Do not export-ignore the license file';
         $keepReadmeDescription = 'Do not export-ignore the README file';
@@ -152,6 +156,13 @@ protected function configure(): void
             $globPatternFileDescription,
             $this->defaultLpvFile
         );
+        $this->addOption(
+            'preset',
+            null,
+            InputOption::VALUE_OPTIONAL,
+            $presetDescription,
+            $this->defaultPreset
+        );
         $this->addOption(
             'keep-license',
             null,
@@ -216,6 +227,7 @@ protected function configure(): void
     protected function execute(InputInterface $input, OutputInterface $output): int
     {
         $directory = (string) $input->getArgument('directory');
+        $chosenPreset = (string) $input->getOption('preset');
 
         if ($directory !== WORKING_DIRECTORY) {
             try {
@@ -380,6 +392,7 @@ protected function execute(InputInterface $input, OutputInterface $output): int
 
                     $this->analyser->setGlobPatternFromFile($globPatternFile);
                 }
+
             } catch (NonExistentGlobPatternFile $e) {
                 $warning = "Warning: The provided glob pattern file "
                     . "'$globPatternFile' doesn't exist.";
@@ -397,6 +410,20 @@ protected function execute(InputInterface $input, OutputInterface $output): int
 
                 $output->writeln($e->getMessage(), OutputInterface::VERBOSITY_DEBUG);
 
+                return Command::FAILURE;
+            }
+        } elseif ($chosenPreset) {
+            try {
+
+                $verboseOutput = '+ Using the ' . $chosenPreset . ' language preset.';
+                $output->writeln($verboseOutput, OutputInterface::VERBOSITY_VERBOSE);
+
+                $this->analyser->setGlobPatternFromPreset($chosenPreset);
+            } catch (PresetNotAvailable $e) {
+                $warning = 'Warning: The chosen language preset ' . $chosenPreset . ' is not available. Maybe contribute it?.';
+                $outputContent = '<error>' . $warning . '</error>';
+                $output->writeln($outputContent);
+
                 return Command::FAILURE;
             }
         }
@@ -456,7 +483,7 @@ protected function execute(InputInterface $input, OutputInterface $output): int
                 . 'content.</info>';
             $output->writeln($outputContent);
 
-            return 1;
+            return Command::FAILURE;
         } elseif ($validateArchive) {
             try {
                 $verboseOutput = '+ Validating Git archive.';

src/Presets/Finder.php

@@ -47,6 +47,18 @@ public function getAvailablePresets(): array
      * @return array
      */
     public function getPresetGlobByLanguageName(string $name): array
+    {
+        $preset = $this->getPresetByLanguageName($name);
+
+        return $preset->getPresetGlob();
+    }
+
+    /**
+     * @param string $name
+     * @throws PresetNotAvailable
+     * @return Preset
+     */
+    public function getPresetByLanguageName(string $name): Preset
     {
         $name = \ucfirst(\strtolower($name));
 
@@ -57,10 +69,7 @@ public function getPresetGlobByLanguageName(string $name): array
 
         $presetClassName = \sprintf('Stolt\LeanPackage\Presets\%sPreset', $name);
 
-        /** @var Preset $preset **/
-        $preset = new $presetClassName();
-
-        return $preset->getPresetGlob();
+        return new $presetClassName();
     }
 
     /**

tests/Commands/ValidateCommandTest.php

@@ -17,6 +17,7 @@
 use Stolt\LeanPackage\Archive;
 use Stolt\LeanPackage\Archive\Validator;
 use Stolt\LeanPackage\Commands\ValidateCommand;
+use Stolt\LeanPackage\Exceptions\InvalidGlobPattern;
 use Stolt\LeanPackage\Exceptions\NoLicenseFilePresent;
 use Stolt\LeanPackage\Helpers\Str as OsHelper;
 use Stolt\LeanPackage\Presets\Finder;
@@ -34,7 +35,7 @@ class ValidateCommandTest extends TestCase
     use InteractsWithConsole;
 
     /**
-     * Set up test environment.
+     * Set up a test environment.
      */
     protected function setUp(): void
     {
@@ -53,7 +54,7 @@ protected function setUp(): void
     }
 
     /**
-     * Tear down test environment.
+     * Tear down the test environment.
      *
      * @return void
      */
@@ -195,9 +196,10 @@ public function showsDifferenceBetweenActualAndExpectedGitattributesContent(): v
     #[Test]
     public function filesInGlobalGitignoreAreExportIgnored(): void
     {
-        $analyserMock = Mockery::mock(Analyser::class)->makePartial();
-
         $globPattern = '{' . \implode(',', (new PhpPreset())->getPresetGlob()) . '}*';
+
+        $analyserMock = Mockery::mock(Analyser::class, [new Finder(new PhpPreset())])->makePartial();
+
         $analyserMock->setGlobPattern($globPattern);
 
         $application = $this->getApplicationWithMockedAnalyser($analyserMock);
@@ -265,7 +267,7 @@ public function filesInGlobalGitignoreAreExportIgnored(): void
     #[Ticket('https://github.com/raphaelstolt/lean-package-validator/issues/16')]
     public function gitattributesFileWithNoExportIgnoresContentShowsExpectedContent(): void
     {
-        $analyserMock = Mockery::mock(Analyser::class)->makePartial();
+        $analyserMock = Mockery::mock(Analyser::class, [new Finder(new PhpPreset())])->makePartial();
 
         $globPattern = '{' . \implode(',', (new PhpPreset())->getPresetGlob()) . '}*';
         $analyserMock->setGlobPattern($globPattern);
@@ -1302,10 +1304,13 @@ public function nonLeanArchiveIsNotConsideredLeanSingular(): void
         $this->assertTrue($commandTester->getStatusCode() > Command::SUCCESS);
     }
 
+    /**
+     * @throws InvalidGlobPattern
+     */
     #[Test]
     public function impossibilityToResolveExpectedGitattributesFileContentIsInfoed(): void
     {
-        $mock = Mockery::mock(Analyser::class)->makePartial();
+        $mock = Mockery::mock(Analyser::class, [new Finder(new PhpPreset())])->makePartial();
 
         $globPattern = '{' . \implode(',', (new PhpPreset())->getPresetGlob()) . '}*';
         $mock->setGlobPattern($globPattern);
@@ -2283,6 +2288,51 @@ public function detectsValidGitattributeContentInStdinInput(): void
             ->assertSuccessful();
     }
 
+    #[Test]
+    #[RunInSeparateProcess]
+    public function usesTheRustPresetIfRequested(): void
+    {
+        $artifactFilenames = [
+            'CODE_OF_CONDUCT.md',
+            '.rustfmt.toml',
+            '.clippy.toml',
+            'LICENSE.md',
+        ];
+
+        $this->createTemporaryFiles(
+            $artifactFilenames,
+            ['src']
+        );
+
+        $gitattributesContent = <<<CONTENT
+*    text=auto eol=lf
+
+.clippy.toml export-ignore
+.gitattributes export-ignore
+.rustfmt.toml export-ignore
+CODE_OF_CONDUCT.md export-ignore
+LICENSE.md export-ignore
+CONTENT;
+
+        $expectedDisplay = <<<CONTENT
+The present .gitattributes file is considered valid.
+
+CONTENT;
+
+        $this->createTemporaryGitattributesFile($gitattributesContent);
+
+        $command = $this->application->find('validate');
+        $commandTester = new CommandTester($command);
+        $commandTester->execute([
+            'command' => $command->getName(),
+            'directory' => WORKING_DIRECTORY,
+            '--preset' => 'Rust',
+        ]);
+
+        $this->assertSame($expectedDisplay, $commandTester->getDisplay());
+        $commandTester->assertCommandIsSuccessful();
+    }
+
     /**
      * @return array
      */