StringHelper::capitalizeForTitle() - Code Metrics - Inspection of "Merge branch 'release/2.4.1'" - seboettg/citeproc-php - Measure and Improve Code Quality continuously with Scrutinizer

Passed

Push — feature/123-styles-distributio... ( b6478c )

by Sebastian

created 2022-05-19 20:47 UTC

StringHelper::capitalizeForTitle() B

↳ Parent: StringHelper

Complexity

Conditions	8
Paths	5

Size

Total Lines	29
Code Lines	20

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	20
CRAP Score	8

Importance

Changes	2
Bugs	0	Features	0

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

<?php /** @noinspection PhpInternalEntityUsedInspection */

/*
 * citeproc-php
 *
 * @link        http://github.com/seboettg/citeproc-php for the source repository
 * @copyright   Copyright (c) 2016 Sebastian Böttger.
 * @license     https://opensource.org/licenses/MIT
 */

namespace Seboettg\CiteProc\Util;

use Seboettg\CiteProc\CiteProc;
use Seboettg\Collection\ArrayList;

/**
 * Class StringHelper
 * @package Seboettg\CiteProc\Util
 *
 * @author Sebastian Böttger <[email protected]>
 */
class StringHelper
{
    const PREPOSITIONS = [
        'on', 'in', 'at', 'since', 'for', 'ago', 'before', 'to', 'past', 'till', 'until', 'by', 'under', 'below',
        'over', 'above', 'across', 'through', 'into', 'towards', 'onto', 'from', 'of', 'off', 'about', 'via'
    ];

    const ARTICLES = [
        'a', 'an', 'the'
    ];

    const ADVERBS = [
        'yet', 'so', 'just', 'only'
    ];

    const CONJUNCTIONS = [
        'nor', 'so', 'and', 'or'
    ];

    const ADJECTIVES = [
        'down', 'up'
    ];

    const ISO_ENCODINGS = [
        'ISO-8859-1',
        'ISO-8859-2',
        'ISO-8859-3',
        'ISO-8859-4',
        'ISO-8859-5',
        'ISO-8859-6',
        'ISO-8859-7',
        'ISO-8859-8',
        'ISO-8859-9',
        'ISO-8859-10',
        'ISO-8859-13',
        'ISO-8859-14',
        'ISO-8859-15',
        'ISO-8859-16'
    ];

    /**
     * opening quote sign
     */
    const OPENING_QUOTE = "“";

    /**
     * closing quote sign
     */
    const CLOSING_QUOTE = "”";

    /**
     * @param $text
     * @return string
     */
    public static function capitalizeAll($text)
    {
        $wordArray = explode(" ", $text);

        array_walk($wordArray, function (&$word) {
            $word = ucfirst($word);
        });

        return implode(" ", array_filter($wordArray));
    }

    /**
     * @param $titleString
     * @return string
     */
    public static function capitalizeForTitle($titleString)
    {
        if (strlen($titleString) == 0) {
            return "";
        }
        if (preg_match('/(.+[^\<\>][\.:\/;\?\!]\s?)([a-z])(.+)/', $titleString, $match)) {
            $titleString = $match[1].StringHelper::mb_ucfirst($match[2]).$match[3];
        }
        $pattern = "/(\s|\/)/";
        if (!preg_match($pattern, $titleString, $matches)) {
            return StringHelper::mb_ucfirst($titleString);
        }
        $delimiter = $matches[1];
        $wordArray = preg_split($pattern, $titleString); //explode(" ", $titleString);

        $wordList = new ArrayList(...$wordArray);
        return $wordList
            ->map(function(string $word) {

                $wordParts = explode("-", $word);
                if (count($wordParts) > 1) {
                    $casedWordParts = [];
                    foreach ($wordParts as $w) {
                        $casedWordParts[] = StringHelper::keepLowerCase($w) ? $w : StringHelper::mb_ucfirst($w);
                    }
                    $word = implode("-", $casedWordParts);
                }
                return StringHelper::keepLowerCase($word) ? $word : StringHelper::mb_ucfirst($word);
            })
            ->collectToString($delimiter);
    }

