Merge branch 'JetBrains:main' into main

.github/workflows/docs-workflow.yml

@@ -50,7 +50,7 @@ jobs:
         uses: gradle/gradle-build-action@v2
 
       - name: Build API documentation with Dokka
-        run: ./gradlew dokkaHtmlMultiModule
+        run: ./gradlew :dokkaGenerate
 
       - name: Create Pull Request
         uses: peter-evans/create-pull-request@v6

CHANGELOG.md

@@ -1,3 +1,37 @@
+# 0.58.0
+
+## What's Changed
+
+Breaking changes:
+* fix: EXPOSED-662 SchemaUtils.listTables() returns empty list & closes db connection by @joc-a in https://github.com/JetBrains/Exposed/pull/2331
+  * `SchemaUtils.listTables()` returns only the tables from the current schema. The behaviour was returned to the 0.56.0 version.
+  * To get tables from all the schemas the method `SchemaUtils.listTablesInAllSchemas()` could be used.
+
+Features:
+* feat: [MariaDB] Support RETURNING clause by @devgor88 in https://github.com/JetBrains/Exposed/pull/2330
+* feat: EXPOSED-654 Allow customizing the check constraint names of columns with check constraints by @joc-a in https://github.com/JetBrains/Exposed/pull/2340
+
+Infrastructure:
+* springFramework 6.2.1
+* log4j2 2.24.3
+* org.junit:junit-bom 5.11.4
+* org.jetbrains.dokka 2.0.0
+* springBoot 3.4.1
+* kotlinCoroutines 1.10.0
+* kotlinCoroutines 1.10.1
+* org.xerial:sqlite-jdbc from 3.47.2.0
+* org.jetbrains.kotlinx.binary-compatibility-validator 0.17.0
+* org.jetbrains.kotlinx:kotlinx-serialization-json 1.8.0
+
+Docs:
+* docs: Update documentation website by @github-actions in https://github.com/JetBrains/Exposed/pull/2304
+* docs: EXPOSED-207 Add link to SQLite ALTER TABLE restrictions in SchemaUtils Kdocs by @bog-walk in https://github.com/JetBrains/Exposed/pull/2338
+* docs: EXPOSED-670 Adjust YouTrack issue visibility and PR guidelines by @bog-walk in https://github.com/JetBrains/Exposed/pull/2337
+* docs: EXPOSED-600 Add links to API docs for functions and classes by @vnikolova in https://github.com/JetBrains/Exposed/pull/2339
+* docs: EXPOSED-682 Switch api link from deprecated select() by @bog-walk in https://github.com/JetBrains/Exposed/pull/2349
+* EXPOSED-675 Clarify that sort methods are from the Kotlin std lib by @vnikolova in https://github.com/JetBrains/Exposed/pull/2352
+
+
 # 0.57.0
 Infrastructure:
 * io.github.hakky54:logcaptor 2.10.0

README.md

@@ -81,52 +81,52 @@ The Maven Central repository is enabled by default for Maven users.
     <dependency>
         <groupId>org.jetbrains.exposed</groupId>
         <artifactId>exposed-core</artifactId>
-        <version>0.57.0</version>
+        <version>0.58.0</version>
     </dependency>
     <dependency>
         <groupId>org.jetbrains.exposed</groupId>
         <artifactId>exposed-crypt</artifactId>
-        <version>0.57.0</version>
+        <version>0.58.0</version>
     </dependency>
     <dependency>
         <groupId>org.jetbrains.exposed</groupId>
         <artifactId>exposed-dao</artifactId>
-        <version>0.57.0</version>
+        <version>0.58.0</version>
     </dependency>
     <dependency>
         <groupId>org.jetbrains.exposed</groupId>
         <artifactId>exposed-java-time</artifactId>
-        <version>0.57.0</version>
+        <version>0.58.0</version>
     </dependency>
     <dependency>
         <groupId>org.jetbrains.exposed</groupId>
         <artifactId>exposed-jdbc</artifactId>
-        <version>0.57.0</version>
+        <version>0.58.0</version>
     </dependency>
     <dependency>
         <groupId>org.jetbrains.exposed</groupId>
         <artifactId>exposed-jodatime</artifactId>
