LogFormatter::formatDuration() - Code Metrics - Inspection of "Merge pull request #19 from yakatz/patch-2" - vanilla/garden-cli - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Push — master ( 8d1501...2efd40 )

by Adam

created 2017-12-22 16:08 UTC

LogFormatter::formatDuration() B

↳ Parent: LogFormatter

Complexity

Conditions	6
Paths	6

Size

Total Lines	24
Code Lines	21

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	5
CRAP Score	6.1666

Importance

Changes

Metric	Value
dl	0
loc	24
ccs	5
cts	6
cp	0.8333
rs	8.5125
c	0
b	0
f	0
cc	6
eloc	21
nc	6
nop	1
crap	6.1666

<?php
/**
 * @author Todd Burry <[email protected]>
 * @copyright 2009-2015 Vanilla Forums Inc.
 * @license MIT
 */

namespace Garden\Cli;

/**
 * A helper class to format CLI output in a log-style format.
 */
class LogFormatter {
    /**
     * @var string The date format as passed to {@link strftime()}.
     */
    protected $dateFormat = '[%F %T]';

    /**
     * @var string The end of line string to use.
     */
    protected $eol = PHP_EOL;

    /**
     * @var bool Whether or not to format output.
     */
    protected $formatOutput;

    /**
     * @var resource The output file handle.
     */
    protected $outputHandle;

    /**
     * @var bool Whether or not the console is on a new line.
     */
    protected $isNewline = true;

    /**
     * @var int The maximum level deep to output.
     */
    protected $maxLevel = 2;

    /**
     * @var bool Whether or not to show durations for tasks.
     */
    protected $showDurations = true;

    /**
     * @var array An array of currently running tasks.
     */
    protected $taskStack = [];

    /**
     * LogFormatter constructor.
     */
    public function __construct() {
        $this->formatOutput = Cli::guessFormatOutput();
        $this->outputHandle = fopen('php://output', 'w');
    }

    /**
     * Output an error message.
     *
     * When formatting is turned on, error messages are displayed in red. Error messages are always output, even if they
     * are past the maximum display level.
     *
     * @param string $str The message to output.
     * @return LogFormatter Returns `$this` for fluent calls.
     */
    public function error($str) {
        return $this->message($this->formatString($str, ["\033[1;31m", "\033[0m"]), true);
    }

    /**
     * Output a success message.
     *
     * When formatting is turned on, success messages are displayed in green.
     *
     * @param string $str The message to output.
     * @return LogFormatter Returns `$this` for fluent calls.
     */
    public function success($str) {
        return $this->message($this->formatString($str, ["\033[1;32m", "\033[0m"]));
    }

    /**
     * Output a warning message.
     *
     * When formatting is turned on, warning messages are displayed in yellow.
     *
     * @param string $str The message to output.
     * @return LogFormatter Returns `$this` for fluent calls.
     */
    public function warn($str) {
        return $this->message($this->formatString($str, ["\033[1;33m", "\033[0m"]));
    }

    /**
     * Get the current depth of tasks.
     *
     * @return int Returns the current level.
     */
    protected function currentLevel() {
        return count($this->taskStack) + 1;
    }

    /**
     * Output a message that designates the beginning of a task.
     *
     * @param string $str The message to output.
     * @return $this Returns `$this` for fluent calls.
     */
    public function begin($str) {
        $output = $this->currentLevel() <= $this->getMaxLevel();
        $task = [$str, microtime(true), $output];
$a = "a";
$ab = "ab";
$abc = "abc";

        if ($output) {
            if (!$this->isNewline) {
                $this->write($this->getEol());
                $this->isNewline = true;
            }

            $this->write($this->messageStr($str, false));
            $this->isNewline = false;
        }

        array_push($this->taskStack, $task);

        return $this;
    }