    /**
     * @param $word
     * @return bool
     */
    public static function keepLowerCase($word)
    {
        // keep lower case if the first char is not an utf-8 letter
        return in_array($word, self::PREPOSITIONS) ||
            in_array($word, self::ARTICLES) ||
            in_array($word, self::CONJUNCTIONS) ||
            in_array($word, self::ADJECTIVES) ||
            (bool) preg_match("/[^\p{L}].+/", $word);
    }

    /**
     * @param $string
     * @param string $encoding
     * @return string
     */
    // phpcs:disable
    public static function mb_ucfirst($string, $encoding = 'UTF-8')
    {// phpcs:enable
        $strlen = mb_strlen($string, $encoding);
        $firstChar = mb_substr($string, 0, 1, $encoding);
        $then = mb_substr($string, 1, $strlen - 1, $encoding);

        /** @noinspection PhpInternalEntityUsedInspection */
        $encoding = mb_detect_encoding($firstChar, self::ISO_ENCODINGS, true);
        return in_array($encoding, self::ISO_ENCODINGS) ?
            mb_strtoupper($firstChar, $encoding).$then : $firstChar.$then;
    }
    // phpcs:disable
    public static function mb_strrev($string)
    {// phpcs:enable
        $result = '';
        for ($i = mb_strlen($string); $i >= 0; --$i) {
            $result .= mb_substr($string, $i, 1);
        }
        return $result;
    }

    /**
     * @param string $delimiter
     * @param string[] $arrayOfStrings
     * @return string;
     */
    public static function implodeAndPreventConsecutiveChars($delimiter, $arrayOfStrings)
    {
        $delim = trim($delimiter);
        if (!empty($delim)) {
            foreach ($arrayOfStrings as $key => $textPart) {
                $pos = mb_strpos(StringHelper::mb_strrev($textPart), StringHelper::mb_strrev($delim));
                if ($pos === 0) {
                    $length = mb_strlen($textPart) - mb_strlen($delim);
                    $textPart = mb_substr($textPart, 0, $length);
                    $arrayOfStrings[$key] = $textPart;
                }
            }
        }
        return implode($delimiter, array_filter($arrayOfStrings));
    }

    /**
     * @param $string
     * @param $initializeSign
     * @return string
     */
    public static function initializeBySpaceOrHyphen($string, $initializeSign)
    {
        $initializeWithHyphen = CiteProc::getContext()->getGlobalOptions()->isInitializeWithHyphen();
        $res = "";
        $exploded = explode("-", $string);
        $i = 0;
        foreach ($exploded as $explode) {
            $spaceExploded = explode(" ", $explode);
            foreach ($spaceExploded as $givenPart) {
                $firstLetter = mb_substr($givenPart, 0, 1, "UTF-8");
                if (StringHelper::isLatinString($firstLetter)) {
                    $res .= ctype_upper($firstLetter) ? $firstLetter.$initializeSign : " ".$givenPart." ";
                } else {
                    $res .= $firstLetter.$initializeSign;
                }
            }
            if ($i < count($exploded) - 1 && $initializeWithHyphen) {
                $res = rtrim($res)."-";
            }
            ++$i;
        }
        return $res;
    }

    /**
     * @param $string
     * @return mixed|string
     */
    public static function camelCase2Hyphen($string)
    {
        $hyphenated = preg_replace("/([A-Z])/", "-$1", $string);
        $hyphenated = substr($hyphenated, 0, 1) === "-" ? substr($hyphenated, 1) : $hyphenated;
        return mb_strtolower($hyphenated);
    }

    /**
     * @param $string
     * @return bool
     */
    public static function checkLowerCaseString($string)
    {
        return ($string === mb_strtolower($string));
    }

    /**
     * @param $string
     * @return bool
     */
    public static function checkUpperCaseString($string)
    {
        return ($string === mb_strtoupper($string));
    }

    /**
     * @param $string
     * @return mixed
     */
    public static function clearApostrophes($string)
    {
        return preg_replace("/\'/", "’", $string);
    }

