Update libraries and improve code

Author: mahozad

.github/workflows/main.yml

@@ -14,13 +14,13 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout the main branch
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
       # Refer to https://stackoverflow.com/a/69116750 for running Kotlin scripts
       - name: Use a specific Kotlin version
         uses: fwilhe2/setup-kotlin@main
         with:
-          version: 1.7.10
+          version: 2.1.0
 
       - name: Check if there is a new release
         id: check-for-updates
@@ -66,7 +66,7 @@ jobs:
 
       # See https://github.community/t/how-to-commit-to-two-branches-from-an-action/17713
       - name: Checkout the website branch
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         if: ${{ steps.check-for-updates.outputs.result == 'stale' }}
         with:
           ref: website

scripts/check-for-updates.main.kts

@@ -5,27 +5,29 @@
 @file:Repository("https://repo.maven.apache.org/maven2")
 @file:Repository("https://jcenter.bintray.com")
 @file:Repository("https://jitpack.io")
-@file:DependsOn("com.rometools:rome:1.16.0")
+@file:DependsOn("com.rometools:rome:2.1.0")
 
 // NOTE: See https://youtrack.jetbrains.com/issue/KT-42101
+// NOTE that currently, IntelliJ code features break when importing external scripts.
 @file:Import("retry.main.kts")
 
 import com.rometools.rome.io.SyndFeedInput
 import com.rometools.rome.io.XmlReader
-import java.io.File
-import java.net.URL
+import java.net.URI
 import java.time.LocalDateTime
 import java.time.format.DateTimeFormatter
-import java.time.format.DateTimeFormatter.ISO_LOCAL_TIME
+import kotlin.io.path.Path
+import kotlin.io.path.appendText
+import kotlin.io.path.readText
 
 val datesPattern = DateTimeFormatter.ofPattern("EEE LLL dd HH:mm:ss z yyyy")
-val feedUrl = URL("https://developer.android.com/feeds/androidx-release-notes.xml")
+val feedUrl = URI("https://developer.android.com/feeds/androidx-release-notes.xml").toURL()
 val reader = tryTo("initialize the feed reader") { XmlReader(feedUrl) }
-val file = File("last-rss-update.txt")
+val file = Path("last-rss-update.txt")
 val feed = SyndFeedInput().build(reader)
-val ours = file.readText().trimEnd().parse()
+val ours = file.readText().trimEnd().parseAsLocalDateTime()
 val ourDate = ours.toLocalDate().toString()
-val theirs = feed.publishedDate.toString().parse()
+val theirs = feed.publishedDate.toString().parseAsLocalDateTime()
 val theirDate = theirs.toLocalDate().toString()
 val theirTime = theirs.toLocalTime().format(DateTimeFormatter.ofPattern("hha"))
 val areTheSame = ours == theirs
@@ -43,10 +45,11 @@ println("Their RSS publish date: $theirs")
 // To set output for a job step
 // see https://docs.github.com/en/actions/learn-github-actions/workflow-commands-for-github-actions#setting-an-output-parameter
 // and https://stackoverflow.com/a/59201610
-val stepsOutputFile = File(System.getenv("GITHUB_OUTPUT"))
+val stepsOutputFile = Path(System.getenv("GITHUB_OUTPUT"))
 val lineFeed: String = System.lineSeparator()
 stepsOutputFile.appendText("result=$freshness$lineFeed")
 stepsOutputFile.appendText("dateTag=$dateTag$lineFeed")
 
-fun String.parse() = runCatching { LocalDateTime.parse(this, datesPattern) }
+fun String.parseAsLocalDateTime() =
+    runCatching { LocalDateTime.parse(this, datesPattern) }
     .getOrDefault(LocalDateTime.of(1, 1, 1, 1, 1))

scripts/create-new-release-notes.main.kts

@@ -5,25 +5,27 @@
 @file:Repository("https://repo.maven.apache.org/maven2")
 @file:Repository("https://jcenter.bintray.com")
 @file:Repository("https://jitpack.io")
