Properties::__toString() - Code Metrics - Inspection of "Bump squizlabs/php_codesniffer from 3.5.5 to 3.5.6..." - phingofficial/phing - Measure and Improve Code Quality continuously with Scrutinizer

Passed

Push — master ( afa2e3...eb32d2 )

by Siad

created 2020-09-01 12:44 UTC

Properties::__toString() A

↳ Parent: Properties

Complexity

Conditions	2
Paths	2

Size

Total Lines	8
Code Lines	4

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	5
CRAP Score	2

Importance

Changes

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

<?php
/**
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 *
 * This software consists of voluntary contributions made by many individuals
 * and is licensed under the LGPL. For more information please see
 * <http://phing.info>.
 */

/**
 * Convenience class for reading and writing property files.
 *
 * FIXME
 *        - Add support for arrays (separated by ',')
 *
 * @package phing.system.util
 */
class Properties
{
    private $properties = [];

    /**
     * @var FileParserInterface
     */
    private $fileParser;

    /**
     * @var PhingFile
     */
    private $file = null;

    /**
     * Constructor
     *
     * @param array $properties
     * @param FileParserInterface $fileParser
     */
    public function __construct($properties = null, FileParserInterface $fileParser = null)
    {
        $this->fileParser = $fileParser == null ? new IniFileParser() : $fileParser;

        if (is_array($properties)) {
            foreach ($properties as $key => $value) {
                $this->setProperty($key, $value);
            }
        }
    }

    /**
     * Load properties from a file.
     *
     * @param  PhingFile $file
     * @return void
     * @throws IOException - if unable to read file.
     */
    public function load(PhingFile $file)
    {
        if ($file->canRead()) {
            $this->parse($file);

            $this->file = $file;
        } else {
            throw new IOException("Can not read file " . $file->getPath());
        }
    }

    /**
     * Parses the file given.
     *
     * @param PhingFile $file
     */
    protected function parse(PhingFile $file)
    {
        $this->properties = $this->fileParser->parseFile($file);
    }

    /**
     * Process values when being written out to properties file.
     * does things like convert true => "true"
     *
     * @param  mixed $val The property value (may be boolean, etc.)
     * @return string
     */
    protected function outVal($val)
    {
        if ($val === true) {
            $val = "true";
        } elseif ($val === false) {
            $val = "false";
        }

        return $val;
    }

    /**
     * Create string representation that can be written to file and would be loadable using load() method.
     *
     * Essentially this function creates a string representation of properties that is ready to
     * write back out to a properties file.  This is used by store() method.
     *
     * @return string
     */
    public function __toString()
    {
        $buf = "";
        foreach ($this->properties as $key => $item) {
            $buf .= $key . "=" . $this->outVal($item) . PHP_EOL;
        }

        return $buf;
    }

    /**
     * Stores current properties to specified file.
     *
     * @param  PhingFile $file File to create/overwrite with properties.
     * @param  string $header Header text that will be placed (within comments) at the top of properties file.
     * @return void
     * @throws IOException - on error writing properties file.
     */
    public function store(PhingFile $file = null, $header = null)
    {
        if ($file == null) {
            $file = $this->file;
        }

        if ($file == null) {
            throw new IOException("Unable to write to empty filename");
        }

        // stores the properties in this object in the file denoted
        // if file is not given and the properties were loaded from a
        // file prior, this method stores them in the file used by load()
        try {
            $fw = new FileWriter($file);
            if ($header !== null) {
                $fw->write("# " . $header . PHP_EOL);
            }
            $fw->write((string) $this);
            $fw->close();
        } catch (IOException $e) {
            throw new IOException("Error writing property file: " . $e->getMessage());
        }
    }

    public function storeOutputStream(OutputStream $os, $comments)
    {
        $this->_storeOutputStream(new BufferedWriter(new OutputStreamWriter($os)), $comments);
    }

