Removes the deprecated create and overwrite options

Author: raphaelstolt

CHANGELOG.md

@@ -10,12 +10,13 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
 ## [v6.0.0] - 2026-06-XX
 
 ### Added
-- Expanded the `validation` to also validate __negated__ export-ignore directives. Closes [#70](https://github.com/raphaelstolt/lean-package-validator/issues/70).
+- Expanded the `validation` to also validate _negated_ export-ignore directives. Closes [#70](https://github.com/raphaelstolt/lean-package-validator/issues/70).
 - New `--flavour` option for the `create` command which influences the `.gitattributes` file generation. Closes [#71](https://github.com/raphaelstolt/lean-package-validator/issues/71).
-- Expanded the `reformatting` to also reformat __negated__ export-ignore directives. Closes [#72](https://github.com/raphaelstolt/lean-package-validator/issues/72).
+- Expanded the `reformatting` to also reformat _negated_ export-ignore directives. Closes [#72](https://github.com/raphaelstolt/lean-package-validator/issues/72).
 
 ### Removed
 - Removed the explicit `--agentic-run` option as agent detection is now done automatically per default.
+- Removed the `--create` and `--overwrite` options of the validate command. Closes [#68](https://github.com/raphaelstolt/lean-package-validator/issues/68).
 
 ## [v5.9.1] - 2026-05-17
 

README.md

@@ -75,7 +75,7 @@ Run the lean package validator CLI within or against a project/micro-package
 directory, and it will validate the [export-ignore](https://git-scm.com/book/en/v2/Customizing-Git-Git-Attributes#Exporting-Your-Repository) entries present in
 a `.gitattributes` file against a set of common repository artefacts.
 
-It can handle __"normal"__ export-ignore directives as well as __negated__ export-ignore directives.
+It can handle _classic_ export-ignore directives as well as _negated_ export-ignore directives.
 
 If no `.gitattributes` file is present it will suggest creating one.
 
@@ -92,23 +92,6 @@ file and fail validation if the order differs. Per __default__ the order compari
 lean-package-validator validate --enforce-strict-order [<directory>]
 ```
 
-The `--create|-c` option creates an `.gitattributes` file if nonexistent.
-
-``` bash
-lean-package-validator validate --create [<directory>]
-```
-
-The `--overwrite|-o` option overwrites an existing `.gitattributes` file when
-there are any `export-ignore` entries missing. Using this option on a directory
-with a nonexistent `.gitattributes` file implicates the `--create` option.
-
-``` bash
-lean-package-validator validate --overwrite [<directory>]
-```
-> [!WARNING]
-> As of release `v5.0` the `--create` and `--overwrite` options are deprecated and will be removed in the next major 
-> release. Please migrate to the dedicated commands `create` and `update`.
-
 The `--glob-pattern` option allows you to overwrite the default pattern used to match common repository artefacts. The
 number of patterns in the grouping braces is expected to be `>1`. As shown next, this utility could thereby also be used
 for projects (i.e. Python) outside the PHP ecosystem.
@@ -148,24 +131,18 @@ The `--keep-glob-pattern` option allows keeping matching files in the release/di
 lean-package-validator validate --keep-glob-pattern '{LICENSE.*,README.*,docs*}' [<directory>]
 ```
 
-The `--align-export-ignores|-a` option will align the created or overwritten export-ignores for better readability.
-
-``` bash
-lean-package-validator validate --align-export-ignores --create [<directory>]
-```
-
 The `--sort-from-directories-to-files|-s` option will order the export-ignores from directories to files for better readability.
 
 ``` bash
-lean-package-validator validate --sort-from-directories-to-files --create [<directory>]
+lean-package-validator validate --sort-from-directories-to-files [<directory>]
 ```
 
 The `--enforce-alignment` option will enforce a strict alignment of export-ignores
 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 `--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 artefacts slip
 into the release/dist archive file. It will do so by creating a `temporary archive` from the
@@ -198,8 +175,8 @@ Would expect the following .gitattributes file content:
  bin/release-version export-ignore
 ```
 
-The `--report-stale-export-ignores` option extends the validation to look for export-ignore statements referencing non-existent
-repository artefacts. In combination with the `--diff` option these will be shown in the output.
+The `--report-stale-export-ignores` option extends the validation to look for export-ignore statements referencing 
+non-existent repository artefacts. In combination with the `--diff` option these will be shown in the output.
 
 The `--stdin-input` option allows the validate command to read from `STDIN`, so that the following piped output 
 can be used for validation. It currently only does a strict comparison.
@@ -212,14 +189,12 @@ cat .gitattributes | lean-package-validator validate --stdin-input
 
 #### Create command
 
-The `create` command will create a `.gitattributes` file in the given directory. This command replaces the `--create` 
-option of the `validate` command. Please migrate to the dedicated commands.
+The `create` command will create a `.gitattributes` file in the given directory.
 
 #### Update command
 
-The `update` command will update a present `.gitattributes` file in the given directory. This command replaces the `--overwrite`
-option of the `validate` command. Please migrate to the dedicated commands. Like the above-mentioned `create` command it 
-provides a `--dry-run` option to see what the `.gitattributes` content would look like.
+The `update` command will update a present `.gitattributes` file in the given directory. Like the above-mentioned `create` 
+command it provides a `--dry-run` option to see what the `.gitattributes` content would look like.
 
 #### Reformat command
 

src/Commands/Concerns/GeneratesGitattributesOptions.php

@@ -46,7 +46,7 @@ protected function addGenerationOptions(callable $addOption): void
     /**
      * Apply generation-related options to the analyser.
      */
-    protected function applyGenerationOptions(InputInterface $input, OutputInterface $output, AbstractExportIgnoreAnalyser $analyser): bool
+    protected function applyGenerationOptions(InputInterface $input, OutputInterface $output, AbstractExportIgnoreAnalyser $analyser, string $commandName): bool
     {
         $globPattern = $input->getOption('glob-pattern');
         $globPatternFile = (string) $input->getOption('glob-pattern-file');
@@ -56,7 +56,12 @@ protected function applyGenerationOptions(InputInterface $input, OutputInterface
         $keepReadme = (bool) $input->getOption('keep-readme');
         $keepGlobPattern = (string) ($input->getOption('keep-glob-pattern') ?? '');
 
-        $alignExportIgnores = (bool) $input->getOption('align-export-ignores');
+        $alignExportIgnores = false;
+
+        if ($commandName !== 'validate') {
+            $alignExportIgnores = (bool) $input->getOption('align-export-ignores');
+        }
+
         $sortFromDirectoriesToFiles = (bool) $input->getOption('sort-from-directories-to-files');
         $enforceStrictOrderComparison = (bool) $input->getOption('enforce-strict-order');
 

src/Commands/CreateCommand.php

@@ -77,7 +77,7 @@ protected function execute(InputInterface $input, OutputInterface $output): int
         }
 
         // Apply options that influence generation
-        if (!$this->applyGenerationOptions($input, $output, $this->analyser->getActualExportIgnoreAnalyser())) {
+        if (!$this->applyGenerationOptions($input, $output, $this->analyser->getActualExportIgnoreAnalyser(), $this->getName())) {
             return self::FAILURE;
         }
 

src/Commands/UpdateCommand.php

@@ -82,7 +82,7 @@ protected function execute(InputInterface $input, OutputInterface $output): int
         }
 
         // Apply options that influence generation
-        if (!$this->applyGenerationOptions($input, $output, $this->exportIgnoreAnalyser)) {
+        if (!$this->applyGenerationOptions($input, $output, $this->exportIgnoreAnalyser, $this->getName())) {
             return self::FAILURE;
         }