Skip to content

Add module performance comparison - #27

Draft
2chevskii wants to merge 1 commit into
masterfrom
docs/performance-comparison
Draft

Add module performance comparison#27
2chevskii wants to merge 1 commit into
masterfrom
docs/performance-comparison

Conversation

@2chevskii

Copy link
Copy Markdown
Owner

Summary

Add a reproducible comparison of gly with PSFileIcons 0.1.1, GlyphShell 0.1.1, and Terminal-Icons 0.11.0.

The new
pm run bench:comparison harness pins the compared module versions, measures isolated module import and standard-table formatting over the same 3,000 generated file-system objects, and can emit JSON results. The README includes the median snapshot, while the web documentation records ranges, environment, methodology, reproduction steps, and interpretation limits.

The recorded Windows/PowerShell 7.6.3 snapshot shows gly importing faster than GlyphShell and Terminal-Icons but slower than PSFileIcons. Its standard-table path was slower than all three modules in this workload. The documentation explicitly treats these figures as a single-machine snapshot because the modules format different columns and perform different work.

Validation

  • Pester tests — all 47 tests passed with
    pm test
  • Documentation build, when documentation changed —
    pm run docs:build passed
  • Manual verification, when applicable — full pinned comparison completed successfully; Test-ModuleManifest ./src/gly.psd1 and git diff --check passed

Checklist

  • The change is focused and does not include unrelated modifications.
  • Tests and documentation have been updated where needed.
  • I have read and agree to follow the Code of Conduct.

@2chevskii 2chevskii added area-performance Performance, benchmarks, or startup/rendering efficiency area-documentation Documentation, examples, or website content labels Jul 10, 2026
@2chevskii 2chevskii self-assigned this Jul 10, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area-documentation Documentation, examples, or website content area-performance Performance, benchmarks, or startup/rendering efficiency

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant