Merge branch 'main' into fix-slash-in-enum-values

Author: kapersoft

.gitattributes

@@ -1,3 +1,10 @@
+# Fix line endings for Windows
+tempest text=auto eol=lf
+bin/* text=auto eol=lf
+packages/console/bin/tempest text=auto eol=lf
+packages/console/src/Installers/tempest text=auto eol=lf
+src/Tempest/Framework/Installers/tempest text=auto eol=lf
+
 # Exclude build/test files from the release
 /bin/                     export-ignore
 .github/                  export-ignore
@@ -15,5 +22,9 @@ rector.php                export-ignore
 cliff.toml                export-ignore
 .commitlintrc.json        export-ignore
 
-# Configure diff output for .php and .phar files.
+# Configure diff output
+*.view.php diff=html
 *.php diff=php
+*.css diff=css
+*.html diff=html
+*.md diff=markdown

packages/auth/.gitattributes

@@ -6,5 +6,9 @@ tests/                    export-ignore
 phpunit.xml               export-ignore
 README.md                 export-ignore
 
-# Configure diff output for .php and .phar files.
+# Configure diff output
+*.view.php diff=html
 *.php diff=php
+*.css diff=css
+*.html diff=html
+*.md diff=markdown

packages/cache/.gitattributes

@@ -6,5 +6,9 @@ tests/                    export-ignore
 phpunit.xml               export-ignore
 README.md                 export-ignore
 
-# Configure diff output for .php and .phar files.
-*.php diff=php
+# Configure diff output
+*.view.php diff=html
+*.php diff=php
+*.css diff=css
+*.html diff=html
+*.md diff=markdown

packages/clock/.gitattributes

@@ -6,5 +6,9 @@ tests/                    export-ignore
 phpunit.xml               export-ignore
 README.md                 export-ignore
 
-# Configure diff output for .php and .phar files.
-*.php diff=php
+# Configure diff output
+*.view.php diff=html
+*.php diff=php
+*.css diff=css
+*.html diff=html
+*.md diff=markdown

packages/command-bus/.gitattributes

@@ -6,5 +6,9 @@ tests/                    export-ignore
 phpunit.xml               export-ignore
 README.md                 export-ignore
 
-# Configure diff output for .php and .phar files.
-*.php diff=php
+# Configure diff output
+*.view.php diff=html
+*.php diff=php
+*.css diff=css
+*.html diff=html
+*.md diff=markdown

packages/console/.gitattributes

@@ -1,5 +1,18 @@
+# Fix line endings for Windows
+bin/tempest text=auto eol=lf
+src/Installers/tempest text=auto eol=lf
+
 # Exclude build/test files from the release
 .github/                  export-ignore
+tests/                    export-ignore
 .gitattributes            export-ignore
 .gitignore                export-ignore
+phpunit.xml               export-ignore
 README.md                 export-ignore
+
+# Configure diff output
+*.view.php diff=html
+*.php diff=php
+*.css diff=css
+*.html diff=html
+*.md diff=markdown

packages/console/src/Console.php

@@ -15,16 +15,34 @@ interface Console
 {
     public function call(string|array $command, string|array $arguments = []): ExitCode|int;
 
+    /**
+     * Reads a line from the console input.
+     */
     public function readln(): string;
 
+    /**
+     * Reads the specified number of bytes from the console input.
+     */
     public function read(int $bytes): string;
 
+    /**
+     * Writes the specified `$contents` to the console output.
+     */
     public function write(string $contents): self;
 
+    /**
+     * Writes the specified `$contents` to the console output and appends a new line.
+     */
     public function writeln(string $line = ''): self;
 
+    /**
+     * Writes the specified `$contents` to the console output, without formatting.
+     */
     public function writeRaw(string $contents): self;
 
+    /**
+     * Writes the specified `$contents` to the console output with the specified syntax highlighting.
+     */
     public function writeWithLanguage(string $contents, Language $language): self;
 
     /**
@@ -33,6 +51,8 @@ public function writeWithLanguage(string $contents, Language $language): self;
     public function component(InteractiveConsoleComponent $component, array $validation = []): mixed;
 
     /**
+     * Asks the user a question and returns the answer.
+     *
      * @param null|array|iterable|class-string<BackedEnum> $options
      * @param mixed|null $default
      * @param \Tempest\Validation\Rule[] $validation
@@ -48,48 +68,93 @@ public function ask(
         array $validation = [],
     ): null|int|string|Stringable|UnitEnum|array;
 
+    /**
+     * Asks the user a question and returns the answer.
+     */
     public function confirm(string $question, bool $default = false, ?string $yes = null, ?string $no = null): bool;
 
