aboutsummaryrefslogtreecommitdiff
path: root/validators/powershell/README.md
blob: 822659e9a72327d213190195e926a6fb20eb3bdf (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
# PowerShell Validator

A PowerShell script for validating `.gitinfo` files.

## Requirements

- PowerShell 5.1+ (Windows) or PowerShell Core 7+ (cross-platform)

## Usage

```powershell
# Validate .gitinfo in current directory
.\Validate-GitInfo.ps1

# Validate a specific file
.\Validate-GitInfo.ps1 -Path "path/to/.gitinfo"
```

## Features

- Parses JSONC (strips `//` and `/* */` comments)
- Validates against the gitinfo JSON Schema
- Checks types, formats (URI, email), and patterns
- Enforces `additionalProperties: false`
- Returns exit code 0 on success, 1 on failure
- Color-coded output (green for success, red for errors)

## Example Output

```
✓ .gitinfo is valid
```

```
Validation failed for .gitinfo:
  - .root: invalid URI "not-a-url"
  - root: unknown property "invalid_field"
```

## Notes

On Windows, you may need to adjust the execution policy:

```powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
```