SiteProcess::setWorkingDirectoryLocal() - Code Metrics - Inspection of "Less setWorkingDirectory()" - consolidation/site-process - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Pull Request — master (#25)

by Moshe

created 2019-02-15 12:32 UTC

SiteProcess::setWorkingDirectoryLocal() A

↳ Parent: SiteProcess

Complexity

Conditions	1
Paths	1

Size

Total Lines

Duplication

Lines	0
Ratio	0 %

Importance

Changes

Metric	Value
dl	0
loc	3
rs	10
c	0
b	0
f	0
cc	1
nc	1
nop	1

<?php
namespace Consolidation\SiteProcess;

use Consolidation\SiteAlias\AliasRecord;
use Consolidation\SiteProcess\Transport\DockerComposeTransport;
use Consolidation\SiteProcess\Util\ArgumentProcessor;
use Consolidation\SiteProcess\Transport\LocalTransport;
use Consolidation\SiteProcess\Transport\SshTransport;
use Consolidation\SiteProcess\Transport\TransportInterface;
use Consolidation\Config\Util\Interpolator;
use Consolidation\SiteProcess\Util\ShellOperatorInterface;
use Consolidation\SiteProcess\Util\Escape;

/**
 * A wrapper around Symfony Process that uses site aliases
 * (https://github.com/consolidation/site-alias)
 *
 * - Interpolate arguments using values from the alias
 *   e.g. `$process = new SiteProcess($alias, ['git', '-C', '{{root}}']);`
 * - Make remote calls via ssh as if they were local.
 */
class SiteProcess extends ProcessBase
{
    /** @var AliasRecord */
    protected $siteAlias;
    /** @var string[] */
    protected $args;
    /** @var string[] */
    protected $options;
    /** @var string[] */
    protected $optionsPassedAsArgs;
    /** @var string */
    protected $cd_remote;
    /** @var TransportInterface */
    protected $transport;

    /**
     * Process arguments and options per the site alias and build the
     * actual command to run.
     */
    public function __construct(AliasRecord $siteAlias, TransportInterface $transport, $args, $options = [], $optionsPassedAsArgs = [])
    {
        $this->siteAlias = $siteAlias;
        $this->transport = $transport;
        $this->args = $args;
        $this->options = $options;
        $this->optionsPassedAsArgs = $optionsPassedAsArgs;

        parent::__construct([]);
    }

    /**
     * Get a starting directory for the remote process.
     *
     * @return string|null
     */
    public function getWorkingDirectory() {
        return $this->cd_remote;
    }

    /**
     * Set a starting directory for the remote process.
     *
     * @param string $cd_remote
     *
     * @return \Consolidation\SiteProcess\SiteProcess
     */
    public function setWorkingDirectory($cd_remote) {
        $this->cd_remote = $cd_remote;
        return $this;
    }

    /**
     * Set a starting directory for the initial/local process.
     *
     * @param string $cd
     *
     * @return \Consolidation\SiteProcess\SiteProcess
     */
    public function setWorkingDirectoryLocal($cd) {
        return parent::setWorkingDirectory($cd);
class Daddy
{
    protected function getFirstName()
    {
        return "Eidur";
    }

    protected function getSurName()
    {
        return "Gudjohnsen";
    }
}

class Son
{
    public function getFirstName()
    {
        return parent::getSurname();
    }
}
    }

    /**
     * Get the starting directory for the initial/local process.
     *
     * @return string|null;

     */
    public function getWorkingDirectoryLocal() {
        return parent::getWorkingDirectory();
class Daddy
{
    protected function getFirstName()
    {
        return "Eidur";
    }

    protected function getSurName()
    {
        return "Gudjohnsen";
    }
}

class Son
{
    public function getFirstName()
    {
        return parent::getSurname();
    }
}
    }

    /**
     *
     * @param bool $shouldUseSiteRoot
     * @return $this|\Symfony\Component\Process\Process
     * @throws \Exception
     */
    public function chdirToSiteRoot($shouldUseSiteRoot = true)
    {
        if (!$shouldUseSiteRoot || !$this->siteAlias->hasRoot()) {
            return $this;
        }

        return $this->setWorkingDirectory($this->siteAlias->root());
    }

    /**
     * Take all of our individual arguments and process them for use.
     */
    protected function processArgs()
    {
        $transport = $this->getTransport($this->siteAlias);
        $transport->configure($this);

        $processor = new ArgumentProcessor();
        $selectedArgs = $processor->selectArgs(
            $this->siteAlias,
            $this->args,
            $this->options,
            $this->optionsPassedAsArgs
        );

        // Ask the transport to drop in a 'cd' if needed.
        if ($this->getWorkingDirectory()) {
''   == false // true
''   == null  // true
'ab' == false // false
'ab' == null  // false

// It is often better to use strict comparison
'' === false // false
'' === null  // false
            $selectedArgs = $transport->addChdir($this->getWorkingDirectory(), $selectedArgs);
        }

        // Do any necessary interpolation on the selected arguments.
        $processedArgs = $this->interpolate($selectedArgs);

        // Wrap the command with 'ssh' or some other transport if this is
        // a remote command; otherwise, leave it as-is.
        return $transport->wrap($processedArgs);
    }

    public function setTransport($transport)
    {
        $this->transport = $transport;
    }

    /**
     * Ask the transport manager for the correct transport for the
     * provided alias.
     */
    protected function getTransport(AliasRecord $siteAlias)

    {
        return $this->transport;
    }

    /**
     * @inheritDoc
     */
    public function getCommandLine()
    {
        $commandLine = parent::getCommandLine();
        if (empty($commandLine)) {
            $processedArgs = $this->processArgs();
            $commandLine = Escape::argsForSite($this->siteAlias, $processedArgs);
            $commandLine = implode(' ', $commandLine);
            $this->setCommandLine($commandLine);
        }
        return $commandLine;
    }

    /**
     * @inheritDoc
     */
    public function start(callable $callback = null, $env = array())
    {
        $cmd = $this->getCommandLine();
$myVar = 'Value';
$higher = false;

if (rand(1, 6) > 3) {
    $higher = true;
} else {
    $higher = false;
}
        parent::start($callback, $env);
    }

    /**
     * @inheritDoc
     */
    public function wait(callable $callback = null)
    {
        $return = parent::wait($callback);
        return $return;
    }

    /**
     * interpolate examines each of the arguments in the provided argument list
     * and replaces any token found therein with the value for that key as
     * pulled from the given site alias.
     *
     * Example: "git -C {{root}} status"
     *
     * The token "{{root}}" will be converted to a value via $siteAlias->get('root').
     * The result will replace the token.
     *
     * It is possible to use dot notation in the keys to access nested elements
     * within the site alias record.
     *
     * @param AliasRecord $siteAlias
/**
 * @param array $germany
 * @param array $island
 * @param array $italy
 */
function finale($germany, $island) {
    return "2:1";
}
     * @param type $args
     * @return type
     */
    protected function interpolate($args)
    {
        $interpolator = new Interpolator();
        return array_map(
            function ($arg) use ($interpolator) {
                if ($arg instanceof ShellOperatorInterface) {
                    return $arg;
                }
                return $interpolator->interpolate($this->siteAlias, $arg, false);
            },
            $args
        );
    }
}


1			<?php
2			namespace Consolidation\SiteProcess;
3
4			use Consolidation\SiteAlias\AliasRecord;
5			use Consolidation\SiteProcess\Transport\DockerComposeTransport;
6			use Consolidation\SiteProcess\Util\ArgumentProcessor;
7			use Consolidation\SiteProcess\Transport\LocalTransport;
8			use Consolidation\SiteProcess\Transport\SshTransport;
9			use Consolidation\SiteProcess\Transport\TransportInterface;
10			use Consolidation\Config\Util\Interpolator;
11			use Consolidation\SiteProcess\Util\ShellOperatorInterface;
12			use Consolidation\SiteProcess\Util\Escape;
13
14			/**
15			* A wrapper around Symfony Process that uses site aliases
16			* (https://github.com/consolidation/site-alias)
17			*
18			* - Interpolate arguments using values from the alias
19			* e.g. `$process = new SiteProcess($alias, ['git', '-C', '{{root}}']);`
20			* - Make remote calls via ssh as if they were local.
21			*/
22			class SiteProcess extends ProcessBase
23			{
24			/** @var AliasRecord */
25			protected $siteAlias;
26			/** @var string[] */
27			protected $args;
28			/** @var string[] */
29			protected $options;
30			/** @var string[] */
31			protected $optionsPassedAsArgs;
32			/** @var string */
33			protected $cd_remote;
34			/** @var TransportInterface */
35			protected $transport;
36
37			/**
38			* Process arguments and options per the site alias and build the
39			* actual command to run.
40			*/
41			public function __construct(AliasRecord $siteAlias, TransportInterface $transport, $args, $options = [], $optionsPassedAsArgs = [])
42			{
43			$this->siteAlias = $siteAlias;
44			$this->transport = $transport;
45			$this->args = $args;
46			$this->options = $options;
47			$this->optionsPassedAsArgs = $optionsPassedAsArgs;
48
49			parent::__construct([]);
50			}
51
52			/**
53			* Get a starting directory for the remote process.
54			*
55			* @return string\|null
56			*/
57			public function getWorkingDirectory() {
58			return $this->cd_remote;
59			}
60
61			/**
62			* Set a starting directory for the remote process.
63			*
64			* @param string $cd_remote
65			*
66			* @return \Consolidation\SiteProcess\SiteProcess
67			*/
68			public function setWorkingDirectory($cd_remote) {
69			$this->cd_remote = $cd_remote;
70			return $this;
71			}
72
73			/**
74			* Set a starting directory for the initial/local process.
75			*
76			* @param string $cd
77			*
78			* @return \Consolidation\SiteProcess\SiteProcess
79			*/
80			public function setWorkingDirectoryLocal($cd) {
81			return parent::setWorkingDirectory($cd);
			0 ignored issues – show Comprehensibility Bug introduced 2019-02-15 12:34 UTC by Report Bug Copy Issue Report It seems like you call parent on a different method (`setWorkingDirectory()` instead of `setWorkingDirectoryLocal()`). Are you sure this is correct? If so, you might want to change this to `$this->setWorkingDirectory()`. This check looks for a call to a parent method whose name is different than the method from which it is called. Consider the following code: class Daddy { protected function getFirstName() { return "Eidur"; } protected function getSurName() { return "Gudjohnsen"; } } class Son { public function getFirstName() { return parent::getSurname(); } } The `getFirstName()` method in the `Son` calls the wrong method in the parent class. Loading history...
82			}
83
84			/**
85			* Get the starting directory for the initial/local process.
86			*
87			* @return string\|null;
			0 ignored issues – show Documentation introduced 2019-02-15 12:34 UTC by Report Bug Copy Issue Report The doc-type `string\|null;` could not be parsed: Expected "\|" or "end of type", but got ";" at position 11. (view supported doc-types) This check marks PHPDoc comments that could not be parsed by our parser. To see which comment annotations we can parse, please refer to our documentation on supported doc-types. Loading history...
88			*/
89			public function getWorkingDirectoryLocal() {
90			return parent::getWorkingDirectory();
			0 ignored issues – show Comprehensibility Bug introduced 2019-02-15 12:34 UTC by Report Bug Copy Issue Report It seems like you call parent on a different method (`getWorkingDirectory()` instead of `getWorkingDirectoryLocal()`). Are you sure this is correct? If so, you might want to change this to `$this->getWorkingDirectory()`. This check looks for a call to a parent method whose name is different than the method from which it is called. Consider the following code: class Daddy { protected function getFirstName() { return "Eidur"; } protected function getSurName() { return "Gudjohnsen"; } } class Son { public function getFirstName() { return parent::getSurname(); } } The `getFirstName()` method in the `Son` calls the wrong method in the parent class. Loading history...
91			}
92
93			/**
94			*
95			* @param bool $shouldUseSiteRoot
96			* @return $this\|\Symfony\Component\Process\Process
97			* @throws \Exception
98			*/
99			public function chdirToSiteRoot($shouldUseSiteRoot = true)
100			{
101			if (!$shouldUseSiteRoot \|\| !$this->siteAlias->hasRoot()) {
102			return $this;
103			}
104
105			return $this->setWorkingDirectory($this->siteAlias->root());
106			}
107
108			/**
109			* Take all of our individual arguments and process them for use.
110			*/
111			protected function processArgs()
112			{
113			$transport = $this->getTransport($this->siteAlias);
114			$transport->configure($this);
115
116			$processor = new ArgumentProcessor();
117			$selectedArgs = $processor->selectArgs(
118			$this->siteAlias,
119			$this->args,
120			$this->options,
121			$this->optionsPassedAsArgs
122			);
123
124			// Ask the transport to drop in a 'cd' if needed.
125			if ($this->getWorkingDirectory()) {
			0 ignored issues – show Bug Best Practice introduced 2019-02-15 12:34 UTC by Report Bug Copy Issue Report The expression `$this->getWorkingDirectory()` of type `string\|null` is loosely compared to `true`; this is ambiguous if the string can be empty. You might want to explicitly use `!== null` instead. In PHP, under loose comparison (like `==`, or `!=`, or `switch` conditions), values of different types might be equal. For `string` values, the empty string `''` is a special case, in particular the following results might be unexpected: '' == false // true '' == null // true 'ab' == false // false 'ab' == null // false // It is often better to use strict comparison '' === false // false '' === null // false Loading history...
126			$selectedArgs = $transport->addChdir($this->getWorkingDirectory(), $selectedArgs);
127			}
128
129			// Do any necessary interpolation on the selected arguments.
130			$processedArgs = $this->interpolate($selectedArgs);
131
132			// Wrap the command with 'ssh' or some other transport if this is
133			// a remote command; otherwise, leave it as-is.
134			return $transport->wrap($processedArgs);
135			}
136
137			public function setTransport($transport)
138			{
139			$this->transport = $transport;
140			}
141
142			/**
143			* Ask the transport manager for the correct transport for the
144			* provided alias.
145			*/
146			protected function getTransport(AliasRecord $siteAlias)
			0 ignored issues – show Unused Code introduced 2019-01-04 02:11 UTC by Report Bug Copy Issue Report The parameter `$siteAlias` is not used and could be removed. This check looks from parameters that have been defined for a function or method, but which are not used in the method body. Loading history...
147			{
148			return $this->transport;
149			}
150
151			/**
152			* @inheritDoc
153			*/
154			public function getCommandLine()
155			{
156			$commandLine = parent::getCommandLine();
157			if (empty($commandLine)) {
158			$processedArgs = $this->processArgs();
159			$commandLine = Escape::argsForSite($this->siteAlias, $processedArgs);
160			$commandLine = implode(' ', $commandLine);
161			$this->setCommandLine($commandLine);
162			}
163			return $commandLine;
164			}
165
166			/**
167			* @inheritDoc
168			*/
169			public function start(callable $callback = null, $env = array())
170			{
171			$cmd = $this->getCommandLine();
			0 ignored issues – show Unused Code introduced 2018-10-27 17:58 UTC by Report Bug Copy Issue Report `$cmd` is not used, you could remove the assignment. This check looks for variable assignements that are either overwritten by other assignments or where the variable is not used subsequently. $myVar = 'Value'; $higher = false; if (rand(1, 6) > 3) { $higher = true; } else { $higher = false; } Both the `$myVar` assignment in line 1 and the `$higher` assignment in line 2 are dead. The first because `$myVar` is never used and the second because `$higher` is always overwritten for every possible time line. Loading history...
172			parent::start($callback, $env);
173			}
174
175			/**
176			* @inheritDoc
177			*/
178			public function wait(callable $callback = null)
179			{
180			$return = parent::wait($callback);
181			return $return;
182			}
183
184			/**
185			* interpolate examines each of the arguments in the provided argument list
186			* and replaces any token found therein with the value for that key as
187			* pulled from the given site alias.
188			*
189			* Example: "git -C {{root}} status"
190			*
191			* The token "{{root}}" will be converted to a value via $siteAlias->get('root').
192			* The result will replace the token.
193			*
194			* It is possible to use dot notation in the keys to access nested elements
195			* within the site alias record.
196			*
197			* @param AliasRecord $siteAlias
			0 ignored issues – show Bug introduced 2018-10-28 01:00 UTC by Report Bug Copy Issue Report There is no parameter named `$siteAlias`. Was it maybe removed? This check looks for PHPDoc comments describing methods or function parameters that do not exist on the corresponding method or function. Consider the following example. The parameter `$italy` is not defined by the method `finale(...)`. /** * @param array $germany * @param array $island * @param array $italy */ function finale($germany, $island) { return "2:1"; } The most likely cause is that the parameter was removed, but the annotation was not. Loading history...
198			* @param type $args
199			* @return type
200			*/
201			protected function interpolate($args)
202			{
203			$interpolator = new Interpolator();
204			return array_map(
205			function ($arg) use ($interpolator) {
206			if ($arg instanceof ShellOperatorInterface) {
207			return $arg;
208			}
209			return $interpolator->interpolate($this->siteAlias, $arg, false);
210			},
211			$args
212			);
213			}
214			}
215

consolidation / site-process

Pull Request — master (#25)

SiteProcess::setWorkingDirectoryLocal() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like