[TheGuardian] Add Extractor for podcasts

[SirElderling]

IMPORTANT: PRs without the template will be CLOSED

Description of your pull request and other information

The purpose of this extractor is to download The Guardian podcast playlists and single episodes.

Fixes #8520

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 c8f48ae

Summary

🎧📰🐍

Add a new extractor TheGuardianPodcastIE for The Guardian podcast pages in theguardian.py and import it in _extractors.py. This allows yt-dlp to download audio files from The Guardian podcast URLs.

TheGuardianPodcastIE
New extractor for autumn podcasts
Inherits InfoExtractor

Walkthrough

• Add support for The Guardian podcasts (link, link)
  • Import TheGuardianPodcastIE from theguardian.py in _extractors.py (link)
  • Define TheGuardianPodcastIE class in theguardian.py (link)

[SirElderling]

Converted this PR to draft in order to add the playlist extract functionality.

[bashonly]

Might be nice to extract a title without the " | The Guardian" junk at the end. Also use clean_html just in case

Suggested change

	title = self._generic_title(url, webpage, default='')
	description = self._og_search_description(webpage) or get_element_by_class(
	'header__description', webpage)
	title = clean_html(get_element_by_class(
	'index-page-header__title', webpage)) or self._generic_title(url, webpage)
	description = self._og_search_description(webpage) or clean_html(get_element_by_class(
	'header__description', webpage))

[SirElderling]

If the URL given by the user has a page, the webpage title will be something like this: Today in Focus | Page 2 of 66 | News | The Guardian.
Is there a helper function that can be used here to clean the text? Or is it fine to do something like title, _ = title.split('|') ?

[bashonly]

remove_end is the helper typically used for this, but it needs a fixed string to remove; so it wouldn't be useful here

IMO let's try to grab the clean title from one of these elements instead of doing string surgery with the title element

        title = clean_html(get_element_by_class(
            'index-page-header__title', webpage) or get_element_by_class('flagship-audio__title', webpage))

[SirElderling]

I implemented your suggestion bashonly. So far, it seems to pick up all the titles correctly.

[SirElderling]

Thank you @bashonly for all the suggestions provided. The code has been adjusted with them in mind.