. // }}} /** * String formatting utilities * * @package GNUsocial * @category Util * * @author Hugo Sales * @copyright 2020-2021 Free Software Foundation, Inc http://www.fsf.org * @license https://www.gnu.org/licenses/agpl.html GNU AGPL v3 or later */ namespace App\Util; use const DIRECTORY_SEPARATOR; use Functional as F; use InvalidArgumentException; use Symfony\Component\Config\Definition\Exception\Exception; abstract class Formatting { /** * Normalize path by converting \ to / * * @param string $path * * @return string */ public static function normalizePath(string $path): string { if (DIRECTORY_SEPARATOR !== '/') { $path = strtr($path, DIRECTORY_SEPARATOR, '/'); } return $path; } /** * Get plugin name from it's path, or null if not a plugin * * @param string $path * * @return null|string */ public static function pluginFromPath(string $path): ?string { $plug = strpos($path, '/plugins/'); if ($plug === false) { return null; } $cut = $plug + strlen('/plugins/'); $cut2 = strpos($path, '/', $cut); if ($cut2) { $final = substr($path, $cut, $cut2 - $cut); } else { // We might be running directly from the plugins dir? // If so, there's no place to store locale info. throw new Exception('The GNU social install dir seems to contain a piece named plugin'); } return $final; } /** * Check whether $haystack starts with $needle * * @param array|string $haystack if array, check that all strings start with $needle * @param string $needle * * @return bool */ public static function startsWith($haystack, string $needle): bool { if (is_string($haystack)) { $length = strlen($needle); return substr($haystack, 0, $length) === $needle; } return F\every($haystack, function ($haystack) use ($needle) { return self::startsWith($haystack, $needle); }); } /** * Check whether $haystack ends with $needle * * @param array|string $haystack if array, check that all strings end with $needle * @param string $needle * * @return bool */ public static function endsWith($haystack, string $needle) { if (is_string($haystack)) { $length = strlen($needle); if ($length == 0) { return true; } return substr($haystack, -$length) === $needle; } return F\every($haystack, function ($haystack) use ($needle) { return self::endsWith($haystack, $needle); }); } public static function camelCaseToSnakeCase(string $str): string { return strtolower(preg_replace('/([a-z])([A-Z])/', '$1_$2', $str)); } public static function snakeCaseToCamelCase(string $str): string { return implode('', F\map(preg_split('/[\b_]/', $str), F\ary('ucfirst', 1))); } /** * Indent $in, a string or array, $level levels * * @param array|string $in * @param int $level How many levels of indentation * @param int $count How many spaces per indentation * * @return string */ public static function indent($in, int $level = 1, int $count = 2): string { if (is_string($in)) { return self::indent(explode("\n", $in), $level, $count); } elseif (is_array($in)) { $indent = str_repeat(' ', $count * $level); return implode("\n", F\map(F\select($in, F\ary(function ($s) { return $s != ''; }, 1)), function ($val) use ($indent) { return F\concat($indent . $val); })); } throw new InvalidArgumentException('Formatting::indent\'s first parameter must be either an array or a string. Input was: ' . $in); } const SPLIT_BY_SPACE = ' '; const SPLIT_BY_COMMA = ', '; const SPLIT_BY_BOTH = '/[, ]/'; /** * Convert scalars, objects implementing __toString or arrays to strings * * @param mixed $value */ public static function toString($value, string $split_type = self::SPLIT_BY_COMMA): string { if (!is_array($value)) { return (string) $value; } else { return implode($split_type, $value); } } /** * Convert a user supplied string to array and return whether the conversion was successfull * * @param mixed $output */ public static function toArray(string $input, &$output, string $split_type = self::SPLIT_BY_COMMA): bool { $matches = []; if (preg_match('/^ *\[?([^,]+(, ?[^,]+)*)\]? *$/', $input, $matches)) { switch ($split_type) { case self::SPLIT_BY_BOTH: $arr = preg_split($split_type, $matches[1], 0, PREG_SPLIT_NO_EMPTY); break; case self::SPLIT_BY_COMMA: $arr = preg_split('/, ?/', $matches[1]); break; default: $arr = explode($split_type[0], $matches[1]); } $output = str_replace([' \'', '\'', ' "', '"'], '', $arr); $output = F\map($output, F\ary('trim', 1)); return true; } return false; } }