Functions/Get-HMPLJS.ps1

function Get-HMPLJS {
    <#
.SYNOPSIS
A script to get latest articles from HMPL.js Forem.
.DESCRIPTION
For developers using HMPL.js to build fast, lightweight web apps. A space to share projects, ask questions, and discuss server-driven templating
This script fetches the latest articles from HMPL.js Forem and displays the title, published date, and URL in the terminal.
.FUNCTIONALITY
API Calls, JSON, Terminal Output
.COMPONENT
PowerShell, Forem.com having their newest articles in a JSON format (API)
.ROLE
IT Professionals, Web Developers
.NOTES
Developer: ITNinja01
Date: 12-05-2025
Version: 0.0.1
#>


    if (-not (Test-Connection hmpljs.forem.com -Count 1 -Quiet)) {
        Write-Error "hmpljs.forem.com is not reachable. Please check your internet connection."
        Exit 1
    }

    Write-Host "Latest news from HMPL.js 🧑‍💻"

    #Carriage return to make it easier to read in the terminal
    $crlf = [Environment]::NewLine

    $Articles = Invoke-RestMethod -Uri "https://hmpljs.forem.com/api/articles"

    #Sorts articles by a date. Important since PowerShell will display them in the terminal at random.
    $SortedArticles = $Articles | Sort-Object -Property published_timestamp 

    #Tons of information is given. However I only need the title, the published date, and the URl; if I want to read the full article.
    $SortedArticles | ForEach-Object {
        $crlf
        $_.title
        $_.published_timestamp  
        $_.url
    }   
}