+    /**
+     * Prompts the user for a password and returns it.
+     */
     public function password(string $label = 'Password', bool $confirm = false, array $validation = []): ?string;
 
+    /**
+     * Progresses through the specified `$data` using the specified `$handler`.
+     */
     public function progressBar(iterable $data, Closure $handler): array;
 
     /**
+     * Asks the user to select an option from a list using a closure.
+     *
      * @param Closure(string $search): array $search
      */
     public function search(string $label, Closure $search, bool $multiple = false, null|string|array $default = null): mixed;
 
+    /**
+     * Displays the progress of a task.
+     */
     public function task(string $label, null|Process|Closure $handler): bool;
 
+    /**
+     * Displays a header.
+     */
     public function header(string $header, ?string $subheader = null): self;
 
+    /**
+     * Displays information to the user.
+     */
     public function info(string $contents, ?string $title = null): self;
 
+    /**
+     * Displays an error message to the user.
+     */
     public function error(string $contents, ?string $title = null): self;
 
+    /**
+     * Displays a warning to the user.
+     */
     public function warning(string $contents, ?string $title = null): self;
 
+    /**
+     * Displays a success message to the user.
+     */
     public function success(string $contents, ?string $title = null): self;
 
+    /**
+     * Displays a key/value pair in a line.
+     */
     public function keyValue(string $key, ?string $value = null, bool $useAvailableWidth = false): self;
 
+    /**
+     * Displays instructions to the user. Can be an array of lines.
+     */
     public function instructions(array|string $lines): self;
 
     /**
+     * Applies the specified `$callback` when the `$condition` is `true`.
+     *
      * @param mixed|Closure(self): bool $condition
      * @param Closure(self): self $callback
      */
     public function when(mixed $condition, Closure $callback): self;
 
     /**
+     * Applies the specified `$callback` unless the `$condition` is `true`.
+     *
      * @param mixed|Closure(self): bool $condition
      * @param Closure(self): self $callback
      */
     public function unless(mixed $condition, Closure $callback): self;
 
     public function withLabel(string $label): self;
 
+    /**
+     * Whether the console is interactive.
+     */
     public function supportsPrompting(): bool;
 
+    /**
+     * Forces the console to not be interactive.
+     */
     public function disablePrompting(): self;
 }

packages/console/src/Exceptions/UnknownArgumentsException.php

@@ -0,0 +1,30 @@
+<?php
+
+namespace Tempest\Console\Exceptions;
+
+use Tempest\Console\Console;
+use Tempest\Console\ConsoleCommand;
+use Tempest\Console\Input\ConsoleInputArgument;
+use Tempest\Support\Arr\ImmutableArray;
+
+final class UnknownArgumentsException extends ConsoleException
+{
+    public function __construct(
+        private readonly ConsoleCommand $consoleCommand,
+        /** @var \Tempest\Console\Input\ConsoleInputArgument[] $invalidArguments */
+        private readonly ImmutableArray $invalidArguments,
+    ) {}
+
+    public function render(Console $console): void
+    {
+        $console->error(sprintf(
+            'Unknown arguments: %s',
+            $this->invalidArguments
+                ->map(fn (ConsoleInputArgument $argument) => sprintf(
+                    '<code>%s</code>',
+                    $argument->name,
+                ))
+                ->implode(', '),
+        ));
+    }
+}

packages/console/src/GenericConsole.php

@@ -310,7 +310,7 @@ public function supportsPrompting(): bool
             return false;
         }
 
-        if ($this->argumentBag->get('interaction')?->value === false) {
+        if ($this->argumentBag->get(GlobalFlags::INTERACTION->value)?->value === false) {
             return false;
         }
 

packages/console/src/GlobalFlags.php

@@ -0,0 +1,16 @@
+<?php
+
+namespace Tempest\Console;
+
+use Tempest\Support\IsEnumHelper;
+
+enum GlobalFlags: string
+{
+    use IsEnumHelper;
+
+    case FORCE = 'force';
+    case FORCE_SHORTHAND = '-f';
+    case HELP = 'help';
+    case HELP_SHORTHAND = '-h';
+    case INTERACTION = 'interaction';
+}