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
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
|
# terraform-config-inspect
This repository contains a helper library for extracting high-level metadata
about Terraform modules from their source code. It processes only a subset
of the information Terraform itself would process, and in return it's able
to be broadly compatible with modules written for many different versions of
Terraform.
```
$ go get github.com/hashicorp/terraform-config-inspect
```
```go
import "github.com/hashicorp/terraform-config-inspect/tfconfig"
// ...
module, diags := tfconfig.LoadModule(dir)
// ...
```
Due to the [Terraform v1.0 Compatibility Promises](https://www.terraform.io/docs/language/v1-compatibility-promises.html),
this library should be able to parse Terraform configurations written in
the language as defined with Terraform v1.0, although it may not immediately
expose _new_ additions to the language added during the v1.x series.
This library can also interpret valid Terraform configurations targeting
Terraform v0.10 through v0.15, although the level of detail returned may
be lower in older language versions.
## Command Line Tool
The primary way to use this repository is as a Go library, but as a convenience
it also contains a CLI tool called `terraform-config-inspect`, installed
automatically by the `go get` command above, that allows viewing module
information in either a Markdown-like format or in JSON format.
```sh
$ terraform-config-inspect path/to/module
```
```markdown
# Module `path/to/module`
Provider Requirements:
* **null:** (any version)
## Input Variables
* `a` (default `"a default"`)
* `b` (required): The b variable
## Output Values
* `a`
* `b`: I am B
## Managed Resources
* `null_resource.a` from `null`
* `null_resource.b` from `null`
```
```sh
$ terraform-config-inspect --json path/to/module
```
```json
{
"path": "path/to/module",
"variables": {
"A": {
"name": "A",
"default": "A default",
"pos": {
"filename": "path/to/module/basics.tf",
"line": 1
}
},
"B": {
"name": "B",
"description": "The B variable",
"pos": {
"filename": "path/to/module/basics.tf",
"line": 5
}
}
},
"outputs": {
"A": {
"name": "A",
"pos": {
"filename": "path/to/module/basics.tf",
"line": 9
}
},
"B": {
"name": "B",
"description": "I am B",
"pos": {
"filename": "path/to/module/basics.tf",
"line": 13
}
}
},
"required_providers": {
"null": []
},
"managed_resources": {
"null_resource.A": {
"mode": "managed",
"type": "null_resource",
"name": "A",
"provider": {
"name": "null"
},
"pos": {
"filename": "path/to/module/basics.tf",
"line": 18
}
},
"null_resource.B": {
"mode": "managed",
"type": "null_resource",
"name": "B",
"provider": {
"name": "null"
},
"pos": {
"filename": "path/to/module/basics.tf",
"line": 19
}
}
},
"data_resources": {},
"module_calls": {}
}
```
## Contributing
This library and tool are intentionally focused on only extracting simple
top-level metadata about a single Terraform module. This is to reduce the
maintenance burden of keeping this codebase synchronized with changes to
Terraform itself: the features extracted by this package are unlikely to change
significantly in future versions.
For that reason, **we cannot accept external PRs for this codebase that add support for additional Terraform language features**.
Furthermore, we consider this package feature-complete; if there is a feature
you wish to see added, please open a GitHub issue first so we can discuss the
feasability and design before submitting a pull request. We are unlikely to
accept PRs that add features without discussion first.
We would be happy to review PRs to fix bugs in existing functionality or to
improve the usability of the Go package API, however. We will be hesitant about
any breaking changes to the API, since this library is used by a number of
existing tools and systems.
To work on this codebase you will need a recent version of Go installed. Please
ensure all files match the formatting rules applied by `go fmt` and that all
unit tests are passing.
|
