🚀 [Feature]: Install-GoogleFont is faster on repeats and bulk installs by MariusStorhaug · Pull Request #210 · PSModule/GoogleFonts

Marius Storhaug (MariusStorhaug) · 2026-05-17T12:42:23Z

Install-GoogleFont now finishes repeated runs and large batches significantly faster by skipping already-installed fonts, deduplicating overlapping selections, reusing cached download files, and increasing download concurrency to match available processor capacity by default.

Changed: Repeated installs skip unnecessary work

When -Force is not used, rows that are already installed at the selected scope are skipped before download and install work starts, so reruns avoid network and disk overhead while still reporting skip reasons through verbose output.

Changed: Bulk and wildcard selections process each font file once

Selections are resolved and deduplicated by URL before processing, which prevents duplicate download/install work from overlapping wildcard patterns and repeated names in the same invocation.

Changed: Download throughput scales with host capacity

The download phase now uses parallel work with a default throttle based on Environment::ProcessorCount, so larger hosts use more available network and CPU capacity without requiring callers to change existing command usage.

Changed: Download cache reuse cuts repeat transfer cost

Downloaded font assets are reused when the same URL is requested again and -Force is not used, reducing repeated CDN requests across retries and reruns.

Fixed: Download progress rendering no longer slows bulk runs

Progress rendering is suppressed during web requests and restored afterward, keeping transfer-heavy runs faster while preserving normal progress behavior outside the function scope.

Technical Details

Updated src/functions/public/Install-GoogleFont.ps1 to add pre-download installed-font detection, URL-based deduplication, cache-aware download flow, parallel download throttling defaults, and scoped progress preference suppression/restoration.
Updated .github/PSModule.yml to align module workflow behavior for this feature branch validation path.
Implementation plan progress: tasks listed in Skip download when a font is already installed and -Force is not set #205, Cache downloaded font files to avoid re-downloading on retries and reruns #206, Suppress Invoke-WebRequest progress bar to speed up downloads #207, Parallelize font downloads in Install-GoogleFont #208, and Resolve and deduplicate the font set once before processing #209 are completed in this PR.

github-actions · 2026-05-17T12:42:50Z

No Significant Changes Detected

This PR does not contain changes to files that would trigger a new release:

Pattern	Description
`^src/`	Matches files where path matches this pattern
`^README\.md$`	Matches files where path matches this pattern

Build, test, and publish stages will be skipped for this PR.

If you believe this is incorrect, please verify that your changes are in the correct locations.

Copilot

Pull request overview

Adds a small PowerShell 7+ benchmarking harness for measuring Install-GoogleFont performance iterations, and prevents the generated perf output from being committed.

Changes:

Add scripts/Measure-InstallPerformance.ps1 to run repeatable install/uninstall scenarios and append JSONL timing results.
Ignore the default output file scripts/perf-results.jsonl in .gitignore.

Reviewed changes

Copilot reviewed 2 out of 3 changed files in this pull request and generated 2 comments.

File	Description
scripts/Measure-InstallPerformance.ps1	New perf measurement script that runs install scenarios and logs duration/results to JSONL.
.gitignore	Ignores the generated `scripts/perf-results.jsonl` output file.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

github-actions · 2026-05-17T12:45:48Z

Super-linter summary

Language	Validation result
CHECKOV	Pass ✅
GITHUB_ACTIONS	Pass ✅
GITHUB_ACTIONS_ZIZMOR	Pass ✅
GITLEAKS	Pass ✅
GIT_MERGE_CONFLICT_MARKERS	Pass ✅
JSON	Pass ✅
MARKDOWN	Pass ✅
NATURAL_LANGUAGE	Pass ✅
POWERSHELL	Fail ❌
PRE_COMMIT	Pass ✅
SPELL_CODESPELL	Pass ✅
TRIVY	Pass ✅
YAML	Pass ✅

Super-linter detected linting errors

For more information, see the GitHub Actions workflow run

Powered by Super-linter

POWERSHELL


