feat: Ajouter un scraper pour Play SRF.

Author: regseb

README.md

@@ -31,7 +31,8 @@ de diffuser des vidéos et des musiques sur **Kodi** :
   - Islande : Útvarp Saga ;
   - Pays-Bas : Dumpert ;
   - Royaume-Uni : Daily Mail, The Guardian ;
-  - Russie : Первый канал.
+  - Russie : Первый канал ;
+  - Suisse : Play SRF.
 
 Cast Kodi analyse aussi les pages pour y trouver des vidéos, de la musique ou
 des intégrations de plateformes externes. Par exemple, si une page affiche une

locales/en/description.tpl

@@ -18,6 +18,7 @@ Cast Kodi, as the name suggests, adds the ability to cast videos and music
       <li>Iran: آپارات;</li>
       <li>Netherlands: Dumpert;</li>
       <li>Russia: Первый&nbsp;канал;</li>
+      <li>Switzerland: Play SRF;</li>
       <li>United Kingdom: Daily&nbsp;Mail, The&nbsp;Guardian;</li>
       <li>USA: KCAA&nbsp;Radio.</li>
     </ul>

locales/fr/description.tpl

@@ -19,7 +19,8 @@ Cast&nbsp;Kodi permet de diffuser des vidéos et des musiques sur <strong>Kodi</
       <li>Islande&nbsp;: Útvarp&nbsp;Saga&nbsp;;</li>
       <li>Pays-Bas&nbsp;: Dumpert&nbsp;;</li>
       <li>Royaume-Uni&nbsp;: Daily&nbsp;Mail, The&nbsp;Guardian&nbsp;;</li>
-      <li>Russie&nbsp;: Первый&nbsp;канал.</li>
+      <li>Russie&nbsp;: Первый&nbsp;канал&nbsp;;</li>
+      <li>Suisse&nbsp;: Play&nbsp;SRF.</li>
     </ul>
   </li>
 </ul>

locales/sk/description.tpl

@@ -19,6 +19,7 @@ Cast&nbsp;Kodi, pridá možnosť posielania videí a hudby do <strong>Kodi</stro
       <li>Nemecko: ARD&nbsp;Mediathek, Arte, ZDF;</li>
       <li>Rusko: Первый&nbsp;канал;</li>
       <li>Spojené kráľovstvo: Daily&nbsp;Mail, The&nbsp;Guardian;</li>
+      <li>Švajčiarsko: Play&nbsp;SRF;</li>
       <li>USA: KCAA&nbsp;Radio.</li>
     </ul>
   </li>

src/core/scraper/srf.js

@@ -0,0 +1,33 @@
+/**
+ * @module
+ */
+/* eslint-disable require-await */
+
+import { matchPattern } from "../tools/matchpattern.js";
+
+/**
+ * L'URL de l'API de Play SRF pour obtenir des informations sur la vidéo.
+ *
+ * @type {string}
+ */
+const API_URL = "https://il.srgssr.ch/integrationlayer/2.0/mediaComposition" +
+                                                                      "/byUrn/";
+
+/**
+ * Extrait les informations nécessaire pour lire une vidéo sur Kodi.
+ *
+ * @param {URL} url L'URL d'une vidéo de Play SRF.
+ * @returns {Promise<?string>} Une promesse contenant le lien du
+ *                             <em>fichier</em> ou <code>null</code>.
+ */
+const action = async function ({ searchParams }) {
+    if (!searchParams.has("urn")) {
+        return null;
+    }
+
+    const response = await fetch(API_URL + searchParams.get("urn"));
+    const json = await response.json();
+    return json.chapterList?.[0].resourceList[0].analyticsMetadata.media_url ??
+                                                                           null;
+};
+export const extract = matchPattern(action, "*://www.srf.ch/play/tv/*");

src/core/scrapers.js

@@ -47,6 +47,7 @@ import * as pokemontv from "./scraper/pokemontv.js";
 import * as radio from "./scraper/radio.js";
 import * as radioline from "./scraper/radioline.js";
 import * as soundcloud from "./scraper/soundcloud.js";
