Merge pull request #18 from josantonius/release/v2.0.1

Release/v2.0.1

Author: josantonius

.gitattributes

@@ -1,7 +1,6 @@
 /.github export-ignore
 /tests export-ignore
 CHANGELOG.md export-ignore
-README.md export-ignore
 phpcs.xml export-ignore
 phpunit.xml export-ignore
 phpmd.xml export-ignore

.github/CONTRIBUTING.md

@@ -42,9 +42,10 @@ appropriate category for it:
 ## Add or Improve a Feature?
 
 - For a **Major Feature**,
-first [open a new discussion](https://github.com/josantonius/php-json/discussions/new) in the `Ideas` category and outline your proposal so that it can be discussed. This will also allow us to better
-coordinate our efforts, prevent duplication of work, and help you to craft the change so that it is
-successfully accepted into the project.
+first [open a new discussion](https://github.com/josantonius/php-json/discussions/new) in the
+`Ideas` category and outline your proposal so that it can be discussed. This will also allow us to
+better coordinate our efforts, prevent duplication of work, and help you to craft the change so that
+it is successfully accepted into the project.
 
 - **Small Features** can be crafted and directly
 [submitted as a Pull Request](#submitting-a-pull-request).

.github/lang/es-ES/CONTRIBUTING.md

@@ -172,7 +172,8 @@ cambios desde la rama `main`:
 
 Para garantizar la coherencia en todo el código fuente, ten en cuenta estas reglas mientras trabajas:
 
-- Todas las características o correcciones de errores **deben ser probadas** por una o más especificaciones (pruebas unitarias).
+- Todas las características o correcciones de errores **deben ser probadas** por una o más
+especificaciones (pruebas unitarias).
 
   Puedes utilizar el siguiente comando para comprobar las pruebas:
 
@@ -222,7 +223,8 @@ El _`header`_ es obligatorio y debe ajustarse al formato para el
 El _`body`_ es opcional. Cuando está presente, debe tener al menos 20 caracteres y debe
 ajustarse al formato del [cuerpo del _commit_](#cuerpo-del-commit).
 
-El _`footer`_ es opcional. El formato para la [parte inferior del _commit_](#parte-inferior-del-commit) detalla la estructura que debe tener.
+El _`footer`_ es opcional.
+El formato para la [parte inferior del _commit_](#parte-inferior-del-commit) detalla su estructura.
 
 ### Cabecera del _commit_
 
@@ -309,7 +311,8 @@ La sección de cambios de última hora debe comenzar con la frase "_BREAKING CHA
 resumen del cambio, una línea en blanco y una descripción detallada del cambio que incluya también
 instrucciones de migración.
 
-Del mismo modo, una sección de desaprobación debe comenzar con "_DEPRECATED_:" seguido de una breve descripción sobre lo que quedó obsoleto, una línea en blanco y una descripción detallada que también
+Del mismo modo, una sección de desaprobación debe comenzar con "_DEPRECATED_:" seguido de una breve
+descripción sobre lo que quedó obsoleto, una línea en blanco y una descripción detallada que también
 recomiende una alternativa.
 
 > Esta guía de contribución está inspirada en la

.github/lang/es-ES/README.md

@@ -4,9 +4,10 @@
 [![License](https://poser.pugx.org/josantonius/json/license)](LICENSE)
 [![Total Downloads](https://poser.pugx.org/josantonius/json/downloads)](https://packagist.org/packages/josantonius/json)
 [![CI](https://github.com/josantonius/php-json/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/josantonius/php-json/actions/workflows/ci.yml)
-[![PSR2](https://img.shields.io/badge/PSR-2-1abc9c.svg)](http://www.php-fig.org/psr/psr-2/)
-[![PSR4](https://img.shields.io/badge/PSR-4-9b59b6.svg)](http://www.php-fig.org/psr/psr-4/)
 [![CodeCov](https://codecov.io/gh/josantonius/php-json/branch/main/graph/badge.svg)](https://codecov.io/gh/josantonius/php-json)
+[![PSR1](https://img.shields.io/badge/PSR-1-f57046.svg)](https://www.php-fig.org/psr/psr-1/)
+[![PSR4](https://img.shields.io/badge/PSR-4-9b59b6.svg)](https://www.php-fig.org/psr/psr-4/)
+[![PSR12](https://img.shields.io/badge/PSR-12-1abc9c.svg)](https://www.php-fig.org/psr/psr-12/)
 
 **Traducciones**: [English](/README.md)
 
@@ -30,15 +31,7 @@ Biblioteca PHP para la gestión de archivos JSON.
 
 ## Requisitos
 
-Esta biblioteca es compatible desde la versión **8.0** de PHP hasta la versión **8.1** de PHP.
-
-Para seguir utilizando la versión con métodos estáticos sin las nuevas características:
-
-- Para versiones anteriores de PHP (desde la **5.6** hasta la **7.4**), puedes utilizar la
-[versión 1.1.9](https://github.com/josantonius/php-json/tree/1.1.9) de esta biblioteca.
-
-- Para las versiones **8.0** y **8.1** de PHP, puedes utilizar la
-[version 1.2.0](https://github.com/josantonius/php-json/tree/1.2.0) de esta biblioteca.
+Esta biblioteca es compatible con las versiones de PHP: 8.0 | 8.1.
 
 ## Instalación
 
@@ -73,17 +66,25 @@ Métodos disponibles en esta biblioteca:
 $json->get();
 ```
 
-**@throws** _CreateDirectoryException_ | _CreateFileException_ | _JsonErrorException_
+**@throws** `CreateDirectoryException` Si no se puede crear el directorio
+
+**@throws** `CreateFileException` Si no se puede crear el archivo
 
-**@Return** `array` - _Contenido del archivo_
+**@throws** `JsonErrorException` Si hay un error al analizar un archivo JSON
+
+**@Return** `array` Contenido del archivo
 
 ### Establecer el contenido del archivo JSON
 
 ```php
 $json->set(array|object $content);
 ```
 
-**@throws** _CreateFileException_ | _JsonErrorException_ | _UnavailableMethodException_
+**@throws** `CreateFileException` Si no se puede crear el archivo
+
+**@throws** `JsonErrorException` Si hay un error al analizar un archivo JSON
+
+**@throws** `UnavailableMethodException` Si el método no está disponible
 
 **@Return** `void`
 
@@ -93,19 +94,31 @@ $json->set(array|object $content);
 $json->merge(array|object $content);
 ```
 
-**@throws** _CreateFileException_ | _GetFileException_ | _JsonErrorException_ | _UnavailableMethodException_
+**@throws** `CreateFileException` Si no se puede crear el archivo
 
-**@Return** `array` - _Array resultante_
+**@throws** `GetFileException` Si no se puede obtener el archivo
+
+**@throws** `JsonErrorException` Si hay un error al analizar un archivo JSON
+
+**@throws** `UnavailableMethodException` Si el método no está disponible
+
+**@Return** `array` Array resultante
 
 ### Incluir en el archivo JSON
 
 ```php
 $json->push(array|object $content);
 ```
 
-**@throws** _CreateFileException_ | _GetFileException_ | _JsonErrorException_ | _UnavailableMethodException_
+**@throws** `CreateFileException` Si no se puede crear el archivo
+
+**@throws** `GetFileException` Si no se puede obtener el archivo
+
+**@throws** `JsonErrorException` Si hay un error al analizar un archivo JSON
+
+**@throws** `UnavailableMethodException` Si el método no está disponible
 
-**@Return** `array` - _Array resultante_
+**@Return** `array` Array resultante
 
 ## Cómo empezar
 
@@ -230,8 +243,7 @@ Ejecutar pruebas unitarias con [PHPUnit](https://phpunit.de/):
 composer phpunit
 ```
 
-Ejecutar pruebas de estándares de código [PSR2](http://www.php-fig.org/psr/psr-2/)
-con [PHPCS](https://github.com/squizlabs/PHP_CodeSniffer):
+Ejecutar pruebas de estándares de código con [PHPCS](https://github.com/squizlabs/PHP_CodeSniffer):
 
 ```console
 composer phpcs
@@ -273,8 +285,9 @@ _pull request_, comenzar una discusión o reportar un _issue_.
 
 ## Patrocinar
 
-Si este proyecto te ayuda a reducir el tiempo de desarrollo y quieres agradecérmelo,
-[¡podrías patrocinarme!](https://github.com/josantonius/lang/es-ES/README.md#patrocinar) :blush:
+Si este proyecto te ayuda a reducir el tiempo de desarrollo,
+[puedes patrocinarme](https://github.com/josantonius/lang/es-ES/README.md#patrocinar)
+para apoyar mi trabajo :blush:
 
 ## Licencia
 

CHANGELOG.md

@@ -1,5 +1,35 @@
 # CHANGELOG
 
+## [2.0.1](https://github.com/josantonius/php-json/releases/tag/2.0.1) (2022-06-28)
+
+* Exceptions were refactored.
+
+* Changes in documentation.
+
+* New code style rules have been added.
+
+* Implemented `PSR12 coding standard` from all library PHP files.
+
+* DELETED:
+  
+  `Josantonius\Json\Json::arrayToFile` method.
+  
+  `Josantonius\Json\Json::fileToArray` method.
+  
+  `Josantonius\Json\Tests\JsonTest` class.
+
+* ADDED:
+  
+  `Josantonius\Json\Tests\ConstructMethodTest` class.
+
+  `Josantonius\Json\Tests\GetMethodTest` class.
+
+  `Josantonius\Json\Tests\MergeMethodTest` class.
+
+  `Josantonius\Json\Tests\PushMethodTest` class.
+
+  `Josantonius\Json\Tests\SetMethodTest` class.
+
 ## [2.0.0](https://github.com/josantonius/php-json/releases/tag/2.0.0) (2022-06-16)
 
 * The library was completely refactored.

README.md

@@ -4,9 +4,10 @@
 [![License](https://poser.pugx.org/josantonius/json/license)](LICENSE)
 [![Total Downloads](https://poser.pugx.org/josantonius/json/downloads)](https://packagist.org/packages/josantonius/json)
 [![CI](https://github.com/josantonius/php-json/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/josantonius/php-json/actions/workflows/ci.yml)
-[![PSR2](https://img.shields.io/badge/PSR-2-1abc9c.svg)](http://www.php-fig.org/psr/psr-2/)
-[![PSR4](https://img.shields.io/badge/PSR-4-9b59b6.svg)](http://www.php-fig.org/psr/psr-4/)
 [![CodeCov](https://codecov.io/gh/josantonius/php-json/branch/main/graph/badge.svg)](https://codecov.io/gh/josantonius/php-json)
+[![PSR1](https://img.shields.io/badge/PSR-1-f57046.svg)](https://www.php-fig.org/psr/psr-1/)
+[![PSR4](https://img.shields.io/badge/PSR-4-9b59b6.svg)](https://www.php-fig.org/psr/psr-4/)
+[![PSR12](https://img.shields.io/badge/PSR-12-1abc9c.svg)](https://www.php-fig.org/psr/psr-12/)
 
 **Translations**: [Español](.github/lang/es-ES/README.md)
 
@@ -30,15 +31,7 @@ PHP simple library for managing JSON files.
 
 ## Requirements
 
-This library is compatible from **PHP 8.0** version to **PHP 8.1** version.
-
-To continue using the version with static methods without the new features:
-
-- For older versions of PHP (from **5.6** to **7.4**),
-[version 1.1.9](https://github.com/josantonius/php-json/tree/1.1.9) of this library can be used.
-
-- For PHP versions **8.0** and **8.1**,
-[version 1.2.0](https://github.com/josantonius/php-json/tree/1.2.0) of this library can be used.
+This library is compatible with the PHP versions: 8.0 | 8.1.
 
 ## Installation
 
@@ -73,17 +66,25 @@ Available methods in this library:
 $json->get();
 ```
 
-**@throws** _CreateDirectoryException_ | _CreateFileException_ | _JsonErrorException_
+**@throws** `CreateDirectoryException` If there is an error when creating a directory
+
+**@throws** `CreateFileException` If there is an error when creating a file
 
-**@Return** `array` - _File contents_
+**@throws** `JsonErrorException` If there is an error when parsing a JSON file
+
+**@Return** `array` File contents
 
 ### Set the content of the JSON file
 
 ```php
 $json->set(array|object $content);
 ```
 
-**@throws** _CreateFileException_ | _JsonErrorException_ | _UnavailableMethodException_
+**@throws** `CreateFileException` If there is an error when creating a file
+
+**@throws** `JsonErrorException` If there is an error when parsing a JSON file
+
+**@throws** `UnavailableMethodException` If the method is not available
 
 **@Return** `void`
 
@@ -93,19 +94,31 @@ $json->set(array|object $content);
 $json->merge(array|object $content);
 ```
 
-**@throws** _CreateFileException_ | _GetFileException_ | _JsonErrorException_ | _UnavailableMethodException_
+**@throws** `CreateFileException` If there is an error when creating a file
 
-**@Return** `array` - _Resulting array_
+**@throws** `GetFileException` If there is an error when getting a file
+
+**@throws** `JsonErrorException` If there is an error when parsing a JSON file
+
+**@throws** `UnavailableMethodException` If the method is not available
+
+**@Return** `array` Resulting array
 
 ### Push on the JSON file
 
 ```php
 $json->push(array|object $content);
 ```
 
-**@throws** _CreateFileException_ | _GetFileException_ | _JsonErrorException_ | _UnavailableMethodException_
+**@throws** `CreateFileException` If there is an error when creating a file
+
+**@throws** `GetFileException` If there is an error when getting a file
+
+**@throws** `JsonErrorException` If there is an error when parsing a JSON file
+
+**@throws** `UnavailableMethodException` If the method is not available
 
-**@Return** `array` - _Resulting array_
+**@Return** `array` Resulting array
 
 ## Quick Start
 
@@ -230,8 +243,7 @@ Run unit tests with [PHPUnit](https://phpunit.de/):
 composer phpunit
 ```
 
-Run [PSR2](http://www.php-fig.org/psr/psr-2/) code standard tests with
-[PHPCS](https://github.com/squizlabs/PHP_CodeSniffer):
+Run code standard tests with [PHPCS](https://github.com/squizlabs/PHP_CodeSniffer):
 
 ```console
 composer phpcs
@@ -271,8 +283,8 @@ Thanks to all [contributors](https://github.com/josantonius/php-json/graphs/cont
 
 ## Sponsor
 
-If this project helps you to reduce your development time and you want to thank me,
-[you could sponsor me!](https://github.com/josantonius#sponsor) :blush:
+If this project helps you to reduce your development time,
+[you can sponsor me](https://github.com/josantonius#sponsor) to support my open source work :blush:
 
 ## License