From cdd7ad020e165fe680703b6d3319b908b682fb7a Mon Sep 17 00:00:00 2001
From: Andrew Dolgov <fox@fakecake.org>
Date: Fri, 20 Oct 2023 17:12:29 +0300
Subject: jaeger-client -> opentelemetry

---
 .../sdk/Common/Dev/Compatibility/README.md         | 14 ++++
 .../sdk/Common/Dev/Compatibility/Util.php          | 93 ++++++++++++++++++++++
 .../sdk/Common/Dev/Compatibility/_load.php         |  7 ++
 3 files changed, 114 insertions(+)
 create mode 100644 vendor/open-telemetry/sdk/Common/Dev/Compatibility/README.md
 create mode 100644 vendor/open-telemetry/sdk/Common/Dev/Compatibility/Util.php
 create mode 100644 vendor/open-telemetry/sdk/Common/Dev/Compatibility/_load.php

(limited to 'vendor/open-telemetry/sdk/Common/Dev')

diff --git a/vendor/open-telemetry/sdk/Common/Dev/Compatibility/README.md b/vendor/open-telemetry/sdk/Common/Dev/Compatibility/README.md
new file mode 100644
index 000000000..661eed3b8
--- /dev/null
+++ b/vendor/open-telemetry/sdk/Common/Dev/Compatibility/README.md
@@ -0,0 +1,14 @@
+# Backwards Compatibility
+
+We aim to provide backward compatibility (without any guarantee) even for alpha releases, however the library will raise notices indicating breaking changes and what to do about them. \
+If you don't want these notices to appear or change the error message level, you can do so by calling:
+```php
+OpenTelemetry\SDK\Common\Dev\Compatibility\Util::setErrorLevel(0)
+``` 
+to turn messages off completely, or (for example)
+```php
+OpenTelemetry\SDK\Common\Dev\Compatibility\Util::setErrorLevel(E_USER_DEPRECATED)
+``` 
+to trigger only deprecation notices. Valid error levels are `0` (none), `E_USER_DEPRECATED`, `E_USER_NOTICE`, `E_USER_WARNING` and `E_USER_ERROR`  \
+However (as long as in alpha) it is safer to pin a dependency on the library to a specific version and/or make the adjustments
+mentioned in the provided messages, since doing otherwise may break things completely for you in the future!
diff --git a/vendor/open-telemetry/sdk/Common/Dev/Compatibility/Util.php b/vendor/open-telemetry/sdk/Common/Dev/Compatibility/Util.php
new file mode 100644
index 000000000..1a3debfdd
--- /dev/null
+++ b/vendor/open-telemetry/sdk/Common/Dev/Compatibility/Util.php
@@ -0,0 +1,93 @@
+<?php
+
+declare(strict_types=1);
+
+namespace OpenTelemetry\SDK\Common\Dev\Compatibility;
+
+class Util
+{
+    public const E_NONE = 0;
+    public const DEFAULT_ERROR_LEVEL = E_USER_NOTICE;
+    public const ERROR_LEVELS = [
+        self::E_NONE,
+        E_USER_DEPRECATED,
+        E_USER_NOTICE,
+        E_USER_WARNING,
+        E_USER_ERROR,
+    ];
+
+    private static int $errorLevel = E_USER_NOTICE;
+
+    public static function setErrorLevel(int $errorLevel = E_USER_NOTICE): void
+    {
+        self::validateErrorLevel($errorLevel);
+
+        self::$errorLevel = $errorLevel;
+    }
+
+    public static function getErrorLevel(): int
+    {
+        return self::$errorLevel;
+    }
+
+    /**
+     * @psalm-suppress ArgumentTypeCoercion
+     */
+    public static function triggerClassDeprecationNotice(string $className, string $alternativeClassName = null): void
+    {
+        if (self::getErrorLevel() === self::E_NONE) {
+            return;
+        }
+
+        $notice = sprintf(
+            'Class "%s" is deprecated and will be removed in a future release. ',
+            $className
+        );
+
+        if ($alternativeClassName !== null) {
+            $notice .= sprintf('Please, use "%s" instead.', $alternativeClassName);
+        }
+
+        trigger_error($notice, self::$errorLevel);
+    }
+
+    /**
+     * @psalm-suppress ArgumentTypeCoercion
+     */
+    public static function triggerMethodDeprecationNotice(
+        string $methodName,
+        string $alternativeMethodName = null,
+        string $alternativeClassName = null
+    ): void {
+        if (self::getErrorLevel() === self::E_NONE) {
+            return;
+        }
+
+        $notice = sprintf(
+            'Method "%s " is deprecated and will be removed in a future release. ',
+            $methodName
+        );
+
+        if ($alternativeMethodName !== null) {
+            $method = $alternativeClassName === null
+                ? $alternativeMethodName
+                : sprintf('%s::%s', $alternativeClassName, $alternativeMethodName);
+
+            $notice .= sprintf('Please, use "%s" instead.', $method);
+        }
+
+        trigger_error($notice, self::$errorLevel);
+    }
+
+    private static function validateErrorLevel(int $errorLevel): void
+    {
+        if (!in_array($errorLevel, self::ERROR_LEVELS, true)) {
+            throw new \InvalidArgumentException(
+                sprintf(
+                    'Error level must be one of "%s"',
+                    implode('", "', self::ERROR_LEVELS)
+                ),
+            );
+        }
+    }
+}
diff --git a/vendor/open-telemetry/sdk/Common/Dev/Compatibility/_load.php b/vendor/open-telemetry/sdk/Common/Dev/Compatibility/_load.php
new file mode 100644
index 000000000..99f86c574
--- /dev/null
+++ b/vendor/open-telemetry/sdk/Common/Dev/Compatibility/_load.php
@@ -0,0 +1,7 @@
+<?php
+
+declare(strict_types=1);
+/**
+ * To add a BC compatibility:
+ * require_once __DIR__ . '/BC/SomeFile.php';
+ */
-- 
cgit v1.2.3