Cmd::isPharOutdated() - Code Metrics - Inspection of "More type hints" - sebastianfeldmann/phpbu - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Push — master ( 98071e...5af57d )

by Sebastian

created 2017-02-05 20:18 UTC

Cmd::isPharOutdated() A

↳ Parent: Cmd

Complexity

Conditions	1
Paths	1

Size

Total Lines	4
Code Lines	2

Duplication

Lines	0
Ratio	0 %

Importance

Changes

Metric	Value
dl	0
loc	4
rs	10
c	0
b	0
f	0
cc	1
eloc	2
nc	1
nop	1

<?php
/**
 * phpbu
 *
 * Copyright (c) 2014 - 2017 Sebastian Feldmann <[email protected]>
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 *
 * @package    phpbu
 * @author     Sebastian Feldmann <[email protected]>
 * @copyright  Sebastian Feldmann
 * @license    https://opensource.org/licenses/MIT The MIT License (MIT)
 * @link       http://phpbu.de/
 * @since      Class available since Release 1.0.0
 */
namespace phpbu\App;

use Phar;
use phpbu\App\Cmd\Args;
use phpbu\App\Util\Arr;

/**
 * Main application class.
 *
 * @package    phpbu
 * @author     Sebastian Feldmann <[email protected]>
 * @copyright  Sebastian Feldmann <[email protected]>
 * @license    https://opensource.org/licenses/MIT The MIT License (MIT)
 * @link       http://phpbu.de/
 * @since      Class available since Release 1.0.0
 */
class Cmd
{
    const EXIT_SUCCESS   = 0;
    const EXIT_FAILURE   = 1;
    const EXIT_EXCEPTION = 2;

    /**
     * Is cmd executed from phar.
     *
     * @var boolean
     */
    private $isPhar;

    /**
     * Is version string printed already.
     *
     * @var boolean
     */
    private $isVersionStringPrinted = false;

    /**
     * List of given arguments
     *
     * @var array
     */
    private $arguments;

    /**
     * Runs the application.
     *
     * @param array $args
     */
    public function run(array $args)
    {
        $this->isPhar = defined('__PHPBU_PHAR__');
        $this->handleOpt($args);

        $ret        = self::EXIT_FAILURE;
        $factory    = new Factory();
        $runner     = new Runner($factory);
        $configFile = $this->findConfiguration();

        try {
            $this->printVersionString();
            $result = $runner->run($this->createConfiguration($configFile, $factory));

            if ($result->wasSuccessful()) {
                $ret = self::EXIT_SUCCESS;
            } elseif ($result->errorCount() > 0) {
                $ret = self::EXIT_EXCEPTION;
            }
        } catch (\Exception $e) {
            echo $e->getMessage() . PHP_EOL;
            $ret = self::EXIT_EXCEPTION;
        }

        exit($ret);
    }

    /**
     * Check arguments and load configuration file.
     *
     * @param array $args
     */
    protected function handleOpt(array $args)
    {
        try {
            $parser  = new Args($this->isPhar);
            $options = $parser->getOptions($args);
            $this->handleArgs($options);
        } catch (Exception $e) {
            $this->printError($e->getMessage(), true);
        }
    }

    /**
     * Handle the parsed command line options
     *
     * @param  array $options
     * @return void
     */
    protected function handleArgs(array $options)
    {
        foreach ($options as $option => $argument) {
            switch ($option) {
                case '--bootstrap':
                    $this->arguments['bootstrap'] = $argument;
                    break;
                case '--colors':
                    $this->arguments['colors'] = $argument;
                    break;
                case '--configuration':
                    $this->arguments['configuration'] = $argument;
                    break;
                case '--debug':
                    $this->arguments['debug'] = $argument;
                    break;
                case '-h':
                case '--help':
                    $this->printHelp();
                    exit(self::EXIT_SUCCESS);
                case 'include-path':
                    $this->arguments['include-path'] = $argument;
                    break;
                case '--limit':
                    $this->arguments['limit'] = $argument;
                    break;
                case '--self-update':
                    $this->handleSelfUpdate();
                    break;
                case '--version-check':
                    $this->handleVersionCheck();
                    break;
                case '--simulate':
                    $this->arguments['simulate'] = $argument;
                    break;
                case '-v':
                case '--verbose':
                    $this->arguments['verbose'] = true;
                    break;
                case '-V':
                case '--version':
                    $this->printVersionString();
                    exit(self::EXIT_SUCCESS);
            }
        }
    }