�[32;1mRuleName �[0m�[32;1m Severity �[0m�[32;1m ScriptName�[0m�[32;1m Line �[0m�[32;1m Message�[0m
�[32;1m-------- �[0m �[32;1m-------- �[0m �[32;1m----------�[0m �[32;1m---- �[0m �[32;1m-------�[0m
PSProvideCommentHelp Information Measure-In 16 The cmdlet 'I
stallPerfo nvoke-Uninsta
rmance.ps1 ll' does not
have a help c
omment.
PSProvideCommentHelp Information Measure-In 26 The cmdlet 'M
stallPerfo easure-Scenar
rmance.ps1 io' does not
have a help c
omment.

github-actions · 2026-05-17T12:46:41Z

✅ New prerelease: PowerShell Gallery - GoogleFonts 1.0.129-perfinstallimprovements001

github-actions · 2026-05-17T12:46:43Z

✅ New prerelease: GitHub - GoogleFonts v1.0.129-perfinstallimprovements001

github-actions · 2026-05-17T12:51:37Z

Super-linter summary

Language	Validation result
CHECKOV	Pass ✅
GITHUB_ACTIONS	Pass ✅
GITHUB_ACTIONS_ZIZMOR	Pass ✅
GITLEAKS	Pass ✅
GIT_MERGE_CONFLICT_MARKERS	Pass ✅
JSON	Pass ✅
MARKDOWN	Pass ✅
NATURAL_LANGUAGE	Pass ✅
POWERSHELL	Fail ❌
PRE_COMMIT	Pass ✅
SPELL_CODESPELL	Pass ✅
TRIVY	Pass ✅
YAML	Pass ✅

Super-linter detected linting errors

For more information, see the GitHub Actions workflow run

Powered by Super-linter

POWERSHELL


�[32;1mRuleName �[0m�[32;1m Severity �[0m�[32;1m ScriptName�[0m�[32;1m Line �[0m�[32;1m Message�[0m
�[32;1m-------- �[0m �[32;1m-------- �[0m �[32;1m----------�[0m �[32;1m---- �[0m �[32;1m-------�[0m
PSProvideCommentHelp Information Measure-In 16 The cmdlet 'I
stallPerfo nvoke-Uninsta
rmance.ps1 ll' does not
have a help c
omment.
PSProvideCommentHelp Information Measure-In 26 The cmdlet 'M
stallPerfo easure-Scenar
rmance.ps1 io' does not
have a help c
omment.

github-actions · 2026-05-17T12:52:32Z

✅ New prerelease: PowerShell Gallery - GoogleFonts 1.0.129-perfinstallimprovements002

github-actions · 2026-05-17T12:52:34Z

✅ New prerelease: GitHub - GoogleFonts v1.0.129-perfinstallimprovements002

github-actions · 2026-05-17T12:56:56Z

Super-linter summary

Language	Validation result
CHECKOV	Pass ✅
GITHUB_ACTIONS	Pass ✅
GITHUB_ACTIONS_ZIZMOR	Pass ✅
GITLEAKS	Pass ✅
GIT_MERGE_CONFLICT_MARKERS	Pass ✅
JSON	Pass ✅
MARKDOWN	Pass ✅
NATURAL_LANGUAGE	Pass ✅
POWERSHELL	Fail ❌
PRE_COMMIT	Pass ✅
SPELL_CODESPELL	Pass ✅
TRIVY	Pass ✅
YAML	Pass ✅

Super-linter detected linting errors

For more information, see the GitHub Actions workflow run

Powered by Super-linter

POWERSHELL


�[32;1mRuleName �[0m�[32;1m Severity �[0m�[32;1m ScriptName�[0m�[32;1m Line �[0m�[32;1m Message�[0m
�[32;1m-------- �[0m �[32;1m-------- �[0m �[32;1m----------�[0m �[32;1m---- �[0m �[32;1m-------�[0m
PSProvideCommentHelp Information Measure-In 16 The cmdlet 'I
stallPerfo nvoke-Uninsta
rmance.ps1 ll' does not
have a help c
omment.
PSProvideCommentHelp Information Measure-In 26 The cmdlet 'M
stallPerfo easure-Scenar
rmance.ps1 io' does not
have a help c
omment.

Copilot

Pull request overview

Copilot reviewed 2 out of 3 changed files in this pull request and generated 4 comments.

Comments suppressed due to low confidence (1)

src/functions/public/Install-GoogleFont.ps1:160

Restoring $ProgressPreference is currently dependent on the clean block completing successfully after Remove-Item. If Remove-Item -Path $tempPath throws, $ProgressPreference may not be restored to the caller’s value. Consider restoring it unconditionally (and ideally before filesystem cleanup), or wrap cleanup in a try/finally so preference restoration is guaranteed.

 clean {
Remove-Item -Path $tempPath -Force
if ($previousProgressPreference) {
$ProgressPreference = $previousProgressPreference
}

github-actions · 2026-05-17T13:01:31Z

Super-linter summary

Language	Validation result
CHECKOV	Pass ✅
GITHUB_ACTIONS	Pass ✅
GITHUB_ACTIONS_ZIZMOR	Pass ✅
GITLEAKS	Pass ✅
GIT_MERGE_CONFLICT_MARKERS	Pass ✅
JSON	Pass ✅
MARKDOWN	Pass ✅
NATURAL_LANGUAGE	Pass ✅
POWERSHELL	Fail ❌
PRE_COMMIT	Pass ✅
SPELL_CODESPELL	Pass ✅
TRIVY	Pass ✅
YAML	Pass ✅

Super-linter detected linting errors

For more information, see the GitHub Actions workflow run

Powered by Super-linter

POWERSHELL


�[32;1mRuleName �[0m�[32;1m Severity �[0m�[32;1m ScriptName�[0m�[32;1m Line �[0m�[32;1m Message�[0m
�[32;1m-------- �[0m �[32;1m-------- �[0m �[32;1m----------�[0m �[32;1m---- �[0m �[32;1m-------�[0m
PSProvideCommentHelp Information Measure-In 16 The cmdlet 'I
stallPerfo nvoke-Uninsta
rmance.ps1 ll' does not
have a help c
omment.
PSProvideCommentHelp Information Measure-In 26 The cmdlet 'M
stallPerfo easure-Scenar
rmance.ps1 io' does not
have a help c
omment.

github-actions · 2026-05-17T13:06:24Z

Super-linter summary

Language	Validation result
CHECKOV	Pass ✅
GITHUB_ACTIONS	Pass ✅
GITHUB_ACTIONS_ZIZMOR	Pass ✅
GITLEAKS	Pass ✅
GIT_MERGE_CONFLICT_MARKERS	Pass ✅
JSON	Pass ✅
MARKDOWN	Pass ✅
NATURAL_LANGUAGE	Pass ✅
POWERSHELL	Fail ❌
PRE_COMMIT	Pass ✅
SPELL_CODESPELL	Pass ✅
TRIVY	Pass ✅
YAML	Pass ✅

Super-linter detected linting errors

For more information, see the GitHub Actions workflow run

Powered by Super-linter

POWERSHELL


�[32;1mRuleName �[0m�[32;1m Severity �[0m�[32;1m ScriptName�[0m�[32;1m Line �[0m�[32;1m Message�[0m
�[32;1m-------- �[0m �[32;1m-------- �[0m �[32;1m----------�[0m �[32;1m---- �[0m �[32;1m-------�[0m
PSProvideCommentHelp Information Measure-In 16 The cmdlet 'I
stallPerfo nvoke-Uninsta
rmance.ps1 ll' does not
have a help c
omment.
PSProvideCommentHelp Information Measure-In 26 The cmdlet 'M
stallPerfo easure-Scenar
rmance.ps1 io' does not
have a help c
omment.

Copilot

Pull request overview

Copilot reviewed 3 out of 4 changed files in this pull request and generated 5 comments.

github-actions · 2026-05-17T13:07:57Z

✅ New prerelease: PowerShell Gallery - GoogleFonts 1.0.129-perfinstallimprovements003

github-actions · 2026-05-17T13:07:59Z

✅ New prerelease: GitHub - GoogleFonts v1.0.129-perfinstallimprovements003

github-actions · 2026-05-17T13:12:42Z

Super-linter summary

Language	Validation result
CHECKOV	Pass ✅
GITHUB_ACTIONS	Pass ✅
GITHUB_ACTIONS_ZIZMOR	Pass ✅
GITLEAKS	Pass ✅
GIT_MERGE_CONFLICT_MARKERS	Pass ✅
JSON	Pass ✅
MARKDOWN	Pass ✅
NATURAL_LANGUAGE	Pass ✅
POWERSHELL	Fail ❌
PRE_COMMIT	Pass ✅
SPELL_CODESPELL	Pass ✅
TRIVY	Pass ✅
YAML	Pass ✅

Super-linter detected linting errors

For more information, see the GitHub Actions workflow run

Powered by Super-linter

POWERSHELL


�[32;1mRuleName �[0m�[32;1m Severity �[0m�[32;1m ScriptName�[0m�[32;1m Line �[0m�[32;1m Message�[0m
�[32;1m-------- �[0m �[32;1m-------- �[0m �[32;1m----------�[0m �[32;1m---- �[0m �[32;1m-------�[0m
PSProvideCommentHelp Information Measure-In 16 The cmdlet 'I
stallPerfo nvoke-Uninsta
rmance.ps1 ll' does not
have a help c
omment.
PSProvideCommentHelp Information Measure-In 26 The cmdlet 'M
stallPerfo easure-Scenar
rmance.ps1 io' does not
have a help c
omment.

Copilot

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

Comments suppressed due to low confidence (1)

src/functions/public/Install-GoogleFont.ps1:267

Same as the parallel path: to ensure the retry loop behaves correctly, Invoke-WebRequest should be invoked with -ErrorAction Stop so non-terminating web cmdlet errors don't bypass the catch and get treated as successes.

 $currentProgressPreference = $ProgressPreference
$ProgressPreference = 'SilentlyContinue'
try {
Invoke-WebRequest -Uri $item.URL -OutFile $item.DownloadPath
} finally {

…to Invoke-WebRequest for retry reliability - Move $previousProgressPreference assignment before the admin-rights check so it is always initialized when the clean block runs (prevents restore if the function throws before reaching the original assignment) - Add -ErrorAction Stop to both Invoke-WebRequest calls (parallel and sequential paths) so non-terminating HTTP/network errors are reliably caught by the retry try/catch loop

github-actions · 2026-05-18T12:12:12Z

Super-linter summary

Language	Validation result
CHECKOV	Pass ✅
GITHUB_ACTIONS	Pass ✅
GITHUB_ACTIONS_ZIZMOR	Pass ✅
GITLEAKS	Pass ✅
GIT_MERGE_CONFLICT_MARKERS	Pass ✅
JSON	Pass ✅
MARKDOWN	Pass ✅
NATURAL_LANGUAGE	Pass ✅
POWERSHELL	Pass ✅
PRE_COMMIT	Pass ✅
SPELL_CODESPELL	Pass ✅
TRIVY	Pass ✅
YAML	Pass ✅

All files and directories linted successfully

For more information, see the GitHub Actions workflow run

Powered by Super-linter

Copilot

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

…n PS 5.1-compatible - Add -ErrorAction Stop to all Copy-Item calls inside try/catch blocks (cache-read on line 199, cache-write on lines 236 and 274) so non-terminating errors reliably enter the catch path - Replace bare $IsWindows/$IsMacOS checks with version-gated variables ($isWin/$isMac) that correctly treat PS 5.1 (which lacks those automatic variables) as Windows

github-actions · 2026-05-18T12:40:05Z

Super-linter summary

Language	Validation result
CHECKOV	Pass ✅
GITHUB_ACTIONS	Pass ✅
GITHUB_ACTIONS_ZIZMOR	Pass ✅
GITLEAKS	Pass ✅
GIT_MERGE_CONFLICT_MARKERS	Pass ✅
JSON	Pass ✅
MARKDOWN	Pass ✅
NATURAL_LANGUAGE	Pass ✅
POWERSHELL	Pass ✅
PRE_COMMIT	Pass ✅
SPELL_CODESPELL	Pass ✅
TRIVY	Pass ✅
YAML	Pass ✅

All files and directories linted successfully

For more information, see the GitHub Actions workflow run

Powered by Super-linter

Copilot

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.

… check - Emit Write-Verbose with resolved cache root path for discoverability - Add per-item cache-miss verbose messages before download phase - Replace -like wildcard with .StartsWith() to avoid special char issues and wildcard parsing overhead in installed-font detection

github-actions · 2026-05-18T14:06:28Z

Super-linter summary

Language	Validation result
CHECKOV	Pass ✅
GITHUB_ACTIONS	Pass ✅
GITHUB_ACTIONS_ZIZMOR	Pass ✅
GITLEAKS	Pass ✅
GIT_MERGE_CONFLICT_MARKERS	Pass ✅
JSON	Pass ✅
MARKDOWN	Pass ✅
NATURAL_LANGUAGE	Pass ✅
POWERSHELL	Pass ✅
PRE_COMMIT	Pass ✅
SPELL_CODESPELL	Pass ✅
TRIVY	Pass ✅
YAML	Pass ✅

All files and directories linted successfully

For more information, see the GitHub Actions workflow run

Powered by Super-linter

Copilot

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

Copilot

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

…es from prefix scan The previous prefix-only StartsWith check falsely marked fonts as installed when a different font family shared the same prefix (e.g., 'Roboto Condensed' installed would incorrectly skip 'Roboto'). Now uses a two-step approach: 1. Exact HashSet.Contains check (primary - O(1)) 2. Prefix fallback that excludes matches which are themselves known Google Font family names, preventing cross-family false positives

github-actions · 2026-05-18T23:27:44Z

Super-linter summary

Language	Validation result
CHECKOV	Pass ✅
GITHUB_ACTIONS	Pass ✅
GITHUB_ACTIONS_ZIZMOR	Pass ✅
GITLEAKS	Pass ✅
GIT_MERGE_CONFLICT_MARKERS	Pass ✅
JSON	Pass ✅
MARKDOWN	Pass ✅
NATURAL_LANGUAGE	Pass ✅
POWERSHELL	Pass ✅
PRE_COMMIT	Pass ✅
SPELL_CODESPELL	Pass ✅
TRIVY	Pass ✅
YAML	Pass ✅

All files and directories linted successfully

For more information, see the GitHub Actions workflow run

Powered by Super-linter

Copilot

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated no new comments.

github-actions · 2026-05-18T23:44:38Z

✅ New release: PowerShell Gallery - GoogleFonts 1.1.0

github-actions · 2026-05-18T23:44:40Z

✅ New release: GitHub - GoogleFonts v1.1.0

perf: add Measure-InstallPerformance.ps1 baseline harness
6c55b9b

CopilotAI review requested due to automatic review settings May 17, 2026 12:42

Marius Storhaug (MariusStorhaug) added the Prerelease Make a prerelease of the package/module/repo. label May 17, 2026

perf(#206): suppress download progress bar in Install-GoogleFont
5ea9c30

Copilotstarted reviewing on behalf of Marius Storhaug (MariusStorhaug)May 17, 2026 12:42 View session

CopilotAI reviewed May 17, 2026
View reviewed changes

Comment threadscripts/Measure-InstallPerformance.ps1 Outdated
Comment threadscripts/Measure-InstallPerformance.ps1 Outdated

perf(#208): dedup font list by URL using HashSet + List[T]
0634d61

perf(#207): skip already-installed font families
29635a1

CopilotAI review requested due to automatic review settings May 17, 2026 12:54

Copilotstarted reviewing on behalf of Marius Storhaug (MariusStorhaug)May 17, 2026 12:54 View session

CopilotAI reviewed May 17, 2026
View reviewed changes

Comment threadsrc/functions/public/Install-GoogleFont.ps1
Comment threadsrc/functions/public/Install-GoogleFont.ps1 Outdated
Comment threadsrc/functions/public/Install-GoogleFont.ps1 Outdated
Comment threadsrc/functions/public/Install-GoogleFont.ps1

test: add -Force/wildcard/skip-installed coverage for Install-GoogleFont
95a9ff2

test: drop -Force test (Install-Font does not handle file overwrite)
5bc74d7

CopilotAI review requested due to automatic review settings May 17, 2026 13:03

Copilotstarted reviewing on behalf of Marius Storhaug (MariusStorhaug)May 17, 2026 13:04 View session

CopilotAI reviewed May 17, 2026
View reviewed changes

Comment threadsrc/functions/public/Install-GoogleFont.ps1
Comment threadsrc/functions/public/Install-GoogleFont.ps1 Outdated
Comment threadsrc/functions/public/Install-GoogleFont.ps1 Outdated
Comment threadtests/GoogleFonts.Tests.ps1 Outdated
Comment threadsrc/functions/public/Install-GoogleFont.ps1

perf(#209): cache downloaded font files by URL hash
aaacb80