adnv 1.5.1

CLI that tracks, checks and auto-updates infrastructure dependency versions across Terraform, Helm, Docker, Git and npm
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
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94

# Version Resolution

adnv handles two version formats and resolves them differently depending on the source type.

## Version formats

### Semantic Versioning (SemVer)

Used by: Helm charts, Docker images, Git repositories, NPM packages.

Follows the [semver specification](https://semver.org/): `MAJOR.MINOR.PATCH` with optional pre-release and build metadata.

Examples: `1.0.0`, `2.3.1-rc.1`, `0.15.0+build.42`

### Terraform Versioning

Used by: Terraform modules, Terraform providers.

Follows Terraform's constraint syntax:

| Operator | Meaning | Example |
|----------|---------|---------|
| `= 1.0.0` | Exact match | Only `1.0.0` |
| `!= 1.0.0` | Exclude | Any except `1.0.0` |
| `> 1.0.0` | Greater than | `1.0.1`, `2.0.0`, etc. |
| `>= 1.0.0` | Greater or equal | `1.0.0`, `1.0.1`, etc. |
| `~> 1.0` | Pessimistic (minor) | `>= 1.0, < 2.0` |
| `~> 1.0.0` | Pessimistic (patch) | `>= 1.0.0, < 1.1.0` |

## Resolution process

```mermaid
flowchart TD
    A[Parse source from file] --> B{Has version constraint?}
    B -->|No| C[Return latest version]
    B -->|Yes| D[Fetch all available tags]
    D --> E[Parse tags as versions]
    E --> F[Sort by version descending]
    F --> G[Find latest overall]
    G --> H{Latest matches constraint?}
    H -->|Yes| I[Up to date - skip]
    H -->|No| J[Find best match for constraint]
    J --> K[Return: wanted + latest]
```

## Key concepts

### Current version

The version currently specified in your file:

```hcl
module "vpc" {
  version = "1.0.0"  # current = 1.0.0
}
```

### Wanted version

The highest available version that satisfies your constraint:

```hcl
# Constraint: ~> 1.0
# Available: 1.0.0, 1.1.0, 1.2.0, 2.0.0
# Wanted: 1.2.0 (highest matching ~> 1.0)
```

### Latest version

The absolute highest available version, regardless of constraints:

```
# Latest: 2.0.0
```

### Display

| Current | Wanted | Latest | Meaning |
|---------|--------|--------|---------|
| 1.0.0 | 1.2.0 | 1.2.0 | Outdated, update available within constraint |
| 1.0.0 | 1.2.0 | 2.0.0 | Outdated, new major available beyond constraint |
| 1.0.0 | 1.0.0 | 1.0.0 | Up to date (not shown) |

## What gets updated

The `update` command only modifies **fixed version strings**. Version ranges and constraints are left untouched:

```hcl
# Updated: fixed version
version = "1.0.0"  →  version = "1.2.0"

# NOT updated: version range
version = "~> 1.0"  # stays as-is
```