feat: add new methods

Exists and filepath methods were added.
The file is no longer created if it does not exist when the instance is created.
The $content parameter of the set method is now optional and contains an empty array by default.

Closes #22

Author: josantonius

src/Json.php

@@ -16,6 +16,7 @@
 use Josantonius\Json\Exceptions\GetFileException;
 use Josantonius\Json\Exceptions\JsonErrorException;
 use Josantonius\Json\Exceptions\CreateFileException;
+use Josantonius\Json\Exceptions\CreateDirectoryException;
 use Josantonius\Json\Exceptions\UnavailableMethodException;
 
 /**
@@ -67,6 +68,7 @@ public function get(): array
      *
      * @throws CreateFileException        if the file cannot be created.
      * @throws UnavailableMethodException if an unavailable method is accessed.
+     * @throws CreateDirectoryException   if the directory cannot be created.
      */
     public function set(array|object $content = []): void
     {
@@ -107,11 +109,25 @@ public function push(array|object $content): array
         return $data;
     }
 
+    /**
+     * Create directory if not exists.
+     *
+     * @throws CreateDirectoryException if the directory cannot be created.
+     */
+    private function createDirIfNotExists(): void
+    {
+        $path = dirname($this->filepath) . DIRECTORY_SEPARATOR;
+        if (!is_dir($path) && !@mkdir($path, 0777, true)) {
+            throw new CreateDirectoryException($path);
+        }
+    }
+
     /**
      * Get the content of the JSON file or a remote JSON file.
      *
-     * @throws GetFileException   if the file cannot be read.
-     * @throws JsonErrorException if the JSON has errors.
+     * @throws GetFileException         if the file cannot be read.
+     * @throws JsonErrorException       if the JSON has errors.
+     * @throws CreateDirectoryException if the directory cannot be created.
      */
     private function getFileContents(): array
     {
@@ -137,6 +153,8 @@ private function saveToJsonFile(array|object $array): void
     {
         $json = json_encode($array, JSON_PRETTY_PRINT);
 
+        $this->createDirIfNotExists();
+
         if (@file_put_contents($this->filepath, $json) === false) {
             throw new CreateFileException($this->filepath);
         }