Env::getPipelinesProjectPath() - Code Metrics - Inspection of "prepare release" - ktomk/pipelines - Measure and Improve Code Quality continuously with Scrutinizer

Passed

Push — master ( 1cedb5...767252 )

by Tom

created 2019-12-21 03:31 UTC

Env::getPipelinesProjectPath() A

↳ Parent: Project

Complexity

Conditions	2
Paths	2

Size

Total Lines	7
Code Lines	3

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	4
CRAP Score	2

Importance

Changes

Metric	Value
cc	2
eloc	3
c	0
b	0
f	0
nc	2
nop	1
dl	0
loc	7
ccs	4
cts	4
cp	1
crap	2
rs	10

<?php

/* this file is part of pipelines */

namespace Ktomk\Pipelines\Runner;

use Ktomk\Pipelines\Cli\Args\Args;
use Ktomk\Pipelines\Cli\Args\Collector;
use Ktomk\Pipelines\Lib;

/**
 * Pipeline environment collaborator
 */
class Env
{
    /**
     * @var array pipelines (bitbucket) environment variables
     */
    private $vars = array();

    /**
     * collected arguments
     *
     * @var array
     */
    private $collected = array();

    /**
     * environment variables to inherit from
     *
     * @var array
     */
    private $inherit = array();

    /**
     * @var null|EnvResolver
     */
    private $resolver;

    /**
     * @param null|array $inherit
     *
     * @return Env
     */
    public static function create(array $inherit = array())
    {
        $env = new self();
        $env->initDefaultVars($inherit);

        return $env;
    }

    /**
     * Initialize default environment used in a Bitbucket Pipeline
     *
     * As the runner mimic some values, defaults are available
     *
     * @param array $inherit Environment variable store to inherit from
     */
    public function initDefaultVars(array $inherit)
    {
        $this->inherit = $inherit;

        $inheritable = array(
            'BITBUCKET_BOOKMARK' => null,
            'BITBUCKET_BRANCH' => null,
            'BITBUCKET_BUILD_NUMBER' => '0',
            'BITBUCKET_COMMIT' => '0000000000000000000000000000000000000000',
            'BITBUCKET_REPO_OWNER' => '' . Lib::r($inherit['USER'], 'nobody'),
            'BITBUCKET_REPO_SLUG' => 'local-has-no-slug',
            'BITBUCKET_TAG' => null,
            'CI' => 'true',
            'PIPELINES_CONTAINER_NAME' => null,
            'PIPELINES_IDS' => null,
            'PIPELINES_PARENT_CONTAINER_NAME' => null,
            'PIPELINES_PROJECT_PATH' => null,
        );

        $invariant = array(
            'PIPELINES_ID' => null,
        );

        foreach ($inheritable as $name => $value) {
            isset($inherit[$name]) ? $inheritable[$name] = $inherit[$name] : null;
        }

        $var = $invariant + $inheritable;
        ksort($var);

        $this->vars = $var;
    }

    /**
     * Map reference to environment variable setting
     *
     * Only add the BITBUCKET_BOOKMARK/_BRANCH/_TAG variable
     * if not yet set.
     *
     * @param Reference $ref
     */
    public function addReference(Reference $ref)
    {
        if (null === $type = $ref->getType()) {
            return;
        }

        $map = array(
            'bookmark' => 'BITBUCKET_BOOKMARK',
            'branch' => 'BITBUCKET_BRANCH',
            'tag' => 'BITBUCKET_TAG',
            'pr' => 'BITBUCKET_BRANCH',
        );

        if (!isset($map[$type])) {
            throw new \UnexpectedValueException(sprintf('Unknown reference type: "%s"', $type));
        }
        $var = $map[$type];

        if (!isset($this->vars[$var])) {
            $this->vars[$var] = $ref->getName();
        }
    }

    /**
     * @param string $name of container
     */
    public function setContainerName($name)
    {
        if (isset($this->vars['PIPELINES_CONTAINER_NAME'])) {
            $this->vars['PIPELINES_PARENT_CONTAINER_NAME']
                = $this->vars['PIPELINES_CONTAINER_NAME'];
        }

        $this->vars['PIPELINES_CONTAINER_NAME'] = $name;
    }

