1	<?php
2
3	declare(strict_types=1);
4
5	/**
6	* Fast Forward Development Tools for PHP projects.
7	*
8	* This file is part of fast-forward/dev-tools project.
9	*
10	* @author   Felipe Sayão Lobato Abreu <github@mentordosnerds.com>
11	* @license  https://opensource.org/licenses/MIT MIT License
12	*
13	* @see      https://github.com/php-fast-forward/
14	* @see      https://github.com/php-fast-forward/dev-tools
15	* @see      https://github.com/php-fast-forward/dev-tools/issues
16	* @see      https://php-fast-forward.github.io/dev-tools/
17	* @see      https://datatracker.ietf.org/doc/html/rfc2119
18	*/
19
20	namespace FastForward\DevTools\Process;
21
22	use Symfony\Component\Console\Output\OutputInterface;
23	use Symfony\Component\Process\Process;
24
25	/**
26	* Configures subprocess environment variables before queued execution.
27	*/
28	interface ProcessEnvironmentConfiguratorInterface
29	{
30	/**
31	* Configures environment variables for a queued process.
32	*
33	* Implementations MUST preserve process-specific environment values that
34	* callers already configured before enqueueing the process.
35	*
36	* @param Process $process the queued process that will be started
37	* @param OutputInterface $output the parent output used to infer console capabilities
38	*/
39	public function configure(Process $process, OutputInterface $output): void;
40	}