Format-SpectreJson

Description

This function takes an objects and converts them into syntax highlighted Json using the Spectre Console Json Library.
Thanks to trackd for adding this!
See https://spectreconsole.net/widgets/json for more information.

Examples

Example 1
This example demonstrates how to format an array of objects into a Spectre Console Json object with syntax highlighting.

$data = @(
    [pscustomobject]@{
        Name = "John"
        Age = 25
        City = "New York"
        IsEmployed = $true
        Salary = 10
        Hobbies = @("Reading", "Swimming")
        Address = @{
            Street = "123 Main St"
            ZipCode = $null
        }
    }
)
Format-SpectreJson -Data $data

Example 2
This example demonstrates how to display json string data using Format-SpectreJson.

$jsonString = @{
    Name = 'Alice'
    Age = 30
    Skills = @('PowerShell', 'Spectre.Console')
} | ConvertTo-Json
# Display the JSON string using Format-SpectreJson
$jsonString | Format-SpectreJson

Example 3
This example demonstrates how to display the contents of one or more JSON files directly using Format-SpectreJson. Create temporary JSON files for demonstration, use a random execution ID to avoid reading random json files from the temp directory.

$executionId = [guid]::NewGuid().ToString()
$tempJson1 = (New-TemporaryFile).FullName -replace '.tmp$', ".$executionId.json"
$tempJson2 = (New-TemporaryFile).FullName -replace '.tmp$', ".$executionId.json"

@{
    Name = 'Alice'
    Age = 30
    Skills = @('PowerShell', 'Spectre.Console')
} | ConvertTo-Json | Set-Content -Path $tempJson1

@{
    Name = 'Bob'
    Age = 35
    Skills = @('C#', 'JavaScript')
} | ConvertTo-Json | Set-Content -Path $tempJson2

# Display the JSON files directly using Get-ChildItem and Format-SpectreJson
$parent = Split-Path $tempJson1 -Parent
Get-ChildItem $parent -Filter "*.$executionId.json" | Format-SpectreJson

Parameters

Data

The array of objects to be formatted into Json.

Type	Required	Position	PipelineInput
`[Object]`	true	1	true (ByValue)

Depth

The maximum depth of the Json. Default is defined by the version of powershell.

Type	Required	Position	PipelineInput
`[Int32]`	false	2	false

NoBorder

Type	Required	Position	PipelineInput
`[Switch]`	false	named	false

Border

Type	Required	Position	PipelineInput
`[String]`	false	3	false

Color

Type	Required	Position	PipelineInput
`[String]`	false	4	false

Title

Type	Required	Position	PipelineInput
`[String]`	false	5	false

Width

Type	Required	Position	PipelineInput
`[Int32]`	false	6	false

Height

Type	Required	Position	PipelineInput
`[Int32]`	false	7	false

JsonStyle

A hashtable of Spectre Console color names and values to style the Json output. You can provide a partial hashtable to override only specific styles, the rest will use defaults. e.g.

@{
    MemberStyle    = "Yellow"
    BracesStyle    = "Red"
    BracketsStyle  = "Orange1"
    ColonStyle     = "White"
    CommaStyle     = "White"
    StringStyle    = "White"
    NumberStyle    = "Red"
    BooleanStyle   = "LightSkyBlue1"
    NullStyle      = "Gray"
}

Type	Required	Position	PipelineInput
`[Hashtable]`	false	8	false

Syntax

Format-SpectreJson [-Data] <Object> [[-Depth] <Int32>] [-NoBorder] [[-Border] <String>] [[-Color] <String>] [[-Title] <String>] [[-Width] <Int32>] [[-Height] <Int32>] [[-JsonStyle] <Hashtable>] [<CommonParameters>]