    /**
     * Try to find a configuration file.
     */
    protected function findConfiguration() : string
    {
        $configOption = $this->arguments['configuration'] ?? '';

        try {
            $finder = new Configuration\Finder();
            return $finder->findConfiguration($configOption);
        } catch (\Exception $e) {
            // config option given but still no config found
            if (!empty($configOption)) {
                $this->printError('Can\'t find configuration file.');
            }
            $this->printHelp();
            exit(self::EXIT_EXCEPTION);
        }
    }

    /**
     * Create a application configuration.
     *
     * @param  string             $configurationFile
     * @param  \phpbu\App\Factory $factory
     * @return \phpbu\App\Configuration
     */
    protected function createConfiguration(string $configurationFile, Factory $factory)
    {
        $configLoader  = Configuration\Loader\Factory::createLoader($configurationFile);
        $configuration = $configLoader->getConfiguration($factory);

        // command line arguments overrule the config file settings
        $this->overrideConfigWithArgument($configuration, 'verbose');
        $this->overrideConfigWithArgument($configuration, 'colors');
        $this->overrideConfigWithArgument($configuration, 'debug');
        $this->overrideConfigWithArgument($configuration, 'simulate');
        $this->overrideConfigWithArgument($configuration, 'bootstrap');

        // check for command line limit option
        $limitOption = Arr::getValue($this->arguments, 'limit');
        $configuration->setLimit(!empty($limitOption) ? explode(',', $limitOption) : []);

        // add a cli printer for some output
        $configuration->addLogger(
            new Result\PrinterCli(
                $configuration->getVerbose(),
                $configuration->getColors(),
                ($configuration->getDebug() || $configuration->isSimulation())
            )
        );
        return $configuration;
    }

    /**
     * Override configuration settings with command line arguments.
     *
     * @param \phpbu\App\Configuration $configuration
     * @param string                   $arg
     */
    protected function overrideConfigWithArgument(Configuration $configuration, string $arg)
    {
        $value = Arr::getValue($this->arguments, $arg);
        if (!empty($value)) {
            $setter = 'set' . ucfirst($arg);
            $configuration->{$setter}($value);
        }
    }

    /**
     * Handle the phar self-update.
     */
    protected function handleSelfUpdate()
    {
        $this->printVersionString();

        // check if upgrade is necessary
        $latestVersion = $this->getLatestVersion();
        if (!$this->isPharOutdated($latestVersion)) {
            echo 'You already have the latest version of phpbu installed.' . PHP_EOL;
            exit(self::EXIT_SUCCESS);
        }

        $remoteFilename = 'http://phar.phpbu.de/phpbu.phar';
        $localFilename  = realpath($_SERVER['argv'][0]);
        $tempFilename   = basename($localFilename, '.phar') . '-temp.phar';

        echo 'Updating the phpbu PHAR to version ' . $latestVersion . ' ... ';

        $old  = error_reporting(0);
        $phar = file_get_contents($remoteFilename);
        error_reporting($old);
        if (!$phar) {
            echo ' failed' . PHP_EOL . 'Could not reach phpbu update site' . PHP_EOL;
            exit(self::EXIT_EXCEPTION);
        }
        file_put_contents($tempFilename, $phar);

        chmod($tempFilename, 0777 & ~umask());

        // check downloaded phar
        try {
            $phar = new Phar($tempFilename);
            unset($phar);
            // replace current phar with the new one
            rename($tempFilename, $localFilename);
        } catch (Exception $e) {
            // cleanup crappy phar
            unlink($tempFilename);
            echo 'failed' . PHP_EOL . $e->getMessage() . PHP_EOL;
            exit(self::EXIT_EXCEPTION);
        }

        echo 'done' . PHP_EOL;
        exit(self::EXIT_SUCCESS);
    }

