symfony · fabpot · Mar 28, 2025 · Jan 28, 2025
diff --git a/composer.json b/composer.json
@@ -83,6 +83,7 @@
         "symfony/http-foundation": "self.version",
         "symfony/http-kernel": "self.version",
         "symfony/intl": "self.version",
+        "symfony/json-path": "self.version",
         "symfony/json-streamer": "self.version",
         "symfony/ldap": "self.version",
         "symfony/lock": "self.version",

diff --git a/src/Symfony/Component/JsonPath/.gitattributes b/src/Symfony/Component/JsonPath/.gitattributes
@@ -0,0 +1,3 @@
+/Tests export-ignore
+/phpunit.xml.dist export-ignore
+/.git* export-ignore
diff --git a/src/Symfony/Component/JsonPath/.github/PULL_REQUEST_TEMPLATE.md b/src/Symfony/Component/JsonPath/.github/PULL_REQUEST_TEMPLATE.md
diff --git a/src/Symfony/Component/JsonPath/.github/workflows/close-pull-request.yml b/src/Symfony/Component/JsonPath/.github/workflows/close-pull-request.yml
diff --git a/src/Symfony/Component/JsonPath/.gitignore b/src/Symfony/Component/JsonPath/.gitignore
@@ -0,0 +1,3 @@
+vendor/
+composer.lock
+phpunit.xml
diff --git a/src/Symfony/Component/JsonPath/CHANGELOG.md b/src/Symfony/Component/JsonPath/CHANGELOG.md
@@ -0,0 +1,7 @@
+CHANGELOG
+=========
+
+7.3
+---
+
+ * Add the component as experimental
diff --git a/src/Symfony/Component/JsonPath/Exception/ExceptionInterface.php b/src/Symfony/Component/JsonPath/Exception/ExceptionInterface.php
@@ -0,0 +1,21 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\JsonPath\Exception;
+
+/**
+ * @author Alexandre Daubois <[email protected]>
+ *
+ * @experimental
+ */
+interface ExceptionInterface extends \Throwable
+{
+}
diff --git a/src/Symfony/Component/JsonPath/Exception/InvalidArgumentException.php b/src/Symfony/Component/JsonPath/Exception/InvalidArgumentException.php
@@ -0,0 +1,21 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\JsonPath\Exception;
+
+/**
+ * @author Alexandre Daubois <[email protected]>
+ *
+ * @experimental
+ */
+class InvalidArgumentException extends \InvalidArgumentException implements ExceptionInterface
+{
+}
diff --git a/src/Symfony/Component/JsonPath/Exception/InvalidJsonPathException.php b/src/Symfony/Component/JsonPath/Exception/InvalidJsonPathException.php
@@ -0,0 +1,25 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\JsonPath\Exception;
+
+/**
+ * @author Alexandre Daubois <[email protected]>
+ *
+ * @experimental
+ */
+class InvalidJsonPathException extends \LogicException implements ExceptionInterface
+{
+    public function __construct(string $message, ?int $position = null)
+    {
+        parent::__construct(\sprintf('JSONPath syntax error%s: %s', $position ? ' at position '.$position : '', $message));
+    }
+}
diff --git a/src/Symfony/Component/JsonPath/Exception/InvalidJsonStringInputException.php b/src/Symfony/Component/JsonPath/Exception/InvalidJsonStringInputException.php
@@ -0,0 +1,27 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\JsonPath\Exception;
+
+/**
+ * Thrown when a string passed as an input is not a valid JSON string, e.g. in {@see JsonCrawler}.
+ *
+ * @author Alexandre Daubois <[email protected]>
+ *
+ * @experimental
+ */
+class InvalidJsonStringInputException extends InvalidArgumentException
+{
+    public function __construct(string $message, ?\Throwable $previous = null)
+    {
+        parent::__construct(\sprintf('Invalid JSON input: %s.', $message), previous: $previous);
+    }
+}
diff --git a/src/Symfony/Component/JsonPath/Exception/JsonCrawlerException.php b/src/Symfony/Component/JsonPath/Exception/JsonCrawlerException.php
@@ -0,0 +1,25 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\JsonPath\Exception;
+
+/**
+ * @author Alexandre Daubois <[email protected]>
+ *
+ * @experimental
+ */
+class JsonCrawlerException extends \RuntimeException implements ExceptionInterface
+{
+    public function __construct(string $path, string $message, ?\Throwable $previous = null)
+    {
+        parent::__construct(\sprintf('Error while crawling JSON with JSON path "%s": %s.', $path, $message), previous: $previous);
+    }
+}