Add more enum samples. (#543)

* Add more enum samples

Change-Id: I743d5967cc1cc91576b8ddf5a60db1767d94508d

* format

Change-Id: I8f6f9389f1cae0a7c934217968d4e2e20bb9590e

Author: MarkDaoust

samples/controlled_generation.py

@@ -73,6 +73,34 @@ class Choice(enum.Enum):
         print(result)  # "Keyboard"
         # [END json_enum]
 
+    def test_enum_in_json(self):
+        # [START enum_in_json]
+        import enum
+        from typing_extensions import TypedDict
+
+        class Grade(enum.Enum):
+            A_PLUS = "a+"
+            A = "a"
+            B = "b"
+            C = "c"
+            D = "d"
+            F = "f"
+
+        class Recipe(TypedDict):
+            recipe_name: str
+            grade: Grade
+
+        model = genai.GenerativeModel("gemini-1.5-pro-latest")
+
+        result = model.generate_content(
+            "List about 10 cookie recipes, grade them based on popularity",
+            generation_config=genai.GenerationConfig(
+                response_mime_type="application/json", response_schema=list[Recipe]
+            ),
+        )
+        print(result)  # [{"grade": "a+", "recipe_name": "Chocolate Chip Cookies"}, ...]
+        # [END enum_in_json]
+
     def test_json_enum_raw(self):
         # [START json_enum_raw]
         model = genai.GenerativeModel("gemini-1.5-pro-latest")
@@ -91,6 +119,47 @@ def test_json_enum_raw(self):
         print(result)  # "Keyboard"
         # [END json_enum_raw]
 
+    def test_x_enum(self):
+        # [START x_enum]
+        import enum
+
+        class Choice(enum.Enum):
+            PERCUSSION = "Percussion"
+            STRING = "String"
+            WOODWIND = "Woodwind"
+            BRASS = "Brass"
+            KEYBOARD = "Keyboard"
+
+        model = genai.GenerativeModel("gemini-1.5-pro-latest")
+
+        organ = genai.upload_file(media / "organ.jpg")
+        result = model.generate_content(
+            ["What kind of instrument is this:", organ],
+            generation_config=genai.GenerationConfig(
+                response_mime_type="text/x.enum", response_schema=Choice
+            ),
+        )
+        print(result)  # "Keyboard"
+        # [END x_enum]
+
+    def test_x_enum_raw(self):
+        # [START x_enum_raw]
+        model = genai.GenerativeModel("gemini-1.5-pro-latest")
+
+        organ = genai.upload_file(media / "organ.jpg")
+        result = model.generate_content(
+            ["What kind of instrument is this:", organ],
+            generation_config=genai.GenerationConfig(
+                response_mime_type="text/x.enum",
+                response_schema={
+                    "type": "STRING",
+                    "enum": ["Percussion", "String", "Woodwind", "Brass", "Keyboard"],
+                },
+            ),
+        )
+        print(result)  # "Keyboard"
+        # [END x_enum_raw]
+
 
 if __name__ == "__main__":
     absltest.main()