From: Brad Jorsch <bjorsch@wikimedia.org>
Date: Fri, 1 Nov 2019 17:48:59 +0000 (-0400)
Subject: ParamValidator: Flag as unstable for 1.34
X-Git-Tag: 1.34.0-rc.1~5
X-Git-Url: http://git.heureux-cyclage.org/?p=lhc%2Fweb%2Fwiklou.git;a=commitdiff_plain;h=25242105e8fd03c9900250bdf9ea91be9a286625

ParamValidator: Flag as unstable for 1.34

Iea6d4a1d0 isn't likely to make it, and I don't want to have to
support the architectural mistakes it's fixing in 1.35.

Change-Id: Icd161779d4e2eb60c507a5a4400f9432741c72eb
(cherry picked from commit ff70806ef1e142c67841b049b7b943170558ed78)
---

diff --git a/includes/libs/ParamValidator/Callbacks.php b/includes/libs/ParamValidator/Callbacks.php
index d94a81fbd5..ecaa86e85c 100644
--- a/includes/libs/ParamValidator/Callbacks.php
+++ b/includes/libs/ParamValidator/Callbacks.php
@@ -15,6 +15,7 @@ use Psr\Http\Message\UploadedFileInterface;
  * and is intended for communication of non-global state.
  *
  * @since 1.34
