FilterCommand refactored to (external) Filter

[petrknap]

• This pull request does not contain any breaking change.
• I asked the AI to briefly summarize, use and improve the feature(s), and I'm okay with the output:

Could you briefly summarize the following code for me?

final class Filter {
    /**
     * @param non-empty-string $command
     * @param array<non-empty-string> $options
     */
    public function __construct(
       private readonly string $command,
       private readonly array $options = [],
    ) {}
    /**
     * @throws Exception\FilterException
     */
    public function filter(string $input): string {/* ... */} }

Certainly! Here's a brief summary of the Filter class:

• Purpose: The Filter class encapsulates a command and its options for filtering input data.
• Constructor:
  • Takes a non-empty string command and an optional array of non-empty string options.
  • Initializes the command and options properties.
• Method:
  • filter(string $input): string
  • Intended to execute the command with the given input and return the filtered result.
  • May throw a FilterException if an error occurs during the filtering process.

The class structure helps manage command-line filtering processes efficiently by encapsulating the necessary command and options, and providing a method to perform the filtering.

If you need a deeper dive or further details on this, let me know! 🛠️💡

Could you show me how to use it?

Here’s an example demonstrating how to instantiate the Filter class and use its filter method:

// Example usage of the Filter class
try {
    // Define the command and options
    $command = 'grep';
    $options = ['-i', 'pattern']; // Case-insensitive search for 'pattern'
    $input = "This is a test input\nPattern matching line\nAnother line";

    // Create a new Filter object
    $filter = new Filter($command, $options);

    // Execute the filter with the given input
    $output = $filter->filter($input);

    echo "Filtered output:\n" . $output;
} catch (Exception\FilterException $e) {
    echo "An error occurred: " . $e->getMessage();
}

This example should help you get started with using the Filter class in your own projects. If you have any specific requirements or questions, feel free to ask! 🛠️📜

[petrknap]

Rename to better match Linux conventions, see https://www.geeksforgeeks.org/filters-in-linux/.