Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/Kriegel/BeautyOfPower

PowerShell Module to tidy / beautify PowerShell sourcecode and to do refactoring.
https://github.com/Kriegel/BeautyOfPower

beautifier beautify case-sensitivity format formatter formatting powershell pretty-printer refactor refactoring tidy

Last synced: about 19 hours ago
JSON representation

PowerShell Module to tidy / beautify PowerShell sourcecode and to do refactoring.

Host: GitHub
URL: https://github.com/Kriegel/BeautyOfPower
Owner: Kriegel
License: agpl-3.0
Created: 2020-07-22T16:19:45.000Z (over 4 years ago)
Default Branch: master
Last Pushed: 2020-08-15T11:39:56.000Z (about 4 years ago)
Last Synced: 2024-08-02T17:35:52.515Z (3 months ago)
Topics: beautifier, beautify, case-sensitivity, format, formatter, formatting, powershell, pretty-printer, refactor, refactoring, tidy
Language: PowerShell
Homepage:
Size: 667 KB
Stars: 7
Watchers: 2
Forks: 0
Open Issues: 1
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# BeautyOfPower (BoP)

**PowerShell Module to format PowerShell script text (sourcecode) to beautify PowerShell sourcecode and to do refactoring on PowerShell sourcecode**

The Functions out of this Module will change (refactor) PowerShell sourcecode.
The Authors of this Module have done great care to do no harm or damage to the processed sourcecode and its execution behavior or results.

Best is to run the this Module in a Sandbox or an Sandbox like Virtual Machine to process, refactor or tidy PowerShell sourcecode.

TO REVIEW THE CHANGES MADE TO THE SOURCECODE, BEFORE EXECUTING IT, IS ON YOUR OWN RESPONSIBILITY.

for Disclaimer of liability see License.

**Alternativly** to this Module use the Module **PSScriptAnalyzer** and his Cmdlet **Invoke-Formatter**

_{(The reason I devlop my own Module here is that PSScriptAnalyzer is written in C# so I can not contribute there and Invoke-Fomatter seems to be an [unloved Kid](https://github.com/PowerShell/PSScriptAnalyzer/issues/775) and shows no development Progress. :-( )}

## Usage

```powershell

# import Module (from Path)
Import-Module 'BeautyOfPower'

# path to file which holds the sourcecode and is to be prettified
$FileToBeParsed = 'C:\PsCode\TestFile.ps1'

# define path for the resulting out file
$OutFilePath = "$env:Temp\Out-Tesfile.ps1"
# remove out file (if exist before)
$Null = Remove-Item $OutFilePath -confirm:$False -ErrorAction 'ignore'
# create an new empty out file
$Null = New-Item $OutFilePath -ItemType File -Force

# Let the sourcecode parsed by the PowerShell parser and Tokenize it
# parse File C:\PsCode\TestFile.ps1
# IT IS STRONGLY NOT RECOMENDED TO USE -IncludeNestedToken IN REFACTORING,
# THIS WILL DAMAGE THE CODE!
Get-BopTokenAndAst -Path $FileToBeParsed |
# Convert .NET Tokens to custom, writeable Bop-Tokens
ConvertTo-BopToken |
#
# Chain the Formating functions to process the tokens
#
# Functions which correct the casing of the Tokens
#
Format-BopCasingTypeName |
Format-BopCasingAttributeName |
Format-BopCasingKeyword -ToLower |
Format-BopCasingCommandName |
Format-BopCasingParameter |
Format-BopCasingTypeMemberName |
Format-BopCasingKnownVariables -MSDefault -IncludeUnknownVars |
Format-BopCasingScopeModifier |
Format-BopCasingOperator -MixedCase |
#
# Function to define the place of the opening brace (LCurly) (here on their own line)
#
Format-BopLCurly -LCurlyOnNewLine |
#
# Function to expand Command-Alias
#
Format-BopExpandCommandAlias -CaseSensitiv -IncludeAll |
#
# Functions to process Command ParameterNames
#
# Command Parameter casing
Format-BopCasingParameter | # this calls : Format-BopParameter -Format 'Casing'
# Shortened Command Parameter expanding
Format-BopExpandParameterShort | # this calls : Format-BopParameter -Format 'ExpandShort'
# Convert Command Parameter-Alias to real Parameter Name
Format-BopExpandParameterAlias | # this calls : Format-BopParameter -Format 'ExpandAlias'
# For faster processing alternativly to the single functions, you can use :
# Format-BopParameter -Format 'All'
#
# Add ParameterName to Positional Parameter
# (convert Positional Parameters to Named Parameters)
# THIS FUNCTION IS EXPERIMENTAL! USE -Force TO USE IT REGARDLESS
Format-BopAddParameterName -Force|
#
ForEach-Object {

# Writing the processed Tokens one after the other to the output file and add spaces between the Tokens
# Write the Surrogate to the file!
Add-Content -Path $OutFilePath -Value ((' ' * $Token.PrefixSpaces) + $Token.Surrogate) -NoNewline
}

# show the out file
Notepad.exe $OutFilePath

```

## Description

I am developing this Module to prettify PowerShell sourcecode, downloaded from the Internet.
I am a german resident, we germans have imbibe word casing from first day of writing.
Many coders in the world, do not care about correct casing, this has itched me so much,
that i have started to develop this Module. (even though I am very bad in grammar)

So the first bunch of Formating functions of this Module are processing PowerShell sourcecode for casing.

### Roadmap

- Largely Done! :-) replace aliases with the names who points the alias to (command alias and ParameterName alias or shorts)

- a bunch of functions to place braces (and space between them).

- write some functions to ident the code and to correct other whitespace.

## Main Functions of this Module

### Get-BopTokenAndAst

Utilizes the PowerShell "advanced" parser to Parse PowerShell sourcecode from File (*.ps1, *.psm1, *.psd1) or Scriptblock or a String Variable.
Returns the Tokens, the AST, syntax Errors and additionally Informations as a custom Object.
(Big credits for this function goes to Tobias Weltner)

### ConvertTo-BopToken

This Function creates an flat clone from 'System.Management.Automation.Language.Token' Token Types.
With additional fields useful for refactoring and to prettify.

Microsoft allows not to Instantiate custom .NET Tokens and
most of the Properties (Fields) of the .NET Token Class members are not edit able.
For simple access of deep nested members, economize memory consumption and for speed reasons this function creates custom Token Object with writeable (set able) fields.

The custom Token Object produced by this function are consumed by the formatting functions.

### Formatting Functions

#### Casing

- Format-BopCasingTypeName

- Format-BopCasingAttributeName

- Format-BopCasingKeyword (uses PascalCase by default!)

- Format-BopCasingCommandName

- Format-BopCasingParameter

- Format-BopCasingTypeMemberName

- Format-BopCasingKnownVariables (uses PascalCase by default!)

- Format-BopCasingParameter ; alternativly use : Format-BopParameter -Format 'Casing'

- Format-BopCasingScopeModifier

- Format-BopCasingOperator

Watchout for additional Parameters a Function servers.
This can be used to change casing behavior