    /**
     * Output a message that designates a task being completed.
     *
     * @param string $str The message to output.
     * @param bool $force Whether or not to always output the message even if the task is past the max depth.
     * @return $this Returns `$this` for fluent calls.
     */
    public function end($str = '', $force = false) {
        // Find the task we are finishing.
        $task = array_pop($this->taskStack);
        if ($task !== null) {
            list($taskStr, $taskTimestamp, $taskOutput) = $task;
            $timespan = microtime(true) - $taskTimestamp;
$a = "a";
$ab = "ab";
$abc = "abc";
        } else {
            trigger_error('Called LogFormatter::end() without calling LogFormatter::begin()', E_USER_NOTICE);
        }

        $pastMaxLevel = $this->currentLevel() > $this->getMaxLevel();
        if ($pastMaxLevel) {
            if ($force && isset($taskStr) && isset($taskOutput)) {
                if (!$taskOutput) {
                    // Output the full task string if it hasn't already been output.
                    $str = trim($taskStr.' '.$str);
                }
                if (!$this->isNewline) {
                    $this->write($this->getEol());
                    $this->isNewline = true;
                }
            } else {
                return $this;
            }
        }

        if (!empty($timespan) && $this->getShowDurations()) {
            $str = trim($str.' '.$this->formatString($this->formatDuration($timespan), ["\033[1;34m", "\033[0m"]));
        }

        if ($this->isNewline) {
            // Output the end message as a normal message.
            $this->message($str, $force);
        } else {
            // Output the end message on the same line.
            $this->write(' '.$str.$this->getEol());
            $this->isNewline = true;
        }

        return $this;
    }

    /**
     * Output a message that represents a task being completed in success.
     *
     * When formatting is turned on, success messages are output in green.
     *
     * @param string $str The message to output.
     * @param bool $force Whether or not to force a message past the max level to be output.
     * @return LogFormatter Returns `$this` for fluent calls.
     */
    public function endSuccess($str, $force = false) {
        return $this->end($this->formatString($str, ["\033[1;32m", "\033[0m"]), $force);
    }

    /**
     * Output a message that represents a task being completed in an error.
     *
     * When formatting is turned on, error messages are output in red. Error messages are always output even if they are
     * past the maximum depth.
     *
     * @param string $str The message to output.
     * @return LogFormatter Returns `$this` for fluent calls.
     */
    public function endError($str) {
        return $this->end($this->formatString($str, ["\033[1;31m", "\033[0m"]), true);
    }

    /**
     * Output a message that ends a task with an HTTP status code.
     *
     * This method is useful if you are making a call to an external API as a task. You can end the task by passing the
     * response code to this message.
     *
     * @param int $httpStatus The HTTP status code that represents the completion of a task.
     * @param bool $force Whether or not to force message output.
     * @return $this Returns `$this` for fluent calls.
     * @see LogFormatter::endSuccess(), LogFormatter::endError().
     */
    public function endHttpStatus($httpStatus, $force = false) {
        $statusStr = sprintf('%03d', $httpStatus);

        if ($httpStatus == 0 || $httpStatus >= 400) {
            $this->endError($statusStr);
        } elseif ($httpStatus >= 200 && $httpStatus < 300) {
            $this->endSuccess($statusStr, $force);
        } else {
            $this->end($statusStr, $force);
        }

        return $this;
    }

    /**
     * Format a time duration.
     *
     * @param float $duration The duration in seconds and fractions of a second.
     * @return string Returns the duration formatted for humans.
     * @see microtime()
     */
    public function formatDuration($duration) {
        if ($duration < 1.0e-3) {
            $n = number_format($duration * 1.0e6, 0);
            $sx = 'μs';
        } elseif ($duration < 1) {
            $n = number_format($duration * 1000, 0);
            $sx = 'ms';
        } elseif ($duration < 60) {
            $n = number_format($duration, 1);
            $sx = 's';
        } elseif ($duration < 3600) {
            $n = number_format($duration / 60, 1);
            $sx = 'm';
        } elseif ($duration < 86400) {
            $n = number_format($duration / 3600, 1);
            $sx = 'h';
        } else {
            $n = number_format($duration / 86400, 1);
            $sx = 'd';
        }

        $result = rtrim($n, '0.').$sx;
        return $result;
    }