    private function _storeOutputStream(BufferedWriter $bw, $comments)
    {
        if ($comments != null) {
            self::writeComments($bw, $comments);
        }
        $bw->write("#" . gmdate('D, d M Y H:i:s', time()) . ' GMT');
        $bw->newLine();
        foreach ($this->getProperties() as $key => $value) {
            $bw->write($key . "=" . $value);
            $bw->newLine();
        }
        $bw->flush();
    }

    private static function writeComments(BufferedWriter $bw, $comments)
    {
        $rows = explode("\n", $comments);
        $bw->write("#" . PHP_EOL);
        foreach ($rows as $row) {
            $bw->write(sprintf("#%s%s", trim($row), PHP_EOL));
        }
        $bw->write("#");
        $bw->newLine();
    }

    /**
     * Returns copy of internal properties hash.
     * Mostly for performance reasons, property hashes are often
     * preferable to passing around objects.
     *
     * @return array
     */
    public function getProperties()
    {
        return $this->properties;
    }

    /**
     * Get value for specified property.
     * This is the same as get() method.
     *
     * @param  string $prop The property name (key).
     * @return mixed
     * @see    get()
     */
    public function getProperty($prop)
    {
        if (!isset($this->properties[$prop])) {
            return null;
        }

        return $this->properties[$prop];
    }

    /**
     * Get value for specified property.
     * This function exists to provide a hashtable-like interface for
     * properties.
     *
     * @param  string $prop The property name (key).
     * @return mixed
     * @see    getProperty()
     */
    public function get($prop)
    {
        if (!isset($this->properties[$prop])) {
            return null;
        }

        return $this->properties[$prop];
    }

    /**
     * Set the value for a property.
     *
     * @param  string $key
     * @param  mixed $value
     * @return mixed  Old property value or null if none was set.
     */
    public function setProperty($key, $value)
    {
        $oldValue = $this->properties[$key] ?? null;
        $this->properties[$key] = $value;

        return $oldValue;
    }

    /**
     * Set the value for a property.
     * This function exists to provide hashtable-lie
     * interface for properties.
     *
     * @param  string $key
     * @param  mixed $value
     * @return mixed
     */
    public function put($key, $value)
    {
        return $this->setProperty($key, $value);
    }

    /**
     * Appends a value to a property if it already exists with a delimiter
     *
     * If the property does not, it just adds it.
     *
     * @param string $key
     * @param mixed $value
     * @param string $delimiter
     */
    public function append($key, $value, $delimiter = ',')
    {
        $newValue = $value;
        if (isset($this->properties[$key]) && !empty($this->properties[$key])) {
            $newValue = $this->properties[$key] . $delimiter . $value;
        }
        $this->properties[$key] = $newValue;
    }

    /**
     * Same as keys() function, returns an array of property names.
     *
     * @return array
     */
    public function propertyNames()
    {
        return $this->keys();
    }

    /**
     * Whether loaded properties array contains specified property name.
     *
     * @param  $key
     * @return boolean
     */
    public function containsKey($key)
    {
        return isset($this->properties[$key]);
    }

    /**
     * Returns properties keys.
     * Use this for foreach () {} iterations, as this is
     * faster than looping through property values.
     *
     * @return array
     */
    public function keys()
    {
        return array_keys($this->properties);
    }

    /**
     * Whether properties list is empty.
     *
     * @return boolean
     */
    public function isEmpty()
    {
        return empty($this->properties);
    }
}


