Version 0.63

Author: Ronef

CHANGELOG.md

@@ -1,7 +1,7 @@
 {
 	"name": "dd/evolutioncms-libraries-ddtools",
 	"type": "modxevo-library-ddtools",
-	"version": "0.62.1",
+	"version": "0.63.0",
 	"description": "A library with various tools facilitating your work.",
 	"keywords": [
 		"modx",
@@ -10,11 +10,13 @@
 		"ddtools"
 	],
 	"homepage": "https://code.divandesign.ru/modx/ddtools",
+	"support": {
+		"chat": "https://t.me/dd_code"
+	},
 	"authors": [
 		{
 			"name": "Ilyas Ronef",
-			"email": "ilyas@DivanDesign.ru",
-			"homepage": "https://ronef.ru",
+			"homepage": "https://ronef.me",
 			"role": "Owner"
 		},
 		{

CHANGELOG_ru.md

@@ -1,11 +1,11 @@
 <?php
 /**
  * EvolutionCMS.libraries.ddTools
- * @version 0.62.1 (2024-06-17)
+ * @version 0.63 (2024-08-02)
  * 
  * @see README.md
  * 
- * @copyright 2012–2024 Ronef {@link https://Ronef.ru }
+ * @copyright 2012–2024 https://Ronef.me
  */
 
 global $modx;
@@ -112,7 +112,7 @@ class ddTools {
 
 	/**
 	 * __construct
-	 * @version 1.0.4 (2020-02-11)
+	 * @version 1.0.5 (2024-08-02)
 	 */
 	private function __construct(){
 		global $modx;
@@ -129,7 +129,7 @@ private function __construct(){
 		}
 
 		//We need to include required files if Composer is not used
-		if(!class_exists('\DDTools\FilesTools')){
+		if(!class_exists('\DDTools\Tools\Files')){
 			require_once(
 				__DIR__ .
 				DIRECTORY_SEPARATOR .
@@ -304,7 +304,7 @@ public static function explodeAssoc(
 
 	/**
 	 * sort2dArray
-	 * @version 1.3 (2022-12-23)
+	 * @version 1.3.1 (2024-08-02)
 	 * 
 	 * @desc Sorts 2-dimensional array by multiple columns (like in SQL) using Hoare's method, also referred to as quicksort. The sorting is stable.
 	 * 
@@ -323,7 +323,7 @@ public static function sort2dArray(
 		$i = 0
 	){
 		//В качестве эталона получаем сортируемое значение (по первому условию сортировки) первого элемента
-		$currentItem_comparisonValue = \DDTools\ObjectTools::getPropValue([
+		$currentItem_comparisonValue = \DDTools\Tools\Objects::getPropValue([
 			'object' => array_values($array)[0],
 			'propName' => $sortBy[$i]
 		]);
@@ -347,7 +347,7 @@ public static function sort2dArray(
 			$arrayItemKey =>
 			$arrayItem
 		){
-			$arrayItem_comparisonValue = \DDTools\ObjectTools::getPropValue([
+			$arrayItem_comparisonValue = \DDTools\Tools\Objects::getPropValue([
 				'object' => $arrayItem,
 				'propName' => $sortBy[$i]
 			]);
@@ -496,7 +496,7 @@ public static function parseFileNameVersion($file){
 
 	/**
 	 * convertUrlToAbsolute
-	 * @version 1.0 (2022-09-05)
+	 * @version 1.0.1 (2024-08-02)
 	 * 
 	 * @desc Converts relative URLs to absolute.
 	 * 
@@ -509,7 +509,7 @@ public static function parseFileNameVersion($file){
 	 */
 	public static function convertUrlToAbsolute($params){
 		//# Prepare params
-		$params = \DDTools\ObjectTools::extend([
+		$params = \DDTools\Tools\Objects::extend([
 			'objects' => [
 				//Defaults
 				(object) [
@@ -956,7 +956,7 @@ public static function parseText($params = []){
 
 	/**
 	 * parseText_parepareParams
-	 * @version 1.0.1 (2024-06-17)
+	 * @version 1.0.2 (2024-08-02)
 	 *
 	 * @param $params {stdClass|arrayAssociative} — The object of parameters. See $this->parseText.
 	 *
@@ -986,7 +986,7 @@ private static function parseText_parepareParams($params = []): \stdClass {
 			'returnCorrectedOnly' => false,
 		]);
 
-		$params = \DDTools\ObjectTools::extend([
+		$params = \DDTools\Tools\Objects::extend([
 			'objects' => [
 				//Defaults
 				(object) [
@@ -1006,7 +1006,7 @@ private static function parseText_parepareParams($params = []): \stdClass {
 
 	/**
 	 * parseText_prepareData
-	 * @version 1.0 (2024-06-06)
+	 * @version 1.0.1 (2024-08-02)
 	 * 
 	 * @param $params {stdClass|arrayAssociative} — The object of parameters. See $this->parseText.
 	 * @param $params->data {stdClass|array|string}
@@ -1023,7 +1023,7 @@ private static function parseText_prepareData($params = []): \stdClass {
 			!is_object($params->data) &&
 			!is_array($params->data)
 		){
-			$params->data = \DDTools\ObjectTools::convertType([
+			$params->data = \DDTools\Tools\Objects::convertType([
 				'object' => $params->data,
 				'type' => 'objectArray'
 			]);
@@ -1039,7 +1039,7 @@ private static function parseText_prepareData($params = []): \stdClass {
 				is_array($value)
 			){
 				//Unfold for nested objects and arrays support (e. g. ['some' => ['a' => 'one', 'b' => 'two'] ] → '[+some.a+]', '[+some.b+]'; ['some' => ['one', 'two'] ] → '[+some.0+]', '[some.1]')
-				$unfoldedValue = \DDTools\ObjectTools::unfold([
+				$unfoldedValue = \DDTools\Tools\Objects::unfold([
 					'object' => [
 						$key => $value
 					],
@@ -1055,7 +1055,7 @@ private static function parseText_prepareData($params = []): \stdClass {
 				}
 
 				//Also add object value as JSON
-				$value = \DDTools\ObjectTools::convertType([
+				$value = \DDTools\Tools\Objects::convertType([
 					'object' => $value,
 					'type' => 'stringJsonAuto'
 				]);
@@ -1329,7 +1329,7 @@ private static function createDocument_prepareAlias($sourceString){
 
 	/**
 	 * createDocument
-	 * @version 1.5 (2020-06-21)
+	 * @version 1.5.1 (2024-08-02)
 	 * 
 	 * @desc Create a new document.
 	 * 
@@ -1345,7 +1345,7 @@ public static function createDocument(
 		$docGroups = false
 	){
 		//Defaults
-		$docData = \DDTools\ObjectTools::extend([
+		$docData = \DDTools\Tools\Objects::extend([
 			'objects' => [
 				(object) [
 					'pagetitle' => 'New resource',
@@ -1507,7 +1507,7 @@ public static function createDocument(
 
 	/**
 	 * updateDocument
-	 * @version 1.5 (2021-03-15)
+	 * @version 1.5.1 (2024-08-02)
 	 * 
 	 * @desc Update document(s). Cache of the updated docs and their parents will be cleared.
 	 * 
@@ -1532,7 +1532,7 @@ public static function updateDocument(
 			return false;
 		}
 
-		$docData = \DDTools\ObjectTools::extend([
+		$docData = \DDTools\Tools\Objects::extend([
 			'objects' => [
 				//Defaults
 				(object) [
@@ -2730,7 +2730,7 @@ function_exists('idn_to_utf8') ?
 
 	/**
 	 * verifyRenamedParams
-	 * @version 1.7.1 (2021-03-09)
+	 * @version 1.7.2 (2024-08-02)
 	 * 
 	 * @see README.md
 	 */
@@ -2747,7 +2747,7 @@ public static function verifyRenamedParams($params){
 			]);
 		}
 
-		$params = \DDTools\ObjectTools::extend([
+		$params = \DDTools\Tools\Objects::extend([
 			'objects' => [
 				//Defaults
 				(object) [
@@ -2991,7 +2991,7 @@ public static function getResponse(){
 
 	/**
 	 * encodedStringToArray
-	 * @version 1.2 (2020-06-02)
+	 * @version 1.2.1 (2024-08-02)
 	 * 
 	 * @desc Converts encoded strings to arrays.
 	 * Supported formats:
@@ -3003,7 +3003,7 @@ public static function getResponse(){
 	 * @return {array}
 	 */
 	public static function encodedStringToArray($inputString){
-		$result = \DDTools\ObjectTools::convertType([
+		$result = \DDTools\Tools\Objects::convertType([
 			'object' => $inputString,
 			'type' => 'objectArray'
 		]);
@@ -3027,23 +3027,23 @@ public static function encodedStringToArray($inputString){
 
 	/**
 	 * unfoldArray
-	 * @version 1.1 (2021-11-16)
+	 * @version 1.1.1 (2024-08-02)
 	 * 
-	 * @see README.md (\DDTools\ObjectTools::unfold)
+	 * @see README.md (\DDTools\Tools\Objects::unfold)
 	 */
 	public static function unfoldArray(
 		$array,
 		$keyPrefix = ''
 	){
-		return \DDTools\ObjectTools::unfold([
+		return \DDTools\Tools\Objects::unfold([
 			'object' => $array,
 			'keyPrefix' => $keyPrefix
 		]);
 	}
 
 	/**
 	 * createDir
-	 * @version 1.0 (2019-10-22)
+	 * @version 1.0.1 (2024-08-02)
 	 * 
 	 * @desc Makes directory using `$modx->config['new_folder_permissions']`. Nested directories will be created too. Doesn't throw an exception if the folder already exists.
 	 * 
@@ -3053,12 +3053,12 @@ public static function unfoldArray(
 	 * @return {boolean} — Success status.
 	 */
 	public static function createDir($params){
-		return \DDTools\FilesTools::createDir($params);
+		return \DDTools\Tools\Files::createDir($params);
 	}
 
 	/**
 	 * copyDir
-	 * @version 1.1 (2018-10-02)
+	 * @version 1.1.1 (2024-08-02)
 	 * 
 	 * @desc Copies a required folder with all contents recursively.
 	 * 
@@ -3071,15 +3071,15 @@ public static function copyDir(
 		$sourcePath,
 		$destinationPath
 	){
-		return \DDTools\FilesTools::copyDir([
+		return \DDTools\Tools\Files::copyDir([
 			'sourcePath' => $sourcePath,
 			'destinationPath' => $destinationPath
 		]);
 	}
 
 	/**
 	 * removeDir
-	 * @version 1.1 (2018-10-02)
+	 * @version 1.1.1 (2024-08-02)
 	 * 
 	 * @desc Removes a required folder with all contents recursively.
 	 * 
@@ -3088,7 +3088,7 @@ public static function copyDir(
 	 * @return {boolean}
 	 */
 	public static function removeDir($path){
-		return \DDTools\FilesTools::removeDir($path);
+		return \DDTools\Tools\Files::removeDir($path);
 	}
 
 	/**

README.md

@@ -1,14 +1,17 @@
 <?php
 require_once('src/Base/Base.php');
 require_once('src/Base/AncestorTrait.php');
-require_once('src/Base/BaseClass.php');
 
-require_once('src/ObjectTools/ObjectTools.php');
-require_once('src/FilesTools/FilesTools.php');
+require_once('src/Tools/Objects.php');
+require_once('src/Tools/Files.php');
+require_once('src/Tools/Cache.php');
+
 require_once('src/ObjectCollection/ObjectCollection.php');
 require_once('src/Response/Response.php');
 require_once('src/Storage/Storage.php');
 require_once('src/Storage/DB/Storage.php');
 
 require_once('src/Snippet/Snippet.php');
+
+require_once('src/backwardCompatibility.php');
 ?>

composer.json

@@ -84,7 +84,7 @@ final public static function getChildClassName($params): string {
 
 	/**
 	 * createChildInstance
-	 * @version 1.2.2 (2024-02-06)
+	 * @version 1.2.3 (2024-08-02)
 	 * 
 	 * @see README.md
 	 */
@@ -94,7 +94,7 @@ final public static function createChildInstance($params){
 		$objectClass = static::getChildClassName($params);
 
 		return new $objectClass(
-			\DDTools\ObjectTools::isPropExists([
+			\DDTools\Tools\Objects::isPropExists([
 				'object' => $params,
 				'propName' => 'params',
 			])

modx.ddtools.class.php

@@ -85,15 +85,15 @@ public static function getClassName(): \stdClass {
 
 	/**
 	 * setExistingProps
-	 * @version 1.4 (2022-01-08)
+	 * @version 1.4.1 (2024-08-02)
 	 * 
 	 * @see README.md
 	 * 
 	 * @return {void}
 	 */
 	public function setExistingProps($props){
 		if (is_string($props)){
-			$props = \DDTools\ObjectTools::convertType([
+			$props = \DDTools\Tools\Objects::convertType([
 				'object' => $props,
 				'type' => 'objectStdClass'
 			]);
@@ -224,14 +224,14 @@ public function toArray(){
 
 	/**
 	 * toJSON
-	 * @version 1.1 (2022-12-26)
+	 * @version 1.1.1 (2024-08-02)
 	 * 
 	 * @see README.md
 	 * 
 	 * @return {stringJsonObject}
 	 */
 	public function toJSON(){
-		return \DDTools\ObjectTools::convertType([
+		return \DDTools\Tools\Objects::convertType([
 			'object' => $this->toArray(),
 			'type' => 'stringJsonAuto'
 		]);