    /**
     * Output a message.
     *
     * @param string $str The message to output.
     * @param bool $force Whether or not to force output of the message even if it's past the max depth.
     * @return $this Returns `$this` for fluent calls.
     */
    public function message($str, $force = false) {
        $pastMaxLevel = $this->currentLevel() > $this->getMaxLevel();

        if ($pastMaxLevel) {
            if ($force) {
                // Trace down the task list and output everything that hasn't already been output.
                foreach ($this->taskStack as $indent => $task) {
                    list($taskStr, $taskTimestamp, $taskOutput) = $this->taskStack[$indent];
                    if (!$taskOutput) {
                        if (!$this->isNewline) {
                            $this->write($this->eol);
                            $this->isNewline = true;
                        }
                        $this->write($this->fullMessageStr($taskTimestamp, $taskStr, $indent, true));
                        $this->taskStack[$indent][2] = true;
                    } else {
                        continue;
                    }
                }
            } else {
                return $this;
            }
        }

        if (!$this->isNewline) {
            $this->write($this->eol);
            $this->isNewline = true;
        }
        $this->write($this->messageStr($str, true));
        return $this;
    }

    /**
     * Get whether or not output should be formatted.
     *
     * @return boolean Returns **true** if output should be formatted or **false** otherwise.
     */
    public function getFormatOutput() {
        return $this->formatOutput;
    }

    /**
     * Set whether or not output should be formatted.
     *
     * @param boolean $formatOutput Whether or not to format output.
     * @return LogFormatter Returns `$this` for fluent calls.
     */
    public function setFormatOutput($formatOutput) {
        $this->formatOutput = $formatOutput;
        return $this;
    }

    protected function fullMessageStr($timestamp, $str, $indent = null, $eol = true) {
        if ($indent === null) {
            $indent = $this->currentLevel() - 1;
        }

        if ($indent <= 0) {
            $indentStr = '';
        } elseif ($indent === 1) {
            $indentStr = '- ';
        } else {
            $indentStr = str_repeat('  ', $indent - 1).'- ';
        }

        $result = $indentStr.$str;

        if ($this->getDateFormat()) {
            $result = strftime($this->getDateFormat(), $timestamp).' '.$result;
        }

        if ($eol) {
            $result .= $this->eol;
        }
        return $result;
    }

    /**
     * Create a message string.
     *
     * @param string $str The message to output.
     * @param bool $eol Whether or not to add an EOL.
     * @return string Returns the message.
     */
    protected function messageStr($str, $eol = true) {
        return $this->fullMessageStr(time(), $str, null, $eol);
    }

    /**
     * Format some text for the console.
     *
     * @param string $text The text to format.
     * @param string[] $wrap The format to wrap in the form ['before', 'after'].
     * @return string Returns the string formatted according to {@link Cli::$format}.
     */
    protected function formatString($text, array $wrap) {
        if ($this->formatOutput) {
            return "{$wrap[0]}$text{$wrap[1]}";
        } else {
            return $text;
        }
    }

    /**
     * Get the maxLevel.
     *
     * @return int Returns the maxLevel.
     */
    public function getMaxLevel() {
        return $this->maxLevel;
    }

    /**
     * @param int $maxLevel
     * @return LogFormatter
     */
    public function setMaxLevel($maxLevel) {
        if ($maxLevel < 0) {
            throw new \InvalidArgumentException("The max level must be greater than zero.", 416);
        }

        $this->maxLevel = $maxLevel;
        return $this;
    }

    /**
     * Get the date format as passed to {@link strftime()}.
     *
     * @return string Returns the date format.
     * @see strftime()
     */
    public function getDateFormat() {
        return $this->dateFormat;
    }

    /**
     * Set the date format as passed to {@link strftime()}.
     *
     * @param string $dateFormat
     * @return LogFormatter Returns `$this` for fluent calls.
     * @see strftime()
     */
    public function setDateFormat($dateFormat) {
        $this->dateFormat = $dateFormat;
        return $this;
    }

    /**
     * Get the end of line string to use.
     *
     * @return string Returns the eol string.
     */
    public function getEol() {
        return $this->eol;
    }

    /**
     * Set the end of line string.
     *
     * @param string $eol The end of line string to use.
     * @return LogFormatter Returns `$this` for fluent calls.
     */
    public function setEol($eol) {
        $this->eol = $eol;
        return $this;
    }

    /**
     * Get the showDurations.
     *
     * @return boolean Returns the showDurations.
     */
    public function getShowDurations() {
        return $this->showDurations;
    }

