Completed
Pull Request — master (#217)
by Victor
02:18
created

DetectCommand::ask()   A

Complexity

Conditions 1
Paths 1

Size

Total Lines 11
Code Lines 8

Duplication

Lines 0
Ratio 0 %

Code Coverage

Tests 0
CRAP Score 2

Importance

Changes 1
Bugs 0 Features 0
Metric Value
c 1
b 0
f 0
dl 0
loc 11
ccs 0
cts 10
cp 0
rs 9.4285
cc 1
eloc 8
nc 1
nop 2
crap 2
1
<?php
2
/**
3
 * @author Victor Dubiniuk <[email protected]>
4
 *
5
 * @copyright Copyright (c) 2015, ownCloud, Inc.
6
 * @license AGPL-3.0
7
 *
8
 * This code is free software: you can redistribute it and/or modify
9
 * it under the terms of the GNU Affero General Public License, version 3,
10
 * as published by the Free Software Foundation.
11
 *
12
 * This program is distributed in the hope that it will be useful,
13
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15
 * GNU Affero General Public License for more details.
16
 *
17
 * You should have received a copy of the GNU Affero General Public License, version 3,
18
 * along with this program.  If not, see <http://www.gnu.org/licenses/>
19
 *
20
 */
21
22
namespace Owncloud\Updater\Command;
23
24
use Symfony\Component\Console\Input\InputArgument;
25
use Symfony\Component\Console\Input\InputInterface;
26
use Symfony\Component\Console\Input\InputOption;
27
use Symfony\Component\Console\Output\OutputInterface;
28
use Symfony\Component\Console\Question\ChoiceQuestion;
29
use GuzzleHttp\Event\ProgressEvent;
30
use Owncloud\Updater\Utils\Fetcher;
31
use Owncloud\Updater\Utils\Feed;
32
use Owncloud\Updater\Utils\ConfigReader;
33
use \Owncloud\Updater\Controller\DownloadController;
34
35
class DetectCommand extends Command {
36
37
	/**
38
	 * @var Fetcher $fetcher
39
	 */
40
	protected $fetcher;
41
42
	/**
43
	 * @var ConfigReader $configReader
44
	 */
45
	protected $configReader;
46
47
	/**
48
	 *
49
	 */
50
	protected $output;
51
52
	/**
53
	 * Constructor
54
	 *
55
	 * @param Fetcher $fetcher
56
	 * @param ConfigReader $configReader
57
	 */
58
	public function __construct(Fetcher $fetcher, ConfigReader $configReader){
59
		parent::__construct();
60
		$this->fetcher = $fetcher;
61
		$this->configReader = $configReader;
62
	}
63
64
	protected function configure(){
65
		$this
66
				->setName('upgrade:detect')
67
				->setDescription('Detect
68
- 1. currently existing code, 
69
- 2. version in config.php, 
70
- 3. online available verison.
71
(ASK) what to do? (download, upgrade, abort, …)')
72
				->addOption(
73
						'exit-if-none', null, InputOption::VALUE_NONE, 'exit with non-zero status code if new version is not found'
74
				)
75
				->addOption(
76
						'only-check', null, InputOption::VALUE_NONE, 'Only check if update is available'
77
				)
78
		;
79
		;
80
	}
81
82
	protected function execute(InputInterface $input, OutputInterface $output){
83
		$registry = $this->container['utils.registry'];
84
		$registry->set('feed', false);
85
86
		$locator = $this->container['utils.locator'];
0 ignored issues
show
Unused Code introduced by
$locator 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...
87
		$fsHelper = $this->container['utils.filesystemhelper'];
88
		$downloadController = new DownloadController($this->fetcher, $registry, $fsHelper);
89
		try {
90
			$currentVersion = $this->configReader->getByPath('system.version');
91
			if (!strlen($currentVersion)){
92
				throw new \UnexpectedValueException('Could not detect installed version.');
93
			}
94
95
			$this->getApplication()->getLogger()->info('ownCloud ' . $currentVersion . ' found');
0 ignored issues
show
Bug introduced by
It seems like you code against a specific sub-type and not the parent class Symfony\Component\Console\Application as the method getLogger() does only exist in the following sub-classes of Symfony\Component\Console\Application: Owncloud\Updater\Console\Application. Maybe you want to instanceof check for one of these explicitly?

Let’s take a look at an example:

abstract class User
{
    /** @return string */
    abstract public function getPassword();
}

class MyUser extends User
{
    public function getPassword()
    {
        // return something
    }

    public function getDisplayName()
    {
        // return some name.
    }
}

class AuthSystem
{
    public function authenticate(User $user)
    {
        $this->logger->info(sprintf('Authenticating %s.', $user->getDisplayName()));
        // do something.
    }
}

In the above example, the authenticate() method works fine as long as you just pass instances of MyUser. However, if you now also want to pass a different sub-classes of User which does not have a getDisplayName() method, the code will break.

Available Fixes

  1. Change the type-hint for the parameter:

    class AuthSystem
    {
        public function authenticate(MyUser $user) { /* ... */ }
    }
    
  2. Add an additional type-check:

    class AuthSystem
    {
        public function authenticate(User $user)
        {
            if ($user instanceof MyUser) {
                $this->logger->info(/** ... */);
            }
    
            // or alternatively
            if ( ! $user instanceof MyUser) {
                throw new \LogicException(
                    '$user must be an instance of MyUser, '
                   .'other instances are not supported.'
                );
            }
    
        }
    }
    
Note: PHP Analyzer uses reverse abstract interpretation to narrow down the types inside the if block in such a case.
  1. Add the method to the parent class:

    abstract class User
    {
        /** @return string */
        abstract public function getPassword();
    
        /** @return string */
        abstract public function getDisplayName();
    }
    
Loading history...
96
			$output->writeln('Current version is ' . $currentVersion);
97
98
			$feedData = $downloadController->checkFeed();
99
			if (!$feedData['success']){
100
				// Network errors, etc
101
				$output->writeln("Can't fetch feed.");
102
				$output->writeln($feedData['exception']->getMessage());
103
				$this->getApplication()->logException($feedData['exception']);
0 ignored issues
show
Bug introduced by
It seems like you code against a specific sub-type and not the parent class Symfony\Component\Console\Application as the method logException() does only exist in the following sub-classes of Symfony\Component\Console\Application: Owncloud\Updater\Console\Application. Maybe you want to instanceof check for one of these explicitly?

Let’s take a look at an example:

abstract class User
{
    /** @return string */
    abstract public function getPassword();
}

class MyUser extends User
{
    public function getPassword()
    {
        // return something
    }

    public function getDisplayName()
    {
        // return some name.
    }
}

class AuthSystem
{
    public function authenticate(User $user)
    {
        $this->logger->info(sprintf('Authenticating %s.', $user->getDisplayName()));
        // do something.
    }
}

In the above example, the authenticate() method works fine as long as you just pass instances of MyUser. However, if you now also want to pass a different sub-classes of User which does not have a getDisplayName() method, the code will break.

Available Fixes

  1. Change the type-hint for the parameter:

    class AuthSystem
    {
        public function authenticate(MyUser $user) { /* ... */ }
    }
    
  2. Add an additional type-check:

    class AuthSystem
    {
        public function authenticate(User $user)
        {
            if ($user instanceof MyUser) {
                $this->logger->info(/** ... */);
            }
    
            // or alternatively
            if ( ! $user instanceof MyUser) {
                throw new \LogicException(
                    '$user must be an instance of MyUser, '
                   .'other instances are not supported.'
                );
            }
    
        }
    }
    
Note: PHP Analyzer uses reverse abstract interpretation to narrow down the types inside the if block in such a case.
  1. Add the method to the parent class:

    abstract class User
    {
        /** @return string */
        abstract public function getPassword();
    
        /** @return string */
        abstract public function getDisplayName();
    }
    
Loading history...
104
				// Return a number to stop the queue
105
				return $input->getOption('exit-if-none') ? 4 : null;
106
			}
107
108
			$feed = $feedData['data']['feed'];
109
			if (!$feed->isValid()){
110
				// Feed is empty. Means there are no updates
111
				$output->writeln('No updates found online.');
112
				return $input->getOption('exit-if-none') ? 4 : null;
113
			}
114
115
			$registry->set('feed', $feed);
116
			$output->writeln($feed->getVersionString() . ' is found online');
117
118
			if ($input->getOption('only-check')){
119
				return;
120
			}
121
122
			$action = $this->ask($input, $output);
123
			if ($action === 'abort'){
0 ignored issues
show
Unused Code Bug introduced by
The strict comparison === seems to always evaluate to false as the types of $action (integer) and 'abort' (string) can never be identical. Maybe you want to use a loose comparison == instead?
Loading history...
124
				$output->writeln('Exiting on user command.');
125
				return 128;
126
			}
127
128
			$this->output = $output;
129
			$packageData = $downloadController->downloadOwncloud([$this, 'progress']);
130
			if (!$packageData['success']){
131
				$registry->set('feed', null);
132
				throw $packageData['exception'];
133
			}
134
	
135
			if ($action === 'download'){
0 ignored issues
show
Unused Code Bug introduced by
The strict comparison === seems to always evaluate to false as the types of $action (integer) and 'download' (string) can never be identical. Maybe you want to use a loose comparison == instead?
Loading history...
136
				$output->writeln('Downloading has been completed. Exiting.');
137
				return 64;
138
			}
139
		} catch (\Exception $e){
140
			$this->getApplication()->getLogger()->error($e->getMessage());
0 ignored issues
show
Bug introduced by
It seems like you code against a specific sub-type and not the parent class Symfony\Component\Console\Application as the method getLogger() does only exist in the following sub-classes of Symfony\Component\Console\Application: Owncloud\Updater\Console\Application. Maybe you want to instanceof check for one of these explicitly?

Let’s take a look at an example:

abstract class User
{
    /** @return string */
    abstract public function getPassword();
}

class MyUser extends User
{
    public function getPassword()
    {
        // return something
    }

    public function getDisplayName()
    {
        // return some name.
    }
}

class AuthSystem
{
    public function authenticate(User $user)
    {
        $this->logger->info(sprintf('Authenticating %s.', $user->getDisplayName()));
        // do something.
    }
}

In the above example, the authenticate() method works fine as long as you just pass instances of MyUser. However, if you now also want to pass a different sub-classes of User which does not have a getDisplayName() method, the code will break.

Available Fixes

  1. Change the type-hint for the parameter:

    class AuthSystem
    {
        public function authenticate(MyUser $user) { /* ... */ }
    }
    
  2. Add an additional type-check:

    class AuthSystem
    {
        public function authenticate(User $user)
        {
            if ($user instanceof MyUser) {
                $this->logger->info(/** ... */);
            }
    
            // or alternatively
            if ( ! $user instanceof MyUser) {
                throw new \LogicException(
                    '$user must be an instance of MyUser, '
                   .'other instances are not supported.'
                );
            }
    
        }
    }
    
Note: PHP Analyzer uses reverse abstract interpretation to narrow down the types inside the if block in such a case.
  1. Add the method to the parent class:

    abstract class User
    {
        /** @return string */
        abstract public function getPassword();
    
        /** @return string */
        abstract public function getDisplayName();
    }
    
Loading history...
141
			return 2;
142
		}
143
	}
144
145
	/**
146
	 * Ask what to do
147
	 * @param InputInterface $input
148
	 * @param OutputInterface $output
149
	 * @return int
150
	 */
151
	public function ask(InputInterface $input, OutputInterface $output){
152
		$helper = $this->getHelper('question');
153
		$question = new ChoiceQuestion(
154
			'What would you do next?',
155
			['download', 'upgrade', 'abort'],
156
			'1'
157
		);
158
		$action = $helper->ask($input, $output, $question);
159
160
		return $action;
161
	}
162
163
	/**
164
	 * Callback to output download progress
165
	 * @param ProgressEvent $e
166
	 */
167
	public function progress(ProgressEvent $e){
168
		if ($e->downloadSize){
169
			$percent = intval(100 * $e->downloaded / $e->downloadSize );
170
			$percentString = $percent . '%';
171
			$this->output->write( 'Downloaded ' . $percentString . ' (' . $e->downloaded . ' of ' . $e->downloadSize . ")\r");
172
		}
173
	}
174
}
175