[RadioComercial] Add extractor

[SirElderling]

IMPORTANT: PRs without the template will be CLOSED

Description of your pull request and other information

This extractor was created specifically for the Portuguese radio station Radio Comercial.
Its main function is to fetch and download podcast episodes.

Presently, it offers two extract functions:

• Downloading individual podcast episodes by directly using their URL links.
• Downloading all the episodes of a specified season for a particular podcast, utilizing the `playlist concept.

Valid URLs that are covered by this extractor:

• Single episode: https://radiocomercial.pt/podcasts/convenca-me-num-minuto/t3/convenca-me-num-minuto-que-os-lobisomens-existem
• Entire podcast playlist: https://radiocomercial.pt/podcasts/as-minhas-coisas-favoritas
• Playlist specific to a particular season of a podcast: https://radiocomercial.pt/podcasts/convenca-me-num-minuto/t3

Template

Before submitting a pull request make sure you have:

• At least skimmed through contributing guidelines including yt-dlp coding conventions
• Searched the bugtracker for similar pull requests
• Checked the code with flake8 and ran relevant tests

In order to be accepted and merged into yt-dlp each piece of code must be in public domain or released under Unlicense. Check all of the following options that apply:

• I am the original author of this code and I am willing to release it under Unlicense
• I am not the original author of this code but it is in public domain or released under Unlicense (provide reliable evidence)

What is the purpose of your pull request?

• Fix or improvement to an extractor (Make sure to add/update tests)
• New extractor (Piracy websites will not be accepted)
• Core bug fix/improvement
• New feature (It is strongly recommended to open an issue first)

Copilot Summary

🤖 Generated by Copilot at bd9904c

Summary

🎙️📻🎧

This pull request adds two new extractors for yt-dlp, RadioComercialIE and RadioComercialPlaylistIE, which enable downloading audio and playlists from the Portuguese radio station Radio Comercial. It also fixes a minor formatting issue in _extractors.py.

Oh we are the coders of the sea
And we write extractors with glee
We pull the audio from RadioComercial
On the count of three, heave ho, heave ho!

Walkthrough

• Add support for Radio Comercial extractors (link, link)
  • Import new classes RadioComercialIE and RadioComercialPlaylistIE from radiocomercial.py in _extractors.py (link)
  • Define new classes in radiocomercial.py that inherit from RadioComercialBaseExtractor (link)
• Remove an empty line from _extractors.py for formatting consistency (link)

[Grub4K]

Same as #8507 (comment). Please instead edit the description and push additional commits onto the other branch

[SirElderling]

@seproDev thank you very much for taking the time to look into this, and provide those valuable suggestions. I'm working on those and will update the code once complete.

[seproDev]

I think after this, we should be good from my side.

[SirElderling]

I'm currently having an issue extracting playlists from the website because of how it deals with unavailable episodes. At first, I was using a Python set to gather the episode links from the elements with class tm-ouvir-podcast, avoiding the duplicates entries (this class shows up twice for each episode).

The trouble is, any unavailable episode defaults to the same URL (like radiocomercial/podcast/<season>). This behaviour can be seen in test number 4 of the RadioComercialPlaylistIE class, in which two episodes are unavailable on the same page (first).

This situation leads to two problems:

Problem 1: When I was using a Python set and more than one episode was missing, I ended up with fewer episodes than the expected number (_PAGE_SIZE). This stopped the scanning of additional pages.
To fix this, I changed the code to get rid of the duplicate tm-ouvir-podcast classes. Now, I use lists instead of sets, ensuring the episode count always matches the _PAGE_SIZE, by keeping the unavailable episodes entries.

Problem 2: The unavailable episodes cause an error when the downloader tries to process them.:

[RadioComercialPlaylist] Playlist TNT - Todos No Top - Temporada 2023: Downloading 41 items of 41
[download] Downloading item 1 of 41
[RadioComercial] Extracting URL: https://radiocomercial.pt/podcasts/tnt-todos-no-top/2023/t-n-t-29-de-outubro
[RadioComercial] t-n-t-29-de-outubro: Downloading webpage
[info] t-n-t-29-de-outubro: Downloading 1 format(s): 0
[download] Destination: T.N.T 29 de outubro [t-n-t-29-de-outubro].mp3
[download] 100% of   86.69MiB in 00:00:13 at 6.62MiB/s
[download] Downloading item 2 of 41
ERROR: No suitable extractor (RadioComercial) found for URL https://radiocomercial.pt/podcasts/tnt-todos-no-top/2023/
[download] Downloading item 3 of 41
[RadioComercial] Extracting URL: https://radiocomercial.pt/podcasts/tnt-todos-no-top/2023/t-n-t-15-de-outubro
[RadioComercial] t-n-t-15-de-outubro: Downloading webpage`

[bashonly]

Both of the problems you mentioned mean that a PagedList is not a viable option for this playlist extractor.

Instead we'll need to just use a generator function (e.g. _entries()), and we can use playlist_from_matches() which casts the URLs to an orderedSet and then constructs the url_results for us. We can also use RadioComercialIE.suitable() to ensure the URLs are not bogus

[seproDev]

I think I initially suggested using a PagedList over a generator function 🙃
Sorry about that

[bashonly]

@seproDev all good, the issues with using a PagedList weren't immediately apparent

[SirElderling]

Both of the problems you mentioned mean that a PagedList is not a viable option for this playlist extractor.

Instead we'll need to just use a generator function (e.g. _entries()), and we can use playlist_from_matches() which casts the URLs to an orderedSet and then constructs the url_results for us. We can also use RadioComercialIE.suitable() to ensure the URLs are not bogus

Thank you very much for taking the time and providing the proper solution for this use case. This has been a great learning experience so far.

[bashonly]

Read #8535 (comment)
Here I have the same question:

Suggested change

	_VALID_URL = r'https?://(?:www\.)?radiocomercial\.pt/podcasts/[^/?#]+/t?(?P<season>\d+)/(?P<id>[\w-]+)/?(?:$|[?#])'
	_VALID_URL = r'https?://(?:www\.)?radiocomercial\.pt/podcasts/[^/?#]+/t?(?P<season>\d+)/(?P<id>[\w-]+)'

It's needed in RadioComercialPlaylistIE._VALID_URL, but I don't think we need it here? Unless I'm missing something

[SirElderling]

I believe you are correct bashonly. I removed it from the single episode regex.