[JsonPath] Add the component as experimental

Author: alexandre-daubois

.gitattributes

@@ -0,0 +1,3 @@
+/Tests export-ignore
+/phpunit.xml.dist export-ignore
+/.git* export-ignore

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,8 @@
+Please do not submit any Pull Requests here. They will be closed.
+---
+
+Please submit your PR here instead:
+https://github.com/symfony/symfony
+
+This repository is what we call a "subtree split": a read-only subset of that main repository.
+We're looking forward to your PR there!

.github/workflows/close-pull-request.yml

@@ -0,0 +1,20 @@
+name: Close Pull Request
+
+on:
+  pull_request_target:
+    types: [opened]
+
+jobs:
+  run:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: superbrothers/close-pull-request@v3
+      with:
+        comment: |
+          Thanks for your Pull Request! We love contributions.
+
+          However, you should instead open your PR on the main repository:
+          https://github.com/symfony/symfony
+
+          This repository is what we call a "subtree split": a read-only subset of that main repository.
+          We're looking forward to your PR there!

.gitignore

@@ -0,0 +1,3 @@
+vendor/
+composer.lock
+phpunit.xml

CHANGELOG.md

@@ -0,0 +1,7 @@
+CHANGELOG
+=========
+
+7.3
+---
+
+ * Add the component as experimental

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
+{
+}

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
+{
+}

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));
+    }
+}

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);
+    }
+}

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);
+    }
+}