-@file:DependsOn("com.rometools:rome:1.16.0")
-@file:DependsOn("org.jsoup:jsoup:1.15.1")
+@file:DependsOn("com.rometools:rome:2.1.0")
+@file:DependsOn("org.jsoup:jsoup:1.18.3")
 
 import com.rometools.rome.io.SyndFeedInput
 import com.rometools.rome.io.XmlReader
 import org.jsoup.Jsoup
 import org.jsoup.nodes.Document
 import org.jsoup.nodes.Element
-import java.io.File
-import java.net.URL
+import java.net.URI
+import kotlin.io.path.Path
+import kotlin.io.path.bufferedWriter
+import kotlin.io.path.writeText
 import kotlin.time.Duration.Companion.seconds
 
-val resultFile = File("release-notes.html")
+val resultFile = Path("release-notes.html")
 val waitTime = 10.seconds
-val feedUrl = URL("https://developer.android.com/feeds/androidx-release-notes.xml")
+val feedUrl = URI("https://developer.android.com/feeds/androidx-release-notes.xml").toURL()
 val writer = resultFile.bufferedWriter()
 val reader = tryTo("initialize the feed reader") {
     // NOTE: Use this to test for a complicated release notes
-    //  XmlReader(File("test-feed-result.xml"))
+    // XmlReader(File("test-feed-result.xml"))
     XmlReader(feedUrl)
 }
 val feed = SyndFeedInput().build(reader)
@@ -47,7 +49,7 @@ Jsoup
 
 // Creates a raw text version as well in case someone needs it
 val text = Jsoup.parse(resultFile).wholeText()
-File("release-notes.txt").writeText(text)
+Path("release-notes.txt").writeText(text)
 
 // TODO: Duplicate; use the retry.main.kts script.
 //  See other scripts for example usage.
@@ -125,12 +127,20 @@ fun Document.extractChangelog(id: String) = this
     .takeWhile { it.`is`(":not(h3)") }
     .joinToString("\n")
 
+
+
+/* -------------------------------------------------------------------------- */
+/* -------------------------------------------------------------------------- */
 /* -------------------------------------------------------------------------- */
+/* -------------------------------------------------------------------------- */
+/* -------------------------------------------------------------------------- */
+
+
 
 // This is a coroutine version of the code.
-// Needs `org.jetbrains.kotlinx:kotlinx-coroutines-core`
+// Needs @file:DependsOn("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.10.1")
 // which seems to not work in Kotlin scripts.
-// Probably fixed in Kotlin 1.7
+// Probably fixed in Kotlin 1.7 or newer
 /*
 fun main() = runBlocking {
     val init = async(Dispatchers.IO) {

scripts/retry.main.kts

@@ -2,8 +2,6 @@
 
 @file:JvmName("Retry")
 @file:CompilerOptions("-jvm-target", "11")
-@file:CompilerOptions("-Xopt-in", "kotlin.RequiresOptIn")
-@file:OptIn(kotlin.time.ExperimentalTime::class)
 
 import kotlin.time.Duration.Companion.seconds
 

scripts/set-rss-last-update.main.kts

@@ -5,19 +5,21 @@
 @file:Repository("https://repo.maven.apache.org/maven2")
 @file:Repository("https://jcenter.bintray.com")
 @file:Repository("https://jitpack.io")
-@file:DependsOn("com.rometools:rome:1.16.0")
+@file:DependsOn("com.rometools:rome:2.1.0")
 
 // NOTE: See https://youtrack.jetbrains.com/issue/KT-42101
+// NOTE that currently, IntelliJ code features break when importing external scripts.
 @file:Import("retry.main.kts")
 
 import com.rometools.rome.io.SyndFeedInput
 import com.rometools.rome.io.XmlReader
-import java.io.File
-import java.net.URL
+import java.net.URI
+import kotlin.io.path.Path
+import kotlin.io.path.writeText
 
-val feedUrl = URL("https://developer.android.com/feeds/androidx-release-notes.xml")
+val feedUrl = URI("https://developer.android.com/feeds/androidx-release-notes.xml").toURL()
 val reader = tryTo("initialize the feed reader") { XmlReader(feedUrl) }
 val feed = SyndFeedInput().build(reader)
 val date = feed.publishedDate.toString()
-File("last-rss-update.txt").writeText("$date\n")
+Path("last-rss-update.txt").writeText("$date\n")
 reader.close()