feat: add new exceptions

Add new exceptions.

#15

Author: josantonius

src/Exception/CreateDirectoryException.php

@@ -0,0 +1,32 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * PHP simple library for managing JSON files.
+ *
+ * @author    Josantonius <hello@josantonius.dev>
+ * @copyright 2016 (c) Josantonius
+ * @license   https://opensource.org/licenses/MIT - The MIT License (MIT)
+ * @link      https://github.com/josantonius/php-json
+ * @since     2.0.0
+ */
+namespace Josantonius\Json\Exception;
+
+/**
+ * You can use an exception and error handler with this library.
+ *
+ * @link https://github.com/josantonius/php-errorhandler
+ */
+class CreateDirectoryException extends \Exception
+{
+    public function __construct(string $path, \Throwable $th = null)
+    {
+        $lastError =  error_get_last()['message'] ?? '';
+
+        $message  = "Could not create directory in '$path'.";
+        $message .= $lastError ? " $lastError." : '';
+
+        parent::__construct($th ? $th->getMessage() : $message, 0, $th);
+    }
+}

src/Exception/CreateFileException.php

@@ -0,0 +1,32 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * PHP simple library for managing JSON files.
+ *
+ * @author    Josantonius <hello@josantonius.dev>
+ * @copyright 2016 (c) Josantonius
+ * @license   https://opensource.org/licenses/MIT - The MIT License (MIT)
+ * @link      https://github.com/josantonius/php-json
+ * @since     2.0.0
+ */
+namespace Josantonius\Json\Exception;
+
+/**
+ * You can use an exception and error handler with this library.
+ *
+ * @link https://github.com/josantonius/php-errorhandler
+ */
+class CreateFileException extends \Exception
+{
+    public function __construct(string $filepath, \Throwable $th = null)
+    {
+        $lastError =  error_get_last()['message'] ?? '';
+
+        $message  = "Could not create file '$filepath'.";
+        $message .= $lastError ? " $lastError." : '';
+
+        parent::__construct($th ? $th->getMessage() : $message, 0, $th);
+    }
+}

src/Exception/GetFileException.php

@@ -0,0 +1,32 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * PHP simple library for managing JSON files.
+ *
+ * @author    Josantonius <hello@josantonius.dev>
+ * @copyright 2016 (c) Josantonius
+ * @license   https://opensource.org/licenses/MIT - The MIT License (MIT)
+ * @link      https://github.com/josantonius/php-json
+ * @since     2.0.0
+ */
+namespace Josantonius\Json\Exception;
+
+/**
+ * You can use an exception and error handler with this library.
+ *
+ * @link https://github.com/josantonius/php-errorhandler
+ */
+class GetFileException extends \Exception
+{
+    public function __construct(string $filepath, \Throwable $th = null)
+    {
+        $lastError =  error_get_last()['message'] ?? '';
+
+        $message  = "Error reading file: '$filepath'.";
+        $message .= $lastError ? " $lastError." : '';
+
+        parent::__construct($th ? $th->getMessage() : $message, 0, $th);
+    }
+}

src/Exception/JsonErrorException.php

@@ -0,0 +1,29 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * PHP simple library for managing JSON files.
+ *
+ * @author    Josantonius <hello@josantonius.dev>
+ * @copyright 2016 (c) Josantonius
+ * @license   https://opensource.org/licenses/MIT - The MIT License (MIT)
+ * @link      https://github.com/josantonius/php-json
+ * @since     2.0.0
+ */
+namespace Josantonius\Json\Exception;
+
+/**
+ * You can use an exception and error handler with this library.
+ *
+ * @link https://github.com/josantonius/php-errorhandler
+ */
+class JsonErrorException extends \Exception
+{
+    public function __construct(\Throwable $th = null)
+    {
+        $message = 'JSON error: ' . json_last_error_msg();
+
+        parent::__construct($th ? $th->getMessage() : $message, 0, $th);
+    }
+}

src/Exception/UnavailableMethodException.php

@@ -0,0 +1,29 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * PHP simple library for managing JSON files.
+ *
+ * @author    Josantonius <hello@josantonius.dev>
+ * @copyright 2016 (c) Josantonius
+ * @license   https://opensource.org/licenses/MIT - The MIT License (MIT)
+ * @link      https://github.com/josantonius/php-json
+ * @since     2.0.0
+ */
+namespace Josantonius\Json\Exception;
+
+/**
+ * You can use an exception and error handler with this library.
+ *
+ * @link https://github.com/josantonius/php-errorhandler
+ */
+class UnavailableMethodException extends \Exception
+{
+    public function __construct(string $method, \Throwable $th = null)
+    {
+        $message = 'The "' . $method . '" method is not available for remote JSON files.';
+
+        parent::__construct($th ? $th->getMessage() : $message, 0, $th);
+    }
+}