PowerShell/docs/list-news.md
2024-01-03 12:11:22 +01:00

104 lines
2.8 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

*list-news.ps1*
================
This PowerShell script lists the latest news by using a RSS (Really Simple Syndication) feed.
Parameters
----------
```powershell
PS> ./list-news.ps1 [[-RSS_URL] <String>] [[-maxLines] <Int32>] [[-speed] <Int32>] [<CommonParameters>]
-RSS_URL <String>
Specifies the URL to the RSS feed (Yahoo World News by default)
Required? false
Position? 1
Default value https://news.yahoo.com/rss/world
Accept pipeline input? false
Accept wildcard characters? false
-maxLines <Int32>
Specifies the maximum number of lines to list (24 by default)
Required? false
Position? 2
Default value 24
Accept pipeline input? false
Accept wildcard characters? false
-speed <Int32>
Specifies the speed to write the text (10 ms by default)
Required? false
Position? 3
Default value 10
Accept pipeline input? false
Accept wildcard characters? false
[<CommonParameters>]
This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction,
WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
```
Example
-------
```powershell
PS> ./list-news.ps1
Deadly Mediterranean wildfires kill more than 40
...
```
Notes
-----
Author: Markus Fleschutz | License: CC0
Related Links
-------------
https://github.com/fleschutz/PowerShell
Script Content
--------------
```powershell
<#
.SYNOPSIS
Lists the latest news
.DESCRIPTION
This PowerShell script lists the latest news by using a RSS (Really Simple Syndication) feed.
.PARAMETER RSS_URL
Specifies the URL to the RSS feed (Yahoo World News by default)
.PARAMETER maxLines
Specifies the maximum number of lines to list (24 by default)
.PARAMETER speed
Specifies the speed to write the text (10 ms by default)
.EXAMPLE
PS> ./list-news.ps1
❇️ Deadly Mediterranean wildfires kill more than 40
...
.LINK
https://github.com/fleschutz/PowerShell
.NOTES
Author: Markus Fleschutz | License: CC0
#>
param([string]$RSS_URL = "https://news.yahoo.com/rss/world", [int]$maxLines = 24, [int]$speed = 10)
try {
[xml]$content = (Invoke-WebRequest -URI $RSS_URL -useBasicParsing).Content
[int]$count = 1
foreach ($item in $content.rss.channel.item) {
& "$PSScriptRoot/write-typewriter.ps1" "❇️ $($item.title)" $speed
if ($count++ -eq $maxLines) { break }
}
$source = $content.rss.channel.title
$date = $content.rss.channel.pubDate
" (by $source as of $date)"
exit 0 # success
} catch {
"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
exit 1
}
```
*(generated by convert-ps2md.ps1 using the comment-based help of list-news.ps1 as of 01/03/2024 12:10:48)*