Merge branch 'feature/2.0'

src/ComplexNumber/ComplexNumber.php

@@ -2,6 +2,13 @@
 
 namespace MagicObject\ComplexNumber;
 
+/**
+ * ComplexNumber class
+ * 
+ * @author Kamshory
+ * @package MagicObject\Database
+ * @link https://github.com/Planetbiru/MagicObject
+ */
 class ComplexNumber {
 
     /**

src/Constants/PicoHttpStatus.php

@@ -6,6 +6,8 @@
  *
  * This class defines constants for standard HTTP status codes.
  * 
+ * @author Kamshory
+ * @package MagicObject\Database
  * @link https://github.com/Planetbiru/MagicObject
  */
 class PicoHttpStatus

src/Constants/PicoMime.php

@@ -7,6 +7,8 @@
  *
  * This class contains constants representing various MIME types.
  * 
+ * @author Kamshory
+ * @package MagicObject\Database
  * @link https://github.com/Planetbiru/MagicObject
  */
 class PicoMime

src/Constants/PicoMimeMap.php

@@ -8,6 +8,8 @@
  * This class defines a mapping of file extensions to their corresponding MIME types.
  * It can be used to determine the appropriate content type for files based on their extensions.
  * 
+ * @author Kamshory
+ * @package MagicObject\Database
  * @link https://github.com/Planetbiru/MagicObject
  */
 class PicoMimeMap

src/DataLabel/PicoDataLabel.php

@@ -12,6 +12,8 @@
  *
  * This class uses annotations to define properties and their metadata.
  *
+ * @author Kamshory
+ * @package MagicObject\DataLabel
  * @link https://github.com/Planetbiru/MagicObject
  */
 class PicoDataLabel extends SetterGetter

src/DataLabel/PicoDataLabels.php

@@ -9,6 +9,8 @@
  *
  * This class allows for the storage and management of multiple data labels.
  *
+ * @author Kamshory
+ * @package MagicObject\DataLabel
  * @link https://github.com/Planetbiru/MagicObject
  */
 class PicoDataLabels

src/DataTable.php

@@ -25,6 +25,8 @@
  * on the provided data, with support for property annotations to manage 
  * labels and attributes.
  *
+ * @author Kamshory
+ * @package MagicObject
  * @link https://github.com/Planetbiru/MagicObject
  */
 class DataTable extends SetterGetter

src/Database/PicoDataComparation.php

@@ -5,7 +5,9 @@
 /**
  * Class for handling data comparisons.
  * Provides various comparison operations for use in database queries.
- *
+ * 
+ * @author Kamshory
+ * @package MagicObject\Database
  * @link https://github.com/Planetbiru/MagicObject
  */
 class PicoDataComparation

src/Database/PicoDatabase.php

@@ -32,7 +32,8 @@
  * $result = $db->fetch("SELECT * FROM users WHERE id = 1");
  * ```
  * 
- * Developer: Kamshory
+ * @author Kamshory
+ * @package MagicObject\Database
  * @link https://github.com/Planetbiru/MagicObject
  */
 class PicoDatabase //NOSONAR

src/Database/PicoDatabaseCredentials.php

@@ -24,6 +24,8 @@
  * The attributes are automatically encrypted when set, providing a secure way to handle sensitive
  * information within your application.
  * 
+ * @author Kamshory
+ * @package MagicObject\Database
  * @link https://github.com/Planetbiru/MagicObject
  */
 class PicoDatabaseCredentials extends SecretObject

src/Database/PicoDatabaseEntity.php

@@ -8,6 +8,10 @@
  * Class PicoDatabaseEntity
  *
  * Represents a database entity that manages multiple database connections.
+ * 
+ * @author Kamshory
+ * @package MagicObject\Database
+ * @link https://github.com/Planetbiru/MagicObject
  */
 class PicoDatabaseEntity
 {

src/Database/PicoDatabasePersistence.php

@@ -25,6 +25,9 @@
 
 /**
  * Database persistence
+ * 
+ * @author Kamshory
+ * @package MagicObject\Database
  * @link https://github.com/Planetbiru/MagicObject
  */
 class PicoDatabasePersistence // NOSONAR

src/Database/PicoDatabasePersistenceExtended.php

@@ -11,7 +11,9 @@
  * This class extends the functionality of the PicoDatabasePersistence
  * by adding dynamic property setting through magic methods and enhanced
  * record selection capabilities.
- *
+ * 
+ * @author Kamshory
+ * @package MagicObject\Database
  * @link https://github.com/Planetbiru/MagicObject
  */
 class PicoDatabasePersistenceExtended extends PicoDatabasePersistence

src/Database/PicoDatabaseQueryBuilder.php

@@ -3,6 +3,9 @@
 
 /**
  * Query builder
+ * 
+ * @author Kamshory
+ * @package MagicObject\Database
  * @link https://github.com/Planetbiru/MagicObject
  */
 class PicoDatabaseQueryBuilder // NOSONAR

src/Database/PicoDatabaseStructure.php

@@ -9,6 +9,8 @@
 /**
  * Represents the structure of a database table.
  * 
+ * @author Kamshory
+ * @package MagicObject\Database
  * @link https://github.com/Planetbiru/MagicObject
  */
 class PicoDatabaseStructure

src/Database/PicoDatabaseType.php

@@ -6,7 +6,9 @@
  * Class representing different database types.
  *
  * This class provides constants for various database types supported by the MagicObject framework.
- *
+ * 
+ * @author Kamshory
+ * @package MagicObject\Database
  * @link https://github.com/Planetbiru/MagicObject
  */
 class PicoDatabaseType

src/Database/PicoEntityField.php

@@ -7,7 +7,9 @@
  *
  * This class encapsulates information about an entity field, including
  * its associated entity, field name, and any parent field relationships.
- *
+ * 
+ * @author Kamshory
+ * @package MagicObject\Database
  * @link https://github.com/Planetbiru/MagicObject
  */
 class PicoEntityField

src/Database/PicoEntityLabel.php

@@ -12,7 +12,9 @@
  * Class to manage entity labels and their annotations.
  * 
  * Provides methods to retrieve and filter entity metadata, including labels, columns, and other attributes.
- *
+ * 
+ * @author Kamshory
+ * @package MagicObject\Database
  * @link https://github.com/Planetbiru/MagicObject
  */
 class PicoEntityLabel

src/Database/PicoJoinMap.php

@@ -6,7 +6,9 @@
  * Class representing a join mapping in a database.
  *
  * Contains information about how an entity is joined with another table.
- *
+ * 
+ * @author Kamshory
+ * @package MagicObject\Database
  * @link https://github.com/Planetbiru/MagicObject
  */
 class PicoJoinMap

src/Database/PicoLimit.php

@@ -7,7 +7,9 @@
  *
  * This class provides functionality to manage pagination in database queries
  * by setting limits and offsets.
- *
+ * 
+ * @author Kamshory
+ * @package MagicObject\Database
  * @link https://github.com/Planetbiru/MagicObject
  */
 class PicoLimit

src/Database/PicoPage.php

@@ -7,7 +7,9 @@
  *
  * This class provides functionality to manage page numbers and sizes,
  * and to calculate offsets for database queries.
- *
+ * 
+ * @author Kamshory
+ * @package MagicObject\Database
  * @link https://github.com/Planetbiru/MagicObject
  */
 class PicoPage

src/Database/PicoPageControl.php

@@ -11,7 +11,9 @@
  * page buttons, allowing users to navigate through pages seamlessly. 
  * The pagination links are generated based on the provided page data and 
  * can be customized with parameter names and paths.
- *
+ * 
+ * @author Kamshory
+ * @package MagicObject\Database
  * @link https://github.com/Planetbiru/MagicObject
  */
 class PicoPageControl

src/Database/PicoPageData.php

@@ -20,7 +20,9 @@
  * - Supports execution time tracking for performance monitoring.
  * - Provides easy access to pagination controls and metadata.
  * - Facilitates fetching and processing of data with subquery mapping.
- *
+ * 
+ * @author Kamshory
+ * @package MagicObject\Database
  * @link https://github.com/Planetbiru/MagicObject
  */
 class PicoPageData //NOSONAR

src/Database/PicoPageable.php

@@ -7,6 +7,9 @@
 
 /**
  * Pageable
+ * 
+ * @author Kamshory
+ * @package MagicObject\Database
  * @link https://github.com/Planetbiru/MagicObject
  */
 class PicoPageable

src/Database/PicoPredicate.php

@@ -9,7 +9,9 @@
  * This class allows you to define various query conditions 
  * (e.g., equality, inequality, inclusion, pattern matching, etc.)
  * to be used when constructing database queries.
- *
+ * 
+ * @author Kamshory
+ * @package MagicObject\Database
  * @link https://github.com/Planetbiru/MagicObject
  */
 class PicoPredicate //NOSONAR

src/Database/PicoSort.php

@@ -8,7 +8,9 @@
  * A class for defining sorting criteria for database queries.
  * This class allows you to specify the field to sort by and the 
  * direction of sorting (ascending or descending).
- *
+ * 
+ * @author Kamshory
+ * @package MagicObject\Database
  * @link https://github.com/Planetbiru/MagicObject
  */
 class PicoSort

src/Database/PicoSortable.php

@@ -10,7 +10,9 @@
  *
  * This class provides functionality to manage sorting criteria,
  * allowing the specification of fields to sort by and their sort types.
- *
+ * 
+ * @author Kamshory
+ * @package MagicObject\Database
  * @link https://github.com/Planetbiru/MagicObject
  */
 class PicoSortable

src/Database/PicoSpecification.php

@@ -10,7 +10,9 @@
  *
  * This class is responsible for building complex database query specifications,
  * allowing for the combination of predicates using logical operators (AND, OR).
- *
+ * 
+ * @author Kamshory
+ * @package MagicObject\Database
  * @link https://github.com/Planetbiru/MagicObject
  */
 class PicoSpecification //NOSONAR

src/Database/PicoSpecificationFilter.php

@@ -8,6 +8,8 @@
  * This class defines filters for columns, specifying the data type 
  * and providing methods to convert values based on the defined type.
  * 
+ * @author Kamshory
+ * @package MagicObject\Database
  * @link https://github.com/Planetbiru/MagicObject
  */
 class PicoSpecificationFilter

src/Database/PicoTableInfo.php

@@ -11,6 +11,8 @@
  * primary keys, and other related metadata necessary for managing 
  * database interactions.
  * 
+ * @author Kamshory
+ * @package MagicObject\Database
  * @link https://github.com/Planetbiru/MagicObject
  */
 class PicoTableInfo // NOSONAR

src/Database/PicoTableInfoExtended.php

@@ -8,7 +8,9 @@
  * This class extends the functionality of PicoTableInfo by providing methods
  * for managing unique columns, join columns, primary keys, auto-increment keys,
  * default values, and not-null columns.
- *
+ * 
+ * @author Kamshory
+ * @package MagicObject\Database
  * @link https://github.com/Planetbiru/MagicObject
  */
 class PicoTableInfoExtended extends PicoTableInfo

src/Exceptions/EmptyResultException.php

@@ -10,6 +10,10 @@
  * Custom exception class for handling scenarios where a result is expected
  * but none is returned. This can be useful for database queries or API calls
  * where a missing result should be treated as an exceptional case.
+ * 
+ * @author Kamshory
+ * @package MagicObject\Exceptions
+ * @link https://github.com/Planetbiru/MagicObject
  */
 class EmptyResultException extends Exception
 {

src/Exceptions/EntityException.php

@@ -10,6 +10,10 @@
  * Custom exception class for handling errors related to entity operations.
  * This can include issues such as validation failures, database errors, or
  * other exceptions that occur during entity processing.
+ * 
+ * @author Kamshory
+ * @package MagicObject\Exceptions
+ * @link https://github.com/Planetbiru/MagicObject
  */
 class EntityException extends Exception
 {

src/Exceptions/FileNotFoundException.php

@@ -10,6 +10,10 @@
  * Custom exception class for handling file not found errors.
  * This can be used in scenarios where a required file is missing,
  * such as when attempting to read or access a file that does not exist.
+ * 
+ * @author Kamshory
+ * @package MagicObject\Exceptions
+ * @link https://github.com/Planetbiru/MagicObject
  */
 class FileNotFoundException extends Exception
 {

src/Exceptions/FindOptionException.php

@@ -11,6 +11,10 @@
  * of finding or retrieving options. This exception can be thrown when
  * an expected option is not found, whether in configuration settings,
  * database queries, or other operational contexts.
+ * 
+ * @author Kamshory
+ * @package MagicObject\Exceptions
+ * @link https://github.com/Planetbiru/MagicObject
  */
 class FindOptionException extends Exception
 {

src/Exceptions/InvalidAddressException.php

@@ -12,6 +12,10 @@
  * found to be improperly formatted. It can be used in scenarios such as
  * address processing in applications that require user input for locations,
  * shipping, or billing addresses.
+ * 
+ * @author Kamshory
+ * @package MagicObject\Exceptions
+ * @link https://github.com/Planetbiru/MagicObject
  */
 class InvalidAddressException extends Exception
 {

src/Exceptions/InvalidAnnotationException.php

@@ -11,6 +11,10 @@
  * This exception can be thrown when an annotation is improperly formatted,
  * missing, or fails validation in contexts such as reflection, metadata
  * processing, or any system relying on annotations for configuration.
+ * 
+ * @author Kamshory
+ * @package MagicObject\Exceptions
+ * @link https://github.com/Planetbiru/MagicObject
  */
 class InvalidAnnotationException extends Exception
 {

src/Exceptions/InvalidClassExceptio.php

@@ -11,6 +11,10 @@
  * This exception can be thrown when a class cannot be instantiated or when
  * a class is found to be improperly defined, potentially during reflection or
  * dynamic class loading operations.
+ * 
+ * @author Kamshory
+ * @package MagicObject\Exceptions
+ * @link https://github.com/Planetbiru/MagicObject
  */
 class InvalidClassException extends Exception
 {