Automated commit of generated code

Author: github-actions[bot]

core/generated-sources/src/main/kotlin/org/jetbrains/kotlinx/dataframe/annotations/ImportDataSchema.kt

@@ -27,6 +27,7 @@ import org.jetbrains.kotlinx.dataframe.io.JSON
  * @param csvOptions options to parse CSV data. Not used when data is not Csv
  * @param jsonOptions options to parse JSON data. Not used when data is not Json
  * @param jdbcOptions options to parse data from a database via JDBC. Not used when data is not stored in the database
+ * @param enableExperimentalOpenApi Can be set to `true` to enable experimental OpenAPI 3.0.0 types support
  */
 @Retention(AnnotationRetention.SOURCE)
 @Target(AnnotationTarget.FILE)
@@ -40,6 +41,7 @@ public annotation class ImportDataSchema(
     val csvOptions: CsvOptions = CsvOptions(','),
     val jsonOptions: JsonOptions = JsonOptions(),
     val jdbcOptions: JdbcOptions = JdbcOptions(),
+    val enableExperimentalOpenApi: Boolean = false,
 )
 
 public enum class DataSchemaVisibility {

core/generated-sources/src/main/kotlin/org/jetbrains/kotlinx/dataframe/jupyter/JupyterConfiguration.kt

@@ -3,7 +3,10 @@ package org.jetbrains.kotlinx.dataframe.jupyter
 import org.jetbrains.kotlinx.dataframe.BuildConfig
 import org.jetbrains.kotlinx.dataframe.io.DisplayConfiguration
 
-public class JupyterConfiguration {
+public class JupyterConfiguration(
+    /** If true, experimental OpenAPI 3.0.0 types support via importDataSchema() is enabled. Can be set via `%use dataframe(..., enableExperimentalOpenApi=true)` */
+    public val enableExperimentalOpenApi: Boolean = false,
+) {
     public val display: DisplayConfiguration = DisplayConfiguration()
 
     /** Version of the library. */

core/generated-sources/src/main/kotlin/org/jetbrains/kotlinx/dataframe/jupyter/importDataSchema.kt

@@ -20,9 +20,14 @@ internal val importDataSchema =
     """
     /** Import the type-only data schema from [url]. */
     fun importDataSchema(url: URL, name: String) {
-        val formats = listOf(
-            OpenApi(),
+        val formats = listOfNotNull(
+            if (dataFrameConfig.enableExperimentalOpenApi) OpenApi() else null,
         )
+        
+        require(formats.isNotEmpty()) { 
+            "importDataSchema() did not find any supported type-only data schema generation providers (`SupportedCodeGenerationFormat`). If you were looking for OpenAPI 3.0.0 types, set `%use dataframe(..., enableExperimentalOpenApi=true)`." 
+        }   
+        
         val codeGenResult = org.jetbrains.dataframe.impl.codeGen.CodeGenerator.urlCodeGenReader(url, formats)
         when (codeGenResult) {
             is org.jetbrains.kotlinx.dataframe.impl.codeGen.CodeGenerationReadResult.Success -> {