idt 0.1.1

A fast, ergonomic CLI tool for working with various ID formats
Documentation 
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
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69

# Commands Overview

idt provides six main commands for working with identifiers:

| Command | Alias | Description |
|---------|-------|-------------|
| [gen](./gen.md) | `g` | Generate new IDs |
| [inspect](./inspect.md) | `i` | Analyze and decode IDs |
| [convert](./convert.md) | `c` | Convert between formats |
| [validate](./validate.md) | `v` | Check if input is valid |
| [compare](./compare.md) | - | Compare two IDs |
| [info](./info.md) | - | Show ID type information |

## Global Options

These options work with all commands:

| Option | Description |
|--------|-------------|
| `-j, --json` | Output in JSON format |
| `-p, --pretty` | Pretty-print JSON output |
| `--no-color` | Disable colored output |
| `-h, --help` | Show help information |
| `-V, --version` | Show version |

## Command Aliases

For faster typing, use command aliases:

```bash
idt g uuid      # Same as: idt gen uuid
idt i <ID>      # Same as: idt inspect <ID>
idt c <ID> -f hex   # Same as: idt convert <ID> -f hex
idt v <ID>      # Same as: idt validate <ID>
```

## Reading from stdin

Most commands that accept IDs can read from stdin:

```bash
# Pipe from another command
idt gen uuid | idt inspect

# Read from file
cat ids.txt | idt validate

# Here-string
idt inspect <<< "550e8400-e29b-41d4-a716-446655440000"
```

## Exit Codes

Commands use standard exit codes:

| Code | Meaning |
|------|---------|
| 0 | Success |
| 1 | Error (invalid input, validation failure, etc.) |

This makes idt suitable for use in scripts:

```bash
if idt validate -q "$ID"; then
    echo "Valid ID"
else
    echo "Invalid ID"
fi
```