    /**
     * set the pipelines environment's running pipeline id
     *
     * @param string $id of pipeline, e.g. "default" or "branch/feature/*"
     *
     * @return bool whether was used before (endless pipelines in pipelines loop)
     */
    public function setPipelinesId($id)
    {
        $list = (string)$this->getValue('PIPELINES_IDS');
        $hashes = preg_split('~\s+~', $list, -1, PREG_SPLIT_NO_EMPTY);
        $hashes = array_map('strtolower', /** @scrutinizer ignore-type */ $hashes);

        $idHash = md5($id);
        $hasId = in_array($idHash, $hashes, true);
        $hashes[] = $idHash;

        $this->vars['PIPELINES_ID'] = $id;
        $this->vars['PIPELINES_IDS'] = implode(' ', $hashes);

        return $hasId;
    }

    /**
     * set PIPELINES_PROJECT_PATH
     *
     * can never be overwritten, must be set by pipelines itself for the
     * initial pipeline. will be taken over into each sub-pipeline.
     *
     * @param string $path absolute path to the project directory (deploy source path)
     */
    public function setPipelinesProjectPath($path)
    {
        // TODO $path must be absolute

        if (isset($this->vars['PIPELINES_PROJECT_PATH'])
            || !isset($this->vars['PIPELINES_ID'], $this->vars['PIPELINES_IDS'])
            || $this->vars['PIPELINES_IDS'] !== md5($this->vars['PIPELINES_ID'])
        ) {
            return;
        }

        $this->vars['PIPELINES_PROJECT_PATH'] = $path;
    }

    /**
     * @param null|string $default [optional]
     *
     * @return null|string
     */
    public function getPipelinesProjectPath($default = null)
    {
        if (isset($this->vars['PIPELINES_PROJECT_PATH'])) {
            return $this->vars['PIPELINES_PROJECT_PATH'];
        }

        return $default;
    }

    /**
     * @param string $option "-e" typically for Docker binary
     *
     * @return array of options (from $option) and values, ['-e', 'val1', '-e', 'val2', ...]
     */
    public function getArgs($option)
    {
        $args = $this->collected;

        foreach ($this->getVarDefinitions() as $definition) {
            $args[] = $option;
            $args[] = $definition;
        }

        return $args;
    }

    /**
     * get a variables value or null if not set
     *
     * @param string $name
     *
     * @return null|string
     */
    public function getValue($name)
    {
        return isset($this->vars[$name])
            ? $this->vars[$name]
            : null;
    }

    /**
     * collect option arguments
     *
     * those options to be passed to docker client, normally -e,
     * --env and --env-file.
     *
     * @param Args $args
     * @param string|string[] $option
     *
     * @throws \InvalidArgumentException
     * @throws \Ktomk\Pipelines\Cli\ArgsException
     */
    public function collect(Args $args, $option)
    {
        $collector = new Collector($args);
        $collector->collect($option);
        $this->collected = array_merge($this->collected, $collector->getArgs());

        $this->getResolver()->addArguments($collector);
    }

    /**
     * @param array $paths
     *
     * @throws \InvalidArgumentException
     */
    public function collectFiles(array $paths)
    {
        $resolver = $this->getResolver();
        foreach ($paths as $path) {
            if ($resolver->addFileIfExists($path)) {
                $this->collected[] = '--env-file';
                $this->collected[] = $path;
            }
        }
    }

    /**
     * @return EnvResolver
     */
    public function getResolver()
    {
        if (null === $this->resolver) {
            $this->resolver = new EnvResolver($this->inherit);
        }

        return $this->resolver;
    }

    /**
     * @return array w/ a string variable definition (name=value) per value
     */
    private function getVarDefinitions()
    {
        $array = array();

        foreach ($this->vars as $name => $value) {
            if (isset($value)) {
                $array[] = sprintf('%s=%s', $name, $value);
            }
        }

        return $array;
    }
}