    /**
     * replaces outer quotes of $text by given inner quotes
     *
     * @param $text
     * @param $outerOpenQuote
     * @param $outerCloseQuote
     * @param $innerOpenQuote
     * @param $innerCloseQuote
     * @return string
     */
    public static function replaceOuterQuotes(
        $text,
        $outerOpenQuote,
        $outerCloseQuote,
        $innerOpenQuote,
        $innerCloseQuote
    ) {
        if (preg_match("/(.*)$outerOpenQuote(.+)$outerCloseQuote(.*)/u", $text, $match)) {
            return $match[1].$innerOpenQuote.$match[2].$innerCloseQuote.$match[3];
        }
        return $text;
    }

    /**
     * @param $string
     * @return bool
     */
    public static function isLatinString($string)
    {
        return boolval(preg_match_all("/^[\p{Latin}\p{Common}]+$/u", $string));
        //return !$noLatin;
    }

    /**
     * @param $string
     * @return bool
     */
    public static function isCyrillicString($string)
    {
        return boolval(preg_match("/^[\p{Cyrillic}\p{Common}]+$/u", $string));
    }

    /**
     * @param $string
     * @return bool
     */
    public static function isAsianString($string)
    {
        return boolval(preg_match("/^[\p{Han}\s\p{P}]*$/u", $string));
    }

    /**
     * removes all kind of brackets from a given string
     * @param $datePart
     * @return mixed
     */
    public static function removeBrackets($datePart)
    {
        return str_replace(["[", "]", "(", ")", "{", "}"], "", $datePart);
    }
}