1		<?php
2		/**
3		* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
4		* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
5		* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
6		* A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
7		* OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
8		* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
9		* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
10		* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
11		* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
12		* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
13		* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
14		*
15		* This software consists of voluntary contributions made by many individuals
16		* and is licensed under the LGPL. For more information please see
17		* <http://phing.info>.
18		*/
19
20		/**
21		* Convenience class for reading and writing property files.
22		*
23		* FIXME
24		* - Add support for arrays (separated by ',')
25		*
26		* @package phing.system.util
27		*/
28		class Properties
29		{
30		private $properties = [];
31
32		/**
33		* @var FileParserInterface
34		*/
35		private $fileParser;
36
37		/**
38		* @var PhingFile
39		*/
40		private $file = null;
41
42		/**
43		* Constructor
44		*
45		* @param array $properties
46		* @param FileParserInterface $fileParser
47		*/
48	824	public function __construct($properties = null, FileParserInterface $fileParser = null)
49		{
50	824	$this->fileParser = $fileParser == null ? new IniFileParser() : $fileParser;
51
52	824	if (is_array($properties)) {
53		foreach ($properties as $key => $value) {
54		$this->setProperty($key, $value);
55		}
56		}
57	824	}
58
59		/**
60		* Load properties from a file.
61		*
62		* @param PhingFile $file
63		* @return void
64		* @throws IOException - if unable to read file.
65		*/
66	820	public function load(PhingFile $file)
67		{
68	820	if ($file->canRead()) {
69	820	$this->parse($file);
70
71	820	$this->file = $file;
72		} else {
73		throw new IOException("Can not read file " . $file->getPath());
74		}
75	820	}
76
77		/**
78		* Parses the file given.
79		*
80		* @param PhingFile $file
81		*/
82	820	protected function parse(PhingFile $file)
83		{
84	820	$this->properties = $this->fileParser->parseFile($file);
85	820	}
86
87		/**
88		* Process values when being written out to properties file.
89		* does things like convert true => "true"
90		*
91		* @param mixed $val The property value (may be boolean, etc.)
92		* @return string
93		*/
94	5	protected function outVal($val)
95		{
96	5	if ($val === true) {
97		$val = "true";
98	5	} elseif ($val === false) {
99		$val = "false";
100		}
101
102	5	return $val;
103		}
104
105		/**
106		* Create string representation that can be written to file and would be loadable using load() method.
107		*
108		* Essentially this function creates a string representation of properties that is ready to
109		* write back out to a properties file. This is used by store() method.
110		*
111		* @return string
112		*/
113	5	public function __toString()
114		{
115	5	$buf = "";
116	5	foreach ($this->properties as $key => $item) {
117	5	$buf .= $key . "=" . $this->outVal($item) . PHP_EOL;
118		}
119
120	5	return $buf;
121		}
122
123		/**
124		* Stores current properties to specified file.
125		*
126		* @param PhingFile $file File to create/overwrite with properties.
127		* @param string $header Header text that will be placed (within comments) at the top of properties file.
128		* @return void
129		* @throws IOException - on error writing properties file.
130		*/
131	4	public function store(PhingFile $file = null, $header = null)
132		{
133	4	if ($file == null) {
134		$file = $this->file;
135		}
136
137	4	if ($file == null) {
138		throw new IOException("Unable to write to empty filename");
139		}
140
141		// stores the properties in this object in the file denoted
142		// if file is not given and the properties were loaded from a
143		// file prior, this method stores them in the file used by load()
144		try {
145	4	$fw = new FileWriter($file);
146	4	if ($header !== null) {
147	4	$fw->write("# " . $header . PHP_EOL);
148		}
149	4	$fw->write((string) $this);
150	4	$fw->close();
151		} catch (IOException $e) {
152		throw new IOException("Error writing property file: " . $e->getMessage());
153		}
154	4	}
155
156		public function storeOutputStream(OutputStream $os, $comments)
157		{
158		$this->_storeOutputStream(new BufferedWriter(new OutputStreamWriter($os)), $comments);
159		}
160
161		private function _storeOutputStream(BufferedWriter $bw, $comments)
162		{
163		if ($comments != null) {
164		self::writeComments($bw, $comments);
165		}
166		$bw->write("#" . gmdate('D, d M Y H:i:s', time()) . ' GMT');
167		$bw->newLine();
168		foreach ($this->getProperties() as $key => $value) {
169		$bw->write($key . "=" . $value);
170		$bw->newLine();
171		}
172		$bw->flush();
173		}
174
175		private static function writeComments(BufferedWriter $bw, $comments)
176		{
177		$rows = explode("\n", $comments);
178		$bw->write("#" . PHP_EOL);
179		foreach ($rows as $row) {
180		$bw->write(sprintf("#%s%s", trim($row), PHP_EOL));
181		}
182		$bw->write("#");
183		$bw->newLine();
184		}
185
186		/**
187		* Returns copy of internal properties hash.
188		* Mostly for performance reasons, property hashes are often
189		* preferable to passing around objects.
190		*
191		* @return array
192		*/
193	1	public function getProperties()
194		{
195	1	return $this->properties;
196		}
197
198		/**
199		* Get value for specified property.
200		* This is the same as get() method.
201		*
202		* @param string $prop The property name (key).
203		* @return mixed
204		* @see get()
205		*/
206	820	public function getProperty($prop)
207		{
208	820	if (!isset($this->properties[$prop])) {
209	1	return null;
210		}
211
212	820	return $this->properties[$prop];
213		}
214
215		/**
216		* Get value for specified property.
217		* This function exists to provide a hashtable-like interface for
218		* properties.
219		*
220		* @param string $prop The property name (key).
221		* @return mixed
222		* @see getProperty()
223		*/
224	1	public function get($prop)
225		{
226	1	if (!isset($this->properties[$prop])) {
227		return null;
228		}
229
230	1	return $this->properties[$prop];
231		}
232
233		/**
234		* Set the value for a property.
235		*
236		* @param string $key
237		* @param mixed $value
238		* @return mixed Old property value or null if none was set.
239		*/
240	14	public function setProperty($key, $value)
241		{
242	14	$oldValue = $this->properties[$key] ?? null;
243	14	$this->properties[$key] = $value;
244
245	14	return $oldValue;
246		}
247
248		/**
249		* Set the value for a property.
250		* This function exists to provide hashtable-lie
251		* interface for properties.
252		*
253		* @param string $key
254		* @param mixed $value
255		* @return mixed
256		*/
257	5	public function put($key, $value)
258		{
259	5	return $this->setProperty($key, $value);
260		}
261
262		/**
263		* Appends a value to a property if it already exists with a delimiter
264		*
265		* If the property does not, it just adds it.
266		*
267		* @param string $key
268		* @param mixed $value
269		* @param string $delimiter
270		*/
271	1	public function append($key, $value, $delimiter = ',')
272		{
273	1	$newValue = $value;
274	1	if (isset($this->properties[$key]) && !empty($this->properties[$key])) {
275	1	$newValue = $this->properties[$key] . $delimiter . $value;
276		}
277	1	$this->properties[$key] = $newValue;
278	1	}
279
280		/**
281		* Same as keys() function, returns an array of property names.
282		*
283		* @return array
284		*/
285	819	public function propertyNames()
286		{
287	819	return $this->keys();
288		}
289
290		/**
291		* Whether loaded properties array contains specified property name.
292		*
293		* @param $key
294		* @return boolean
295		*/
296	6	public function containsKey($key)
297		{
298	6	return isset($this->properties[$key]);
299		}
300
301		/**
302		* Returns properties keys.
303		* Use this for foreach () {} iterations, as this is
304		* faster than looping through property values.
305		*
306		* @return array
307		*/
308	819	public function keys()
309		{
310	819	return array_keys($this->properties);
311		}
312
313		/**
314		* Whether properties list is empty.
315		*
316		* @return boolean
317		*/
318	1	public function isEmpty()
319		{
320	1	return empty($this->properties);
321		}
322		}
323

phingofficial / phing

Push — master ( afa2e3...eb32d2 )

Properties::__toString() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like