    /**
     * Handle phar version-check.
     */
    protected function handleVersionCheck()
    {
        $this->printVersionString();

        $latestVersion = $this->getLatestVersion();
        if ($this->isPharOutdated($latestVersion)) {
            print 'You are not using the latest version of phpbu.' . PHP_EOL
                . 'Use "phpunit --self-update" to install phpbu ' . $latestVersion . PHP_EOL;
        } else {
            print 'You are using the latest version of phpbu.' . PHP_EOL;
        }
        exit(self::EXIT_SUCCESS);
    }

    /**
     * Returns latest released phpbu version.
     *
     * @return string
     * @throws \RuntimeException
     */
    protected function getLatestVersion() : string
    {
        $old     = error_reporting(0);
        $version = file_get_contents('https://phar.phpbu.de/latest-version-of/phpbu');
        error_reporting($old);
        if (!$version) {
            echo 'Network-Error: Could not check latest version.' . PHP_EOL;
            exit(self::EXIT_EXCEPTION);
        }
        return $version;
    }

    /**
     * Check if current phar is outdated.
     *
     * @param  string $latestVersion
     * @return bool
     */
    protected function isPharOutdated(string $latestVersion) : bool
    {
        return version_compare($latestVersion, Version::id(), '>');
    }

    /**
     * Shows the current application version.
     */
    protected function printVersionString()
    {
        if ($this->isVersionStringPrinted) {
            return;
        }

        echo Version::getVersionString() . PHP_EOL . PHP_EOL;
        $this->isVersionStringPrinted = true;
    }

    /**
     * Show the help message.
     */
    protected function printHelp()
    {
        $this->printVersionString();
        echo <<<EOT
Usage: phpbu [option]

  --bootstrap=<file>     A "bootstrap" PHP file that is included before the backup.
  --configuration=<file> A phpbu configuration file.
  --colors               Use colors in output.
  --debug                Display debugging information during backup generation.
  --limit=<subset>       Limit backup execution to a subset.
  --simulate             Perform a trial run with no changes made.
  -h, --help             Print this usage information.
  -v, --verbose          Output more verbose information.
  -V, --version          Output version information and exit.

EOT;
        if ($this->isPhar) {
            echo '  --version-check        Check whether phpbu is up to date.' . PHP_EOL;
            echo '  --self-update          Upgrade phpbu to the latest version.' . PHP_EOL;
        }
    }

    /**
     * Shows some given error message.
     *
     * @param string $message
     * @param bool   $hint
     */
    private function printError($message, $hint = false)
    {
        $help = $hint ? ', use "phpbu -h" for help' : '';
        $this->printVersionString();
        echo $message . $help . PHP_EOL;
        exit(self::EXIT_EXCEPTION);
    }

    /**
     * Main method, is called by phpbu command and the phar file.
     */
    public static function main()
    {
        $app = new static();
        $app->run($_SERVER['argv']);
    }
}