+import * as srf from "./scraper/srf.js";
 // eslint-disable-next-line import/no-cycle
 import * as stargr from "./scraper/stargr.js";
 import * as steam from "./scraper/steam.js";
@@ -108,6 +109,7 @@ const SCRAPERS = [
     radio,
     radioline,
     soundcloud,
+    srf,
     stargr,
     steam,
     tiktok,

test/integration/scraper/srf.js

@@ -0,0 +1,34 @@
+import assert from "node:assert";
+import { extract } from "../../../src/core/scrapers.js";
+
+describe("Scraper: Play SRF", function () {
+    it("should return URL when it's not a video", async function () {
+        const url = new URL("https://www.srf.ch/hilfe/kontakt" +
+                                                "?srg_shorturl_source=kontakt");
+        const options = { depth: false, incognito: false };
+
+        const file = await extract(url, options);
+        assert.strictEqual(file, url.href);
+    });
+
+    it("should return URL when urn is invalid", async function () {
+        const url = new URL("https://www.srf.ch/play/tv/foo/video/bar" +
+                     "?urn=urn:srf:video:d5cb6b79-cc9f-4e29-82fb-64e8283f02e2");
+        const options = { depth: false, incognito: false };
+
+        const file = await extract(url, options);
+        assert.strictEqual(file, url.href);
+    });
+
+    it("should return video URL", async function () {
+        const url = new URL("https://www.srf.ch/play/tv/mona-mittendrin/video" +
+                                          "/bei-spitzenkoechin-tanja-grandits" +
+                     "?urn=urn:srf:video:05fe9231-6f59-46e1-bcd1-82c3d30f9ccd");
+        const options = { depth: false, incognito: false };
+
+        const file = await extract(url, options);
+        assert.ok(null !== file &&
+                                new URL(file).pathname.endsWith("/master.m3u8"),
+                  `new URL("${file}").pathname.endsWith(...) from ${url}`);
+    });
+});

test/unit/core/scraper/srf.js

@@ -0,0 +1,64 @@
+import assert from "node:assert";
+import sinon from "sinon";
+import * as scraper from "../../../../src/core/scraper/srf.js";
+
+describe("core/scraper/srf.js", function () {
+    describe("extract()", function () {
+        it("should return null when it's a unsupported URL", async function () {
+            const url = new URL("https://www.srf.ch/foo");
+
+            const file = await scraper.extract(url);
+            assert.strictEqual(file, null);
+        });
+
+        it("should return null when there isn't urn", async function () {
+            const url = new URL("https://www.srf.ch/play/tv/foo");
+
+            const file = await scraper.extract(url);
+            assert.strictEqual(file, null);
+        });
+
+        it("should return null when urn is invalid", async function () {
+            const stub = sinon.stub(globalThis, "fetch").resolves(new Response(
+                JSON.stringify({ status: "foo" }),
+            ));
+
+            const url = new URL("https://www.srf.ch/play/tv/bar?urn=baz");
+
+            const file = await scraper.extract(url);
+            assert.strictEqual(file, null);
+
+            assert.strictEqual(stub.callCount, 1);
+            assert.deepStrictEqual(stub.firstCall.args, [
+                "https://il.srgssr.ch/integrationlayer/2.0/mediaComposition" +
+                                                                   "/byUrn/baz",
+            ]);
+        });
+
+        it("should return video URL", async function () {
+            const stub = sinon.stub(globalThis, "fetch").resolves(new Response(
+                JSON.stringify({
+                    chapterList: [{
+                        resourceList: [{
+                            analyticsMetadata: {
+                                // eslint-disable-next-line camelcase
+                                media_url: "http://foo.ch/bar.m3u8",
+                            },
+                        }],
+                    }],
+                }),
+            ));
+
+            const url = new URL("https://www.srf.ch/play/tv/bar?urn=baz");
+
+            const file = await scraper.extract(url);
+            assert.strictEqual(file, "http://foo.ch/bar.m3u8");
+
+            assert.strictEqual(stub.callCount, 1);
+            assert.deepStrictEqual(stub.firstCall.args, [
+                "https://il.srgssr.ch/integrationlayer/2.0/mediaComposition" +
+                                                                   "/byUrn/baz",
+            ]);
+        });
+    });
+});