-        <version>0.57.0</version>
+        <version>0.58.0</version>
     </dependency>
     <dependency>
         <groupId>org.jetbrains.exposed</groupId>
         <artifactId>exposed-json</artifactId>
-        <version>0.57.0</version>
+        <version>0.58.0</version>
     </dependency>
     <dependency>
         <groupId>org.jetbrains.exposed</groupId>
         <artifactId>exposed-kotlin-datetime</artifactId>
-        <version>0.57.0</version>
+        <version>0.58.0</version>
     </dependency>
     <dependency>
         <groupId>org.jetbrains.exposed</groupId>
         <artifactId>exposed-money</artifactId>
-        <version>0.57.0</version>
+        <version>0.58.0</version>
     </dependency>
     <dependency>
         <groupId>org.jetbrains.exposed</groupId>
         <artifactId>exposed-spring-boot-starter</artifactId>
-        <version>0.57.0</version>
+        <version>0.58.0</version>
     </dependency>
 </dependencies>
 
@@ -136,20 +136,20 @@ The Maven Central repository is enabled by default for Maven users.
 
 ```groovy
 dependencies {
-    implementation 'org.jetbrains.exposed:exposed-core:0.57.0'
-    implementation 'org.jetbrains.exposed:exposed-crypt:0.57.0'
-    implementation 'org.jetbrains.exposed:exposed-dao:0.57.0'
-    implementation 'org.jetbrains.exposed:exposed-jdbc:0.57.0'
+    implementation 'org.jetbrains.exposed:exposed-core:0.58.0'
+    implementation 'org.jetbrains.exposed:exposed-crypt:0.58.0'
+    implementation 'org.jetbrains.exposed:exposed-dao:0.58.0'
+    implementation 'org.jetbrains.exposed:exposed-jdbc:0.58.0'
     
-    implementation 'org.jetbrains.exposed:exposed-jodatime:0.57.0'
+    implementation 'org.jetbrains.exposed:exposed-jodatime:0.58.0'
     // or
-    implementation 'org.jetbrains.exposed:exposed-java-time:0.57.0'
+    implementation 'org.jetbrains.exposed:exposed-java-time:0.58.0'
     // or
-    implementation 'org.jetbrains.exposed:exposed-kotlin-datetime:0.57.0'
+    implementation 'org.jetbrains.exposed:exposed-kotlin-datetime:0.58.0'
     
-    implementation 'org.jetbrains.exposed:exposed-json:0.57.0'
-    implementation 'org.jetbrains.exposed:exposed-money:0.57.0'
-    implementation 'org.jetbrains.exposed:exposed-spring-boot-starter:0.57.0'
+    implementation 'org.jetbrains.exposed:exposed-json:0.58.0'
+    implementation 'org.jetbrains.exposed:exposed-money:0.58.0'
+    implementation 'org.jetbrains.exposed:exposed-spring-boot-starter:0.58.0'
 }
 ```
 
@@ -180,7 +180,7 @@ dependencies {
 and in `gradle.properties`
 
 ```
-exposedVersion=0.57.0
+exposedVersion=0.58.0
 ```
 
 ## Samples

build.gradle.kts

@@ -1,4 +1,3 @@
-import org.jetbrains.dokka.gradle.DokkaMultiModuleTask
 import org.jetbrains.exposed.gradle.configureDetekt
 import org.jetbrains.exposed.gradle.configurePublishing
 import org.jetbrains.exposed.gradle.testDb
@@ -12,8 +11,10 @@ plugins {
     alias(libs.plugins.dokka)
 }
 
-tasks.withType<DokkaMultiModuleTask> {
-    outputDirectory.set(project.file("docs/api"))
+dokka {
+    dokkaPublications.html {
+        outputDirectory.set(project.file("docs/api"))
+    }
 }
 
 repositories {

buildScripts/docker/docker-compose-sqlserver.yml

@@ -2,7 +2,7 @@ services:
     sqlserver:
         container_name: SQLServer
         restart: always
-        image: mcr.microsoft.com/azure-sql-edge:1.0.7
+        image: mcr.microsoft.com/azure-sql-edge:2.0.0
         ports:
             - "3005:1433"
         environment:

buildSrc/src/main/kotlin/org/jetbrains/exposed/gradle/Detekt.kt

@@ -10,6 +10,13 @@ fun Project.configureDetekt() {
     apply<DetektPlugin>()
 
     configure<DetektExtension> {
+        source.from(
+            files(
+                "$rootDir/documentation-website/Writerside/snippets",
+                "$rootDir/samples"
+            )
+        )
+
         ignoreFailures = false
         buildUponDefaultConfig = true
         parallel = true

docs/HelpTOC.json

@@ -1 +1 @@
-{"entities":{"pages":{"Home":{"id":"Home","title":"Home","url":"home.html","level":0,"tabIndex":0},"About":{"id":"About","title":"About","url":"about.html","level":0,"tabIndex":1},"Getting-Started-with-Exposed":{"id":"Getting-Started-with-Exposed","title":"Get started with Exposed","url":"getting-started-with-exposed.html","level":0,"tabIndex":2},"Exposed-Modules":{"id":"Exposed-Modules","title":"Modules","url":"exposed-modules.html","level":0,"tabIndex":3},"i4wqvqx_5":{"id":"i4wqvqx_5","title":"Databases","level":0,"pages":["Working-with-Database","Working-with-DataSource","Transactions"],"tabIndex":4},"Working-with-Database":{"id":"Working-with-Database","title":"Working with Databases","url":"working-with-database.html","level":1,"parentId":"i4wqvqx_5","tabIndex":0},"Working-with-DataSource":{"id":"Working-with-DataSource","title":"Working with DataSources","url":"working-with-datasource.html","level":1,"parentId":"i4wqvqx_5","tabIndex":1},"Transactions":{"id":"Transactions","title":"Working with Transactions","url":"transactions.html","level":1,"parentId":"i4wqvqx_5","tabIndex":2},"i4wqvqx_9":{"id":"i4wqvqx_9","title":"Schemas","level":0,"pages":["Working-with-Tables","Data-Types","SQL-Functions","Working-with-Schema"],"tabIndex":5},"Working-with-Tables":{"id":"Working-with-Tables","title":"Working with tables","url":"working-with-tables.html","level":1,"parentId":"i4wqvqx_9","tabIndex":0},"Data-Types":{"id":"Data-Types","title":"Data Types","url":"data-types.html","level":1,"parentId":"i4wqvqx_9","tabIndex":1},"SQL-Functions":{"id":"SQL-Functions","title":"SQL Functions","url":"sql-functions.html","level":1,"parentId":"i4wqvqx_9","tabIndex":2},"Working-with-Schema":{"id":"Working-with-Schema","title":"Working with Schema","url":"working-with-schema.html","level":1,"parentId":"i4wqvqx_9","tabIndex":3},"i4wqvqx_14":{"id":"i4wqvqx_14","title":"Deep Dive into DSL","level":0,"pages":["DSL-Table-Types","DSL-Joining-tables","DSL-CRUD-operations","Working-with-Sequence","DSL-Querying-data"],"tabIndex":6},"DSL-Table-Types":{"id":"DSL-Table-Types","title":"Table types","url":"dsl-table-types.html","level":1,"parentId":"i4wqvqx_14","tabIndex":0},"DSL-Joining-tables":{"id":"DSL-Joining-tables","title":"Joining tables","url":"dsl-joining-tables.html","level":1,"parentId":"i4wqvqx_14","tabIndex":1},"DSL-CRUD-operations":{"id":"DSL-CRUD-operations","title":"CRUD operations","url":"dsl-crud-operations.html","level":1,"parentId":"i4wqvqx_14","tabIndex":2},"Working-with-Sequence":{"id":"Working-with-Sequence","title":"Working with Sequence","url":"working-with-sequence.html","level":1,"parentId":"i4wqvqx_14","tabIndex":3},"DSL-Querying-data":{"id":"DSL-Querying-data","title":"Querying data","url":"dsl-querying-data.html","level":1,"parentId":"i4wqvqx_14","tabIndex":4},"i4wqvqx_20":{"id":"i4wqvqx_20","title":"Deep Dive into DAO","level":0,"pages":["DAO-Table-Types","DAO-Entity-definition","DAO-CRUD-Operations","DAO-Relationships"],"tabIndex":7},"DAO-Table-Types":{"id":"DAO-Table-Types","title":"Table types","url":"dao-table-types.html","level":1,"parentId":"i4wqvqx_20","tabIndex":0},"DAO-Entity-definition":{"id":"DAO-Entity-definition","title":"Entity definition","url":"dao-entity-definition.html","level":1,"parentId":"i4wqvqx_20","tabIndex":1},"DAO-CRUD-Operations":{"id":"DAO-CRUD-Operations","title":"CRUD operations","url":"dao-crud-operations.html","level":1,"parentId":"i4wqvqx_20","tabIndex":2},"DAO-Relationships":{"id":"DAO-Relationships","title":"Relationships","url":"dao-relationships.html","level":1,"parentId":"i4wqvqx_20","tabIndex":3},"i4wqvqx_25":{"id":"i4wqvqx_25","title":"Releases","level":0,"pages":["Breaking-Changes","Migration-Guide"],"tabIndex":8},"Breaking-Changes":{"id":"Breaking-Changes","title":"Breaking Changes","url":"breaking-changes.html","level":1,"parentId":"i4wqvqx_25","tabIndex":0},"Migration-Guide":{"id":"Migration-Guide","title":"Migrating from 0.45.0 to 0.46.0","url":"migration-guide.html","level":1,"parentId":"i4wqvqx_25","tabIndex":1},"Frequently-Asked-Questions":{"id":"Frequently-Asked-Questions","title":"Frequently Asked Questions","url":"frequently-asked-questions.html","level":0,"tabIndex":9},"i4wqvqx_29":{"id":"i4wqvqx_29","title":"Samples","url":"https://github.com/JetBrains/Exposed/tree/main/samples","level":0,"tabIndex":10},"Contributing":{"id":"Contributing","title":"Contributing to Exposed","url":"contributing.html","level":0,"tabIndex":11}}},"topLevelIds":["Home","About","Getting-Started-with-Exposed","Exposed-Modules","i4wqvqx_5","i4wqvqx_9","i4wqvqx_14","i4wqvqx_20","i4wqvqx_25","Frequently-Asked-Questions","i4wqvqx_29","Contributing"]}
+{"entities":{"pages":{"Home":{"id":"Home","title":"Home","url":"home.html","level":0,"tabIndex":0},"About":{"id":"About","title":"About","url":"about.html","level":0,"tabIndex":1},"Getting-Started-with-Exposed":{"id":"Getting-Started-with-Exposed","title":"Get started with Exposed","url":"getting-started-with-exposed.html","level":0,"tabIndex":2},"Exposed-Modules":{"id":"Exposed-Modules","title":"Modules","url":"exposed-modules.html","level":0,"tabIndex":3},"-qb7fbx_5":{"id":"-qb7fbx_5","title":"Databases","level":0,"pages":["Working-with-Database","Working-with-DataSource","Transactions"],"tabIndex":4},"Working-with-Database":{"id":"Working-with-Database","title":"Working with Databases","url":"working-with-database.html","level":1,"parentId":"-qb7fbx_5","tabIndex":0},"Working-with-DataSource":{"id":"Working-with-DataSource","title":"Working with DataSources","url":"working-with-datasource.html","level":1,"parentId":"-qb7fbx_5","tabIndex":1},"Transactions":{"id":"Transactions","title":"Working with Transactions","url":"transactions.html","level":1,"parentId":"-qb7fbx_5","tabIndex":2},"-qb7fbx_9":{"id":"-qb7fbx_9","title":"Schemas","level":0,"pages":["Working-with-Tables","Data-Types","SQL-Functions","Working-with-Schema"],"tabIndex":5},"Working-with-Tables":{"id":"Working-with-Tables","title":"Working with tables","url":"working-with-tables.html","level":1,"parentId":"-qb7fbx_9","tabIndex":0},"Data-Types":{"id":"Data-Types","title":"Data Types","url":"data-types.html","level":1,"parentId":"-qb7fbx_9","tabIndex":1},"SQL-Functions":{"id":"SQL-Functions","title":"SQL Functions","url":"sql-functions.html","level":1,"parentId":"-qb7fbx_9","tabIndex":2},"Working-with-Schema":{"id":"Working-with-Schema","title":"Working with Schema","url":"working-with-schema.html","level":1,"parentId":"-qb7fbx_9","tabIndex":3},"-qb7fbx_14":{"id":"-qb7fbx_14","title":"Deep Dive into DSL","level":0,"pages":["DSL-Table-Types","DSL-Joining-tables","DSL-CRUD-operations","Working-with-Sequence","DSL-Querying-data"],"tabIndex":6},"DSL-Table-Types":{"id":"DSL-Table-Types","title":"Table types","url":"dsl-table-types.html","level":1,"parentId":"-qb7fbx_14","tabIndex":0},"DSL-Joining-tables":{"id":"DSL-Joining-tables","title":"Joining tables","url":"dsl-joining-tables.html","level":1,"parentId":"-qb7fbx_14","tabIndex":1},"DSL-CRUD-operations":{"id":"DSL-CRUD-operations","title":"CRUD operations","url":"dsl-crud-operations.html","level":1,"parentId":"-qb7fbx_14","tabIndex":2},"Working-with-Sequence":{"id":"Working-with-Sequence","title":"Working with Sequence","url":"working-with-sequence.html","level":1,"parentId":"-qb7fbx_14","tabIndex":3},"DSL-Querying-data":{"id":"DSL-Querying-data","title":"Querying data","url":"dsl-querying-data.html","level":1,"parentId":"-qb7fbx_14","tabIndex":4},"-qb7fbx_20":{"id":"-qb7fbx_20","title":"Deep Dive into DAO","level":0,"pages":["DAO-Table-Types","DAO-Entity-definition","DAO-CRUD-Operations","DAO-Relationships"],"tabIndex":7},"DAO-Table-Types":{"id":"DAO-Table-Types","title":"Table types","url":"dao-table-types.html","level":1,"parentId":"-qb7fbx_20","tabIndex":0},"DAO-Entity-definition":{"id":"DAO-Entity-definition","title":"Entity definition","url":"dao-entity-definition.html","level":1,"parentId":"-qb7fbx_20","tabIndex":1},"DAO-CRUD-Operations":{"id":"DAO-CRUD-Operations","title":"CRUD operations","url":"dao-crud-operations.html","level":1,"parentId":"-qb7fbx_20","tabIndex":2},"DAO-Relationships":{"id":"DAO-Relationships","title":"Relationships","url":"dao-relationships.html","level":1,"parentId":"-qb7fbx_20","tabIndex":3},"-qb7fbx_25":{"id":"-qb7fbx_25","title":"Releases","level":0,"pages":["Breaking-Changes","Migration-Guide"],"tabIndex":8},"Breaking-Changes":{"id":"Breaking-Changes","title":"Breaking Changes","url":"breaking-changes.html","level":1,"parentId":"-qb7fbx_25","tabIndex":0},"Migration-Guide":{"id":"Migration-Guide","title":"Migrating from 0.45.0 to 0.46.0","url":"migration-guide.html","level":1,"parentId":"-qb7fbx_25","tabIndex":1},"Frequently-Asked-Questions":{"id":"Frequently-Asked-Questions","title":"Frequently Asked Questions","url":"frequently-asked-questions.html","level":0,"tabIndex":9},"-qb7fbx_29":{"id":"-qb7fbx_29","title":"Samples","url":"https://github.com/JetBrains/Exposed/tree/main/samples","level":0,"tabIndex":10},"Contributing":{"id":"Contributing","title":"Contributing to Exposed","url":"contributing.html","level":0,"tabIndex":11}}},"topLevelIds":["Home","About","Getting-Started-with-Exposed","Exposed-Modules","-qb7fbx_5","-qb7fbx_9","-qb7fbx_14","-qb7fbx_20","-qb7fbx_25","Frequently-Asked-Questions","-qb7fbx_29","Contributing"]}