Merge branch 'main' into renovate/protobuf

# Conflicts:
#	gradle/libs.versions.toml

Author: ashtanko

README.md

@@ -22,21 +22,21 @@
 
 ### Metrics
 ```text
-14882 number of properties
-10261 number of functions
-8796 number of classes
-226 number of packages
-3460 number of kt files
+14883 number of properties
+10262 number of functions
+8797 number of classes
+227 number of packages
+3461 number of kt files
 ```
 
 
 ### Complexity Report
 ```text
-257825 lines of code (loc)
-157796 source lines of code (sloc)
-115146 logical lines of code (lloc)
+257847 lines of code (loc)
+157813 source lines of code (sloc)
+115157 logical lines of code (lloc)
 72253 comment lines of code (cloc)
-24538 cyclomatic complexity (mcc)
+24539 cyclomatic complexity (mcc)
 20171 cognitive complexity
 0 number of total code smells
 45 comment source ratio

build.gradle.kts

@@ -330,10 +330,10 @@ dependencies {
         implementation("org.openjdk.jol:jol-core:0.17")
         implementation("com.jakewharton.retrofit:retrofit2-kotlinx-serialization-converter:1.0.0")
         implementation(jsoup)
-        implementation("com.google.protobuf:protobuf-java:3.19.1")
-        implementation("com.google.protobuf:protobuf-kotlin-lite:3.19.6")
-        implementation("io.grpc:grpc-stub:1.15.1")
-        implementation("io.grpc:grpc-protobuf:1.15.1")
+        implementation("com.google.protobuf:protobuf-java:4.30.0")
+        implementation("com.google.protobuf:protobuf-kotlin-lite:4.30.0")
+        implementation("io.grpc:grpc-stub:1.71.0")
+        implementation("io.grpc:grpc-protobuf:1.71.0")
 
 
         testImplementation(mockk)

gradle/libs.versions.toml

@@ -9,7 +9,7 @@ dependency = "1.33.0"       # https://github.com/autonomousapps/dependency-analy
 pitest = "1.15.0"           # https://plugins.gradle.org/plugin/info.solidsoft.pitest
 ktlint = "12.2.0"           # https://github.com/JLLeitschuh/ktlint-gradle
 kapt = "2.1.0"              # https://kotlinlang.org/docs/kapt.html
-slf4j = "1.7.36"            # https://www.slf4j.org TODO remove
+slf4j = "2.0.17"            # https://www.slf4j.org TODO remove
 rxjava = "3.1.10"            # https://github.com/ReactiveX/RxJava TODO remove
 rxkotlin = "3.0.1"          # https://github.com/ReactiveX/RxKotlin TODO remove
 lincheck = "2.36"           # https://github.com/JetBrains/lincheck
@@ -21,19 +21,19 @@ jmh = "1.37"                # https://github.com/openjdk/jmh
 kotlintest = "3.4.2"        # https://mvnrepository.com/artifact/io.kotlintest/kotlintest-core
 kotest = "5.9.1"            # https://kotest.io
 assertj = "3.27.3"          # https://mvnrepository.com/artifact/org.assertj/assertj-core | https://assertj.github.io/doc
-mockito = "5.15.2"          # https://mvnrepository.com/artifact/org.mockito/mockito-core
+mockito = "5.16.0"          # https://mvnrepository.com/artifact/org.mockito/mockito-core
 mockito_kotlin = "5.4.0"    # https://github.com/mockito/mockito-kotlin
 logback = "1.5.17"          # https://logback.qos.ch
 hamcrest = "3.0"            # https://hamcrest.org/JavaHamcrest/distributables
-mockk = "1.13.16"           # https://mockk.io
+mockk = "1.13.17"           # https://mockk.io
 kover = "0.9.1"             # https://github.com/Kotlin/kotlinx-kover
 diktat = "2.0.0"            # https://github.com/saveourtool/diktat
 jsoup = "1.19.1"            # https://jsoup.org/
 turbine = "1.2.0"           # https://github.com/cashapp/turbine/releases
 truth = "1.4.4"             # https://central.sonatype.com/artifact/com.google.truth/truth/overview
 sandwich = "2.1.0"          # https://github.com/skydoves/sandwich
 protobuf = "0.9.4"
-protoc = "3.19.1"
+protoc = "4.30.0"
 
 [libraries]
 kotlin-coroutines = { module = "org.jetbrains.kotlinx:kotlinx-coroutines-jdk8", version.ref = "coroutines" }

src/test/kotlin/dev/shtanko/TESTING_FRAMEWORKS.md

@@ -0,0 +1,51 @@
+# Kotlin Testing Frameworks
+
+## ✅ Unit Testing & JVM Testing
+### 1. JUnit 5 (Jupiter) - Standard JVM Testing
+- Best for unit and integration tests.
+- Supports annotations like `@Test`, `@BeforeEach`, `@AfterEach`.
+- Works well with Kotest, Mockito, and Spring.
+
+### 2. Kotest (formerly KotlinTest) - Kotlin-native Testing
+- Supports property-based testing, matchers, and coroutines.
+- DSL-style syntax for expressive tests.
+
+### 3. Spek - Specification-based Testing
+Inspired by RSpec (from Ruby).
+
+## ✅ Mocking Libraries
+### 4. Mockito & MockK - Mocking Frameworks
+- Mockito: Java-based, integrates with JUnit 5.
+- MockK: Kotlin-native, better for coroutines and DSL-friendly.
+
+## ✅ Android UI & Instrumentation Testing
+### 5. Espresso - UI Testing for Android
+
+### 6. UIAutomator - System UI Testing
+Used for interactions beyond the app (e.g., system UI, notifications).
+### 7. Compose Testing - Jetpack Compose UI Testing
+
+## ✅ Benchmarking & Performance Testing
+### 8. JMH (Java Microbenchmark Harness) - Benchmark Kotlin Code
+Best for measuring performance of functions and loops.
+Requires annotation processing (kapt).
+
+### 9. Android Benchmark (Jetpack)
+Measures Android performance in native/kotlin code.
+Supports BenchmarkRule and Perfetto.
+
+## ✅Turbine
+Works with kotlinx.coroutines.Flow for testing emissions.
+Eliminates the need for complex collect() calls in tests.
+Supports structured assertions like awaitItem(), expectNoEvents(), and awaitComplete().
+
+### ✅ Turbine vs Standard Flow Testing
+
+| Feature                          | Standard Flow (`collect`) | Turbine |
+|----------------------------------|-----------------|---------|
+| Requires manual `collect()`      | ✅ Yes          | ❌ No  |
+| Assertions are simple            | ❌ No           | ✅ Yes  |
+| Supports awaiting specific items | ❌ No           | ✅ Yes (`awaitItem()`) |
+| Checks for no events             | ❌ No           | ✅ Yes (`expectNoEvents()`) |
+| Supports Flow cancellation       | ❌ No           | ✅ Yes (`cancelAndIgnoreRemainingEvents()`) |
+| Handles delays in Flows          | ❌ No           | ✅ Yes |

src/test/kotlin/dev/shtanko/proto/SearchRequestTest.kt

@@ -0,0 +1,21 @@
+package dev.shtanko.proto
+
+import SearchRequestOuterClass.SearchRequest
+import org.junit.jupiter.api.Assertions.assertEquals
+import org.junit.jupiter.api.Test
+
+class SearchRequestTest {
+
+    @Test
+    fun testSearchRequest() {
+        val searchRequest = SearchRequest.newBuilder()
+            .setQuery("example query")
+            .setPageNumber(1)
+            .setResultPerPage(10)
+            .build()
+
+        assertEquals("example query", searchRequest.query)
+        assertEquals(1, searchRequest.pageNumber)
+        assertEquals(10, searchRequest.resultPerPage)
+    }
+}