1		<?php /** @noinspection PhpInternalEntityUsedInspection */
2
3		/*
4		* citeproc-php
5		*
6		* @link http://github.com/seboettg/citeproc-php for the source repository
7		* @copyright Copyright (c) 2016 Sebastian Böttger.
8		* @license https://opensource.org/licenses/MIT
9		*/
10
11		namespace Seboettg\CiteProc\Util;
12
13		use Seboettg\CiteProc\CiteProc;
14		use Seboettg\Collection\ArrayList;
15
16		/**
17		* Class StringHelper
18		* @package Seboettg\CiteProc\Util
19		*
20		* @author Sebastian Böttger <[email protected]>
21		*/
22		class StringHelper
23		{
24		const PREPOSITIONS = [
25		'on', 'in', 'at', 'since', 'for', 'ago', 'before', 'to', 'past', 'till', 'until', 'by', 'under', 'below',
26		'over', 'above', 'across', 'through', 'into', 'towards', 'onto', 'from', 'of', 'off', 'about', 'via'
27		];
28
29		const ARTICLES = [
30		'a', 'an', 'the'
31		];
32
33		const ADVERBS = [
34		'yet', 'so', 'just', 'only'
35		];
36
37		const CONJUNCTIONS = [
38		'nor', 'so', 'and', 'or'
39		];
40
41		const ADJECTIVES = [
42		'down', 'up'
43		];
44
45		const ISO_ENCODINGS = [
46		'ISO-8859-1',
47		'ISO-8859-2',
48		'ISO-8859-3',
49		'ISO-8859-4',
50		'ISO-8859-5',
51		'ISO-8859-6',
52		'ISO-8859-7',
53		'ISO-8859-8',
54		'ISO-8859-9',
55		'ISO-8859-10',
56		'ISO-8859-13',
57		'ISO-8859-14',
58		'ISO-8859-15',
59		'ISO-8859-16'
60		];
61
62		/**
63		* opening quote sign
64		*/
65		const OPENING_QUOTE = "“";
66
67		/**
68		* closing quote sign
69		*/
70		const CLOSING_QUOTE = "”";
71
72		/**
73		* @param $text
74		* @return string
75		*/
76	1	public static function capitalizeAll($text)
77		{
78	1	$wordArray = explode(" ", $text);
79
80		array_walk($wordArray, function (&$word) {
81	1	$word = ucfirst($word);
82	1	});
83
84	1	return implode(" ", array_filter($wordArray));
85		}
86
87		/**
88		* @param $titleString
89		* @return string
90		*/
91	16	public static function capitalizeForTitle($titleString)
92		{
93	16	if (strlen($titleString) == 0) {
94	9	return "";
95		}
96	14	if (preg_match('/(.+[^\<\>][\.:\/;\?\!]\s?)([a-z])(.+)/', $titleString, $match)) {
97	1	$titleString = $match[1].StringHelper::mb_ucfirst($match[2]).$match[3];
98		}
99	14	$pattern = "/(\s\|\/)/";
100	14	if (!preg_match($pattern, $titleString, $matches)) {
101	1	return StringHelper::mb_ucfirst($titleString);
102		}
103	14	$delimiter = $matches[1];
104	14	$wordArray = preg_split($pattern, $titleString); //explode(" ", $titleString);
105
106	14	$wordList = new ArrayList(...$wordArray);
107		return $wordList
108		->map(function(string $word) {
		0 ignored issues – show Coding Style introduced 2022-05-07 21:02 UTC by Report Bug Copy Issue Report Expected 1 space after FUNCTION keyword; 0 found Loading history...
109	14	$wordParts = explode("-", $word);
110	14	if (count($wordParts) > 1) {
111	4	$casedWordParts = [];
112	4	foreach ($wordParts as $w) {
113	4	$casedWordParts[] = StringHelper::keepLowerCase($w) ? $w : StringHelper::mb_ucfirst($w);
114		}
115	4	$word = implode("-", $casedWordParts);
116		}
117	14	return StringHelper::keepLowerCase($word) ? $word : StringHelper::mb_ucfirst($word);
118	14	})
119	14	->collectToString($delimiter);
120		}
121
122		/**
123		* @param $word
124		* @return bool
125		*/
126	14	public static function keepLowerCase($word)
127		{
128		// keep lower case if the first char is not an utf-8 letter
129	14	return in_array($word, self::PREPOSITIONS) \|\|
130	14	in_array($word, self::ARTICLES) \|\|
131	14	in_array($word, self::CONJUNCTIONS) \|\|
132	14	in_array($word, self::ADJECTIVES) \|\|
133	14	(bool) preg_match("/[^\p{L}].+/", $word);
134		}
135
136		/**
137		* @param $string
138		* @param string $encoding
139		* @return string
140		*/
141		// phpcs:disable
142	29	public static function mb_ucfirst($string, $encoding = 'UTF-8')
143		{// phpcs:enable
144	29	$strlen = mb_strlen($string, $encoding);
145	29	$firstChar = mb_substr($string, 0, 1, $encoding);
146	29	$then = mb_substr($string, 1, $strlen - 1, $encoding);
147
148		/** @noinspection PhpInternalEntityUsedInspection */
149	29	$encoding = mb_detect_encoding($firstChar, self::ISO_ENCODINGS, true);
150	29	return in_array($encoding, self::ISO_ENCODINGS) ?
151	29	mb_strtoupper($firstChar, $encoding).$then : $firstChar.$then;
152		}
153		// phpcs:disable
154	51	public static function mb_strrev($string)
155		{// phpcs:enable
156	51	$result = '';
157	51	for ($i = mb_strlen($string); $i >= 0; --$i) {
158	51	$result .= mb_substr($string, $i, 1);
159		}
160	51	return $result;
161		}
162
163		/**
164		* @param string $delimiter
165		* @param string[] $arrayOfStrings
166		* @return string;
167		*/
168	86	public static function implodeAndPreventConsecutiveChars($delimiter, $arrayOfStrings)
169		{
170	86	$delim = trim($delimiter);
171	86	if (!empty($delim)) {
172	51	foreach ($arrayOfStrings as $key => $textPart) {
173	51	$pos = mb_strpos(StringHelper::mb_strrev($textPart), StringHelper::mb_strrev($delim));
174	51	if ($pos === 0) {
175	3	$length = mb_strlen($textPart) - mb_strlen($delim);
176	3	$textPart = mb_substr($textPart, 0, $length);
177	3	$arrayOfStrings[$key] = $textPart;
178		}
179		}
180		}
181	86	return implode($delimiter, array_filter($arrayOfStrings));
182		}
183
184		/**
185		* @param $string
186		* @param $initializeSign
187		* @return string
188		*/
189	33	public static function initializeBySpaceOrHyphen($string, $initializeSign)
190		{
191	33	$initializeWithHyphen = CiteProc::getContext()->getGlobalOptions()->isInitializeWithHyphen();
192	33	$res = "";
193	33	$exploded = explode("-", $string);
194	33	$i = 0;
195	33	foreach ($exploded as $explode) {
196	33	$spaceExploded = explode(" ", $explode);
197	33	foreach ($spaceExploded as $givenPart) {
198	33	$firstLetter = mb_substr($givenPart, 0, 1, "UTF-8");
199	33	if (StringHelper::isLatinString($firstLetter)) {
200	31	$res .= ctype_upper($firstLetter) ? $firstLetter.$initializeSign : " ".$givenPart." ";
201		} else {
202	2	$res .= $firstLetter.$initializeSign;
203		}
204		}
205	33	if ($i < count($exploded) - 1 && $initializeWithHyphen) {
206	2	$res = rtrim($res)."-";
207		}
208	33	++$i;
209		}
210	33	return $res;
211		}
212
213		/**
214		* @param $string
215		* @return mixed\|string
216		*/
217	1	public static function camelCase2Hyphen($string)
218		{
219	1	$hyphenated = preg_replace("/([A-Z])/", "-$1", $string);
220	1	$hyphenated = substr($hyphenated, 0, 1) === "-" ? substr($hyphenated, 1) : $hyphenated;
221	1	return mb_strtolower($hyphenated);
222		}
223
224		/**
225		* @param $string
226		* @return bool
227		*/
228	1	public static function checkLowerCaseString($string)
229		{
230	1	return ($string === mb_strtolower($string));
231		}
232
233		/**
234		* @param $string
235		* @return bool
236		*/
237	2	public static function checkUpperCaseString($string)
238		{
239	2	return ($string === mb_strtoupper($string));
240		}
241
242		/**
243		* @param $string
244		* @return mixed
245		*/
246	172	public static function clearApostrophes($string)
247		{
248	172	return preg_replace("/\'/", "’", $string);
249		}
250
251		/**
252		* replaces outer quotes of $text by given inner quotes
253		*
254		* @param $text
255		* @param $outerOpenQuote
256		* @param $outerCloseQuote
257		* @param $innerOpenQuote
258		* @param $innerCloseQuote
259		* @return string
260		*/
261	14	public static function replaceOuterQuotes(
262		$text,
263		$outerOpenQuote,
264		$outerCloseQuote,
265		$innerOpenQuote,
266		$innerCloseQuote
267		) {
268	14	if (preg_match("/(.)$outerOpenQuote(.+)$outerCloseQuote(.)/u", $text, $match)) {
269	3	return $match[1].$innerOpenQuote.$match[2].$innerCloseQuote.$match[3];
270		}
271	13	return $text;
272		}
273
274		/**
275		* @param $string
276		* @return bool
277		*/
278	105	public static function isLatinString($string)
279		{
280	105	return boolval(preg_match_all("/^[\p{Latin}\p{Common}]+$/u", $string));
281		//return !$noLatin;
282		}
283
284		/**
285		* @param $string
286		* @return bool
287		*/
288	4	public static function isCyrillicString($string)
289		{
290	4	return boolval(preg_match("/^[\p{Cyrillic}\p{Common}]+$/u", $string));
291		}
292
293		/**
294		* @param $string
295		* @return bool
296		*/
297	1	public static function isAsianString($string)
298		{
299	1	return boolval(preg_match("/^[\p{Han}\s\p{P}]*$/u", $string));
300		}
301
302		/**
303		* removes all kind of brackets from a given string
304		* @param $datePart
305		* @return mixed
306		*/
307	64	public static function removeBrackets($datePart)
308		{
309	64	return str_replace(["[", "]", "(", ")", "{", "}"], "", $datePart);
310		}
311		}
312

seboettg / citeproc-php

Push — feature/123-styles-distributio... ( b6478c )

StringHelper::capitalizeForTitle() B

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like