PS1 Formatter

The PS1 Formatter applies a consistent styling policy to PowerShell scripts, normalizing indentation, spacing, and line breaks to produce readable, maintainable code. It accepts a PS1 script as input and outputs a reformatted version that adheres to a defined policy while preserving semantics and comments. Core capabilities include automatic indentation (default 4 spaces, option to switch to tabs), standardized spacing around operators, and consistent brace placement. Optional controls let users adjust indent size, enforce a maximum line length, and preserve or align existing comments. The tool operates conceptually as a two-pass formatter: a lexical pass identifies tokens and blocks, followed by a syntactic pass that positions tokens in a uniform layout without altering meaning. This approach supports reliable formatting across modules, scripts, and automation tasks. Formatting results are deterministic, aiding clear diffs and faster code reviews. Use cases include standardizing scripts from multiple contributors, preparing code for publication, onboarding new engineers, and enforcing team style guides in DevOps pipelines. The combination of PS1-aware parsing, configurable options, and preservation of comments makes it suitable for both small admin scripts and large automation suites.