Merge branch 'dev' into Refactor-Optional

# Conflicts:
#	extractor/src/main/java/org/schabi/newpipe/extractor/services/youtube/YoutubeMetaInfoHelper.java
#	extractor/src/main/java/org/schabi/newpipe/extractor/services/youtube/YoutubeParsingHelper.java
#	extractor/src/main/java/org/schabi/newpipe/extractor/services/youtube/extractors/YoutubeStreamExtractor.java
#	extractor/src/main/java/org/schabi/newpipe/extractor/services/youtube/extractors/YoutubeStreamInfoItemExtractor.java

Author: Isira-Seneviratne

.github/workflows/ci.yml

@@ -25,23 +25,23 @@ jobs:
   build-and-test:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
 
-      - name: set up JDK 11
+      - name: set up JDK
         uses: actions/setup-java@v5
         with:
-          java-version: '11'
+          java-version: 21
           distribution: 'temurin'
 
       - name: Cache Gradle wrapper dists
-        uses: actions/cache@v4
+        uses: actions/cache@v5
         with:
           path: ~/.gradle/wrapper/dists
           key: ${{ runner.os }}-gradle-wrapper-dists-${{ hashFiles('gradle/wrapper/**') }}
           restore-keys: ${{ runner.os }}-gradle-wrapper-dists
 
       - name: Cache Gradle dependencies
-        uses: actions/cache@v4
+        uses: actions/cache@v5
         with:
           path: ~/.gradle/caches
           key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle') }}
@@ -63,7 +63,7 @@ jobs:
             -Dcom.google.protobuf.error_on_unsafe_pre22_gencode
 
       - name: Upload test reports when failure occurs
-        uses: actions/upload-artifact@v5
+        uses: actions/upload-artifact@v7
         if: failure()
         with:
           name: NewPipeExtractor-test-reports

.github/workflows/docs.yml

@@ -13,16 +13,16 @@ jobs:
   build-and-deploy-docs:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
 
-      - name: set up JDK 11
+      - name: set up JDK
         uses: actions/setup-java@v5
         with:
-          java-version: '11'
+          java-version: 21
           distribution: 'temurin'
 
       - name: Cache Gradle dependencies
-        uses: actions/cache@v4
+        uses: actions/cache@v5
         with:
           path: ~/.gradle/caches
           key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle') }}

.github/workflows/snapshot.yml

@@ -0,0 +1,40 @@
+name: Publish snapshot
+
+on:
+  push:
+    branches:
+      - dev
+  workflow_dispatch:
+
+jobs:
+  build-and-deploy-docs:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: set up JDK
+        uses: actions/setup-java@v5
+        with:
+          java-version: 21
+          distribution: 'temurin'
+
+      - name: Cache Gradle dependencies
+        uses: actions/cache@v5
+        with:
+          path: ~/.gradle/caches
+          key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle') }}
+          restore-keys: ${{ runner.os }}-gradle
+
+      - name: Publish snapshot
+        env:
+          PGP_PRIVATE_SIGNING_KEY: ${{ secrets.PGP_PRIVATE_SIGNING_KEY }}
+          PGP_PRIVATE_SIGNING_KEY_PASSWORD: ${{ secrets.PGP_PRIVATE_SIGNING_KEY_PASSWORD }}
+          SONATYPE_MAVEN_CENTRAL_USERNAME: ${{ secrets.SONATYPE_MAVEN_CENTRAL_USERNAME }}
+          SONATYPE_MAVEN_CENTRAL_PASSWORD: ${{ secrets.SONATYPE_MAVEN_CENTRAL_PASSWORD }}
+        run: ./gradlew publishSnapshotPublicationToSonatypeRepository
+
+      - name: Upload metadata
+        uses: actions/upload-artifact@v7
+        with:
+          name: NewPipeExtractor-Snapshot
+          path: extractor/build/publications/snapshot/**

README.md

@@ -25,6 +25,24 @@ If you're using Gradle, you could add NewPipe Extractor as a dependency with the
 
 ### Testing changes
 
+#### Maven Central
+
+NewPipe Extractor's snapshots are available on Maven Central's snapshot repository. These versions
+are based on the commit's short hash (for e.g. `git rev-parse --short HEAD`) and are available for
+90 days since the date of publication/commit.
+
+```kotlin
+repositories {
+    maven(url = "https://central.sonatype.com/repository/maven-snapshots/")
+}
+
+dependencies {
+    implementation("net.newpipe:extractor:${LAST_COMMIT_SHORT_HASH}-SNAPSHOT")
+}
+```
+
+#### Local
+
 To test changes quickly you can build the library locally. A good approach would be to add something like the following to your `settings.gradle`:
 
 ```groovy

build.gradle

@@ -0,0 +1,64 @@
+/*
+ * SPDX-FileCopyrightText: 2025 NewPipe e.V. <https://newpipe-ev.de>
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ */
+
+plugins {
+    alias(libs.plugins.google.protobuf) apply false
+}
+
+allprojects {
+    apply(plugin = "java-library")
+
+    version = "v0.26.1"
+
+    tasks.withType<JavaCompile> {
+        options.encoding = Charsets.UTF_8.toString()
+    }
+
+    extensions.configure<JavaPluginExtension> {
+        toolchain {
+            languageVersion.set(JavaLanguageVersion.of(11))
+        }
+    }
+}
+
+subprojects {
+    // https://discuss.gradle.org/t/best-approach-gradle-multi-module-project-generate-just-one-global-javadoc/18657/21
+    // Fixes unknown tag @implNote; the other two were added precautionary
+    tasks.withType<Javadoc>().configureEach {
+        (options as StandardJavadocDocletOptions).apply {
+            encoding = Charsets.UTF_8.toString()
+            links = listOf("https://docs.oracle.com/javase/11/docs/api/")
+            tags = listOf(
+                "apiNote:a:API Note:",
+                "implSpec:a:Implementation Requirements:",
+                "implNote:a:Implementation Note:"
+            )
+        }
+    }
+}
+
+tasks.register<Javadoc>("aggregatedJavadocs") {
+    group = "documentation"
+    description = "Generates aggregated Javadocs for all subprojects."
+    (options as StandardJavadocDocletOptions).apply {
+        encoding = Charsets.UTF_8.toString()
+        links = listOf("https://docs.oracle.com/javase/11/docs/api/")
+        title = "NewPipe Extractor ${rootProject.version}"
+        tags = listOf(
+            "apiNote:a:API Note:",
+            "implSpec:a:Implementation Requirements:",
+            "implNote:a:Implementation Note:"
+        )
+    }
+
+    dependsOn(subprojects.map { it.tasks.named("classes") })
+
+    subprojects.forEach { proj ->
+        proj.extensions.findByType(JavaPluginExtension::class.java)?.sourceSets?.getByName("main")?.let { main ->
+            source(main.allJava)
+            classpath += main.output + proj.configurations.getByName("compileClasspath")
+        }
+    }
+}