ANY value in a list is required (#2615)

conan-io · Jun 28, 2022 · 81f6fdd · 81f6fdd
1 parent ff11162
commit 81f6fdd
Show file tree

Hide file tree

Showing 3 changed files with 32 additions and 4 deletions.
diff --git a/migrating_to_2.0/recipes.rst b/migrating_to_2.0/recipes.rst
@@ -117,6 +117,9 @@ Settings
 Options
 -------
 
+default_options
+^^^^^^^^^^^^^^^
+
 The definition of the ``default_options`` attribute has changed when referring to a dependency. It is related to the
 :ref:`unified patterns in the command line<conan_v2_unified_arguments>`.
 
@@ -140,6 +143,31 @@ The definition of the ``default_options`` attribute has changed when referring t
         default_options = {"pkg/*:some_option": "value"}
 
 
+ANY special value
+^^^^^^^^^^^^^^^^^
+
+The special value ``ANY`` has to be declared in a list:
+
+.. code-block:: python
+   :caption: **From:**
+
+    from conans import ConanFile
+
+    class Pkg(Conanfile):
+        options = {"opt": "ANY"}
+
+
+.. code-block:: python
+   :caption: **To:**
+
+    from conan import ConanFile
+
+    class Pkg(Conanfile):
+        options = {"opt": ["ANY"]}
+
+
+
+
 The layout() method
 -------------------
 

diff --git a/reference/conanfile/attributes.rst b/reference/conanfile/attributes.rst
@@ -344,7 +344,7 @@ options that can take any value.
         options = {
             "shared": [True, False],
             "option1": ["value1", "value2"],
-            "option2": "ANY",
+            "option2": ["ANY]",
             "option3": [None, "value1", "value2"],
             "option4": [True, False, "value"],
         }
@@ -387,7 +387,7 @@ go over all of them for the example recipe ``mypkg`` defined above:
             options = {
                 "shared": [True, False],
                 "option1": ["value1", "value2"],
-                "option2": "ANY",
+                "option2": ["ANY"],
             }
 
             def configure(self):
@@ -527,7 +527,7 @@ not define them. This attribute should be defined as a python dictionary:
         ...
         options = {"build_tests": [True, False],
                    "option1": ["value1", "value2"],
-                   "option2": "ANY"}
+                   "option2": ["ANY"]}
         default_options = {"build_tests": True,
                            "option1": "value1",
                            "option2": 42}

diff --git a/systems_cross_building/cross_building.rst b/systems_cross_building/cross_building.rst
@@ -231,7 +231,7 @@ With previous attributes, a draft for a recipe that packages a cross compiler co
         name = "my_compiler"
 
         settings = "os", "arch", "compiler", "build_type"
-        options = {"target": "ANY"}
+        options = {"target": ["ANY"]}
         default_options = {"shared": False, "target": None}
 
         def validate(self):