+ * @unstable
  */
 interface Callbacks {
 
diff --git a/includes/libs/ParamValidator/ParamValidator.php b/includes/libs/ParamValidator/ParamValidator.php
index 02746ecd3e..99f0e549b1 100644
--- a/includes/libs/ParamValidator/ParamValidator.php
+++ b/includes/libs/ParamValidator/ParamValidator.php
@@ -33,6 +33,7 @@ use Wikimedia\ObjectFactory;
  *      the user unnecessarily.
  *
  * @since 1.34
+ * @unstable
  */
 class ParamValidator {
 
diff --git a/includes/libs/ParamValidator/SimpleCallbacks.php b/includes/libs/ParamValidator/SimpleCallbacks.php
index 77dab92619..315ff965a6 100644
--- a/includes/libs/ParamValidator/SimpleCallbacks.php
+++ b/includes/libs/ParamValidator/SimpleCallbacks.php
@@ -11,6 +11,7 @@ use Wikimedia\ParamValidator\Util\UploadedFile;
  *  - 'useHighLimits': (bool) Return value from useHighLimits()
  *
  * @since 1.34
+ * @unstable
  */
 class SimpleCallbacks implements Callbacks {
 
diff --git a/includes/libs/ParamValidator/TypeDef.php b/includes/libs/ParamValidator/TypeDef.php
index 0d54addc58..27fddde85c 100644
--- a/includes/libs/ParamValidator/TypeDef.php
+++ b/includes/libs/ParamValidator/TypeDef.php
@@ -10,6 +10,7 @@ namespace Wikimedia\ParamValidator;
  * and is intended for communication of non-global state.
  *
  * @since 1.34
+ * @unstable
  */
 abstract class TypeDef {
 
diff --git a/includes/libs/ParamValidator/TypeDef/BooleanDef.php b/includes/libs/ParamValidator/TypeDef/BooleanDef.php
index f77c930499..15f082ee31 100644
--- a/includes/libs/ParamValidator/TypeDef/BooleanDef.php
+++ b/includes/libs/ParamValidator/TypeDef/BooleanDef.php
@@ -17,6 +17,7 @@ use Wikimedia\ParamValidator\ValidationException;
  *     - 'falsevals': List of recognized values for "false".
  *
  * @since 1.34
+ * @unstable
  */
 class BooleanDef extends TypeDef {
 
diff --git a/includes/libs/ParamValidator/TypeDef/EnumDef.php b/includes/libs/ParamValidator/TypeDef/EnumDef.php
index 0f4f6908e5..ab703b054e 100644
--- a/includes/libs/ParamValidator/TypeDef/EnumDef.php
+++ b/includes/libs/ParamValidator/TypeDef/EnumDef.php
@@ -23,6 +23,7 @@ use Wikimedia\ParamValidator\ValidationException;
  * the constants' documentation for details.
  *
  * @since 1.34
+ * @unstable
  */
 class EnumDef extends TypeDef {
 
diff --git a/includes/libs/ParamValidator/TypeDef/FloatDef.php b/includes/libs/ParamValidator/TypeDef/FloatDef.php
index 0a204b3a88..5d1c75911f 100644
--- a/includes/libs/ParamValidator/TypeDef/FloatDef.php
+++ b/includes/libs/ParamValidator/TypeDef/FloatDef.php
@@ -24,6 +24,7 @@ use Wikimedia\ParamValidator\ValidationException;
  *    infinity or NAN.
  *
  * @since 1.34
+ * @unstable
  */
 class FloatDef extends TypeDef {
 
diff --git a/includes/libs/ParamValidator/TypeDef/IntegerDef.php b/includes/libs/ParamValidator/TypeDef/IntegerDef.php
index 556301b898..49c403dd51 100644
--- a/includes/libs/ParamValidator/TypeDef/IntegerDef.php
+++ b/includes/libs/ParamValidator/TypeDef/IntegerDef.php
@@ -21,6 +21,7 @@ use Wikimedia\ParamValidator\ValidationException;
  * the constants' documentation for details.
  *
  * @since 1.34
+ * @unstable
  */
 class IntegerDef extends TypeDef {
 
diff --git a/includes/libs/ParamValidator/TypeDef/LimitDef.php b/includes/libs/ParamValidator/TypeDef/LimitDef.php
index 99780c4a0d..2e314337df 100644
--- a/includes/libs/ParamValidator/TypeDef/LimitDef.php
+++ b/includes/libs/ParamValidator/TypeDef/LimitDef.php
@@ -10,6 +10,7 @@ namespace Wikimedia\ParamValidator\TypeDef;
  *
  * @see IntegerDef
  * @since 1.34
+ * @unstable
  */
 class LimitDef extends IntegerDef {
 
diff --git a/includes/libs/ParamValidator/TypeDef/PasswordDef.php b/includes/libs/ParamValidator/TypeDef/PasswordDef.php
index 289db54869..55800c064b 100644
--- a/includes/libs/ParamValidator/TypeDef/PasswordDef.php
+++ b/includes/libs/ParamValidator/TypeDef/PasswordDef.php
@@ -11,6 +11,7 @@ use Wikimedia\ParamValidator\ParamValidator;
  *
  * @see StringDef
  * @since 1.34
+ * @unstable
  */
 class PasswordDef extends StringDef {
 
diff --git a/includes/libs/ParamValidator/TypeDef/PresenceBooleanDef.php b/includes/libs/ParamValidator/TypeDef/PresenceBooleanDef.php
index 2e1c8f5428..2d8734ef48 100644
--- a/includes/libs/ParamValidator/TypeDef/PresenceBooleanDef.php
+++ b/includes/libs/ParamValidator/TypeDef/PresenceBooleanDef.php
@@ -14,6 +14,7 @@ use Wikimedia\ParamValidator\TypeDef;
  * The result from validate() is a PHP boolean.
  *
  * @since 1.34
+ * @unstable
  */
 class PresenceBooleanDef extends TypeDef {
 
diff --git a/includes/libs/ParamValidator/TypeDef/StringDef.php b/includes/libs/ParamValidator/TypeDef/StringDef.php
index 0ed310b50f..243a0e22cb 100644
--- a/includes/libs/ParamValidator/TypeDef/StringDef.php
+++ b/includes/libs/ParamValidator/TypeDef/StringDef.php
@@ -19,6 +19,7 @@ use Wikimedia\ParamValidator\ValidationException;
  * the constants' documentation for details.
  *
  * @since 1.34
+ * @unstable
  */
 class StringDef extends TypeDef {
 
diff --git a/includes/libs/ParamValidator/TypeDef/TimestampDef.php b/includes/libs/ParamValidator/TypeDef/TimestampDef.php
index 5d0bf4e951..c05b10f31d 100644
--- a/includes/libs/ParamValidator/TypeDef/TimestampDef.php
+++ b/includes/libs/ParamValidator/TypeDef/TimestampDef.php
@@ -24,6 +24,7 @@ use Wikimedia\Timestamp\TimestampException;
  *    Use 'now' instead if you really want the current timestamp. No data.
  *
  * @since 1.34
+ * @unstable
  */
 class TimestampDef extends TypeDef {
 
diff --git a/includes/libs/ParamValidator/TypeDef/UploadDef.php b/includes/libs/ParamValidator/TypeDef/UploadDef.php
index b436a6dc54..c1296ad05e 100644
--- a/includes/libs/ParamValidator/TypeDef/UploadDef.php
+++ b/includes/libs/ParamValidator/TypeDef/UploadDef.php
@@ -28,6 +28,7 @@ use Wikimedia\ParamValidator\ValidationException;
  *     - 'code': The code.
  *
  * @since 1.34
+ * @unstable
  */
 class UploadDef extends TypeDef {
 
diff --git a/includes/libs/ParamValidator/Util/UploadedFile.php b/includes/libs/ParamValidator/Util/UploadedFile.php
index 2be9119d25..96de155aee 100644
--- a/includes/libs/ParamValidator/Util/UploadedFile.php
+++ b/includes/libs/ParamValidator/Util/UploadedFile.php
@@ -15,6 +15,7 @@ use Wikimedia\AtEase\AtEase;
  * Callbacks::getUploadedFile() when another PSR-7 library is not already in use.
  *
  * @since 1.34
+ * @unstable
  */
 class UploadedFile implements UploadedFileInterface {
 
diff --git a/includes/libs/ParamValidator/ValidationException.php b/includes/libs/ParamValidator/ValidationException.php
index c8d995e0b9..71be25c8f0 100644
--- a/includes/libs/ParamValidator/ValidationException.php
+++ b/includes/libs/ParamValidator/ValidationException.php
@@ -10,6 +10,7 @@ use UnexpectedValueException;
  * Error reporting for ParamValidator
  *
  * @since 1.34
+ * @unstable
  */
 class ValidationException extends UnexpectedValueException {