1		<?php
2
3		/* this file is part of pipelines */
4
5		namespace Ktomk\Pipelines\Runner;
6
7		use Ktomk\Pipelines\Cli\Args\Args;
8		use Ktomk\Pipelines\Cli\Args\Collector;
9		use Ktomk\Pipelines\Lib;
10
11		/**
12		* Pipeline environment collaborator
13		*/
14		class Env
15		{
16		/**
17		* @var array pipelines (bitbucket) environment variables
18		*/
19		private $vars = array();
20
21		/**
22		* collected arguments
23		*
24		* @var array
25		*/
26		private $collected = array();
27
28		/**
29		* environment variables to inherit from
30		*
31		* @var array
32		*/
33		private $inherit = array();
34
35		/**
36		* @var null\|EnvResolver
37		*/
38		private $resolver;
39
40		/**
41		* @param null\|array $inherit
42		*
43		* @return Env
44		*/
45	16	public static function create(array $inherit = array())
46		{
47	16	$env = new self();
48	16	$env->initDefaultVars($inherit);
49
50	16	return $env;
51		}
52
53		/**
54		* Initialize default environment used in a Bitbucket Pipeline
55		*
56		* As the runner mimic some values, defaults are available
57		*
58		* @param array $inherit Environment variable store to inherit from
59		*/
60	19	public function initDefaultVars(array $inherit)
61		{
62	19	$this->inherit = $inherit;
63
64		$inheritable = array(
65	19	'BITBUCKET_BOOKMARK' => null,
66		'BITBUCKET_BRANCH' => null,
67	19	'BITBUCKET_BUILD_NUMBER' => '0',
68	19	'BITBUCKET_COMMIT' => '0000000000000000000000000000000000000000',
69	19	'BITBUCKET_REPO_OWNER' => '' . Lib::r($inherit['USER'], 'nobody'),
70	19	'BITBUCKET_REPO_SLUG' => 'local-has-no-slug',
71		'BITBUCKET_TAG' => null,
72	19	'CI' => 'true',
73		'PIPELINES_CONTAINER_NAME' => null,
74		'PIPELINES_IDS' => null,
75		'PIPELINES_PARENT_CONTAINER_NAME' => null,
76		'PIPELINES_PROJECT_PATH' => null,
77		);
78
79		$invariant = array(
80	19	'PIPELINES_ID' => null,
81		);
82
83	19	foreach ($inheritable as $name => $value) {
84	19	isset($inherit[$name]) ? $inheritable[$name] = $inherit[$name] : null;
85		}
86
87	19	$var = $invariant + $inheritable;
88	19	ksort($var);
89
90	19	$this->vars = $var;
91	19	}
92
93		/**
94		* Map reference to environment variable setting
95		*
96		* Only add the BITBUCKET_BOOKMARK/_BRANCH/_TAG variable
97		* if not yet set.
98		*
99		* @param Reference $ref
100		*/
101	4	public function addReference(Reference $ref)
102		{
103	4	if (null === $type = $ref->getType()) {
104	2	return;
105		}
106
107		$map = array(
108	4	'bookmark' => 'BITBUCKET_BOOKMARK',
109		'branch' => 'BITBUCKET_BRANCH',
110		'tag' => 'BITBUCKET_TAG',
111		'pr' => 'BITBUCKET_BRANCH',
112		);
113
114	4	if (!isset($map[$type])) {
115	1	throw new \UnexpectedValueException(sprintf('Unknown reference type: "%s"', $type));
116		}
117	3	$var = $map[$type];
118
119	3	if (!isset($this->vars[$var])) {
120	2	$this->vars[$var] = $ref->getName();
121		}
122	3	}
123
124		/**
125		* @param string $name of container
126		*/
127	2	public function setContainerName($name)
128		{
129	2	if (isset($this->vars['PIPELINES_CONTAINER_NAME'])) {
130	2	$this->vars['PIPELINES_PARENT_CONTAINER_NAME']
131	2	= $this->vars['PIPELINES_CONTAINER_NAME'];
132		}
133
134	2	$this->vars['PIPELINES_CONTAINER_NAME'] = $name;
135	2	}
136
137		/**
138		* set the pipelines environment's running pipeline id
139		*
140		* @param string $id of pipeline, e.g. "default" or "branch/feature/*"
141		*
142		* @return bool whether was used before (endless pipelines in pipelines loop)
143		*/
144	2	public function setPipelinesId($id)
145		{
146	2	$list = (string)$this->getValue('PIPELINES_IDS');
147	2	$hashes = preg_split('~\s+~', $list, -1, PREG_SPLIT_NO_EMPTY);
148	2	$hashes = array_map('strtolower', /** @scrutinizer ignore-type */ $hashes);
149
150	2	$idHash = md5($id);
151	2	$hasId = in_array($idHash, $hashes, true);
152	2	$hashes[] = $idHash;
153
154	2	$this->vars['PIPELINES_ID'] = $id;
155	2	$this->vars['PIPELINES_IDS'] = implode(' ', $hashes);
156
157	2	return $hasId;
158		}
159
160		/**
161		* set PIPELINES_PROJECT_PATH
162		*
163		* can never be overwritten, must be set by pipelines itself for the
164		* initial pipeline. will be taken over into each sub-pipeline.
165		*
166		* @param string $path absolute path to the project directory (deploy source path)
167		*/
168	1	public function setPipelinesProjectPath($path)
169		{
170		// TODO $path must be absolute
171
172	1	if (isset($this->vars['PIPELINES_PROJECT_PATH'])
173	1	\|\| !isset($this->vars['PIPELINES_ID'], $this->vars['PIPELINES_IDS'])
174	1	\|\| $this->vars['PIPELINES_IDS'] !== md5($this->vars['PIPELINES_ID'])
175		) {
176	1	return;
177		}
178
179	1	$this->vars['PIPELINES_PROJECT_PATH'] = $path;
180	1	}
181
182		/**
183		* @param null\|string $default [optional]
184		*
185		* @return null\|string
186		*/
187	1	public function getPipelinesProjectPath($default = null)
188		{
189	1	if (isset($this->vars['PIPELINES_PROJECT_PATH'])) {
190	1	return $this->vars['PIPELINES_PROJECT_PATH'];
191		}
192
193	1	return $default;
194		}
195
196		/**
197		* @param string $option "-e" typically for Docker binary
198		*
199		* @return array of options (from $option) and values, ['-e', 'val1', '-e', 'val2', ...]
200		*/
201	12	public function getArgs($option)
202		{
203	12	$args = $this->collected;
204
205	12	foreach ($this->getVarDefinitions() as $definition) {
206	11	$args[] = $option;
207	11	$args[] = $definition;
208		}
209
210	12	return $args;
211		}
212
213		/**
214		* get a variables value or null if not set
215		*
216		* @param string $name
217		*
218		* @return null\|string
219		*/
220	6	public function getValue($name)
221		{
222	6	return isset($this->vars[$name])
223	4	? $this->vars[$name]
224	6	: null;
225		}
226
227		/**
228		* collect option arguments
229		*
230		* those options to be passed to docker client, normally -e,
231		* --env and --env-file.
232		*
233		* @param Args $args
234		* @param string\|string[] $option
235		*
236		* @throws \InvalidArgumentException
237		* @throws \Ktomk\Pipelines\Cli\ArgsException
238		*/
239	1	public function collect(Args $args, $option)
240		{
241	1	$collector = new Collector($args);
242	1	$collector->collect($option);
243	1	$this->collected = array_merge($this->collected, $collector->getArgs());
244
245	1	$this->getResolver()->addArguments($collector);
246	1	}
247
248		/**
249		* @param array $paths
250		*
251		* @throws \InvalidArgumentException
252		*/
253	2	public function collectFiles(array $paths)
254		{
255	2	$resolver = $this->getResolver();
256	2	foreach ($paths as $path) {
257	2	if ($resolver->addFileIfExists($path)) {
258	2	$this->collected[] = '--env-file';
259	2	$this->collected[] = $path;
260		}
261		}
262	2	}
263
264		/**
265		* @return EnvResolver
266		*/
267	4	public function getResolver()
268		{
269	4	if (null === $this->resolver) {
270	4	$this->resolver = new EnvResolver($this->inherit);
271		}
272
273	4	return $this->resolver;
274		}
275
276		/**
277		* @return array w/ a string variable definition (name=value) per value
278		*/
279	12	private function getVarDefinitions()
280		{
281	12	$array = array();
282
283	12	foreach ($this->vars as $name => $value) {
284	11	if (isset($value)) {
285	11	$array[] = sprintf('%s=%s', $name, $value);
286		}
287		}
288
289	12	return $array;
290		}
291		}
292

ktomk / pipelines

Push — master ( 1cedb5...767252 )

Env::getPipelinesProjectPath() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like