1			<?php
2			/**
3			* phpbu
4			*
5			* Copyright (c) 2014 - 2017 Sebastian Feldmann <[email protected]>
6			*
7			* Permission is hereby granted, free of charge, to any person obtaining a copy
8			* of this software and associated documentation files (the "Software"), to deal
9			* in the Software without restriction, including without limitation the rights
10			* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
11			* copies of the Software, and to permit persons to whom the Software is
12			* furnished to do so, subject to the following conditions:
13			*
14			* The above copyright notice and this permission notice shall be included in
15			* all copies or substantial portions of the Software.
16			*
17			* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
18			* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19			* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
20			* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
21			* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
22			* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
23			* THE SOFTWARE.
24			*
25			* @package phpbu
26			* @author Sebastian Feldmann <[email protected]>
27			* @copyright Sebastian Feldmann
28			* @license https://opensource.org/licenses/MIT The MIT License (MIT)
29			* @link http://phpbu.de/
30			* @since Class available since Release 1.0.0
31			*/
32			namespace phpbu\App;
33
34			use Phar;
35			use phpbu\App\Cmd\Args;
36			use phpbu\App\Util\Arr;
37
38			/**
39			* Main application class.
40			*
41			* @package phpbu
42			* @author Sebastian Feldmann <[email protected]>
43			* @copyright Sebastian Feldmann <[email protected]>
44			* @license https://opensource.org/licenses/MIT The MIT License (MIT)
45			* @link http://phpbu.de/
46			* @since Class available since Release 1.0.0
47			*/
48			class Cmd
49			{
50			const EXIT_SUCCESS = 0;
51			const EXIT_FAILURE = 1;
52			const EXIT_EXCEPTION = 2;
53
54			/**
55			* Is cmd executed from phar.
56			*
57			* @var boolean
58			*/
59			private $isPhar;
60
61			/**
62			* Is version string printed already.
63			*
64			* @var boolean
65			*/
66			private $isVersionStringPrinted = false;
67
68			/**
69			* List of given arguments
70			*
71			* @var array
72			*/
73			private $arguments;
74
75			/**
76			* Runs the application.
77			*
78			* @param array $args
79			*/
80			public function run(array $args)
81			{
82			$this->isPhar = defined('__PHPBU_PHAR__');
83			$this->handleOpt($args);
84
85			$ret = self::EXIT_FAILURE;
86			$factory = new Factory();
87			$runner = new Runner($factory);
88			$configFile = $this->findConfiguration();
89
90			try {
91			$this->printVersionString();
92			$result = $runner->run($this->createConfiguration($configFile, $factory));
93
94			if ($result->wasSuccessful()) {
95			$ret = self::EXIT_SUCCESS;
96			} elseif ($result->errorCount() > 0) {
97			$ret = self::EXIT_EXCEPTION;
98			}
99			} catch (\Exception $e) {
100			echo $e->getMessage() . PHP_EOL;
101			$ret = self::EXIT_EXCEPTION;
102			}
103
104			exit($ret);
105			}
106
107			/**
108			* Check arguments and load configuration file.
109			*
110			* @param array $args
111			*/
112			protected function handleOpt(array $args)
113			{
114			try {
115			$parser = new Args($this->isPhar);
116			$options = $parser->getOptions($args);
117			$this->handleArgs($options);
118			} catch (Exception $e) {
119			$this->printError($e->getMessage(), true);
120			}
121			}
122
123			/**
124			* Handle the parsed command line options
125			*
126			* @param array $options
127			* @return void
128			*/
129			protected function handleArgs(array $options)
130			{
131			foreach ($options as $option => $argument) {
132			switch ($option) {
133			case '--bootstrap':
134			$this->arguments['bootstrap'] = $argument;
135			break;
136			case '--colors':
137			$this->arguments['colors'] = $argument;
138			break;
139			case '--configuration':
140			$this->arguments['configuration'] = $argument;
141			break;
142			case '--debug':
143			$this->arguments['debug'] = $argument;
144			break;
145			case '-h':
146			case '--help':
147			$this->printHelp();
148			exit(self::EXIT_SUCCESS);
149			case 'include-path':
150			$this->arguments['include-path'] = $argument;
151			break;
152			case '--limit':
153			$this->arguments['limit'] = $argument;
154			break;
155			case '--self-update':
156			$this->handleSelfUpdate();
157			break;
158			case '--version-check':
159			$this->handleVersionCheck();
160			break;
161			case '--simulate':
162			$this->arguments['simulate'] = $argument;
163			break;
164			case '-v':
165			case '--verbose':
166			$this->arguments['verbose'] = true;
167			break;
168			case '-V':
169			case '--version':
170			$this->printVersionString();
171			exit(self::EXIT_SUCCESS);
172			}
173			}
174			}
175
176			/**
177			* Try to find a configuration file.
178			*/
179			protected function findConfiguration() : string
180			{
181			$configOption = $this->arguments['configuration'] ?? '';
182
183			try {
184			$finder = new Configuration\Finder();
185			return $finder->findConfiguration($configOption);
186			} catch (\Exception $e) {
187			// config option given but still no config found
188			if (!empty($configOption)) {
189			$this->printError('Can\'t find configuration file.');
190			}
191			$this->printHelp();
192			exit(self::EXIT_EXCEPTION);
193			}
194			}
195
196			/**
197			* Create a application configuration.
198			*
199			* @param string $configurationFile
200			* @param \phpbu\App\Factory $factory
201			* @return \phpbu\App\Configuration
202			*/
203			protected function createConfiguration(string $configurationFile, Factory $factory)
204			{
205			$configLoader = Configuration\Loader\Factory::createLoader($configurationFile);
206			$configuration = $configLoader->getConfiguration($factory);
207
208			// command line arguments overrule the config file settings
209			$this->overrideConfigWithArgument($configuration, 'verbose');
210			$this->overrideConfigWithArgument($configuration, 'colors');
211			$this->overrideConfigWithArgument($configuration, 'debug');
212			$this->overrideConfigWithArgument($configuration, 'simulate');
213			$this->overrideConfigWithArgument($configuration, 'bootstrap');
214
215			// check for command line limit option
216			$limitOption = Arr::getValue($this->arguments, 'limit');
217			$configuration->setLimit(!empty($limitOption) ? explode(',', $limitOption) : []);
218
219			// add a cli printer for some output
220			$configuration->addLogger(
221			new Result\PrinterCli(
222			$configuration->getVerbose(),
223			$configuration->getColors(),
224			($configuration->getDebug() \|\| $configuration->isSimulation())
225			)
226			);
227			return $configuration;
228			}
229
230			/**
231			* Override configuration settings with command line arguments.
232			*
233			* @param \phpbu\App\Configuration $configuration
234			* @param string $arg
235			*/
236			protected function overrideConfigWithArgument(Configuration $configuration, string $arg)
237			{
238			$value = Arr::getValue($this->arguments, $arg);
239			if (!empty($value)) {
240			$setter = 'set' . ucfirst($arg);
241			$configuration->{$setter}($value);
242			}
243			}
244
245			/**
246			* Handle the phar self-update.
247			*/
248			protected function handleSelfUpdate()
249			{
250			$this->printVersionString();
251
252			// check if upgrade is necessary
253			$latestVersion = $this->getLatestVersion();
254			if (!$this->isPharOutdated($latestVersion)) {
255			echo 'You already have the latest version of phpbu installed.' . PHP_EOL;
256			exit(self::EXIT_SUCCESS);
257			}
258
259			$remoteFilename = 'http://phar.phpbu.de/phpbu.phar';
260			$localFilename = realpath($_SERVER['argv'][0]);
261			$tempFilename = basename($localFilename, '.phar') . '-temp.phar';
262
263			echo 'Updating the phpbu PHAR to version ' . $latestVersion . ' ... ';
264
265			$old = error_reporting(0);
266			$phar = file_get_contents($remoteFilename);
267			error_reporting($old);
268			if (!$phar) {
269			echo ' failed' . PHP_EOL . 'Could not reach phpbu update site' . PHP_EOL;
270			exit(self::EXIT_EXCEPTION);
271			}
272			file_put_contents($tempFilename, $phar);
273
274			chmod($tempFilename, 0777 & ~umask());
275
276			// check downloaded phar
277			try {
278			$phar = new Phar($tempFilename);
279			unset($phar);
280			// replace current phar with the new one
281			rename($tempFilename, $localFilename);
282			} catch (Exception $e) {
283			// cleanup crappy phar
284			unlink($tempFilename);
285			echo 'failed' . PHP_EOL . $e->getMessage() . PHP_EOL;
286			exit(self::EXIT_EXCEPTION);
287			}
288
289			echo 'done' . PHP_EOL;
290			exit(self::EXIT_SUCCESS);
291			}
292
293			/**
294			* Handle phar version-check.
295			*/
296			protected function handleVersionCheck()
297			{
298			$this->printVersionString();
299
300			$latestVersion = $this->getLatestVersion();
301			if ($this->isPharOutdated($latestVersion)) {
302			print 'You are not using the latest version of phpbu.' . PHP_EOL
303			. 'Use "phpunit --self-update" to install phpbu ' . $latestVersion . PHP_EOL;
304			} else {
305			print 'You are using the latest version of phpbu.' . PHP_EOL;
306			}
307			exit(self::EXIT_SUCCESS);
308			}
309
310			/**
311			* Returns latest released phpbu version.
312			*
313			* @return string
314			* @throws \RuntimeException
315			*/
316			protected function getLatestVersion() : string
317			{
318			$old = error_reporting(0);
319			$version = file_get_contents('https://phar.phpbu.de/latest-version-of/phpbu');
320			error_reporting($old);
321			if (!$version) {
322			echo 'Network-Error: Could not check latest version.' . PHP_EOL;
323			exit(self::EXIT_EXCEPTION);
324			}
325			return $version;
326			}
327
328			/**
329			* Check if current phar is outdated.
330			*
331			* @param string $latestVersion
332			* @return bool
333			*/
334			protected function isPharOutdated(string $latestVersion) : bool
335			{
336			return version_compare($latestVersion, Version::id(), '>');
337			}
338
339			/**
340			* Shows the current application version.
341			*/
342			protected function printVersionString()
343			{
344			if ($this->isVersionStringPrinted) {
345			return;
346			}
347
348			echo Version::getVersionString() . PHP_EOL . PHP_EOL;
349			$this->isVersionStringPrinted = true;
350			}
351
352			/**
353			* Show the help message.
354			*/
355			protected function printHelp()
356			{
357			$this->printVersionString();
358			echo <<<EOT
359			Usage: phpbu [option]
360
361			--bootstrap=<file> A "bootstrap" PHP file that is included before the backup.
362			--configuration=<file> A phpbu configuration file.
363			--colors Use colors in output.
364			--debug Display debugging information during backup generation.
365			--limit=<subset> Limit backup execution to a subset.
366			--simulate Perform a trial run with no changes made.
367			-h, --help Print this usage information.
368			-v, --verbose Output more verbose information.
369			-V, --version Output version information and exit.
370
371			EOT;
372			if ($this->isPhar) {
373			echo ' --version-check Check whether phpbu is up to date.' . PHP_EOL;
374			echo ' --self-update Upgrade phpbu to the latest version.' . PHP_EOL;
375			}
376			}
377
378			/**
379			* Shows some given error message.
380			*
381			* @param string $message
382			* @param bool $hint
383			*/
384			private function printError($message, $hint = false)
385			{
386			$help = $hint ? ', use "phpbu -h" for help' : '';
387			$this->printVersionString();
388			echo $message . $help . PHP_EOL;
389			exit(self::EXIT_EXCEPTION);
390			}
391
392			/**
393			* Main method, is called by phpbu command and the phar file.
394			*/
395			public static function main()
396			{
397			$app = new static();
398			$app->run($_SERVER['argv']);
399			}
400			}
401

sebastianfeldmann / phpbu

Push — master ( 98071e...5af57d )

Cmd::isPharOutdated() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like