    /**
     * Set the showDurations.
     *
     * @param boolean $showDurations
     * @return LogFormatter Returns `$this` for fluent calls.
     */
    public function setShowDurations($showDurations) {
        $this->showDurations = $showDurations;
        return $this;
    }

    /**
     * Set the output file handle.
     *
     * @param resource $handle
     * @return LogFormatter Returns `$this` for fluent calls.
     */
    public function setOutputHandle($handle) {
        if (feof($handle)) {
            throw new \InvalidArgumentException("The provided file handle must be open.", 416);
        }
        $this->outputHandle = $handle;
        return $this;
    }

    /**
     * Write a string to the CLI.
     *
     * This method is intended to centralize the echoing of output in case the class is subclassed and the behaviour
     * needs to change.
     *
     * @param string $str The string to write.
     */
    public function write($str) {
        if (feof($this->outputHandle)) {
            trigger_error('Called LogFormatter::write() but file handle was closed.', E_USER_WARNING);
            return;
        }
        fwrite($this->outputHandle, $str);
    }
}


1		<?php
2		/**
3		* @author Todd Burry <[email protected]>
4		* @copyright 2009-2015 Vanilla Forums Inc.
5		* @license MIT
6		*/
7
8		namespace Garden\Cli;
9
10		/**
11		* A helper class to format CLI output in a log-style format.
12		*/
13		class LogFormatter {
14		/**
15		* @var string The date format as passed to {@link strftime()}.
16		*/
17		protected $dateFormat = '[%F %T]';
18
19		/**
20		* @var string The end of line string to use.
21		*/
22		protected $eol = PHP_EOL;
23
24		/**
25		* @var bool Whether or not to format output.
26		*/
27		protected $formatOutput;
28
29		/**
30		* @var resource The output file handle.
31		*/
32		protected $outputHandle;
33
34		/**
35		* @var bool Whether or not the console is on a new line.
36		*/
37		protected $isNewline = true;
38
39		/**
40		* @var int The maximum level deep to output.
41		*/
42		protected $maxLevel = 2;
43
44		/**
45		* @var bool Whether or not to show durations for tasks.
46		*/
47		protected $showDurations = true;
48
49		/**
50		* @var array An array of currently running tasks.
51		*/
52		protected $taskStack = [];
53
54		/**
55		* LogFormatter constructor.
56		*/
57	13	public function __construct() {
58		$this->formatOutput = Cli::guessFormatOutput();
59		$this->outputHandle = fopen('php://output', 'w');
60	13	}
61
62		/**
63		* Output an error message.
64		*
65		* When formatting is turned on, error messages are displayed in red. Error messages are always output, even if they
66		* are past the maximum display level.
67		*
68		* @param string $str The message to output.
69		* @return LogFormatter Returns `$this` for fluent calls.
70		*/
71		public function error($str) {
72		return $this->message($this->formatString($str, ["\033[1;31m", "\033[0m"]), true);
73		}
74
75		/**
76		* Output a success message.
77		*
78		* When formatting is turned on, success messages are displayed in green.
79		*
80		* @param string $str The message to output.
81		* @return LogFormatter Returns `$this` for fluent calls.
82		*/
83		public function success($str) {
84		return $this->message($this->formatString($str, ["\033[1;32m", "\033[0m"]));
85		}
86
87		/**
88		* Output a warning message.
89		*
90		* When formatting is turned on, warning messages are displayed in yellow.
91		*
92		* @param string $str The message to output.
93		* @return LogFormatter Returns `$this` for fluent calls.
94		*/
95		public function warn($str) {
96		return $this->message($this->formatString($str, ["\033[1;33m", "\033[0m"]));
97		}
98
99		/**
100		* Get the current depth of tasks.
101		*
102	6	* @return int Returns the current level.
103		*/
104		protected function currentLevel() {
105		return count($this->taskStack) + 1;
106	3	}
107	6
108		/**
109	2	* Output a message that designates the beginning of a task.
110		*
111		* @param string $str The message to output.
112		* @return $this Returns `$this` for fluent calls.
113	6	*/
114		public function begin($str) {
115		$output = $this->currentLevel() <= $this->getMaxLevel();
116		$task = [$str, microtime(true), $output];
		0 ignored issues – show Coding Style introduced 2016-04-14 20:16 UTC by Report Bug Copy Issue Report Equals sign not aligned with surrounding assignments; expected 3 spaces but found 1 space This check looks for multiple assignments in successive lines of code. It will report an issue if the operators are not in a straight line. To visualize $a = "a"; $ab = "ab"; $abc = "abc"; will produce issues in the first and second line, while this second example $a = "a"; $ab = "ab"; $abc = "abc"; will produce no issues. Loading history...
117
118	3	if ($output) {
119		if (!$this->isNewline) {
120		$this->write($this->getEol());
121		$this->isNewline = true;
122		}
123
124		$this->write($this->messageStr($str, false));
125		$this->isNewline = false;
126		}
127
128	4	array_push($this->taskStack, $task);
129
130		return $this;
131	2	}
132	3
133		/**
134		* Output a message that designates a task being completed.
135		*
136	3	* @param string $str The message to output.
137		* @param bool $force Whether or not to always output the message even if the task is past the max depth.
138		* @return $this Returns `$this` for fluent calls.
139	2	*/
140	3	public function end($str = '', $force = false) {
141	1	// Find the task we are finishing.
142		$task = array_pop($this->taskStack);
143		if ($task !== null) {
144		list($taskStr, $taskTimestamp, $taskOutput) = $task;
145	1	$timespan = microtime(true) - $taskTimestamp;
		0 ignored issues – show Coding Style introduced 2016-04-14 20:16 UTC by Report Bug Copy Issue Report Equals sign not aligned with surrounding assignments; expected 35 spaces but found 1 space This check looks for multiple assignments in successive lines of code. It will report an issue if the operators are not in a straight line. To visualize $a = "a"; $ab = "ab"; $abc = "abc"; will produce issues in the first and second line, while this second example $a = "a"; $ab = "ab"; $abc = "abc"; will produce no issues. Loading history...
146		} else {
147	1	trigger_error('Called LogFormatter::end() without calling LogFormatter::begin()', E_USER_NOTICE);
148		}
149
150	2	$pastMaxLevel = $this->currentLevel() > $this->getMaxLevel();
151	1	if ($pastMaxLevel) {
152		if ($force && isset($taskStr) && isset($taskOutput)) {
153		if (!$taskOutput) {
154		// Output the full task string if it hasn't already been output.
155		$str = trim($taskStr.' '.$str);
156		}
157		if (!$this->isNewline) {
158	4	$this->write($this->getEol());
159		$this->isNewline = true;
160		}
161		} else {
162		return $this;
163		}
164	4	}
165	4
166		if (!empty($timespan) && $this->getShowDurations()) {
167	4	$str = trim($str.' '.$this->formatString($this->formatDuration($timespan), ["\033[1;34m", "\033[0m"]));
168	3	}
169
170		if ($this->isNewline) {
171		// Output the end message as a normal message.
172		$this->message($str, $force);
173		} else {
174		// Output the end message on the same line.
175		$this->write(' '.$str.$this->getEol());
176		$this->isNewline = true;
177		}
178
179		return $this;
180		}
181
182		/**
183		* Output a message that represents a task being completed in success.
184		*
185		* When formatting is turned on, success messages are output in green.
186		*
187		* @param string $str The message to output.
188		* @param bool $force Whether or not to force a message past the max level to be output.
189		* @return LogFormatter Returns `$this` for fluent calls.
190		*/
191		public function endSuccess($str, $force = false) {
192		return $this->end($this->formatString($str, ["\033[1;32m", "\033[0m"]), $force);
193		}
194
195		/**
196		* Output a message that represents a task being completed in an error.
197		*
198		* When formatting is turned on, error messages are output in red. Error messages are always output even if they are
199		* past the maximum depth.
200		*
201		* @param string $str The message to output.
202		* @return LogFormatter Returns `$this` for fluent calls.
203		*/
204		public function endError($str) {
205		return $this->end($this->formatString($str, ["\033[1;31m", "\033[0m"]), true);
206		}
207
208		/**
209		* Output a message that ends a task with an HTTP status code.
210		*
211		* This method is useful if you are making a call to an external API as a task. You can end the task by passing the
212		* response code to this message.
213		*
214		* @param int $httpStatus The HTTP status code that represents the completion of a task.
215		* @param bool $force Whether or not to force message output.
216		* @return $this Returns `$this` for fluent calls.
217		* @see LogFormatter::endSuccess(), LogFormatter::endError().
218		*/
219		public function endHttpStatus($httpStatus, $force = false) {
220		$statusStr = sprintf('%03d', $httpStatus);
221
222		if ($httpStatus == 0 \|\| $httpStatus >= 400) {
223		$this->endError($statusStr);
224		} elseif ($httpStatus >= 200 && $httpStatus < 300) {
225		$this->endSuccess($statusStr, $force);
226		} else {
227		$this->end($statusStr, $force);
228	1	}
229
230		return $this;
231	1	}
232
233		/**
234	1	* Format a time duration.
235		*
236		* @param float $duration The duration in seconds and fractions of a second.
237	1	* @return string Returns the duration formatted for humans.
238		* @see microtime()
239		*/
240	1	public function formatDuration($duration) {
241		if ($duration < 1.0e-3) {
242		$n = number_format($duration * 1.0e6, 0);
243	1	$sx = 'μs';
244		} elseif ($duration < 1) {
245		$n = number_format($duration * 1000, 0);
246	1	$sx = 'ms';
247		} elseif ($duration < 60) {
248		$n = number_format($duration, 1);
249		$sx = 's';
250		} elseif ($duration < 3600) {
251		$n = number_format($duration / 60, 1);
252		$sx = 'm';
253		} elseif ($duration < 86400) {
254		$n = number_format($duration / 3600, 1);
255		$sx = 'h';
256		} else {
257		$n = number_format($duration / 86400, 1);
258		$sx = 'd';
259		}
260	8
261		$result = rtrim($n, '0.').$sx;
262		return $result;
263	4	}
264	2
265		/**
266	3	* Output a message.
267	1	*
268	1	* @param string $str The message to output.
269	1	* @param bool $force Whether or not to force output of the message even if it's past the max depth.
270		* @return $this Returns `$this` for fluent calls.
271	1	*/
272		public function message($str, $force = false) {
273		$pastMaxLevel = $this->currentLevel() > $this->getMaxLevel();
274	1
275		if ($pastMaxLevel) {
276	2	if ($force) {
277	1	// Trace down the task list and output everything that hasn't already been output.
278		foreach ($this->taskStack as $indent => $task) {
279		list($taskStr, $taskTimestamp, $taskOutput) = $this->taskStack[$indent];
280	5	if (!$taskOutput) {
281	3	if (!$this->isNewline) {
282		$this->write($this->eol);
283		$this->isNewline = true;
284	4	}
285		$this->write($this->fullMessageStr($taskTimestamp, $taskStr, $indent, true));
286	2	$this->taskStack[$indent][2] = true;
287		} else {
288		continue;
289	4	}
290	8	}
291		} else {
292		return $this;
293		}
294		}
295
296		if (!$this->isNewline) {
297		$this->write($this->eol);
298		$this->isNewline = true;
299		}
300		$this->write($this->messageStr($str, true));
301		return $this;
302		}
303
304		/**
305		* Get whether or not output should be formatted.
306		*
307	10	* @return boolean Returns true if output should be formatted or false otherwise.
308	10	*/
309	10	public function getFormatOutput() {
310		return $this->formatOutput;
311		}
312	4
313	4	/**
314		* Set whether or not output should be formatted.
315		*
316		* @param boolean $formatOutput Whether or not to format output.
317	4	* @return LogFormatter Returns `$this` for fluent calls.
318	4	*/
319	2	public function setFormatOutput($formatOutput) {
320	3	$this->formatOutput = $formatOutput;
321		return $this;
322		}
323	4
324		protected function fullMessageStr($timestamp, $str, $indent = null, $eol = true) {
325	4	if ($indent === null) {
326		$indent = $this->currentLevel() - 1;
327		}
328
329		if ($indent <= 0) {
330		$indentStr = '';
331	4	} elseif ($indent === 1) {
332	4	$indentStr = '- ';
333		} else {
334	4	$indentStr = str_repeat(' ', $indent - 1).'- ';
335		}
336
337		$result = $indentStr.$str;
338
339		if ($this->getDateFormat()) {
340		$result = strftime($this->getDateFormat(), $timestamp).' '.$result;
341		}
342
343		if ($eol) {
344		$result .= $this->eol;
345		}
346		return $result;
347		}
348
349		/**
350		* Create a message string.
351		*
352		* @param string $str The message to output.
353		* @param bool $eol Whether or not to add an EOL.
354		* @return string Returns the message.
355	3	*/
356	3	protected function messageStr($str, $eol = true) {
357		return $this->fullMessageStr(time(), $str, null, $eol);
358		}
359	3
360		/**
361	3	* Format some text for the console.
362		*
363		* @param string $text The text to format.
364		* @param string[] $wrap The format to wrap in the form ['before', 'after'].
365		* @return string Returns the string formatted according to {@link Cli::$format}.
366		*/
367		protected function formatString($text, array $wrap) {
368	2	if ($this->formatOutput) {
369	2	return "{$wrap[0]}$text{$wrap[1]}";
370		} else {
371		return $text;
372		}
373		}
374
375		/**
376	12	* Get the maxLevel.
377	12	*
378		* @return int Returns the maxLevel.
379		*/
380		public function getMaxLevel() {
381	11	return $this->maxLevel;
382	11	}
383
384		/**
385		* @param int $maxLevel
386		* @return LogFormatter
387		*/
388		public function setMaxLevel($maxLevel) {
389		if ($maxLevel < 0) {
390		throw new \InvalidArgumentException("The max level must be greater than zero.", 416);
391	1	}
392	1
393		$this->maxLevel = $maxLevel;
394		return $this;
395		}
396
397		/**
398		* Get the date format as passed to {@link strftime()}.
399		*
400		* @return string Returns the date format.
401		* @see strftime()
402	9	*/
403	9	public function getDateFormat() {
404	9	return $this->dateFormat;
405		}
406
407		/**
408		* Set the date format as passed to {@link strftime()}.
409		*
410		* @param string $dateFormat
411		* @return LogFormatter Returns `$this` for fluent calls.
412	5	* @see strftime()
413	5	*/
414		public function setDateFormat($dateFormat) {
415		$this->dateFormat = $dateFormat;
416		return $this;
417		}
418
419		/**
420		* Get the end of line string to use.
421		*
422	11	* @return string Returns the eol string.
423	11	*/
424	11	public function getEol() {
425		return $this->eol;
426		}
427
428		/**
429		* Set the end of line string.
430		*
431		* @param string $eol The end of line string to use.
432	5	* @return LogFormatter Returns `$this` for fluent calls.
433	5	*/
434		public function setEol($eol) {
435		$this->eol = $eol;
436		return $this;
437		}
438
439		/**
440		* Get the showDurations.
441		*
442	11	* @return boolean Returns the showDurations.
443	11	*/
444	11	public function getShowDurations() {
445		return $this->showDurations;
446		}
447
448		/**
449		* Set the showDurations.
450		*
451		* @param boolean $showDurations
452		* @return LogFormatter Returns `$this` for fluent calls.
453		*/
454		public function setShowDurations($showDurations) {
455		$this->showDurations = $showDurations;
456		return $this;
457		}
458
459		/**
460		* Set the output file handle.
461		*
462		* @param resource $handle
463		* @return LogFormatter Returns `$this` for fluent calls.
464		*/
465		public function setOutputHandle($handle) {
466		if (feof($handle)) {
467		throw new \InvalidArgumentException("The provided file handle must be open.", 416);
468		}
469	2	$this->outputHandle = $handle;
470		return $this;
471		}
472
473		/**
474		* Write a string to the CLI.
475	2	*
476		* This method is intended to centralize the echoing of output in case the class is subclassed and the behaviour
477		* needs to change.
478		*
479		* @param string $str The string to write.
480		*/
481		public function write($str) {
482		if (feof($this->outputHandle)) {
483		trigger_error('Called LogFormatter::write() but file handle was closed.', E_USER_WARNING);
484		return;
485		}
486		fwrite($this->outputHandle, $str);
487		}
488		}
489

vanilla / garden-cli

Push — master ( 8d1501...2efd40 )

LogFormatter::formatDuration() B

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like