├── .github
├── dependabot.yml
└── workflows
│ ├── go.yml
│ └── publish.yml
├── .golangci.yml
├── .goreleaser.yaml
├── LICENSE
├── Makefile
├── README.md
├── UPDATING.md
├── cmd
├── get.go
├── root.go
├── save.go
└── web.go
├── conf
├── defaults.go
├── environment.go
└── version.go
├── go.mod
├── go.sum
├── main
└── main.go
├── pkg
├── forms
│ ├── errors.go
│ └── form.go
├── models
│ └── models.go
└── util
│ ├── awsssm.go
│ ├── awsssm_test.go
│ └── test.env
├── server
├── handlers.go
├── handlers_test.go
├── helpers.go
├── middleware.go
├── middleware_test.go
├── routes.go
├── server.go
├── templates.go
└── testutils_test.go
└── ui
├── efs.go
├── html
├── base.layout.tmpl
├── error.page.tmpl
├── footer.partial.tmpl
└── home.page.tmpl
└── static
└── css
├── bootstrap-grid.css
├── bootstrap-grid.css.map
├── bootstrap-grid.min.css
├── bootstrap-grid.min.css.map
├── bootstrap-reboot.css
├── bootstrap-reboot.css.map
├── bootstrap-reboot.min.css
├── bootstrap-reboot.min.css.map
├── bootstrap.css
├── bootstrap.css.map
├── bootstrap.min.css
└── bootstrap.min.css.map
/.github/dependabot.yml:
--------------------------------------------------------------------------------
1 | # To get started with Dependabot version updates, you'll need to specify which
2 | # package ecosystems to update and where the package manifests are located.
3 | # Please see the documentation for all configuration options:
4 | # https://docs.github.com/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file
5 |
6 | version: 2
7 | updates:
8 | - package-ecosystem: "gomod" # See documentation for possible values
9 | directory: "/" # Location of package manifests
10 | schedule:
11 | interval: "weekly"
12 |
--------------------------------------------------------------------------------
/.github/workflows/go.yml:
--------------------------------------------------------------------------------
1 | name: Go
2 |
3 | on:
4 | push:
5 | pull_request:
6 | branches:
7 | - main
8 |
9 | jobs:
10 |
11 | build:
12 | runs-on: ubuntu-latest
13 | steps:
14 | - uses: actions/checkout@v4
15 |
16 | - name: Set up Go
17 | uses: actions/setup-go@v5
18 | with:
19 | go-version: 1.23
20 |
21 | - name: Build
22 | run: go build -v ./...
23 |
24 | - name: Test
25 | run: go test ./... -parallel=1 -cover -coverprofile cover.out
26 |
--------------------------------------------------------------------------------
/.github/workflows/publish.yml:
--------------------------------------------------------------------------------
1 | name: publish
2 |
3 | on:
4 | workflow_dispatch:
5 | inputs:
6 | tag:
7 | description: 'Version to Checkout and Release'
8 | required: true
9 | default: 'v0.0.1'
10 |
11 | permissions:
12 | contents: write
13 |
14 | jobs:
15 |
16 | build:
17 | runs-on: ubuntu-latest
18 | steps:
19 | - uses: actions/checkout@v2
20 |
21 | - name: Set up Go
22 | uses: actions/setup-go@v2
23 | with:
24 | go-version: 1.23
25 |
26 | - name: Build
27 | run: go build -v ./...
28 |
29 | - name: Test
30 | run: go test ./... -parallel=1 -cover -coverprofile cover.out
31 |
32 | goreleaser:
33 | runs-on: ubuntu-latest
34 | steps:
35 | -
36 | name: Checkout
37 | uses: actions/checkout@v2
38 | with:
39 | fetch-depth: 0
40 | -
41 | name: Set up Go
42 | uses: actions/setup-go@v5
43 | with:
44 | go-version: 1.23
45 | -
46 | name: Run GoReleaser
47 | uses: goreleaser/goreleaser-action@v5
48 | with:
49 | # either 'goreleaser' (default) or 'goreleaser-pro'
50 | distribution: goreleaser
51 | version: ${{ env.GITHUB_REF_NAME }}
52 | args: release --clean
53 | env:
54 | GITHUB_TOKEN: ${{ secrets.PUBLISHER_TOKEN }}
55 |
--------------------------------------------------------------------------------
/.golangci.yml:
--------------------------------------------------------------------------------
1 | linters-settings:
2 | errcheck:
3 | # report about not checking of errors in type assetions: `a := b.(MyStruct)`;
4 | # default is false: such cases aren't reported by default.
5 | check-type-assertions: true
6 | # report about assignment of errors to blank identifier: `num, _ := strconv.Atoi(numStr)`;
7 | # default is false: such cases aren't reported by default.
8 | check-blank: true
9 | govet:
10 | # report about shadowed variables
11 | check-shadowing: true
12 | gofmt:
13 | # simplify code: gofmt with `-s` option, true by default
14 | simplify: true
15 | golint:
16 | # minimal confidence for issues, default is 0.8
17 | min-confidence: 0
18 | gocyclo:
19 | min-complexity: 15
20 | goimports:
21 | # put imports beginning with prefix after 3rd-party packages;
22 | # it's a comma-separated list of prefixes
23 | local-prefixes: github.com/mgeri/
24 | maligned:
25 | # print struct with more effective memory layout or not, false by default
26 | suggest-new: true
27 | dupl:
28 | # tokens count to trigger issue, 150 by default
29 | threshold: 150
30 | goconst:
31 | # minimal length of string constant, 3 by default
32 | min-len: 3
33 | # minimal occurrences count to trigger, 3 by default
34 | min-occurrences: 3
35 | depguard:
36 | list-type: blacklist
37 | misspell:
38 | # Correct spellings using locale preferences for US or UK.
39 | # Default is to use a neutral variety of English.
40 | # Setting locale to US will correct the British spelling of 'colour' to 'color'.
41 | locale: US
42 | lll:
43 | # max line length, lines longer will be reported. Default is 120.
44 | # '\t' is counted as 1 character by default, and can be changed with the tab-width option
45 | line-length: 150
46 | # tab width in spaces. Default to 1.
47 | tab-width: 1
48 | # gocritic:
49 | # enabled-tags:
50 | # - performance
51 | # - style
52 | # - experimental
53 | # disabled-checks:
54 | # - wrapperFunc
55 | # - dupImport # https://github.com/go-critic/go-critic/issues/845
56 |
57 | linters:
58 | enable-all: true
59 | disable:
60 | - maligned
61 | - prealloc
62 | - gochecknoglobals
63 | - dupl
64 |
65 | # output configuration options
66 | output:
67 | # colored-line-number|line-number|json|tab|checkstyle, default is "colored-line-number"
68 | format: colored-line-number
69 | # print lines of code with issue, default is true
70 | print-issued-lines: true
71 | # print linter name in the end of issue text, default is true
72 | print-linter-name: true
73 |
74 | run:
75 | # which dirs to skip: they won't be analyzed;
76 | # can use regexp here: generated.*, regexp is applied on full path;
77 | # default value is empty list, but next dirs are always skipped independently
78 | skip-dirs:
79 | - vendor
80 | - gen
81 | - docker
82 | - docs
83 |
84 | # which files to skip: they will be analyzed, but issues from them
85 | # won't be reported. Default value is empty list, but there is
86 | # no need to include all autogenerated files, we confidently recognize
87 | # autogenerated files. If it's not please let us know.
88 | skip-files:
89 | - ".*_test.go"
90 |
91 | issues:
92 | # List of regexps of issue texts to exclude, empty list by default.
93 | # But independently from this option we use default exclude patterns,
94 | # it can be disabled by `exclude-use-default: false`. To list all
95 | # excluded by default patterns execute `golangci-lint run --help`
96 | exclude:
97 | - composite literal uses unkeyed fields
98 |
99 | exclude-rules:
100 | # Exclude some linters from running on test files.
101 | - path: _test\.go$|^tests/|^samples/
102 | linters:
103 | - errcheck
104 | - maligned
105 |
106 | # Independently from option `exclude` we use default exclude patterns,
107 | # it can be disabled by this option. To list all
108 | # excluded by default patterns execute `golangci-lint run --help`.
109 | # Default value for this option is true.
110 | exclude-use-default: true
111 |
112 | # Maximum issues count per one linter. Set to 0 to disable. Default is 50.
113 | max-per-linter: 0
114 |
115 | # Maximum count of issues with the same text. Set to 0 to disable. Default is 3.
116 | max-same-issues: 0
117 |
118 | # golangci.com configuration
119 | # https://github.com/golangci/golangci/wiki/Configuration
120 | service:
121 | golangci-lint-version: 1.17.x # use the fixed version to not introduce new linters unexpectedly
122 | prepare:
123 | - echo "here I can run custom commands, but no preparation needed for this repo"
--------------------------------------------------------------------------------
/.goreleaser.yaml:
--------------------------------------------------------------------------------
1 | env:
2 | - GO111MODULE=on
3 | before:
4 | hooks:
5 | - go mod tidy
6 | - go generate ./...
7 | builds:
8 | - binary: aws-parameter-bulk
9 | env:
10 | - CGO_ENABLED=0
11 | goos:
12 | - linux
13 | - windows
14 | - darwin
15 | goarch:
16 | - amd64
17 | - arm
18 | - arm64
19 | goarm:
20 | - "6"
21 | - "7"
22 | ignore:
23 | - goos: darwin
24 | goarch: "386"
25 | - goos: windows
26 | goarch: arm
27 | - goos: windows
28 | goarch: arm64
29 | main: ./main/main.go
30 | archives:
31 | - format_overrides:
32 | - goos: windows
33 | format: zip
34 | files:
35 | - LICENSE
36 | - README.md
37 | - ui/*
38 | checksum:
39 | name_template: 'checksums.txt'
40 | snapshot:
41 | name_template: "{{ incpatch .Version }}-next"
42 | changelog:
43 | sort: asc
44 | filters:
45 | exclude:
46 | - '^docs:'
47 | - '^test:'
48 |
49 | universal_binaries:
50 | - replace: true
51 |
52 | brews:
53 | -
54 | name: aws-parameter-bulk
55 | homepage: "https://github.com/gork74/aws-parameter-bulk"
56 | repository:
57 | owner: gork74
58 | name: homebrew-gork74
59 | commit_author:
60 | name: Adam Malik
61 | email: work@adam-malik.de
62 |
--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
1 | MIT License
2 |
3 | Copyright (c) 2021 Adam Malik
4 |
5 | Permission is hereby granted, free of charge, to any person obtaining a copy
6 | of this software and associated documentation files (the "Software"), to deal
7 | in the Software without restriction, including without limitation the rights
8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9 | copies of the Software, and to permit persons to whom the Software is
10 | furnished to do so, subject to the following conditions:
11 |
12 | The above copyright notice and this permission notice shall be included in all
13 | copies or substantial portions of the Software.
14 |
15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21 | SOFTWARE.
--------------------------------------------------------------------------------
/Makefile:
--------------------------------------------------------------------------------
1 | export CGO_ENABLED=0
2 | export GO111MODULE=on
3 |
4 | .PHONY: clean
5 | clean:
6 | rm -rf ./bin
7 | go clean
8 |
9 | .PHONY: deps
10 | deps:
11 | go mod download
12 | go mod tidy
13 |
14 | .PHONY: test
15 | test:
16 | go test ./... -parallel=1 -cover -coverprofile cover.out | sed ''/PASS/s//$(shell printf "\033[32mPASS\033[0m")/'' | sed ''/FAIL/s//$(shell printf "\033[31mFAIL\033[0m")/''
17 |
18 | .PHONY: build
19 | build:
20 | CGO_ENABLED=0 GOOS=darwin GOARCH=amd64 go build -o ./bin/aws-parameter-bulk-darwin-amd64 main/main.go
21 | CGO_ENABLED=0 GOOS=darwin GOARCH=arm64 go build -o ./bin/aws-parameter-bulk-darwin-arm64 main/main.go
22 | CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o ./bin/aws-parameter-bulk-linux-amd64 main/main.go
23 | CGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build -o ./bin/aws-parameter-bulk-linux-arm64 main/main.go
24 | CGO_ENABLED=0 GOOS=linux GOARCH=arm GOARM=6 go build -o ./bin/aws-parameter-bulk-linux-armhf main/main.go
25 | CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build -o ./bin/aws-parameter-bulk-windows-amd64.exe main/main.go
26 |
27 | .PHONY: dev
28 | dev:
29 | SSM_LOG_LEVEL=debug go run main/main.go
30 |
31 | # install goreleaser first
32 | .PHONY: release-snapshot
33 | release-snapshot:
34 | goreleaser release --snapshot --rm-dist
35 |
36 | .PHONY: setversion
37 | setversion:
38 | if [ -z "$(GITHUB_REF_NAME)" ]; then echo "GITHUB_REF_NAME is not set"; exit 1; fi
39 | sed "s/v[0-9]\.[0-9]\.[0-9]/${GITHUB_REF_NAME}/g" conf/version.go > conf/version.temp
40 | rm conf/version.go
41 | mv conf/version.temp conf/version.go
42 |
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | # aws-parameter-bulk
2 |
3 | Utility to read parameters from AWS Systems Manager (SSM) Parameter Store in bulk and output them in environment-file or json format.
4 | It can read all parameters for a given path, or read a list of single parameters. If the parameters contain json, this can be parsed as single values via a flag.
5 | It uses your current aws profile to access AWS SSM,
6 | you can supply a different profile if you need to read from a different account.
7 | Have your AWS CLI set up correctly. See below for instructions.
8 |
9 |
10 | The output can be used as .env in your development workspace, as --from-env in docker, or as Kubernetes secret.
11 |
12 | ## Install via Homebrew
13 |
14 | ```bash
15 | $ brew tap gork74/gork74
16 |
17 | $ brew install aws-parameter-bulk
18 | ```
19 |
20 | ## Usage
21 |
22 | `get` reads names from single values, or from a path recursively.
23 | Use --help for usage and parameters.
24 |
25 | ````bash
26 | $ aws-parameter-bulk --help
27 |
28 | $ aws-parameter-bulk get --help
29 | ````
30 |
31 |
32 | Assuming you have the following structure in SSM,
33 | and the parameters are filled with "valueOfParam1" etc.:
34 |
35 | ````
36 | /dev/test/param1
37 | /dev/test/param2
38 | /dev/test/param3
39 | /dev/other/other1
40 | /dev/other/other2
41 | /dev/testextend/param1
42 | /dev/path/param1
43 | /dev/path/subpath/subparam1
44 | someparam1
45 | someparam2
46 | jsonparam1
47 | jsonparam2
48 | ````
49 |
50 | ## Get Path
51 |
52 | These are the outputs you can create for a path variable.
53 | Note that the last part of the path will be printed in upper case, if you supply the --upper flag.
54 | To be a valid ENV Identifier the output has to use this format: `[a-zA-Z_][a-zA-Z0-9_]*`
55 |
56 |
57 | ````bash
58 | $ aws-parameter-bulk get /dev/test --upper
59 | PARAM1=valueOfParam1
60 | PARAM2=valueOfParam2
61 | PARAM3=valueOfParam3
62 | ````
63 |
64 | ## Get Path without recursion
65 |
66 | Paths will be read recursively by default, to turn that off supply the --norecursive flag.
67 |
68 | ````bash
69 | $ aws-parameter-bulk get /dev/path --upper --norecursive
70 | PARAM1=valueOfParam1
71 | ````
72 | Without the flag you would get:
73 | ````bash
74 | $ aws-parameter-bulk get /dev/path --upper
75 | PARAM1=valueOfParam1
76 | SUBPARAM1=valueOfSubParam1
77 | ````
78 |
79 | ## Get Path with path prefix
80 |
81 | If you want to add the full path to the output, use the --prefixpath flag.
82 |
83 | ````bash
84 | $ aws-parameter-bulk get /dev/path --prefixpath
85 | /dev/path/param1=valueOfParam1
86 | /dev/path/subpath/subparam1=valueOfSubParam1
87 | ````
88 |
89 | ## Get Path with normalized path prefix
90 |
91 | If you want to add the full path to the output, with underscores as separator (to make it bash variable compliant),
92 | use the --prefixnormalizedpath flag. The first slash of the path is not replaced with an underscore, it will be removed.
93 |
94 | ````bash
95 | $ aws-parameter-bulk get /dev/path --prefixnormalizedpath
96 | dev_path_param1=valueOfParam1
97 | dev_path_subpath_subparam1=valueOfSubParam1
98 | ````
99 |
100 | ## Get Multiple Paths
101 |
102 | You can supply multiple paths:
103 |
104 | ````bash
105 | $ aws-parameter-bulk get /dev/test,/dev/other --upper
106 | PARAM1=valueOfParam1
107 | PARAM2=valueOfParam2
108 | PARAM3=valueOfParam3
109 | OTHER1=valueOfOther1
110 | OTHER2=valueOfOther2
111 | ````
112 |
113 | ## Overwrite Values
114 |
115 | An env file key must be unique, therefore it will be filtered so each key only occurs once.
116 | The last key to appear will be printed out, so this will overwrite /dev/test/param1 with /dev/testextend/param1.
117 | This can be used to first read some default values and overwrite some of them.
118 |
119 | ````bash
120 | $ aws-parameter-bulk get /dev/test,/dev/testextend --upper
121 | PARAM1=valueOfParamFromExtend1
122 | PARAM2=valueOfParam2
123 | PARAM3=valueOfParam3
124 | ````
125 |
126 | ## JSON Output
127 |
128 | Output path parameters as JSON file:
129 |
130 | ````bash
131 | $ aws-parameter-bulk get /dev/test,/dev/other --upper --outjson
132 | ````
133 | ````json
134 | {
135 | "PARAM1": "valueOfParam1",
136 | "PARAM2": "valueOfParam2",
137 | "PARAM3": "valueOfParam3",
138 | "OTHER1": "valueOfOther1",
139 | "OTHER2": "valueOfOther2"
140 | }
141 | ````
142 |
143 | ## Get Single Parameters
144 |
145 | Reading single (non-path) SSM Parameters.
146 |
147 | ````bash
148 | $ aws-parameter-bulk get someparam1,someparam2 --upper
149 | SOMEPARAM1=valueOfSomeParam1
150 | SOMEPARAM2=valueOfSomeParam2
151 | ````
152 |
153 | ## Get Single Parameters on a path
154 |
155 | Reading single SSM Parameters on a path.
156 |
157 | ````bash
158 | $ aws-parameter-bulk get /dev/test/param1,/dev/test/param2 --upper
159 | PARAM1=valueOfParam1
160 | PARAM2=valueOfParam2
161 | ````
162 |
163 | ## Get Parameters Containing JSON
164 |
165 | Reading SSM Parameters containing JSON, parsing and converting them. This also works for path parameters. Each parameter has to be json.
166 |
167 | Assuming this is jsonparam1:
168 | ````json
169 | {
170 | "Json1a": "value1a",
171 | "Json1b": "value1b"
172 | }
173 | ````
174 | And jsonparam2:
175 | ````json
176 | {
177 | "JSON2a": "value2a",
178 | "JSON2b": "value2b"
179 | }
180 | ````
181 |
182 | This will be the output:
183 | ````bash
184 | $ aws-parameter-bulk get jsonparam1,jsonparam2 --injson --upper
185 | JSON1A=value1a
186 | JSON1B=value1b
187 | JSON2A=value2a
188 | JSON2B=value2b
189 | ````
190 |
191 | ## Saving From .env File To SSM Names
192 |
193 | Takes a file in `KEY=value` form, and store each line as name and valie in ssm.
194 |
195 | ````bash
196 | $ aws-parameter-bulk save .env
197 | NAME1
198 | NAME2
199 | ````
200 |
201 |
202 | ## Saving From .env File To SSM Paths
203 |
204 | Takes a file in `KEY=value` form, prefixes each key with the given path, and stores it in ssm.
205 |
206 | ````bash
207 | $ aws-parameter-bulk save .env /dev/something
208 | /dev/something/PARAM1
209 | /dev/something/PARAM2
210 | ````
211 |
212 | ## Saving From JSON File To SSM Paths
213 |
214 | Using a json file as input and storing it to a path
215 |
216 | ````bash
217 | $ aws-parameter-bulk save .env /dev/something --injson
218 |
219 | /dev/something/key1=val1
220 | 2021-12-07T22:38:19Z INF pkg/util/awsssm.go:174 > Output: {
221 | Version: 1
222 | }
223 | /dev/something/key2=val2
224 | 2021-12-07T22:38:20Z INF pkg/util/awsssm.go:174 > Output: {
225 | Version: 1
226 | }
227 | ````
228 |
229 | ## Debugging
230 |
231 | Add SSM_LOG_LEVEL=debug
232 |
233 | ````bash
234 | $ SSM_LOG_LEVEL=debug aws-parameter-bulk get jsonparam1, jsonparam2 --injson --upper
235 | ````
236 |
237 | # Web UI
238 |
239 | Start with parameter "web" to start a web ui on [http://localhost:8888](http://localhost:8888).
240 | Change the listen ip and port with the `--address` flag.
241 |
242 | ````bash
243 | $ aws-parameter-bulk web
244 |
245 | $ aws-parameter-bulk web --address :1234
246 | ````
247 |
248 |
249 | # AWS Setup
250 |
251 | https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html
252 |
253 | It is important that you set your region in your aws profile.
254 |
255 | ````bash
256 | $ aws configure
257 | AWS Access Key ID [None]: AKIAIOSFODNN7EXAMPLE
258 | AWS Secret Access Key [None]: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
259 | Default region name [None]: eu-central-1
260 | Default output format [None]: json
261 | ````
262 |
263 | If you have multiple profiles like this (.aws/config):
264 |
265 | ````
266 | [default]
267 | account = 11111111111
268 | region = eu-central-1
269 | output = json
270 |
271 | [profile other]
272 | account = 2222222222
273 | region = eu-central-1
274 | output = json
275 | source_profile = default
276 | ````
277 |
278 | You can read the SSM Parameters from the other account like this:
279 |
280 | ````bash
281 | $ AWS_PROFILE=other aws-parameter-bulk get /dev/test
282 | ````
283 |
--------------------------------------------------------------------------------
/UPDATING.md:
--------------------------------------------------------------------------------
1 | # Updating dependencies
2 |
3 | ```shell
4 | go get -u ./...
5 | ```
6 |
7 | ```shell
8 | go mod tidy
9 | ```
10 |
11 | ```shell
12 | go test ./... -parallel=1
13 | ```
14 |
15 | ```shell
16 | export NEW_VERSION=v0.0.15
17 | ```
18 |
19 | ```shell
20 | sed -i '' "s/Version = \"v[0-9]*\.[0-9]*\.[0-9]*\"/Version = \"$NEW_VERSION\"/" conf/version.go
21 | cat conf/version.go
22 | ```
23 |
24 | ```shell
25 | git add .
26 | git commit -m"feat: update dependencies"
27 | git push
28 | ```
29 |
30 | ```shell
31 | git tag "${NEW_VERSION?}"
32 | git push --tags
33 | ```
34 |
35 | In case the tag has to be deleted:
36 | ```shell
37 | git tag -d "${NEW_VERSION?}"
38 | git push origin ":refs/tags/${NEW_VERSION?}"
39 | ```
40 |
41 | # Scan for vulnerabilities
42 |
43 | Build
44 | ```shell
45 | CGO_ENABLED=0 GOOS=darwin GOARCH=arm64 go build -o ./bin/aws-parameter-bulk-darwin-arm64 main/main.go
46 | ```
47 | Scan
48 | ```shell
49 | trivy rootfs bin/aws-parameter-bulk-darwin-arm64
50 | ```
51 |
--------------------------------------------------------------------------------
/cmd/get.go:
--------------------------------------------------------------------------------
1 | package cmd
2 |
3 | import (
4 | "fmt"
5 | "github.com/gork74/aws-parameter-bulk/pkg/util"
6 | "github.com/rs/zerolog/log"
7 | "github.com/spf13/cobra"
8 | "os"
9 | )
10 |
11 | func init() { // nolint: gochecknoinits
12 | getCmd := &cobra.Command{
13 | Args: cobra.MinimumNArgs(1),
14 | Use: "get [names]",
15 | Short: "get name1,/path1,/path2/subpath",
16 | Long: "get name1,/path1,/path2/subpath,name3,name4\n\n" +
17 | "Accepts paths and non-path names, as a colon-separated list.\n" +
18 | "For names, returns the name and value as name=value.\n" +
19 | "For paths, returns all parameter store values under a path as name=value.\n" +
20 | "This can be piped into an file (> .env), to be included via --env-file=.env\n" +
21 | "or to be set in a shell environment (not recommended): export $(cat .env).\n" +
22 | "Note: name output is unique, if two paths parameters have the same name, the value of the last name in the list wins\n" +
23 | "Use --help for help on the flags: --export --injson --outjson --upper --quote --norecursive --prefixpath --prefixnormalizedpath",
24 | Run: func(cmd *cobra.Command, args []string) {
25 | exportFlag, _ := cmd.Flags().GetBool("export")
26 | inJsonFlag, _ := cmd.Flags().GetBool("injson")
27 | outJsonFlag, _ := cmd.Flags().GetBool("outjson")
28 | upperFlag, _ := cmd.Flags().GetBool("upper")
29 | quoteFlag, _ := cmd.Flags().GetBool("quote")
30 | // use recursive as default, to stay backward compatible
31 | noRecursiveFlag, _ := cmd.Flags().GetBool("norecursive")
32 | recursiveFlag := !noRecursiveFlag
33 | prefixPathFlag, _ := cmd.Flags().GetBool("prefixpath")
34 | prefixNormalizedPathFlag, _ := cmd.Flags().GetBool("prefixnormalizedpath")
35 | flags := util.Flags{
36 | exportFlag,
37 | inJsonFlag,
38 | outJsonFlag,
39 | upperFlag,
40 | quoteFlag,
41 | false,
42 | recursiveFlag,
43 | prefixPathFlag,
44 | prefixNormalizedPathFlag,
45 | }
46 | log.Debug().Msgf("Names/Paths: %s", args[0])
47 | log.Debug().Msgf("Flags: %+v", flags)
48 | ssmClient := util.NewSSM()
49 | result, err := ssmClient.GetParams(&args[0], flags)
50 | if err != nil {
51 | log.Error().Msg(err.Error())
52 | os.Exit(1)
53 | return
54 | }
55 |
56 | output, err := ssmClient.GetOutputString(result, flags)
57 | if err != nil {
58 | log.Error().Msg(err.Error())
59 | os.Exit(1)
60 | return
61 | }
62 | fmt.Print(output)
63 | },
64 | }
65 | getCmd.PersistentFlags().Bool("export", false, "Prefix output with export to eval it in shell")
66 | getCmd.PersistentFlags().Bool("injson", false, "Parse input parameter values as json and extract each json value as output. Each has to be json.")
67 | getCmd.PersistentFlags().Bool("outjson", false, "Output everything as a json file. Does not make sense together with --export.")
68 | getCmd.PersistentFlags().Bool("upper", false, "Make keys uppercase")
69 | getCmd.PersistentFlags().Bool("quote", false, "Wrap values in quotes")
70 | getCmd.PersistentFlags().Bool("norecursive", false, "Do not read recursively if getting a path")
71 | getCmd.PersistentFlags().Bool("prefixpath", false, "Prefix names with the path")
72 | getCmd.PersistentFlags().Bool("prefixnormalizedpath", false, "Prefix names with the normalized path")
73 | rootCmd.AddCommand(getCmd)
74 |
75 | }
76 |
--------------------------------------------------------------------------------
/cmd/root.go:
--------------------------------------------------------------------------------
1 | package cmd
2 |
3 | import (
4 | "fmt"
5 | "io"
6 | "os"
7 | "strings"
8 | "time"
9 |
10 | "github.com/gork74/aws-parameter-bulk/conf"
11 |
12 | "github.com/rs/zerolog"
13 | "github.com/rs/zerolog/log"
14 | "github.com/spf13/cobra"
15 | "github.com/spf13/viper"
16 | "gopkg.in/natefinch/lumberjack.v2"
17 | )
18 |
19 | // Config and global logger
20 | var configFile string
21 | var pidFile string
22 | var logger zerolog.Logger
23 |
24 | // The Root Cobra Handler
25 | var rootCmd = &cobra.Command{
26 | Version: conf.Version,
27 | Use: conf.Executable,
28 | }
29 |
30 | func main() {
31 | Execute()
32 | }
33 |
34 | // This is the main initializer handling cli, config and log
35 | func init() { // nolint: gochecknoinits
36 | // Initialize configuration
37 | cobra.OnInitialize(conf.BindEnv, initConfig, initLog)
38 | }
39 |
40 | // Execute starts the program
41 | func Execute() {
42 | // Run the program
43 | if err := rootCmd.Execute(); err != nil {
44 | fmt.Fprintf(os.Stderr, "%s\n", err.Error())
45 | }
46 | }
47 |
48 | // initConfig reads in config file and ENV variables if set.
49 | func initConfig() {
50 |
51 | // Sets up the config file, environment etc
52 | viper.SetEnvPrefix(strings.ToUpper(conf.Executable))
53 | // If a default value is []string{"a"} an environment variable of "a b" will end up []string{"a","b"}
54 | viper.SetTypeByDefaultValue(true)
55 | // Automatically use environment variables where available
56 | viper.AutomaticEnv()
57 | // Environment variables use underscores instead of periods
58 | viper.SetEnvKeyReplacer(strings.NewReplacer(".", "_"))
59 |
60 | viper.Set("logger.level", viper.GetString("SSM_LOG_LEVEL"))
61 |
62 | }
63 |
64 | func initLog() {
65 |
66 | zerolog.TimeFieldFormat = zerolog.TimeFormatUnixMs
67 |
68 | // log level
69 | var logLevel zerolog.Level
70 | var err error
71 | logLevel, err = zerolog.ParseLevel(viper.GetString("logger.level"))
72 | if err != nil {
73 | fmt.Fprintf(os.Stderr, "Failed to parse log level: %s ERROR: %s\n", viper.GetString("logger.level"), err.Error())
74 | logLevel = zerolog.DebugLevel
75 | }
76 |
77 | zerolog.SetGlobalLevel(logLevel)
78 |
79 | var logWriter io.Writer
80 |
81 | if viper.GetString("logger.file") != "" {
82 | logWriter = &lumberjack.Logger{
83 | Filename: viper.GetString("logger.file"),
84 | MaxSize: 100, // megabytes
85 | MaxBackups: 3,
86 | MaxAge: 28, // days
87 | }
88 | } else {
89 | // log on stdout
90 | // pretty console logger
91 | output := zerolog.ConsoleWriter{Out: os.Stdout, TimeFormat: time.RFC3339}
92 |
93 | logWriter = output
94 | }
95 |
96 | logger = zerolog.New(logWriter).With().Timestamp().Caller().Logger()
97 |
98 | // set global logger
99 | log.Logger = logger
100 | }
101 |
--------------------------------------------------------------------------------
/cmd/save.go:
--------------------------------------------------------------------------------
1 | package cmd
2 |
3 | import (
4 | "github.com/gork74/aws-parameter-bulk/pkg/util"
5 | "github.com/rs/zerolog/log"
6 | "github.com/spf13/cobra"
7 | )
8 |
9 | func init() { // nolint: gochecknoinits
10 | saveCmd := &cobra.Command{
11 | Args: cobra.MinimumNArgs(1),
12 | Use: "save [file] [basepath]",
13 | Short: "save .env",
14 | Long: "save .env\n" +
15 | "save .env /basepath\n\n" +
16 | "saves each entry from a file in the .env format (KEY=value) into multiple variables in the form key=value\n" +
17 | "or saves them into multiple variables in the form /basepath/key=value",
18 | Run: func(cmd *cobra.Command, args []string) {
19 | fileName := args[0]
20 | path := ""
21 | if len(args) > 1 {
22 | path = args[1]
23 | }
24 | inJsonFlag, _ := cmd.Flags().GetBool("injson")
25 | dryFlag, _ := cmd.Flags().GetBool("dry")
26 | flags := util.Flags{
27 | false,
28 | inJsonFlag,
29 | false,
30 | false,
31 | false,
32 | dryFlag,
33 | false,
34 | false,
35 | false,
36 | }
37 | log.Debug().Msgf("Filename: %s Path: %s", fileName, path)
38 | log.Debug().Msgf("Flags: %+v", flags)
39 |
40 | ssmClient := util.NewSSM()
41 | err := ssmClient.SaveParametersFromFile(fileName, path, flags)
42 | if err != nil {
43 | log.Error().Msg(err.Error())
44 | return
45 | }
46 | },
47 | }
48 | saveCmd.PersistentFlags().Bool("injson", false, "Parse input file as json and extract each json value as output.")
49 | saveCmd.PersistentFlags().Bool("dry", false, "Dry run, just output what would be saved to ssm and do nothing.")
50 | rootCmd.AddCommand(saveCmd)
51 | }
52 |
--------------------------------------------------------------------------------
/cmd/web.go:
--------------------------------------------------------------------------------
1 | package cmd
2 |
3 | import (
4 | "github.com/gork74/aws-parameter-bulk/server"
5 |
6 | "github.com/spf13/cobra"
7 | )
8 |
9 | // Web ui command
10 | func init() { // nolint: gochecknoinits
11 | webCmd := &cobra.Command{
12 | Use: "web",
13 | Short: "web ",
14 | Long: "web \n\n" +
15 | "Starts a web ui on localhost:8888 which can show, compare and edit multiple ssm entries",
16 | Run: func(cmd *cobra.Command, args []string) {
17 | address, _ := cmd.Flags().GetString("address")
18 | if address == "" {
19 | address = ":8888"
20 | }
21 | server.ListenAndServe(&logger, address)
22 | },
23 | }
24 | webCmd.PersistentFlags().String("address", ":8888", "Ip and Port where the webserver is started, you can leave out the ip as a shortcut.")
25 | rootCmd.AddCommand(webCmd)
26 | }
27 |
--------------------------------------------------------------------------------
/conf/defaults.go:
--------------------------------------------------------------------------------
1 | package conf
2 |
3 | import (
4 | "github.com/spf13/viper"
5 | )
6 |
7 | // Initialize defaults
8 | var (
9 | _ = func() struct{} {
10 | // Logger Defaults
11 | viper.SetDefault("logger.level", "info")
12 | // if no file is specified, log on standard output
13 | viper.SetDefault("logger.file", "")
14 |
15 | viper.SetDefault("SSM_LOG_LEVEL", "info")
16 |
17 | return struct{}{}
18 | }()
19 | )
20 |
--------------------------------------------------------------------------------
/conf/environment.go:
--------------------------------------------------------------------------------
1 | package conf
2 |
3 | import (
4 | "github.com/spf13/viper"
5 | )
6 |
7 | // BindEnv binds used environment variables
8 | func BindEnv() {
9 | viper.SetEnvPrefix("")
10 | viper.BindEnv("SSM_LOG_LEVEL")
11 | }
12 |
--------------------------------------------------------------------------------
/conf/version.go:
--------------------------------------------------------------------------------
1 | package conf
2 |
3 | var (
4 | // Executable name
5 | Executable = "aws-parameter-bulk"
6 | // Version value
7 | Version = "v0.0.15"
8 | )
9 |
--------------------------------------------------------------------------------
/go.mod:
--------------------------------------------------------------------------------
1 | module github.com/gork74/aws-parameter-bulk
2 |
3 | go 1.23.0
4 |
5 | require (
6 | github.com/alexedwards/scs/v2 v2.8.0
7 | github.com/aws/aws-sdk-go v1.55.6
8 | github.com/bmizerany/pat v0.0.0-20210406213842-e4b6760bdd6f
9 | github.com/justinas/alice v1.2.0
10 | github.com/justinas/nosurf v1.1.1
11 | github.com/rs/zerolog v1.34.0
12 | github.com/spf13/cobra v1.9.1
13 | github.com/spf13/viper v1.20.0
14 | gopkg.in/natefinch/lumberjack.v2 v2.2.1
15 | )
16 |
17 | require (
18 | github.com/fsnotify/fsnotify v1.8.0 // indirect
19 | github.com/go-viper/mapstructure/v2 v2.2.1 // indirect
20 | github.com/inconshreveable/mousetrap v1.1.0 // indirect
21 | github.com/jmespath/go-jmespath v0.4.0 // indirect
22 | github.com/mattn/go-colorable v0.1.14 // indirect
23 | github.com/mattn/go-isatty v0.0.20 // indirect
24 | github.com/pelletier/go-toml/v2 v2.2.3 // indirect
25 | github.com/sagikazarmark/locafero v0.7.0 // indirect
26 | github.com/sourcegraph/conc v0.3.0 // indirect
27 | github.com/spf13/afero v1.12.0 // indirect
28 | github.com/spf13/cast v1.7.1 // indirect
29 | github.com/spf13/pflag v1.0.6 // indirect
30 | github.com/subosito/gotenv v1.6.0 // indirect
31 | go.uber.org/multierr v1.11.0 // indirect
32 | golang.org/x/sys v0.30.0 // indirect
33 | golang.org/x/text v0.22.0 // indirect
34 | gopkg.in/yaml.v2 v2.4.0 // indirect
35 | gopkg.in/yaml.v3 v3.0.1 // indirect
36 | )
37 |
--------------------------------------------------------------------------------
/go.sum:
--------------------------------------------------------------------------------
1 | github.com/alexedwards/scs/v2 v2.8.0 h1:h31yUYoycPuL0zt14c0gd+oqxfRwIj6SOjHdKRZxhEw=
2 | github.com/alexedwards/scs/v2 v2.8.0/go.mod h1:ToaROZxyKukJKT/xLcVQAChi5k6+Pn1Gvmdl7h3RRj8=
3 | github.com/aws/aws-sdk-go v1.55.6 h1:cSg4pvZ3m8dgYcgqB97MrcdjUmZ1BeMYKUxMMB89IPk=
4 | github.com/aws/aws-sdk-go v1.55.6/go.mod h1:eRwEWoyTWFMVYVQzKMNHWP5/RV4xIUGMQfXQHfHkpNU=
5 | github.com/bmizerany/pat v0.0.0-20210406213842-e4b6760bdd6f h1:gOO/tNZMjjvTKZWpY7YnXC72ULNLErRtp94LountVE8=
6 | github.com/bmizerany/pat v0.0.0-20210406213842-e4b6760bdd6f/go.mod h1:8rLXio+WjiTceGBHIoTvn60HIbs7Hm7bcHjyrSqYB9c=
7 | github.com/coreos/go-systemd/v22 v22.5.0/go.mod h1:Y58oyj3AT4RCenI/lSvhwexgC+NSVTIJ3seZv2GcEnc=
8 | github.com/cpuguy83/go-md2man/v2 v2.0.6/go.mod h1:oOW0eioCTA6cOiMLiUPZOpcVxMig6NIQQ7OS05n1F4g=
9 | github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
10 | github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
11 | github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
12 | github.com/frankban/quicktest v1.14.6 h1:7Xjx+VpznH+oBnejlPUj8oUpdxnVs4f8XU8WnHkI4W8=
13 | github.com/frankban/quicktest v1.14.6/go.mod h1:4ptaffx2x8+WTWXmUCuVU6aPUX1/Mz7zb5vbUoiM6w0=
14 | github.com/fsnotify/fsnotify v1.8.0 h1:dAwr6QBTBZIkG8roQaJjGof0pp0EeF+tNV7YBP3F/8M=
15 | github.com/fsnotify/fsnotify v1.8.0/go.mod h1:8jBTzvmWwFyi3Pb8djgCCO5IBqzKJ/Jwo8TRcHyHii0=
16 | github.com/go-viper/mapstructure/v2 v2.2.1 h1:ZAaOCxANMuZx5RCeg0mBdEZk7DZasvvZIxtHqx8aGss=
17 | github.com/go-viper/mapstructure/v2 v2.2.1/go.mod h1:oJDH3BJKyqBA2TXFhDsKDGDTlndYOZ6rGS0BRZIxGhM=
18 | github.com/godbus/dbus/v5 v5.0.4/go.mod h1:xhWf0FNVPg57R7Z0UbKHbJfkEywrmjJnf7w5xrFpKfA=
19 | github.com/google/go-cmp v0.6.0 h1:ofyhxvXcZhMsU5ulbFiLKl/XBFqE1GSq7atu8tAmTRI=
20 | github.com/google/go-cmp v0.6.0/go.mod h1:17dUlkBOakJ0+DkrSSNjCkIjxS6bF9zb3elmeNGIjoY=
21 | github.com/inconshreveable/mousetrap v1.1.0 h1:wN+x4NVGpMsO7ErUn/mUI3vEoE6Jt13X2s0bqwp9tc8=
22 | github.com/inconshreveable/mousetrap v1.1.0/go.mod h1:vpF70FUmC8bwa3OWnCshd2FqLfsEA9PFc4w1p2J65bw=
23 | github.com/jmespath/go-jmespath v0.4.0 h1:BEgLn5cpjn8UN1mAw4NjwDrS35OdebyEtFe+9YPoQUg=
24 | github.com/jmespath/go-jmespath v0.4.0/go.mod h1:T8mJZnbsbmF+m6zOOFylbeCJqk5+pHWvzYPziyZiYoo=
25 | github.com/jmespath/go-jmespath/internal/testify v1.5.1 h1:shLQSRRSCCPj3f2gpwzGwWFoC7ycTf1rcQZHOlsJ6N8=
26 | github.com/jmespath/go-jmespath/internal/testify v1.5.1/go.mod h1:L3OGu8Wl2/fWfCI6z80xFu9LTZmf1ZRjMHUOPmWr69U=
27 | github.com/justinas/alice v1.2.0 h1:+MHSA/vccVCF4Uq37S42jwlkvI2Xzl7zTPCN5BnZNVo=
28 | github.com/justinas/alice v1.2.0/go.mod h1:fN5HRH/reO/zrUflLfTN43t3vXvKzvZIENsNEe7i7qA=
29 | github.com/justinas/nosurf v1.1.1 h1:92Aw44hjSK4MxJeMSyDa7jwuI9GR2J/JCQiaKvXXSlk=
30 | github.com/justinas/nosurf v1.1.1/go.mod h1:ALpWdSbuNGy2lZWtyXdjkYv4edL23oSEgfBT1gPJ5BQ=
31 | github.com/kr/pretty v0.3.1 h1:flRD4NNwYAUpkphVc1HcthR4KEIFJ65n8Mw5qdRn3LE=
32 | github.com/kr/pretty v0.3.1/go.mod h1:hoEshYVHaxMs3cyo3Yncou5ZscifuDolrwPKZanG3xk=
33 | github.com/kr/text v0.2.0 h1:5Nx0Ya0ZqY2ygV366QzturHI13Jq95ApcVaJBhpS+AY=
34 | github.com/kr/text v0.2.0/go.mod h1:eLer722TekiGuMkidMxC/pM04lWEeraHUUmBw8l2grE=
35 | github.com/mattn/go-colorable v0.1.13/go.mod h1:7S9/ev0klgBDR4GtXTXX8a3vIGJpMovkB8vQcUbaXHg=
36 | github.com/mattn/go-colorable v0.1.14 h1:9A9LHSqF/7dyVVX6g0U9cwm9pG3kP9gSzcuIPHPsaIE=
37 | github.com/mattn/go-colorable v0.1.14/go.mod h1:6LmQG8QLFO4G5z1gPvYEzlUgJ2wF+stgPZH1UqBm1s8=
38 | github.com/mattn/go-isatty v0.0.16/go.mod h1:kYGgaQfpe5nmfYZH+SKPsOc2e4SrIfOl2e/yFXSvRLM=
39 | github.com/mattn/go-isatty v0.0.19/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
40 | github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY=
41 | github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
42 | github.com/pelletier/go-toml/v2 v2.2.3 h1:YmeHyLY8mFWbdkNWwpr+qIL2bEqT0o95WSdkNHvL12M=
43 | github.com/pelletier/go-toml/v2 v2.2.3/go.mod h1:MfCQTFTvCcUyyvvwm1+G6H/jORL20Xlb6rzQu9GuUkc=
44 | github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0=
45 | github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
46 | github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
47 | github.com/rogpeppe/go-internal v1.9.0 h1:73kH8U+JUqXU8lRuOHeVHaa/SZPifC7BkcraZVejAe8=
48 | github.com/rogpeppe/go-internal v1.9.0/go.mod h1:WtVeX8xhTBvf0smdhujwtBcq4Qrzq/fJaraNFVN+nFs=
49 | github.com/rs/xid v1.6.0/go.mod h1:7XoLgs4eV+QndskICGsho+ADou8ySMSjJKDIan90Nz0=
50 | github.com/rs/zerolog v1.34.0 h1:k43nTLIwcTVQAncfCw4KZ2VY6ukYoZaBPNOE8txlOeY=
51 | github.com/rs/zerolog v1.34.0/go.mod h1:bJsvje4Z08ROH4Nhs5iH600c3IkWhwp44iRc54W6wYQ=
52 | github.com/russross/blackfriday/v2 v2.1.0/go.mod h1:+Rmxgy9KzJVeS9/2gXHxylqXiyQDYRxCVz55jmeOWTM=
53 | github.com/sagikazarmark/locafero v0.7.0 h1:5MqpDsTGNDhY8sGp0Aowyf0qKsPrhewaLSsFaodPcyo=
54 | github.com/sagikazarmark/locafero v0.7.0/go.mod h1:2za3Cg5rMaTMoG/2Ulr9AwtFaIppKXTRYnozin4aB5k=
55 | github.com/sourcegraph/conc v0.3.0 h1:OQTbbt6P72L20UqAkXXuLOj79LfEanQ+YQFNpLA9ySo=
56 | github.com/sourcegraph/conc v0.3.0/go.mod h1:Sdozi7LEKbFPqYX2/J+iBAM6HpqSLTASQIKqDmF7Mt0=
57 | github.com/spf13/afero v1.12.0 h1:UcOPyRBYczmFn6yvphxkn9ZEOY65cpwGKb5mL36mrqs=
58 | github.com/spf13/afero v1.12.0/go.mod h1:ZTlWwG4/ahT8W7T0WQ5uYmjI9duaLQGy3Q2OAl4sk/4=
59 | github.com/spf13/cast v1.7.1 h1:cuNEagBQEHWN1FnbGEjCXL2szYEXqfJPbP2HNUaca9Y=
60 | github.com/spf13/cast v1.7.1/go.mod h1:ancEpBxwJDODSW/UG4rDrAqiKolqNNh2DX3mk86cAdo=
61 | github.com/spf13/cobra v1.9.1 h1:CXSaggrXdbHK9CF+8ywj8Amf7PBRmPCOJugH954Nnlo=
62 | github.com/spf13/cobra v1.9.1/go.mod h1:nDyEzZ8ogv936Cinf6g1RU9MRY64Ir93oCnqb9wxYW0=
63 | github.com/spf13/pflag v1.0.6 h1:jFzHGLGAlb3ruxLB8MhbI6A8+AQX/2eW4qeyNZXNp2o=
64 | github.com/spf13/pflag v1.0.6/go.mod h1:McXfInJRrz4CZXVZOBLb0bTZqETkiAhM9Iw0y3An2Bg=
65 | github.com/spf13/viper v1.20.0 h1:zrxIyR3RQIOsarIrgL8+sAvALXul9jeEPa06Y0Ph6vY=
66 | github.com/spf13/viper v1.20.0/go.mod h1:P9Mdzt1zoHIG8m2eZQinpiBjo6kCmZSKBClNNqjJvu4=
67 | github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
68 | github.com/stretchr/testify v1.10.0 h1:Xv5erBjTwe/5IxqUQTdXv5kgmIvbHo3QQyRwhJsOfJA=
69 | github.com/stretchr/testify v1.10.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY=
70 | github.com/subosito/gotenv v1.6.0 h1:9NlTDc1FTs4qu0DDq7AEtTPNw6SVm7uBMsUCUjABIf8=
71 | github.com/subosito/gotenv v1.6.0/go.mod h1:Dk4QP5c2W3ibzajGcXpNraDfq2IrhjMIvMSWPKKo0FU=
72 | go.uber.org/multierr v1.11.0 h1:blXXJkSxSSfBVBlC76pxqeO+LN3aDfLQo+309xJstO0=
73 | go.uber.org/multierr v1.11.0/go.mod h1:20+QtiLqy0Nd6FdQB9TLXag12DsQkrbs3htMFfDN80Y=
74 | golang.org/x/sys v0.0.0-20220811171246-fbc7d0a398ab/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
75 | golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
76 | golang.org/x/sys v0.12.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
77 | golang.org/x/sys v0.30.0 h1:QjkSwP/36a20jFYWkSue1YwXzLmsV5Gfq7Eiy72C1uc=
78 | golang.org/x/sys v0.30.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA=
79 | golang.org/x/text v0.22.0 h1:bofq7m3/HAFvbF51jz3Q9wLg3jkvSPuiZu/pD1XwgtM=
80 | golang.org/x/text v0.22.0/go.mod h1:YRoo4H8PVmsu+E3Ou7cqLVH8oXWIHVoX0jqUWALQhfY=
81 | gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
82 | gopkg.in/check.v1 v1.0.0-20190902080502-41f04d3bba15 h1:YR8cESwS4TdDjEe65xsg0ogRM/Nc3DYOhEAlW+xobZo=
83 | gopkg.in/check.v1 v1.0.0-20190902080502-41f04d3bba15/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
84 | gopkg.in/natefinch/lumberjack.v2 v2.2.1 h1:bBRl1b0OH9s/DuPhuXpNl+VtCaJXFZ5/uEFST95x9zc=
85 | gopkg.in/natefinch/lumberjack.v2 v2.2.1/go.mod h1:YD8tP3GAjkrDg1eZH7EGmyESg/lsYskCTPBJVb9jqSc=
86 | gopkg.in/yaml.v2 v2.2.8/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI=
87 | gopkg.in/yaml.v2 v2.4.0 h1:D8xgwECY7CYvx+Y2n4sBz93Jn9JRvxdiyyo8CTfuKaY=
88 | gopkg.in/yaml.v2 v2.4.0/go.mod h1:RDklbk79AGWmwhnvt/jBztapEOGDOx6ZbXqjP6csGnQ=
89 | gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
90 | gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
91 |
--------------------------------------------------------------------------------
/main/main.go:
--------------------------------------------------------------------------------
1 | package main
2 |
3 | import "github.com/gork74/aws-parameter-bulk/cmd"
4 |
5 | func main() {
6 | cmd.Execute()
7 | }
8 |
--------------------------------------------------------------------------------
/pkg/forms/errors.go:
--------------------------------------------------------------------------------
1 | package forms
2 |
3 | type errors map[string][]string
4 |
5 | func (e errors) Add(field, message string) {
6 | e[field] = append(e[field], message)
7 | }
8 |
9 | func (e errors) Get(field string) string {
10 | es := e[field]
11 | if len(es) == 0 {
12 | return ""
13 | }
14 | return es[0]
15 | }
16 |
--------------------------------------------------------------------------------
/pkg/forms/form.go:
--------------------------------------------------------------------------------
1 | package forms
2 |
3 | import (
4 | "net/url"
5 | "strings"
6 | )
7 |
8 | type Form struct {
9 | url.Values
10 | Errors errors
11 | }
12 |
13 | func New(data url.Values) *Form {
14 | return &Form{
15 | data,
16 | errors(map[string][]string{}),
17 | }
18 | }
19 |
20 | func (f *Form) Required(fields ...string) {
21 | for _, field := range fields {
22 | value := f.Get(field)
23 | if strings.TrimSpace(value) == "" {
24 | f.Errors.Add(field, "This field cannot be blank")
25 | }
26 | }
27 | }
28 |
29 | func (f *Form) Valid() bool {
30 | return len(f.Errors) == 0
31 | }
32 |
--------------------------------------------------------------------------------
/pkg/models/models.go:
--------------------------------------------------------------------------------
1 | package models
2 |
3 | type ValueCompare struct {
4 | LeftName string
5 | LeftOriginal string
6 | LeftValue string
7 | LeftBasePath string
8 | RightName string
9 | RightOriginal string
10 | RightValue string
11 | RightBasePath string
12 | Different bool
13 | }
14 |
--------------------------------------------------------------------------------
/pkg/util/awsssm.go:
--------------------------------------------------------------------------------
1 | package util
2 |
3 | import (
4 | "bufio"
5 | "encoding/json"
6 | "errors"
7 | "fmt"
8 | "github.com/aws/aws-sdk-go/aws/session"
9 | "github.com/aws/aws-sdk-go/service/ssm"
10 | "github.com/aws/aws-sdk-go/service/ssm/ssmiface"
11 | "github.com/rs/zerolog/log"
12 | "os"
13 | "reflect"
14 | "sort"
15 | "strings"
16 | )
17 |
18 | var (
19 | trueBool = true
20 | parameterType = "SecureString"
21 | ErrNameNotFound = errors.New("Name not found")
22 | )
23 |
24 | type Flags struct {
25 | Export bool
26 | InJson bool
27 | OutJson bool
28 | Upper bool
29 | Quote bool
30 | Dry bool
31 | Recursive bool
32 | PrefixPath bool
33 | PrefixNormalizedPath bool
34 | }
35 |
36 | type AWSSSM struct {
37 | session *session.Session
38 | SSM ssmiface.SSMAPI
39 | }
40 |
41 | func IsPath(param *string) (bool, error) {
42 | if strings.Contains(*param, ",") {
43 | log.Error().Msgf("Parameter is unsplitted, contains a colon: %s", *param)
44 | return false, errors.New("Parameter is unsplitted, contains a colon")
45 | }
46 | if strings.Contains(*param, "/") {
47 | return true, nil
48 | }
49 | return false, nil
50 | }
51 |
52 | func SplitParams(param *string) []string {
53 | if *param != "" {
54 | return strings.Split(*param, ",")
55 | }
56 |
57 | return []string{}
58 | }
59 |
60 | func NewSSM() *AWSSSM {
61 | // initialize aws SSM
62 | session := session.Must(session.NewSessionWithOptions(session.Options{
63 | SharedConfigState: session.SharedConfigEnable,
64 | }))
65 |
66 | SSM := ssm.New(session)
67 |
68 | return &AWSSSM{
69 | session: session,
70 | SSM: SSM,
71 | }
72 | }
73 |
74 | func getNameAndValue(param *ssm.Parameter, flags Flags) (string, string, error) {
75 | if flags.PrefixPath {
76 | return getUpper(*param.Name, flags), *param.Value, nil
77 | } else if flags.PrefixNormalizedPath {
78 | prefixPath := getUpper(*param.Name, flags)
79 | // remove first occurrence
80 | normalizedPath := strings.Replace(prefixPath, "/", "", 1)
81 | normalizedPath = strings.ReplaceAll(normalizedPath, "/", "_")
82 | return normalizedPath, *param.Value, nil
83 | } else {
84 | split := strings.Split(*param.Name, "/")
85 | name := split[len(split)-1]
86 | return getUpper(name, flags), *param.Value, nil
87 | }
88 | }
89 |
90 | func chunkParamNames(paramNames []*string, chunkSize int) [][]*string {
91 | var chunks [][]*string
92 | for i := 0; i < len(paramNames); i += chunkSize {
93 | end := i + chunkSize
94 | if end > len(paramNames) {
95 | end = len(paramNames)
96 | }
97 |
98 | chunks = append(chunks, paramNames[i:end])
99 | }
100 |
101 | return chunks
102 | }
103 |
104 | func (f *AWSSSM) GetParametersByPath(paths []string, flags Flags) (map[string]string, error) {
105 | params := make(map[string]string)
106 |
107 | // retrieve params for all paths
108 | for _, path := range paths {
109 | log.Debug().Msgf("Retrieving Path: %s", path)
110 |
111 | done := false
112 | var nextToken string
113 | for !done {
114 | input := &ssm.GetParametersByPathInput{
115 | Path: &path,
116 | Recursive: &flags.Recursive,
117 | WithDecryption: &trueBool,
118 | }
119 |
120 | if nextToken != "" {
121 | input.SetNextToken(nextToken)
122 | }
123 |
124 | output, err := f.SSM.GetParametersByPath(input)
125 | if err != nil {
126 | return params, err
127 | }
128 | log.Debug().Msgf("Retrieved Parameters for path %s: %s", path, output.Parameters)
129 | if len(output.Parameters) == 0 {
130 | // if no parameters are found, try to get the parameter as a single value
131 | inputSingle := &ssm.GetParameterInput{
132 | Name: &path,
133 | WithDecryption: &trueBool,
134 | }
135 | outputSingle, err := f.SSM.GetParameter(inputSingle)
136 | if err != nil {
137 | // if this also fails, no path or parameter on path exists
138 | log.Error().Msgf("No names found for path: %s", path)
139 | return params, ErrNameNotFound
140 | }
141 | nameSingle, value, _ := getNameAndValue(outputSingle.Parameter, flags)
142 | log.Debug().Msgf("Retrieved Parameter for %s: %s", path, nameSingle)
143 | params[nameSingle] = value
144 | break
145 | }
146 |
147 | for _, param := range output.Parameters {
148 | name, value, _ := getNameAndValue(param, flags)
149 | log.Debug().Msgf("Name: %s Value %s", name, value)
150 | params[name] = value
151 | }
152 |
153 | // if nextToken has a value, there are more parameters to fetch. maximum is 10 parameters at a time.
154 | if output.NextToken != nil {
155 | nextToken = *output.NextToken
156 | } else {
157 | done = true
158 | }
159 | }
160 | }
161 |
162 | return params, nil
163 | }
164 |
165 | func (f *AWSSSM) GetParameters(ssmnames []*string, flags Flags) (map[string]string, error) {
166 | params := make(map[string]string)
167 |
168 | // GetParameters only supports at max of 10 params
169 | chunks := chunkParamNames(ssmnames, 10)
170 |
171 | // retrieve listed param names
172 | for _, chunk := range chunks {
173 | chunkNames := ""
174 | for _, name := range chunk {
175 | log.Debug().Msgf("Retrieving Name: %s", *name)
176 | chunkNames += fmt.Sprintf("%s ", *name)
177 | }
178 |
179 | input := &ssm.GetParametersInput{
180 | Names: chunk,
181 | WithDecryption: &trueBool,
182 | }
183 |
184 | output, err := f.SSM.GetParameters(input)
185 | if err != nil {
186 | return params, err
187 | }
188 | if len(output.Parameters) == 0 {
189 | log.Error().Msgf("None of the Names was found: %s", chunkNames)
190 | return params, ErrNameNotFound
191 | }
192 | log.Debug().Msgf("Retrieved Parameters: %s", output.Parameters)
193 |
194 | for _, param := range output.Parameters {
195 | name, value, _ := getNameAndValue(param, flags)
196 | log.Debug().Msgf("NAME: %s VALUE: %s", name, value)
197 | params[name] = value
198 | }
199 | }
200 |
201 | return params, nil
202 | }
203 |
204 | func (f *AWSSSM) ReadParametersFromFile(fileName string, path string, flags Flags) (map[string]string, error) {
205 | params := make(map[string]string)
206 |
207 | if path != "" {
208 | isPath, err := IsPath(&path)
209 | if err != nil {
210 | log.Error().Msg(err.Error())
211 | return params, err
212 | }
213 | if !isPath {
214 | log.Error().Msgf("Target is not a path: %s", path)
215 | return params, errors.New("Target is not a path")
216 | }
217 | }
218 |
219 | if flags.InJson {
220 | dat, err := os.ReadFile(fileName)
221 | if err != nil {
222 | log.Error().Msg(err.Error())
223 | return params, err
224 | }
225 | params, err = ExpandJson(string(dat))
226 | if err != nil {
227 | log.Error().Msg(err.Error())
228 | return params, err
229 | }
230 | } else {
231 | file, err := os.Open(fileName)
232 | if err != nil {
233 | log.Error().Msg(err.Error())
234 | return params, err
235 | }
236 | defer file.Close()
237 |
238 | scanner := bufio.NewScanner(file)
239 | for scanner.Scan() {
240 | log.Debug().Msgf("READ LINE: %s", scanner.Text())
241 | if strings.Index(scanner.Text(), "=") < 1 {
242 | log.Info().Msgf("Ignoring line: %s", scanner.Text())
243 | } else {
244 | data := strings.SplitN(scanner.Text(), "=", 2)
245 | name := data[0]
246 | value := data[1]
247 | if name != "" {
248 | log.Debug().Msgf("NAME: %s VALUE: %s", name, value)
249 | params[name] = value
250 | } else {
251 | log.Info().Msgf("Ignoring line: %s", scanner.Text())
252 | }
253 | }
254 | }
255 | if err := scanner.Err(); err != nil {
256 | log.Error().Msg(err.Error())
257 | return params, err
258 | }
259 | }
260 | return params, nil
261 | }
262 |
263 | func (f *AWSSSM) SaveParametersFromFile(fileName string, basePath string, flags Flags) error {
264 | params, err := f.ReadParametersFromFile(fileName, basePath, flags)
265 | if err != nil {
266 | log.Error().Msg(err.Error())
267 | return err
268 | }
269 | if flags.Dry {
270 | prefix := ""
271 | if basePath != "" {
272 | prefix = basePath + "/"
273 | }
274 | result := OutputParamsAsString(params, prefix, flags)
275 | fmt.Println("### Dry run, not saving, this would have been set:")
276 | fmt.Println(result)
277 | return nil
278 | }
279 | return f.SaveParameters(params, basePath)
280 | }
281 |
282 | func (f *AWSSSM) SaveParameters(params map[string]string, basePath string) error {
283 | var names []string
284 | for param := range params {
285 | names = append(names, param)
286 | }
287 | sort.Strings(names)
288 | for _, rawName := range names {
289 | paramName := rawName
290 | // construct a path if neccessary
291 | if basePath != "" {
292 | paramName = fmt.Sprintf("%s/%s", basePath, rawName)
293 | }
294 | value := params[rawName]
295 | fmt.Printf("%s=%s\n", paramName, value)
296 | input := &ssm.PutParameterInput{
297 | Name: ¶mName,
298 | Value: &value,
299 | Overwrite: &trueBool,
300 | Type: ¶meterType,
301 | }
302 |
303 | output, err := f.SSM.PutParameter(input)
304 | if err != nil {
305 | return err
306 | }
307 | log.Info().Msgf("Output: %s", output)
308 | }
309 |
310 | return nil
311 | }
312 |
313 | func GetSortedNamesFromParams(params map[string]string) []string {
314 | var names []string
315 | for param := range params {
316 | names = append(names, param)
317 | }
318 | sort.Strings(names)
319 | return names
320 | }
321 |
322 | // outputs the parameters as string sorted by name
323 | func OutputParamsAsString(params map[string]string, prefix string, flags Flags) string {
324 | names := GetSortedNamesFromParams(params)
325 | var result = ""
326 | for _, name := range names {
327 | if flags.Quote {
328 | result += fmt.Sprintf("%s%s=\"%s\"\n", prefix, name, params[name])
329 | } else {
330 | result += fmt.Sprintf("%s%s=%s\n", prefix, name, params[name])
331 | }
332 | }
333 | return result
334 | }
335 |
336 | func ExpandJson(value string) (map[string]string, error) {
337 | result := make(map[string]string)
338 |
339 | log.Debug().Str("json", value).Msg("ExpandJson")
340 | jsonMap := make(map[string]interface{})
341 | err := json.Unmarshal([]byte(value), &jsonMap)
342 | if err != nil {
343 | log.Error().Msgf("Error unmarshalling json: %s", err.Error())
344 | return nil, err
345 | }
346 | for jkey := range jsonMap {
347 | valueType := reflect.TypeOf(jsonMap[jkey])
348 | log.Debug().Str("jkey", jkey).Interface("jsonMap[jkey]", jsonMap[jkey]).Interface("valueType", valueType).Msg("ExpandJson jsonMap")
349 | switch jsonMap[jkey].(type) {
350 | case int, int8, int16, int32, int64:
351 | result[jkey] = fmt.Sprintf("%v", jsonMap[jkey])
352 | case float32, float64:
353 | // Integer "0" and float "0.0" result in a float type and hence are
354 | // indistinguishable here, and output as integer
355 | result[jkey] = fmt.Sprintf("%v", jsonMap[jkey])
356 | case bool:
357 | result[jkey] = fmt.Sprintf("%t", jsonMap[jkey])
358 | default:
359 | result[jkey] = fmt.Sprintf("%s", jsonMap[jkey])
360 | }
361 | }
362 | return result, nil
363 | }
364 |
365 | func ExpandJsonParams(params map[string]string, flags Flags) (map[string]string, error) {
366 | result := make(map[string]string)
367 |
368 | for name, value := range params {
369 | log.Debug().Str("name", name).Msg("ExpandJsonParams")
370 |
371 | valueMap, err := ExpandJson(value)
372 | if err != nil {
373 | log.Error().Msgf("Error unmarshalling ssm parameter: %s / %s", name, err.Error())
374 | return nil, err
375 | }
376 | for jkey := range valueMap {
377 | resultKey := getUpper(jkey, flags)
378 | log.Debug().Msgf("valueMap: %s = %s", jkey, valueMap[jkey])
379 | result[resultKey] = fmt.Sprintf("%s", valueMap[jkey])
380 | }
381 | }
382 | return result, nil
383 | }
384 |
385 | func getUpper(param string, flags Flags) string {
386 | if flags.Upper {
387 | return strings.ToUpper(param)
388 | }
389 | return param
390 | }
391 |
392 | func (f *AWSSSM) GetParams(paramstring *string, flags Flags) (map[string]string, error) {
393 | results := make(map[string]string)
394 |
395 | params := SplitParams(paramstring)
396 | paramNames := make([]*string, 0)
397 | pathNames := make([]string, 0)
398 |
399 | for index := range params {
400 | parameter := params[index]
401 | isPath, err := IsPath(¶meter)
402 | if err != nil {
403 | log.Error().Msg(err.Error())
404 | return results, err
405 | }
406 | if isPath {
407 | pathNames = append(pathNames, parameter)
408 | log.Debug().Msgf("Parameter Path: %s", parameter)
409 | } else {
410 | paramNames = append(paramNames, ¶meter)
411 | log.Debug().Msgf("Parameter Name: %s", parameter)
412 | }
413 | }
414 |
415 | pathResults, err := f.GetParametersByPath(pathNames, flags)
416 | if err != nil {
417 | log.Error().Msg(err.Error())
418 | return results, err
419 | }
420 |
421 | for name, value := range pathResults {
422 | log.Debug().Msgf("Name: %s Value %s", name, value)
423 | results[name] = value
424 | }
425 |
426 | singleResults, err := f.GetParameters(paramNames, flags)
427 | if err != nil {
428 | log.Error().Msg(err.Error())
429 | return results, err
430 | }
431 |
432 | for name, value := range singleResults {
433 | log.Debug().Msgf("Name: %s Value %s", name, value)
434 | results[name] = value
435 | }
436 |
437 | if flags.InJson {
438 | results, err = ExpandJsonParams(results, flags)
439 | if err != nil {
440 | log.Error().Msg(err.Error())
441 | return results, err
442 | }
443 | }
444 | return results, nil
445 | }
446 |
447 | func (f *AWSSSM) GetOutputString(results map[string]string, flags Flags) (string, error) {
448 | if flags.Export && flags.OutJson {
449 | log.Error().Msg("--export and --outjson can not be used together")
450 | return "", errors.New("export and outjson can not be used together")
451 | }
452 |
453 | var result string
454 | if flags.OutJson {
455 | json, _ := json.MarshalIndent(results, "", " ")
456 | result = fmt.Sprint(string(json))
457 | } else {
458 | if flags.Export {
459 | result = OutputParamsAsString(results, "export ", flags)
460 | } else {
461 | result = OutputParamsAsString(results, "", flags)
462 | }
463 | }
464 | return result, nil
465 | }
466 |
--------------------------------------------------------------------------------
/pkg/util/awsssm_test.go:
--------------------------------------------------------------------------------
1 | package util
2 |
3 | import (
4 | "fmt"
5 | "github.com/aws/aws-sdk-go/aws"
6 | "github.com/aws/aws-sdk-go/service/ssm"
7 | "github.com/aws/aws-sdk-go/service/ssm/ssmiface"
8 | "github.com/rs/zerolog/log"
9 | "testing"
10 | )
11 |
12 | type MockSSM struct {
13 | ssmiface.SSMAPI
14 | err error
15 | }
16 |
17 | func nameString(parameter ssm.GetParametersInput) string {
18 | result := "["
19 | for i, param := range parameter.Names {
20 | if i > 0 {
21 | result += ", "
22 | }
23 | result += fmt.Sprintf("%s", *param)
24 | }
25 | return result + "]"
26 | }
27 |
28 | func (sp *MockSSM) GetParameter(input *ssm.GetParameterInput) (*ssm.GetParameterOutput, error) {
29 | output := new(ssm.GetParameterOutput)
30 | log.Info().Msgf("%s", *input.Name)
31 | if *input.Name == "/path2/One1" {
32 | name1 := "One1"
33 | output.Parameter = &ssm.Parameter{Name: &name1, Value: aws.String("OneVal1")}
34 | }
35 | return output, sp.err
36 | }
37 |
38 | func (sp *MockSSM) GetParameters(input *ssm.GetParametersInput) (*ssm.GetParametersOutput, error) {
39 | output := new(ssm.GetParametersOutput)
40 | log.Info().Msgf("%s", nameString(*input))
41 | if nameString(*input) == "[One1]" {
42 | name1 := "One1"
43 | output.Parameters = append(output.Parameters, &ssm.Parameter{Name: &name1, Value: aws.String("OneVal1")})
44 | }
45 | if nameString(*input) == "[One2]" {
46 | name1 := "One2"
47 | output.Parameters = append(output.Parameters, &ssm.Parameter{Name: &name1, Value: aws.String("OneVal2")})
48 | }
49 | if nameString(*input) == "[One1, One2]" {
50 | name1 := "One1"
51 | name2 := "One2"
52 | output.Parameters = append(output.Parameters, &ssm.Parameter{Name: &name1, Value: aws.String("OneVal1")})
53 | output.Parameters = append(output.Parameters, &ssm.Parameter{Name: &name2, Value: aws.String("OneVal2")})
54 | }
55 | if nameString(*input) == "[Three1, Three2]" {
56 | name1 := "Three1"
57 | name2 := "Three2"
58 | output.Parameters = append(output.Parameters, &ssm.Parameter{Name: &name1, Value: aws.String("ThreeVal1")})
59 | output.Parameters = append(output.Parameters, &ssm.Parameter{Name: &name2, Value: aws.String("ThreeVal2")})
60 | }
61 | if nameString(*input) == "[Num0]" {
62 | name1 := "Num0"
63 | output.Parameters = append(output.Parameters, &ssm.Parameter{Name: &name1, Value: aws.String("0")})
64 | }
65 | if nameString(*input) == "[Json]" {
66 | name1 := "Json"
67 | output.Parameters = append(output.Parameters, &ssm.Parameter{Name: &name1, Value: aws.String("{\"Str\": \"0\",\"Int\": 0,\"Int123\": 123}")})
68 | }
69 | if nameString(*input) == "[Json2]" {
70 | name1 := "Json2"
71 | output.Parameters = append(output.Parameters, &ssm.Parameter{Name: &name1, Value: aws.String("{\"Bool\": true}")})
72 | }
73 | return output, sp.err
74 | }
75 |
76 | func (sp *MockSSM) GetParametersByPath(input *ssm.GetParametersByPathInput) (*ssm.GetParametersByPathOutput, error) {
77 | output := new(ssm.GetParametersByPathOutput)
78 | params := make([]*ssm.Parameter, 0)
79 | if *input.Path == "/path" {
80 | params = append(params, &ssm.Parameter{Name: aws.String("/path/One1"), Value: aws.String("OneVal1")})
81 | }
82 | if *input.Path == "/path2" {
83 | params = append(params, &ssm.Parameter{Name: aws.String("/path2/One1"), Value: aws.String("OneVal1")})
84 | params = append(params, &ssm.Parameter{Name: aws.String("/path2/One2"), Value: aws.String("OneVal2")})
85 | }
86 | if *input.Path == "/path3" {
87 | params = append(params, &ssm.Parameter{Name: aws.String("/path3/Name3"), Value: aws.String("Val3")})
88 | }
89 | if *input.Path == "/path3/sub" {
90 | params = append(params, &ssm.Parameter{Name: aws.String("/path3/sub/NameSub"), Value: aws.String("SubVal")})
91 | }
92 | if *input.Recursive {
93 | if *input.Path == "/path3" {
94 | params = append(params, &ssm.Parameter{Name: aws.String("/path3/sub/NameSub"), Value: aws.String("SubVal")})
95 | }
96 | }
97 | output.Parameters = params
98 | return output, sp.err
99 | }
100 |
101 | func Test_IsPath(t *testing.T) {
102 | tests := []struct {
103 | name string
104 | want bool
105 | }{
106 | {
107 | name: "/path",
108 | want: true,
109 | },
110 | {
111 | name: "nopath",
112 | want: false,
113 | },
114 | }
115 | for _, tt := range tests {
116 | t.Run(tt.name, func(t *testing.T) {
117 | result, err := IsPath(&tt.name)
118 | t.Logf("%t", result)
119 | if err != nil {
120 | t.Error("Error in IsPath")
121 | }
122 | if result != tt.want {
123 | t.Errorf("Expected %t but got %t", tt.want, result)
124 | }
125 | })
126 | }
127 | }
128 |
129 | func Test_SplitParams(t *testing.T) {
130 | tests := []struct {
131 | name string
132 | want interface{}
133 | }{
134 | {
135 | name: "/path",
136 | want: [...]string{"/path"},
137 | },
138 | {
139 | name: "nopath",
140 | want: [...]string{"nopath"},
141 | },
142 | {
143 | name: "/path,single",
144 | want: [...]string{"/path", "single"},
145 | },
146 | {
147 | name: "/path,single,/path2",
148 | want: [...]string{"/path", "single", "/path2"},
149 | },
150 | }
151 | for _, tt := range tests {
152 | t.Run(tt.name, func(t *testing.T) {
153 | result := SplitParams(&tt.name)
154 | t.Logf("%s", result)
155 | t.Logf("%s", tt.want)
156 | resultStr := fmt.Sprintf("%s", result)
157 | wantStr := fmt.Sprintf("%s", tt.want)
158 | if resultStr != wantStr {
159 | t.Errorf("Expected %s but got %s", tt.want, result)
160 | }
161 | })
162 | }
163 | }
164 |
165 | func Test_ExpandJson(t *testing.T) {
166 | value := `{"Name1":"Alice","Name2":"Bob"}`
167 | tests := []struct {
168 | name string
169 | want string
170 | }{
171 | {
172 | name: "Name1",
173 | want: "Alice",
174 | },
175 | {
176 | name: "Name2",
177 | want: "Bob",
178 | },
179 | }
180 | result, err := ExpandJson(value)
181 | if err != nil {
182 | t.Error("Error expanding json")
183 | }
184 | t.Logf("%s", result)
185 | for _, tt := range tests {
186 | t.Run(tt.name, func(t *testing.T) {
187 | if result[tt.name] != tt.want {
188 | t.Errorf("Expected %s but got %s", tt.want, result[tt.name])
189 | }
190 | })
191 | }
192 | }
193 |
194 | func Test_ExpandJsonParams(t *testing.T) {
195 | input := make(map[string]string)
196 | input["one"] = `{"One1":"OneVal1","One2":"OneVal2"}`
197 | input["two"] = `{"Two1":"TwoVal1","Two2":"TwoVal2"}`
198 |
199 | tests := []struct {
200 | name string
201 | upper bool
202 | want string
203 | }{
204 | {
205 | name: "One1",
206 | upper: false,
207 | want: "OneVal1",
208 | },
209 | {
210 | name: "ONE1",
211 | upper: true,
212 | want: "OneVal1",
213 | },
214 | {
215 | name: "One2",
216 | upper: false,
217 | want: "OneVal2",
218 | },
219 | {
220 | name: "ONE2",
221 | upper: true,
222 | want: "OneVal2",
223 | },
224 | {
225 | name: "Two1",
226 | upper: false,
227 | want: "TwoVal1",
228 | },
229 | {
230 | name: "Two2",
231 | upper: false,
232 | want: "TwoVal2",
233 | },
234 | }
235 | for _, tt := range tests {
236 | flags := Flags{
237 | false,
238 | false,
239 | false,
240 | tt.upper,
241 | false,
242 | false,
243 | true,
244 | false,
245 | false,
246 | }
247 | result, err := ExpandJsonParams(input, flags)
248 | if err != nil {
249 | t.Error("Error expanding json Params")
250 | }
251 | t.Logf("%s", result)
252 | t.Run(tt.name, func(t *testing.T) {
253 | if result[tt.name] != tt.want {
254 | t.Errorf("Expected %s but got %s", tt.want, result[tt.name])
255 | }
256 | })
257 | }
258 | }
259 |
260 | func Test_GetParams(t *testing.T) {
261 | input := make(map[string]string)
262 | input["One"] = `{"One1":"OneVal1","One2":"OneVal2"}`
263 | input["Two"] = `{"Two1":"TwoVal1","Two2":"TwoVal2"}`
264 | tests := []struct {
265 | params string
266 | flags Flags
267 | want string
268 | }{
269 | {
270 | params: "/path",
271 | flags: Flags{
272 | false,
273 | false,
274 | false,
275 | true,
276 | false,
277 | false,
278 | true,
279 | false,
280 | false,
281 | },
282 | want: "ONE1=OneVal1\n",
283 | },
284 | {
285 | params: "/path",
286 | flags: Flags{
287 | false,
288 | false,
289 | false,
290 | false,
291 | false,
292 | false,
293 | true,
294 | false,
295 | false,
296 | },
297 | want: "One1=OneVal1\n",
298 | },
299 | {
300 | params: "/path,/path2",
301 | flags: Flags{
302 | false,
303 | false,
304 | false,
305 | true,
306 | false,
307 | false,
308 | true,
309 | false,
310 | false,
311 | },
312 | want: "ONE1=OneVal1\nONE2=OneVal2\n",
313 | },
314 | {
315 | params: "/path2/One1,/path3",
316 | flags: Flags{
317 | false,
318 | false,
319 | false,
320 | true,
321 | false,
322 | false,
323 | true,
324 | false,
325 | false,
326 | },
327 | want: "NAME3=Val3\nNAMESUB=SubVal\nONE1=OneVal1\n",
328 | },
329 | {
330 | params: "One1",
331 | flags: Flags{
332 | false,
333 | false,
334 | false,
335 | true,
336 | false,
337 | false,
338 | true,
339 | false,
340 | false,
341 | },
342 | want: "ONE1=OneVal1\n",
343 | },
344 | {
345 | params: "One1,One2",
346 | flags: Flags{
347 | false,
348 | false,
349 | false,
350 | true,
351 | false,
352 | false,
353 | true,
354 | false,
355 | false,
356 | },
357 | want: "ONE1=OneVal1\nONE2=OneVal2\n",
358 | },
359 | {
360 | params: "/path,Three1,Three2,/path2",
361 | flags: Flags{
362 | false,
363 | false,
364 | false,
365 | true,
366 | false,
367 | false,
368 | true,
369 | false,
370 | false,
371 | },
372 | want: "ONE1=OneVal1\nONE2=OneVal2\nTHREE1=ThreeVal1\nTHREE2=ThreeVal2\n",
373 | },
374 | {
375 | params: "/path,Three1,Three2,/path2",
376 | flags: Flags{
377 | false,
378 | false,
379 | false,
380 | false,
381 | false,
382 | false,
383 | true,
384 | false,
385 | false,
386 | },
387 | want: "One1=OneVal1\nOne2=OneVal2\nThree1=ThreeVal1\nThree2=ThreeVal2\n",
388 | },
389 | {
390 | params: "/path,Three1,Three2,/path2",
391 | flags: Flags{
392 | false,
393 | false,
394 | false,
395 | false,
396 | true,
397 | false,
398 | true,
399 | false,
400 | false,
401 | },
402 | want: "One1=\"OneVal1\"\nOne2=\"OneVal2\"\nThree1=\"ThreeVal1\"\nThree2=\"ThreeVal2\"\n",
403 | },
404 | {
405 | params: "Num0",
406 | flags: Flags{
407 | false,
408 | false,
409 | false,
410 | true,
411 | false,
412 | false,
413 | true,
414 | false,
415 | false,
416 | },
417 | want: "NUM0=0\n",
418 | },
419 | {
420 | params: "Json",
421 | flags: Flags{
422 | false,
423 | true,
424 | false,
425 | true,
426 | false,
427 | false,
428 | true,
429 | false,
430 | false,
431 | },
432 | want: "INT=0\nINT123=123\nSTR=0\n",
433 | },
434 | {
435 | params: "Json2",
436 | flags: Flags{
437 | false,
438 | true,
439 | false,
440 | true,
441 | false,
442 | false,
443 | true,
444 | false,
445 | false,
446 | },
447 | want: "BOOL=true\n",
448 | },
449 | {
450 | params: "/path3",
451 | flags: Flags{
452 | false,
453 | false,
454 | false,
455 | true,
456 | false,
457 | false,
458 | true,
459 | false,
460 | false,
461 | },
462 | want: "NAME3=Val3\nNAMESUB=SubVal\n",
463 | },
464 | {
465 | params: "/path3",
466 | flags: Flags{
467 | false,
468 | false,
469 | false,
470 | true,
471 | false,
472 | false,
473 | false,
474 | false,
475 | false,
476 | },
477 | want: "NAME3=Val3\n",
478 | },
479 | {
480 | params: "/path3",
481 | flags: Flags{
482 | false,
483 | false,
484 | false,
485 | false,
486 | false,
487 | false,
488 | true,
489 | true,
490 | false,
491 | },
492 | want: "/path3/Name3=Val3\n/path3/sub/NameSub=SubVal\n",
493 | },
494 | {
495 | params: "/path3",
496 | flags: Flags{
497 | false,
498 | false,
499 | true,
500 | false,
501 | false,
502 | false,
503 | true,
504 | true,
505 | false,
506 | },
507 | want: "{\n \"/path3/Name3\": \"Val3\",\n \"/path3/sub/NameSub\": \"SubVal\"\n}",
508 | },
509 | {
510 | params: "/path3",
511 | flags: Flags{
512 | false,
513 | false,
514 | false,
515 | false,
516 | false,
517 | false,
518 | true,
519 | false,
520 | true,
521 | },
522 | want: "path3_Name3=Val3\npath3_sub_NameSub=SubVal\n",
523 | },
524 | {
525 | params: "/path3",
526 | flags: Flags{
527 | false,
528 | false,
529 | true,
530 | false,
531 | false,
532 | false,
533 | true,
534 | false,
535 | true,
536 | },
537 | want: "{\n \"path3_Name3\": \"Val3\",\n \"path3_sub_NameSub\": \"SubVal\"\n}",
538 | },
539 | }
540 | for _, tt := range tests {
541 | t.Run(tt.params, func(t *testing.T) {
542 | ssmClient := NewSSM()
543 | ssmClient.SSM = &MockSSM{
544 | err: nil, //errors.New("my custom error"),
545 | }
546 | result, err := ssmClient.GetParams(&tt.params, tt.flags)
547 | if err != nil {
548 | t.Error("Error in GetParams")
549 | }
550 | output, err := ssmClient.GetOutputString(result, tt.flags)
551 | outputStr := fmt.Sprintf("%s", output)
552 | wantStr := fmt.Sprintf("%s", tt.want)
553 | if outputStr != wantStr {
554 | fmt.Println("# Expected:")
555 | fmt.Println(wantStr)
556 | fmt.Println("# Output:")
557 | fmt.Println(output)
558 | t.Errorf("Expected '%s' but got '%s'", tt.want, output)
559 | }
560 | })
561 | }
562 | }
563 |
564 | func Test_ReadParametersFromFile(t *testing.T) {
565 | tests := []struct {
566 | fileName string
567 | basePath string
568 | flags Flags
569 | want string
570 | }{
571 | {
572 | fileName: "test.env",
573 | basePath: "/saveTest",
574 | flags: Flags{
575 | false,
576 | false,
577 | false,
578 | false,
579 | false,
580 | true,
581 | true,
582 | false,
583 | false,
584 | },
585 | want: "One1=Value1\nOne2=Value2\n",
586 | },
587 | }
588 | for _, tt := range tests {
589 | t.Run(tt.fileName, func(t *testing.T) {
590 | ssmClient := NewSSM()
591 | ssmClient.SSM = &MockSSM{
592 | err: nil, //errors.New("my custom error"),
593 | }
594 | params, err := ssmClient.ReadParametersFromFile(tt.fileName, tt.basePath, tt.flags)
595 | if err != nil {
596 | t.Error("Error in ReadParametersFromFile")
597 | }
598 | output, err := ssmClient.GetOutputString(params, tt.flags)
599 | outputStr := fmt.Sprintf("%s", output)
600 | wantStr := fmt.Sprintf("%s", tt.want)
601 | if outputStr != wantStr {
602 | fmt.Println("# Expected:")
603 | fmt.Println(wantStr)
604 | fmt.Println("# Output:")
605 | fmt.Println(output)
606 | t.Errorf("Expected '%s' but got '%s'", tt.want, output)
607 | }
608 | })
609 | }
610 | }
611 |
--------------------------------------------------------------------------------
/pkg/util/test.env:
--------------------------------------------------------------------------------
1 | One1=Value1
2 | One2=Value2
3 | =Error
4 |
5 |
--------------------------------------------------------------------------------
/server/handlers.go:
--------------------------------------------------------------------------------
1 | package server
2 |
3 | import (
4 | "github.com/gork74/aws-parameter-bulk/pkg/forms"
5 | "github.com/gork74/aws-parameter-bulk/pkg/models"
6 | "github.com/gork74/aws-parameter-bulk/pkg/util"
7 | "net/http"
8 | "strings"
9 | )
10 |
11 | func (app *application) home(w http.ResponseWriter, r *http.Request) {
12 | view := &templateData{}
13 | if app.session.Get(r.Context(), "view") == nil {
14 | app.logger.Info().Msg("view is nil")
15 | view = &templateData{
16 | Form: forms.New(nil),
17 | NamesLeft: "",
18 | Different: false,
19 | NamesRight: "",
20 | Compare: make([]models.ValueCompare, 0),
21 | }
22 | app.session.Put(r.Context(), "view", view)
23 | } else {
24 | app.logger.Info().Msg("loading view")
25 | viewSess := app.session.Get(r.Context(), "view")
26 | view = viewSess.(*templateData)
27 | view.Compare = updateCompares(view.Compare)
28 | }
29 | app.render(w, r, "home.page.tmpl", view)
30 | }
31 |
32 | func (app *application) postReset(w http.ResponseWriter, r *http.Request) {
33 | app.logger.Info().Msg("resetting view")
34 | view := &templateData{
35 | Form: forms.New(nil),
36 | NamesLeft: "",
37 | JsonLeft: false,
38 | Different: false,
39 | NamesRight: "",
40 | JsonRight: false,
41 | Compare: make([]models.ValueCompare, 0),
42 | }
43 | app.session.Put(r.Context(), "view", view)
44 | app.render(w, r, "home.page.tmpl", view)
45 | }
46 |
47 | func (app *application) postHome(w http.ResponseWriter, r *http.Request) {
48 | err := r.ParseForm()
49 | if err != nil {
50 | app.clientError(w, http.StatusBadRequest)
51 | app.logger.Error().Msgf("Error parsing form: %s", err)
52 | return
53 | }
54 | jsonLeft := false
55 | jsonRight := false
56 | recursiveLeft := false
57 | recursiveRight := false
58 |
59 | form := forms.New(r.PostForm)
60 | form.Required("namesleft")
61 | namesLeft := strings.TrimSpace(form.Get("namesleft"))
62 | namesRight := strings.TrimSpace(form.Get("namesright"))
63 | jsonLeftFlag := form.Get("jsonleft")
64 | recursiveLeftFlag := form.Get("recursiveleft")
65 | jsonRightFlag := form.Get("jsonright")
66 | recursiveRightFlag := form.Get("recursiveright")
67 | if jsonLeftFlag == "on" {
68 | jsonLeft = true
69 | }
70 | if recursiveLeftFlag == "on" {
71 | recursiveLeft = true
72 | }
73 | if jsonRightFlag == "on" {
74 | jsonRight = true
75 | }
76 | if recursiveRightFlag == "on" {
77 | recursiveRight = true
78 | }
79 | flagsLeft := util.Flags{
80 | false,
81 | jsonLeft,
82 | false,
83 | false,
84 | false,
85 | false,
86 | recursiveLeft,
87 | false,
88 | false,
89 | }
90 | flagsRight := util.Flags{
91 | false,
92 | jsonRight,
93 | false,
94 | false,
95 | false,
96 | false,
97 | recursiveRight,
98 | false,
99 | false,
100 | }
101 |
102 | app.logger.Debug().Msgf("Namesright: '%s'", namesRight)
103 | app.logger.Debug().Msgf("JsonLeft: '%s'", jsonLeftFlag)
104 | app.logger.Debug().Msgf("JsonRight: '%s'", jsonRightFlag)
105 |
106 | // If there are any errors, redisplay the form.
107 | if !form.Valid() {
108 | app.logger.Error().Msgf("Names not valid")
109 | if err != nil {
110 | app.session.Put(r.Context(), "flasherror", "Error reading template data")
111 | app.render(w, r, "error.page.tmpl", &templateData{})
112 | return
113 | }
114 | app.session.Put(r.Context(), "flasherror", "Names not valid")
115 |
116 | app.render(w, r, "home.page.tmpl", &templateData{Form: form})
117 | return
118 | }
119 |
120 | resultLeft, err := app.ssmClient.GetParams(&namesLeft, flagsLeft)
121 | if err != nil {
122 | app.logger.Error().Msg(err.Error())
123 | app.session.Put(r.Context(), "flasherror", "Error reading values from the left side input: "+err.Error())
124 | app.render(w, r, "error.page.tmpl", &templateData{})
125 | return
126 | }
127 |
128 | sortedLeftNames := util.GetSortedNamesFromParams(resultLeft)
129 |
130 | compares := make([]models.ValueCompare, 0)
131 |
132 | for _, name := range sortedLeftNames {
133 | value := resultLeft[name]
134 | compare := models.ValueCompare{
135 | LeftName: name,
136 | LeftOriginal: value,
137 | LeftValue: value,
138 | Different: false,
139 | }
140 | compares = append(compares, compare)
141 | }
142 |
143 | if namesRight != "" {
144 | resultRight, err := app.ssmClient.GetParams(&namesRight, flagsRight)
145 | if err != nil {
146 | app.logger.Error().Msg(err.Error())
147 | app.session.Put(r.Context(), "flasherror", "Error reading values from the right side input: "+err.Error())
148 | app.render(w, r, "error.page.tmpl", &templateData{})
149 | return
150 | }
151 |
152 | sortedRightNames := util.GetSortedNamesFromParams(resultRight)
153 |
154 | index := 0
155 | for _, name := range sortedRightNames {
156 | value := resultRight[name]
157 | compare := models.ValueCompare{
158 | RightName: name,
159 | RightOriginal: value,
160 | RightValue: value,
161 | Different: false,
162 | }
163 | if index < len(compares) {
164 | compares[index].RightName = name
165 | compares[index].RightOriginal = value
166 | compares[index].RightValue = value
167 | } else {
168 | compares = append(compares, compare)
169 | }
170 | index++
171 | }
172 | }
173 |
174 | view := &templateData{
175 | Form: form,
176 | NamesLeft: namesLeft,
177 | JsonLeft: jsonLeft,
178 | NamesRight: namesRight,
179 | JsonRight: jsonRight,
180 | Compare: compares,
181 | }
182 | view.Compare = updateCompares(view.Compare)
183 | app.session.Put(r.Context(), "view", view)
184 | app.render(w, r, "home.page.tmpl", view)
185 | return
186 | }
187 |
188 | func updateCompares(compares []models.ValueCompare) []models.ValueCompare {
189 | result := make([]models.ValueCompare, 0)
190 | for _, originalCompare := range compares {
191 | compare := originalCompare
192 | compare.Different = compare.RightOriginal != compare.LeftOriginal
193 | result = append(result, compare)
194 | }
195 | return result
196 | }
197 |
--------------------------------------------------------------------------------
/server/handlers_test.go:
--------------------------------------------------------------------------------
1 | package server
2 |
3 | import (
4 | "bytes"
5 | "net/http"
6 | "net/url"
7 | "testing"
8 | )
9 |
10 | func Test_application_getHome(t *testing.T) {
11 | app := newTestApplication(t)
12 | ts := newTestServer(t, app.routes())
13 | defer ts.Close()
14 |
15 | tests := []struct {
16 | name string
17 | wantCode int
18 | wantBody []byte
19 | }{
20 | {"Get home", http.StatusOK, []byte("Load and Compare")},
21 | }
22 |
23 | for _, tt := range tests {
24 | t.Run(tt.name, func(t *testing.T) {
25 |
26 | code, _, body := ts.get(t, "/", tt.wantBody != nil)
27 |
28 | if code != tt.wantCode {
29 | t.Errorf("want %d; got %d", tt.wantCode, code)
30 | }
31 |
32 | if tt.wantBody != nil && !bytes.Contains(body, tt.wantBody) {
33 | t.Errorf("want body %s to contain %q", body, tt.wantBody)
34 | }
35 | })
36 | }
37 | }
38 |
39 | func Test_application_postHome(t *testing.T) {
40 | app := newTestApplication(t)
41 | ts := newTestServer(t, app.routes())
42 | defer ts.Close()
43 |
44 | // Make a GET /request and then extract the CSRF token from the
45 | // response body.
46 | _, _, body := ts.get(t, "/", true)
47 | csrfToken := extractCSRFToken(t, body)
48 |
49 | t.Log(csrfToken)
50 |
51 | tests := []struct {
52 | name string
53 | namesleft string
54 | nameright string
55 | jsonleft bool
56 | recursiveleft bool
57 | csrfToken string
58 | wantCode int
59 | wantBody []byte
60 | }{
61 | {"Empty namesleft and namesright", "", "", true, true, csrfToken, http.StatusOK, []byte("Names not valid")},
62 | {"Valid namesleft", "Three1", "", false, true, csrfToken, http.StatusOK, []byte(">ThreeVal1<")},
63 | {"Empty namesleft but namesright", "", "One1", false, true, csrfToken, http.StatusOK, []byte("Names not valid")},
64 | {"Valid namesleft and namesright", "One1", "One2", false, true, csrfToken, http.StatusOK, []byte(">OneVal2<")},
65 | {"Invalid CSRF Token", "One1", "", false, true, "wrongToken", http.StatusBadRequest, nil},
66 | }
67 |
68 | for _, tt := range tests {
69 | t.Run(tt.name, func(t *testing.T) {
70 | form := url.Values{}
71 | form.Add("namesleft", tt.namesleft)
72 | form.Add("namesright", tt.nameright)
73 | form.Add("csrf_token", tt.csrfToken)
74 |
75 | code, _, body := ts.postForm(t, "/", form, tt.wantBody != nil)
76 |
77 | if code != tt.wantCode {
78 | t.Errorf("want %d; got %d", tt.wantCode, code)
79 | }
80 |
81 | if tt.wantBody != nil && !bytes.Contains(body, tt.wantBody) {
82 | t.Errorf("want body %s to contain %q", body, tt.wantBody)
83 | }
84 | })
85 | }
86 | }
87 |
88 | func Test_application_postReset(t *testing.T) {
89 | app := newTestApplication(t)
90 | ts := newTestServer(t, app.routes())
91 | defer ts.Close()
92 |
93 | // Make a GET /request and then extract the CSRF token from the
94 | // response body.
95 | _, _, body := ts.get(t, "/", true)
96 | csrfToken := extractCSRFToken(t, body)
97 |
98 | t.Log(csrfToken)
99 |
100 | tests := []struct {
101 | name string
102 | csrfToken string
103 | wantCode int
104 | wantBody []byte
105 | }{
106 | {"Empty textarea", csrfToken, http.StatusOK, []byte(">")},
107 | {"Invalid CSRF Token", "wrongToken", http.StatusBadRequest, nil},
108 | }
109 |
110 | for _, tt := range tests {
111 | t.Run(tt.name, func(t *testing.T) {
112 | form := url.Values{}
113 | form.Add("csrf_token", tt.csrfToken)
114 |
115 | code, _, body := ts.postForm(t, "/reset", form, tt.wantBody != nil)
116 |
117 | if code != tt.wantCode {
118 | t.Errorf("want %d; got %d", tt.wantCode, code)
119 | }
120 |
121 | if tt.wantBody != nil && !bytes.Contains(body, tt.wantBody) {
122 | t.Errorf("want body %s to contain %q", body, tt.wantBody)
123 | }
124 | })
125 | }
126 | }
127 |
--------------------------------------------------------------------------------
/server/helpers.go:
--------------------------------------------------------------------------------
1 | package server
2 |
3 | import (
4 | "bytes"
5 | "fmt"
6 | "github.com/justinas/nosurf"
7 | "net/http"
8 | "runtime/debug"
9 | )
10 |
11 | func (app *application) serverError(w http.ResponseWriter, err error) {
12 | app.logger.Error().Err(err).Msg(string(debug.Stack()))
13 | http.Error(w, http.StatusText(http.StatusInternalServerError), http.StatusInternalServerError)
14 | }
15 |
16 | func (app *application) clientError(w http.ResponseWriter, status int) {
17 | http.Error(w, http.StatusText(status), status)
18 | }
19 |
20 | func (app *application) addDefaultData(td *templateData, r *http.Request) *templateData {
21 | if td == nil {
22 | td = &templateData{}
23 | }
24 |
25 | // Add the CSRF token to the templateData struct.
26 | td.CSRFToken = nosurf.Token(r)
27 |
28 | // Add the flash message to the template data, if one exists.
29 | td.Flash = app.session.PopString(r.Context(), "flash")
30 | td.FlashError = app.session.PopString(r.Context(), "flasherror")
31 |
32 | return td
33 | }
34 |
35 | func (app *application) render(w http.ResponseWriter, r *http.Request, name string, td *templateData) {
36 | ts, ok := app.templateCache[name]
37 | if !ok {
38 | app.serverError(w, fmt.Errorf("the template %s does not exist", name))
39 | return
40 | }
41 |
42 | buf := new(bytes.Buffer)
43 |
44 | err := ts.Execute(buf, app.addDefaultData(td, r))
45 | if err != nil {
46 | app.serverError(w, err)
47 | return
48 | }
49 |
50 | _, err = buf.WriteTo(w)
51 | if err != nil {
52 | app.serverError(w, err)
53 | return
54 | }
55 | }
56 |
--------------------------------------------------------------------------------
/server/middleware.go:
--------------------------------------------------------------------------------
1 | package server
2 |
3 | import (
4 | "fmt"
5 | "github.com/justinas/nosurf"
6 | "net/http"
7 | )
8 |
9 | func secureHeaders(next http.Handler) http.Handler {
10 | return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
11 | w.Header().Set("X-XSS-Protection", "1; mode=block")
12 | w.Header().Set("X-Frame-Options", "deny")
13 | next.ServeHTTP(w, r)
14 | })
15 | }
16 |
17 | func (app *application) logRequest(next http.Handler) http.Handler {
18 | return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
19 | app.logger.Info().Msgf("%s - %s %s %s", r.RemoteAddr, r.Proto, r.Method, r.URL.RequestURI())
20 | next.ServeHTTP(w, r)
21 | })
22 | }
23 |
24 | func (app *application) recoverPanic(next http.Handler) http.Handler {
25 | return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
26 | defer func() {
27 | if err := recover(); err != nil {
28 | // Set a "Connection: close" header on the response.
29 | w.Header().Set("Connection", "close")
30 | // Call the app.serverError helper method to return a 500
31 | // Internal Server response.
32 | app.serverError(w, fmt.Errorf("%s", err))
33 | }
34 | }()
35 |
36 | next.ServeHTTP(w, r)
37 | })
38 | }
39 |
40 | // Create a NoSurf middleware function which uses a customized CSRF cookie with
41 | // the Secure, Path and HttpOnly flags set.
42 | func noSurf(next http.Handler) http.Handler {
43 | csrfHandler := nosurf.New(next)
44 | csrfHandler.SetBaseCookie(http.Cookie{
45 | HttpOnly: true,
46 | Path: "/",
47 | //Secure: true,
48 | })
49 |
50 | return csrfHandler
51 | }
52 |
--------------------------------------------------------------------------------
/server/middleware_test.go:
--------------------------------------------------------------------------------
1 | package server
2 |
3 | import (
4 | "io/ioutil"
5 | "net/http"
6 | "net/http/httptest"
7 | "testing"
8 | )
9 |
10 | func Test_secureHeaders(t *testing.T) {
11 | // Initialize a new httptest.ResponseRecorder and dummy http.Request.
12 | rr := httptest.NewRecorder()
13 |
14 | r, err := http.NewRequest("GET", "/", nil)
15 | if err != nil {
16 | t.Fatal(err)
17 | }
18 |
19 | // Create a mock HTTP handler that we can pass to our secureHeaders
20 | // middleware, which writes a 200 status code and "OK" response body.
21 | next := http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
22 | w.Write([]byte("OK"))
23 | })
24 |
25 | // Pass the mock HTTP handler to our secureHeaders middleware. Because
26 | // secureHeaders *returns* a http.Handler we can call its ServeHTTP()
27 | // method, passing in the http.ResponseRecorder and dummy http.Request to
28 | // execute it.
29 | secureHeaders(next).ServeHTTP(rr, r)
30 |
31 | // Call the Result() method on the http.ResponseRecorder to get the results
32 | // of the test.
33 | rs := rr.Result()
34 |
35 | // Check that the middleware has correctly set the X-Frame-Options header
36 | // on the response.
37 | frameOptions := rs.Header.Get("X-Frame-Options")
38 | if frameOptions != "deny" {
39 | t.Errorf("want %q; got %q", "deny", frameOptions)
40 | }
41 |
42 | // Check that the middleware has correctly set the X-XSS-Protection header
43 | // on the response.
44 | xssProtection := rs.Header.Get("X-XSS-Protection")
45 | if xssProtection != "1; mode=block" {
46 | t.Errorf("want %q; got %q", "1; mode=block", xssProtection)
47 | }
48 |
49 | // Check that the middleware has correctly called the next handler in line
50 | // and the response status code and body are as expected.
51 | if rs.StatusCode != http.StatusOK {
52 | t.Errorf("want %d; got %d", http.StatusOK, rs.StatusCode)
53 | }
54 |
55 | defer rs.Body.Close()
56 | body, err := ioutil.ReadAll(rs.Body)
57 | if err != nil {
58 | t.Fatal(err)
59 | }
60 |
61 | if string(body) != "OK" {
62 | t.Errorf("want body to equal %q", "OK")
63 | }
64 | }
65 |
--------------------------------------------------------------------------------
/server/routes.go:
--------------------------------------------------------------------------------
1 | package server
2 |
3 | import (
4 | "github.com/gork74/aws-parameter-bulk/ui"
5 | "net/http"
6 | "strings"
7 |
8 | "github.com/bmizerany/pat"
9 | "github.com/justinas/alice"
10 | )
11 |
12 | type neuteredFileSystem struct {
13 | fs http.FileSystem
14 | }
15 |
16 | // return 404 not found if index.html do not exist when passing url with path suffix /
17 | func (nfs neuteredFileSystem) Open(path string) (http.File, error) {
18 | f, err := nfs.fs.Open(path)
19 | if err != nil {
20 | return nil, err
21 | }
22 |
23 | s, err := f.Stat()
24 | if err != nil {
25 | return nil, err
26 | }
27 |
28 | if s != nil && s.IsDir() {
29 | index := strings.TrimSuffix(path, "/") + "/index.html"
30 | if _, err := nfs.fs.Open(index); err != nil {
31 | return nil, err
32 | }
33 | }
34 |
35 | return f, nil
36 | }
37 |
38 | func (app *application) routes() http.Handler {
39 | standardMiddleware := alice.New(app.recoverPanic, app.logRequest, secureHeaders)
40 |
41 | fileServer := http.FileServer(http.FS(ui.Files))
42 |
43 | dynamicMiddleware := alice.New(app.session.LoadAndSave, noSurf)
44 |
45 | mux := pat.New()
46 | mux.Get("/", dynamicMiddleware.ThenFunc(app.home))
47 | mux.Post("/", dynamicMiddleware.ThenFunc(app.postHome))
48 | mux.Post("/reset", dynamicMiddleware.ThenFunc(app.postReset))
49 | mux.Get("/static/", http.StripPrefix("/static", fileServer))
50 |
51 | return standardMiddleware.Then(mux)
52 | }
53 |
--------------------------------------------------------------------------------
/server/server.go:
--------------------------------------------------------------------------------
1 | package server
2 |
3 | import (
4 | "fmt"
5 | "github.com/alexedwards/scs/v2"
6 | "github.com/gork74/aws-parameter-bulk/pkg/util"
7 | "html/template"
8 | "math/rand"
9 | "net/http"
10 | "strings"
11 | "time"
12 |
13 | "github.com/rs/zerolog"
14 | )
15 |
16 | type application struct {
17 | logger *zerolog.Logger
18 | session *scs.SessionManager
19 | templateCache map[string]*template.Template
20 | ssmClient *util.AWSSSM
21 | }
22 |
23 | func ListenAndServe(logger *zerolog.Logger, address string) {
24 |
25 | var err error
26 |
27 | InitTemplates()
28 | session := scs.New()
29 | session.Lifetime = 24 * 30 * time.Hour
30 |
31 | templateCache, err := newTemplateCache()
32 | if err != nil {
33 | logger.Fatal().Msgf("Template cache Error %s", err)
34 | }
35 |
36 | ssmClient := util.NewSSM()
37 | app := &application{logger, session, templateCache, ssmClient}
38 |
39 | srv := &http.Server{
40 | Addr: address,
41 | Handler: app.routes(),
42 | }
43 |
44 | rand.Seed(time.Now().UnixNano())
45 |
46 | addrString := address
47 | if strings.HasPrefix(addrString, ":") {
48 | addrString = fmt.Sprintf("localhost%s", address)
49 | }
50 | app.logger.Info().Msgf("Starting server on http://%s", addrString)
51 | err = srv.ListenAndServe()
52 | if err != nil {
53 | app.logger.Fatal().Err(err).Msg("Startup failed")
54 | }
55 | }
56 |
--------------------------------------------------------------------------------
/server/templates.go:
--------------------------------------------------------------------------------
1 | package server
2 |
3 | import (
4 | "encoding/gob"
5 | "github.com/gork74/aws-parameter-bulk/pkg/forms"
6 | "github.com/gork74/aws-parameter-bulk/pkg/models"
7 | "github.com/gork74/aws-parameter-bulk/ui"
8 | "html/template"
9 | "io/fs"
10 | "path/filepath"
11 | )
12 |
13 | // Add templateData to gob to make it serializable
14 | func InitTemplates() {
15 | gob.RegisterName("github.com/gork74/aws-parameter-bulk/server.templateData", &templateData{})
16 | }
17 |
18 | type templateData struct {
19 | NamesLeft string
20 | JsonLeft bool
21 | RecursiveLeft bool
22 | NamesRight string
23 | JsonRight bool
24 | RecursiveRight bool
25 | Different bool
26 | CSRFToken string
27 | Flash string
28 | FlashError string
29 | Form *forms.Form
30 | Compare []models.ValueCompare
31 | }
32 |
33 | // Initialize a template.FuncMap object and store it in a global variable. This is
34 | // essentially a string-keyed map which acts as a lookup between the names of our
35 | // custom template functions and the functions themselves.
36 | var functions = template.FuncMap{}
37 |
38 | func newTemplateCache() (map[string]*template.Template, error) {
39 | // Initialize a new map to act as the cache.
40 | cache := map[string]*template.Template{}
41 |
42 | // Use the fs.Glob function to get a slice of all filepaths with
43 | // the extension '.tmpl'. This essentially gives us a slice of all the
44 | // 'page' templates for the application.
45 | pages, err := fs.Glob(ui.Files, "html/*.tmpl")
46 | if err != nil {
47 | return nil, err
48 | }
49 |
50 | // Loop through the pages one-by-one.
51 | for _, page := range pages {
52 | // Extract the file name (like 'home.page.tmpl') from the full file path
53 | // and assign it to the name variable.
54 | name := filepath.Base(page)
55 |
56 | patterns := []string{
57 | "html/*.layout.tmpl",
58 | "html/*.page.tmpl",
59 | "html/*.partial.tmpl",
60 | page,
61 | }
62 |
63 | ts, err := template.New(name).Funcs(functions).ParseFS(ui.Files, patterns...)
64 | if err != nil {
65 | return nil, err
66 | }
67 |
68 | // Add the template set to the cache, using the name of the page
69 | // (like 'home.page.tmpl') as the key.
70 | cache[name] = ts
71 | }
72 |
73 | // Return the map.
74 | return cache, nil
75 | }
76 |
--------------------------------------------------------------------------------
/server/testutils_test.go:
--------------------------------------------------------------------------------
1 | package server
2 |
3 | import (
4 | "fmt"
5 | "github.com/alexedwards/scs/v2"
6 | "github.com/aws/aws-sdk-go/aws"
7 | "github.com/aws/aws-sdk-go/service/ssm"
8 | "github.com/aws/aws-sdk-go/service/ssm/ssmiface"
9 | "github.com/gork74/aws-parameter-bulk/pkg/util"
10 | "github.com/rs/zerolog/log"
11 | "html"
12 | "io/ioutil"
13 | "net/http"
14 | "net/http/cookiejar"
15 | "net/http/httptest"
16 | "net/url"
17 | "os"
18 | "regexp"
19 | "testing"
20 | "time"
21 |
22 | "github.com/gork74/aws-parameter-bulk/conf"
23 | "github.com/rs/zerolog"
24 | )
25 |
26 | type MockSSM struct {
27 | ssmiface.SSMAPI
28 | err error
29 | }
30 |
31 | func nameString(parameter ssm.GetParametersInput) string {
32 | result := "["
33 | for i, param := range parameter.Names {
34 | if i > 0 {
35 | result += ", "
36 | }
37 | result += fmt.Sprintf("%s", *param)
38 | }
39 | return result + "]"
40 | }
41 |
42 | func (sp *MockSSM) GetParameter(input *ssm.GetParameterInput) (*ssm.GetParameterOutput, error) {
43 | output := new(ssm.GetParameterOutput)
44 | log.Info().Msgf("%s", *input.Name)
45 | if *input.Name == "One1" {
46 | name1 := "One1"
47 | output.Parameter = &ssm.Parameter{Name: &name1, Value: aws.String("OneVal1")}
48 | }
49 | return output, sp.err
50 | }
51 |
52 | func (sp *MockSSM) GetParameters(input *ssm.GetParametersInput) (*ssm.GetParametersOutput, error) {
53 | output := new(ssm.GetParametersOutput)
54 | log.Info().Msgf("%s", nameString(*input))
55 | if nameString(*input) == "[One1]" {
56 | name1 := "One1"
57 | output.Parameters = append(output.Parameters, &ssm.Parameter{Name: &name1, Value: aws.String("OneVal1")})
58 | }
59 | if nameString(*input) == "[Three1]" {
60 | name1 := "Three1"
61 | output.Parameters = append(output.Parameters, &ssm.Parameter{Name: &name1, Value: aws.String("ThreeVal1")})
62 | }
63 | if nameString(*input) == "[One2]" {
64 | name1 := "One2"
65 | output.Parameters = append(output.Parameters, &ssm.Parameter{Name: &name1, Value: aws.String("OneVal2")})
66 | }
67 | if nameString(*input) == "[One1, One2]" {
68 | name1 := "One1"
69 | name2 := "One2"
70 | output.Parameters = append(output.Parameters, &ssm.Parameter{Name: &name1, Value: aws.String("OneVal1")})
71 | output.Parameters = append(output.Parameters, &ssm.Parameter{Name: &name2, Value: aws.String("OneVal2")})
72 | }
73 | if nameString(*input) == "[Three1, Three2]" {
74 | name1 := "Three1"
75 | name2 := "Three2"
76 | output.Parameters = append(output.Parameters, &ssm.Parameter{Name: &name1, Value: aws.String("ThreeVal1")})
77 | output.Parameters = append(output.Parameters, &ssm.Parameter{Name: &name2, Value: aws.String("ThreeVal2")})
78 | }
79 | return output, sp.err
80 | }
81 |
82 | func (sp *MockSSM) GetParametersByPath(input *ssm.GetParametersByPathInput) (*ssm.GetParametersByPathOutput, error) {
83 | output := new(ssm.GetParametersByPathOutput)
84 | params := make([]*ssm.Parameter, 0)
85 | if *input.Path == "/path" {
86 | params = append(params, &ssm.Parameter{Name: aws.String("One1"), Value: aws.String("OneVal1")})
87 | }
88 | if *input.Path == "/path2" {
89 | params = append(params, &ssm.Parameter{Name: aws.String("One1"), Value: aws.String("OneVal1")})
90 | params = append(params, &ssm.Parameter{Name: aws.String("One2"), Value: aws.String("OneVal2")})
91 | }
92 | output.Parameters = params
93 | return output, sp.err
94 | }
95 |
96 | // Define a custom testServer type which anonymously embeds a httptest.Server
97 | // instance.
98 | type testServer struct {
99 | *httptest.Server
100 | }
101 |
102 | // Define a regular expression which captures the CSRF token value from the
103 | // HTML.
104 | var csrfTokenRX = regexp.MustCompile(`AWS Parameter Bulk
12 |
32 |
35 | ×
38 | {{end}}
39 | {{with .FlashError}}
40 |
41 | ×
44 | {{end}}
45 | {{template "body" .}}
46 |
47 | {{template "footer" .}}
48 |
49 |
50 | {{end}}
--------------------------------------------------------------------------------
/ui/html/error.page.tmpl:
--------------------------------------------------------------------------------
1 | {{template "base" .}}
2 |
3 | {{define "title"}}Error{{end}}
4 |
5 | {{define "body"}}
6 |
7 | {{end}}
--------------------------------------------------------------------------------
/ui/html/footer.partial.tmpl:
--------------------------------------------------------------------------------
1 | {{define "footer"}}
2 |
3 |
6 | {{end}}
--------------------------------------------------------------------------------
/ui/html/home.page.tmpl:
--------------------------------------------------------------------------------
1 | {{template "base" .}}
2 |
3 | {{define "title"}}AWS Parameter Bulk{{end}}
4 |
5 | {{define "body"}}
6 |
7 |
8 |
9 | {{$csrfToken := .CSRFToken}}
10 | {{$namesLeft := .NamesLeft}}
11 | {{$namesRight := .NamesRight}}
12 | {{$jsonLeft := .JsonLeft}}
13 | {{$recursiveLeft := .RecursiveLeft}}
14 | {{$jsonRight := .JsonRight}}
15 | {{$recursiveRight := .RecursiveRight}}
16 |
17 | {{with .Form}}
18 | {{with .Errors.Get "generic"}}
19 |
{{.}}
20 | {{end}}
21 |
50 |
58 | {{end}}
59 |
60 |
61 | {{ range $key, $comp := .Compare }}
62 |
63 |
72 |
73 | =
74 |
75 |
84 |
85 | {{end}}
86 |
87 |
` elements.\n\nbody {\n margin: 0; // 1\n font-family: $font-family-base;\n font-size: $font-size-base;\n font-weight: $font-weight-base;\n line-height: $line-height-base;\n color: $body-color;\n text-align: left; // 3\n background-color: $body-bg; // 2\n}\n\n// Suppress the focus outline on elements that cannot be accessed via keyboard.\n// This prevents an unwanted focus outline from appearing around elements that\n// might still respond to pointer events.\n//\n// Credit: https://github.com/suitcss/base\n[tabindex=\"-1\"]:focus {\n outline: 0 !important;\n}\n\n\n// Content grouping\n//\n// 1. Add the correct box sizing in Firefox.\n// 2. Show the overflow in Edge and IE.\n\nhr {\n box-sizing: content-box; // 1\n height: 0; // 1\n overflow: visible; // 2\n}\n\n\n//\n// Typography\n//\n\n// Remove top margins from headings\n//\n// By default, ``-`` all receive top and bottom margins. We nuke the top\n// margin for easier control within type scales as it avoids margin collapsing.\n// stylelint-disable selector-list-comma-newline-after\nh1, h2, h3, h4, h5, h6 {\n margin-top: 0;\n margin-bottom: $headings-margin-bottom;\n}\n// stylelint-enable selector-list-comma-newline-after\n\n// Reset margins on paragraphs\n//\n// Similarly, the top margin on ` `s get reset. However, we also reset the\n// bottom margin to use `rem` units instead of `em`.\np {\n margin-top: 0;\n margin-bottom: $paragraph-margin-bottom;\n}\n\n// Abbreviations\n//\n// 1. Remove the bottom border in Firefox 39-.\n// 2. Add the correct text decoration in Chrome, Edge, IE, Opera, and Safari.\n// 3. Add explicit cursor to indicate changed behavior.\n// 4. Duplicate behavior to the data-* attribute for our tooltip plugin\n\nabbr[title],\nabbr[data-original-title] { // 4\n text-decoration: underline; // 2\n text-decoration: underline dotted; // 2\n cursor: help; // 3\n border-bottom: 0; // 1\n}\n\naddress {\n margin-bottom: 1rem;\n font-style: normal;\n line-height: inherit;\n}\n\nol,\nul,\ndl {\n margin-top: 0;\n margin-bottom: 1rem;\n}\n\nol ol,\nul ul,\nol ul,\nul ol {\n margin-bottom: 0;\n}\n\ndt {\n font-weight: $dt-font-weight;\n}\n\ndd {\n margin-bottom: .5rem;\n margin-left: 0; // Undo browser default\n}\n\nblockquote {\n margin: 0 0 1rem;\n}\n\ndfn {\n font-style: italic; // Add the correct font style in Android 4.3-\n}\n\n// stylelint-disable font-weight-notation\nb,\nstrong {\n font-weight: bolder; // Add the correct font weight in Chrome, Edge, and Safari\n}\n// stylelint-enable font-weight-notation\n\nsmall {\n font-size: 80%; // Add the correct font size in all browsers\n}\n\n//\n// Prevent `sub` and `sup` elements from affecting the line height in\n// all browsers.\n//\n\nsub,\nsup {\n position: relative;\n font-size: 75%;\n line-height: 0;\n vertical-align: baseline;\n}\n\nsub { bottom: -.25em; }\nsup { top: -.5em; }\n\n\n//\n// Links\n//\n\na {\n color: $link-color;\n text-decoration: $link-decoration;\n background-color: transparent; // Remove the gray background on active links in IE 10.\n -webkit-text-decoration-skip: objects; // Remove gaps in links underline in iOS 8+ and Safari 8+.\n\n @include hover {\n color: $link-hover-color;\n text-decoration: $link-hover-decoration;\n }\n}\n\n// And undo these styles for placeholder links/named anchors (without href)\n// which have not been made explicitly keyboard-focusable (without tabindex).\n// It would be more straightforward to just use a[href] in previous block, but that\n// causes specificity issues in many other styles that are too complex to fix.\n// See https://github.com/twbs/bootstrap/issues/19402\n\na:not([href]):not([tabindex]) {\n color: inherit;\n text-decoration: none;\n\n @include hover-focus {\n color: inherit;\n text-decoration: none;\n }\n\n &:focus {\n outline: 0;\n }\n}\n\n\n//\n// Code\n//\n\npre,\ncode,\nkbd,\nsamp {\n font-family: $font-family-monospace;\n font-size: 1em; // Correct the odd `em` font sizing in all browsers.\n}\n\npre {\n // Remove browser default top margin\n margin-top: 0;\n // Reset browser default of `1em` to use `rem`s\n margin-bottom: 1rem;\n // Don't allow content to break outside\n overflow: auto;\n // We have @viewport set which causes scrollbars to overlap content in IE11 and Edge, so\n // we force a non-overlapping, non-auto-hiding scrollbar to counteract.\n -ms-overflow-style: scrollbar;\n}\n\n\n//\n// Figures\n//\n\nfigure {\n // Apply a consistent margin strategy (matches our type styles).\n margin: 0 0 1rem;\n}\n\n\n//\n// Images and content\n//\n\nimg {\n vertical-align: middle;\n border-style: none; // Remove the border on images inside links in IE 10-.\n}\n\nsvg {\n // Workaround for the SVG overflow bug in IE10/11 is still required.\n // See https://github.com/twbs/bootstrap/issues/26878\n overflow: hidden;\n vertical-align: middle;\n}\n\n\n//\n// Tables\n//\n\ntable {\n border-collapse: collapse; // Prevent double borders\n}\n\ncaption {\n padding-top: $table-cell-padding;\n padding-bottom: $table-cell-padding;\n color: $table-caption-color;\n text-align: left;\n caption-side: bottom;\n}\n\nth {\n // Matches default `
` alignment by inheriting from the ``, or the\n // closest parent with a set `text-align`.\n text-align: inherit;\n}\n\n\n//\n// Forms\n//\n\nlabel {\n // Allow labels to use `margin` for spacing.\n display: inline-block;\n margin-bottom: $label-margin-bottom;\n}\n\n// Remove the default `border-radius` that macOS Chrome adds.\n//\n// Details at https://github.com/twbs/bootstrap/issues/24093\nbutton {\n border-radius: 0;\n}\n\n// Work around a Firefox/IE bug where the transparent `button` background\n// results in a loss of the default `button` focus styles.\n//\n// Credit: https://github.com/suitcss/base/\nbutton:focus {\n outline: 1px dotted;\n outline: 5px auto -webkit-focus-ring-color;\n}\n\ninput,\nbutton,\nselect,\noptgroup,\ntextarea {\n margin: 0; // Remove the margin in Firefox and Safari\n font-family: inherit;\n font-size: inherit;\n line-height: inherit;\n}\n\nbutton,\ninput {\n overflow: visible; // Show the overflow in Edge\n}\n\nbutton,\nselect {\n text-transform: none; // Remove the inheritance of text transform in Firefox\n}\n\n// 1. Prevent a WebKit bug where (2) destroys native `audio` and `video`\n// controls in Android 4.\n// 2. Correct the inability to style clickable types in iOS and Safari.\nbutton,\nhtml [type=\"button\"], // 1\n[type=\"reset\"],\n[type=\"submit\"] {\n -webkit-appearance: button; // 2\n}\n\n// Remove inner border and padding from Firefox, but don't restore the outline like Normalize.\nbutton::-moz-focus-inner,\n[type=\"button\"]::-moz-focus-inner,\n[type=\"reset\"]::-moz-focus-inner,\n[type=\"submit\"]::-moz-focus-inner {\n padding: 0;\n border-style: none;\n}\n\ninput[type=\"radio\"],\ninput[type=\"checkbox\"] {\n box-sizing: border-box; // 1. Add the correct box sizing in IE 10-\n padding: 0; // 2. Remove the padding in IE 10-\n}\n\n\ninput[type=\"date\"],\ninput[type=\"time\"],\ninput[type=\"datetime-local\"],\ninput[type=\"month\"] {\n // Remove the default appearance of temporal inputs to avoid a Mobile Safari\n // bug where setting a custom line-height prevents text from being vertically\n // centered within the input.\n // See https://bugs.webkit.org/show_bug.cgi?id=139848\n // and https://github.com/twbs/bootstrap/issues/11266\n -webkit-appearance: listbox;\n}\n\ntextarea {\n overflow: auto; // Remove the default vertical scrollbar in IE.\n // Textareas should really only resize vertically so they don't break their (horizontal) containers.\n resize: vertical;\n}\n\nfieldset {\n // Browsers set a default `min-width: min-content;` on fieldsets,\n // unlike e.g. ``s, which have `min-width: 0;` by default.\n // So we reset that to ensure fieldsets behave more like a standard block element.\n // See https://github.com/twbs/bootstrap/issues/12359\n // and https://html.spec.whatwg.org/multipage/#the-fieldset-and-legend-elements\n min-width: 0;\n // Reset the default outline behavior of fieldsets so they don't affect page layout.\n padding: 0;\n margin: 0;\n border: 0;\n}\n\n// 1. Correct the text wrapping in Edge and IE.\n// 2. Correct the color inheritance from `fieldset` elements in IE.\nlegend {\n display: block;\n width: 100%;\n max-width: 100%; // 1\n padding: 0;\n margin-bottom: .5rem;\n font-size: 1.5rem;\n line-height: inherit;\n color: inherit; // 2\n white-space: normal; // 1\n}\n\nprogress {\n vertical-align: baseline; // Add the correct vertical alignment in Chrome, Firefox, and Opera.\n}\n\n// Correct the cursor style of increment and decrement buttons in Chrome.\n[type=\"number\"]::-webkit-inner-spin-button,\n[type=\"number\"]::-webkit-outer-spin-button {\n height: auto;\n}\n\n[type=\"search\"] {\n // This overrides the extra rounded corners on search inputs in iOS so that our\n // `.form-control` class can properly style them. Note that this cannot simply\n // be added to `.form-control` as it's not specific enough. For details, see\n // https://github.com/twbs/bootstrap/issues/11586.\n outline-offset: -2px; // 2. Correct the outline style in Safari.\n -webkit-appearance: none;\n}\n\n//\n// Remove the inner padding and cancel buttons in Chrome and Safari on macOS.\n//\n\n[type=\"search\"]::-webkit-search-cancel-button,\n[type=\"search\"]::-webkit-search-decoration {\n -webkit-appearance: none;\n}\n\n//\n// 1. Correct the inability to style clickable types in iOS and Safari.\n// 2. Change font properties to `inherit` in Safari.\n//\n\n::-webkit-file-upload-button {\n font: inherit; // 2\n -webkit-appearance: button; // 1\n}\n\n//\n// Correct element displays\n//\n\noutput {\n display: inline-block;\n}\n\nsummary {\n display: list-item; // Add the correct display in all browsers\n cursor: pointer;\n}\n\ntemplate {\n display: none; // Add the correct display in IE\n}\n\n// Always hide an element with the `hidden` HTML attribute (from PureCSS).\n// Needed for proper display in IE 10-.\n[hidden] {\n display: none !important;\n}\n","/*!\n * Bootstrap Reboot v4.1.3 (https://getbootstrap.com/)\n * Copyright 2011-2018 The Bootstrap Authors\n * Copyright 2011-2018 Twitter, Inc.\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/master/LICENSE)\n * Forked from Normalize.css, licensed MIT (https://github.com/necolas/normalize.css/blob/master/LICENSE.md)\n */\n*,\n*::before,\n*::after {\n box-sizing: border-box;\n}\n\nhtml {\n font-family: sans-serif;\n line-height: 1.15;\n -webkit-text-size-adjust: 100%;\n -ms-text-size-adjust: 100%;\n -ms-overflow-style: scrollbar;\n -webkit-tap-highlight-color: rgba(0, 0, 0, 0);\n}\n\n@-ms-viewport {\n width: device-width;\n}\n\narticle, aside, figcaption, figure, footer, header, hgroup, main, nav, section {\n display: block;\n}\n\nbody {\n margin: 0;\n font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, \"Helvetica Neue\", Arial, sans-serif, \"Apple Color Emoji\", \"Segoe UI Emoji\", \"Segoe UI Symbol\", \"Noto Color Emoji\";\n font-size: 1rem;\n font-weight: 400;\n line-height: 1.5;\n color: #212529;\n text-align: left;\n background-color: #fff;\n}\n\n[tabindex=\"-1\"]:focus {\n outline: 0 !important;\n}\n\nhr {\n box-sizing: content-box;\n height: 0;\n overflow: visible;\n}\n\nh1, h2, h3, h4, h5, h6 {\n margin-top: 0;\n margin-bottom: 0.5rem;\n}\n\np {\n margin-top: 0;\n margin-bottom: 1rem;\n}\n\nabbr[title],\nabbr[data-original-title] {\n text-decoration: underline;\n -webkit-text-decoration: underline dotted;\n text-decoration: underline dotted;\n cursor: help;\n border-bottom: 0;\n}\n\naddress {\n margin-bottom: 1rem;\n font-style: normal;\n line-height: inherit;\n}\n\nol,\nul,\ndl {\n margin-top: 0;\n margin-bottom: 1rem;\n}\n\nol ol,\nul ul,\nol ul,\nul ol {\n margin-bottom: 0;\n}\n\ndt {\n font-weight: 700;\n}\n\ndd {\n margin-bottom: .5rem;\n margin-left: 0;\n}\n\nblockquote {\n margin: 0 0 1rem;\n}\n\ndfn {\n font-style: italic;\n}\n\nb,\nstrong {\n font-weight: bolder;\n}\n\nsmall {\n font-size: 80%;\n}\n\nsub,\nsup {\n position: relative;\n font-size: 75%;\n line-height: 0;\n vertical-align: baseline;\n}\n\nsub {\n bottom: -.25em;\n}\n\nsup {\n top: -.5em;\n}\n\na {\n color: #007bff;\n text-decoration: none;\n background-color: transparent;\n -webkit-text-decoration-skip: objects;\n}\n\na:hover {\n color: #0056b3;\n text-decoration: underline;\n}\n\na:not([href]):not([tabindex]) {\n color: inherit;\n text-decoration: none;\n}\n\na:not([href]):not([tabindex]):hover, a:not([href]):not([tabindex]):focus {\n color: inherit;\n text-decoration: none;\n}\n\na:not([href]):not([tabindex]):focus {\n outline: 0;\n}\n\npre,\ncode,\nkbd,\nsamp {\n font-family: SFMono-Regular, Menlo, Monaco, Consolas, \"Liberation Mono\", \"Courier New\", monospace;\n font-size: 1em;\n}\n\npre {\n margin-top: 0;\n margin-bottom: 1rem;\n overflow: auto;\n -ms-overflow-style: scrollbar;\n}\n\nfigure {\n margin: 0 0 1rem;\n}\n\nimg {\n vertical-align: middle;\n border-style: none;\n}\n\nsvg {\n overflow: hidden;\n vertical-align: middle;\n}\n\ntable {\n border-collapse: collapse;\n}\n\ncaption {\n padding-top: 0.75rem;\n padding-bottom: 0.75rem;\n color: #6c757d;\n text-align: left;\n caption-side: bottom;\n}\n\nth {\n text-align: inherit;\n}\n\nlabel {\n display: inline-block;\n margin-bottom: 0.5rem;\n}\n\nbutton {\n border-radius: 0;\n}\n\nbutton:focus {\n outline: 1px dotted;\n outline: 5px auto -webkit-focus-ring-color;\n}\n\ninput,\nbutton,\nselect,\noptgroup,\ntextarea {\n margin: 0;\n font-family: inherit;\n font-size: inherit;\n line-height: inherit;\n}\n\nbutton,\ninput {\n overflow: visible;\n}\n\nbutton,\nselect {\n text-transform: none;\n}\n\nbutton,\nhtml [type=\"button\"],\n[type=\"reset\"],\n[type=\"submit\"] {\n -webkit-appearance: button;\n}\n\nbutton::-moz-focus-inner,\n[type=\"button\"]::-moz-focus-inner,\n[type=\"reset\"]::-moz-focus-inner,\n[type=\"submit\"]::-moz-focus-inner {\n padding: 0;\n border-style: none;\n}\n\ninput[type=\"radio\"],\ninput[type=\"checkbox\"] {\n box-sizing: border-box;\n padding: 0;\n}\n\ninput[type=\"date\"],\ninput[type=\"time\"],\ninput[type=\"datetime-local\"],\ninput[type=\"month\"] {\n -webkit-appearance: listbox;\n}\n\ntextarea {\n overflow: auto;\n resize: vertical;\n}\n\nfieldset {\n min-width: 0;\n padding: 0;\n margin: 0;\n border: 0;\n}\n\nlegend {\n display: block;\n width: 100%;\n max-width: 100%;\n padding: 0;\n margin-bottom: .5rem;\n font-size: 1.5rem;\n line-height: inherit;\n color: inherit;\n white-space: normal;\n}\n\nprogress {\n vertical-align: baseline;\n}\n\n[type=\"number\"]::-webkit-inner-spin-button,\n[type=\"number\"]::-webkit-outer-spin-button {\n height: auto;\n}\n\n[type=\"search\"] {\n outline-offset: -2px;\n -webkit-appearance: none;\n}\n\n[type=\"search\"]::-webkit-search-cancel-button,\n[type=\"search\"]::-webkit-search-decoration {\n -webkit-appearance: none;\n}\n\n::-webkit-file-upload-button {\n font: inherit;\n -webkit-appearance: button;\n}\n\noutput {\n display: inline-block;\n}\n\nsummary {\n display: list-item;\n cursor: pointer;\n}\n\ntemplate {\n display: none;\n}\n\n[hidden] {\n display: none !important;\n}\n/*# sourceMappingURL=bootstrap-reboot.css.map */","/*!\n * Bootstrap Reboot v4.1.3 (https://getbootstrap.com/)\n * Copyright 2011-2018 The Bootstrap Authors\n * Copyright 2011-2018 Twitter, Inc.\n * Licensed under MIT (https://github.com/twbs/bootstrap/blob/master/LICENSE)\n * Forked from Normalize.css, licensed MIT (https://github.com/necolas/normalize.css/blob/master/LICENSE.md)\n */\n*,\n*::before,\n*::after {\n box-sizing: border-box;\n}\n\nhtml {\n font-family: sans-serif;\n line-height: 1.15;\n -webkit-text-size-adjust: 100%;\n -ms-text-size-adjust: 100%;\n -ms-overflow-style: scrollbar;\n -webkit-tap-highlight-color: rgba(0, 0, 0, 0);\n}\n\n@-ms-viewport {\n width: device-width;\n}\n\narticle, aside, figcaption, figure, footer, header, hgroup, main, nav, section {\n display: block;\n}\n\nbody {\n margin: 0;\n font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, \"Helvetica Neue\", Arial, sans-serif, \"Apple Color Emoji\", \"Segoe UI Emoji\", \"Segoe UI Symbol\", \"Noto Color Emoji\";\n font-size: 1rem;\n font-weight: 400;\n line-height: 1.5;\n color: #212529;\n text-align: left;\n background-color: #fff;\n}\n\n[tabindex=\"-1\"]:focus {\n outline: 0 !important;\n}\n\nhr {\n box-sizing: content-box;\n height: 0;\n overflow: visible;\n}\n\nh1, h2, h3, h4, h5, h6 {\n margin-top: 0;\n margin-bottom: 0.5rem;\n}\n\np {\n margin-top: 0;\n margin-bottom: 1rem;\n}\n\nabbr[title],\nabbr[data-original-title] {\n text-decoration: underline;\n text-decoration: underline dotted;\n cursor: help;\n border-bottom: 0;\n}\n\naddress {\n margin-bottom: 1rem;\n font-style: normal;\n line-height: inherit;\n}\n\nol,\nul,\ndl {\n margin-top: 0;\n margin-bottom: 1rem;\n}\n\nol ol,\nul ul,\nol ul,\nul ol {\n margin-bottom: 0;\n}\n\ndt {\n font-weight: 700;\n}\n\ndd {\n margin-bottom: .5rem;\n margin-left: 0;\n}\n\nblockquote {\n margin: 0 0 1rem;\n}\n\ndfn {\n font-style: italic;\n}\n\nb,\nstrong {\n font-weight: bolder;\n}\n\nsmall {\n font-size: 80%;\n}\n\nsub,\nsup {\n position: relative;\n font-size: 75%;\n line-height: 0;\n vertical-align: baseline;\n}\n\nsub {\n bottom: -.25em;\n}\n\nsup {\n top: -.5em;\n}\n\na {\n color: #007bff;\n text-decoration: none;\n background-color: transparent;\n -webkit-text-decoration-skip: objects;\n}\n\na:hover {\n color: #0056b3;\n text-decoration: underline;\n}\n\na:not([href]):not([tabindex]) {\n color: inherit;\n text-decoration: none;\n}\n\na:not([href]):not([tabindex]):hover, a:not([href]):not([tabindex]):focus {\n color: inherit;\n text-decoration: none;\n}\n\na:not([href]):not([tabindex]):focus {\n outline: 0;\n}\n\npre,\ncode,\nkbd,\nsamp {\n font-family: SFMono-Regular, Menlo, Monaco, Consolas, \"Liberation Mono\", \"Courier New\", monospace;\n font-size: 1em;\n}\n\npre {\n margin-top: 0;\n margin-bottom: 1rem;\n overflow: auto;\n -ms-overflow-style: scrollbar;\n}\n\nfigure {\n margin: 0 0 1rem;\n}\n\nimg {\n vertical-align: middle;\n border-style: none;\n}\n\nsvg {\n overflow: hidden;\n vertical-align: middle;\n}\n\ntable {\n border-collapse: collapse;\n}\n\ncaption {\n padding-top: 0.75rem;\n padding-bottom: 0.75rem;\n color: #6c757d;\n text-align: left;\n caption-side: bottom;\n}\n\nth {\n text-align: inherit;\n}\n\nlabel {\n display: inline-block;\n margin-bottom: 0.5rem;\n}\n\nbutton {\n border-radius: 0;\n}\n\nbutton:focus {\n outline: 1px dotted;\n outline: 5px auto -webkit-focus-ring-color;\n}\n\ninput,\nbutton,\nselect,\noptgroup,\ntextarea {\n margin: 0;\n font-family: inherit;\n font-size: inherit;\n line-height: inherit;\n}\n\nbutton,\ninput {\n overflow: visible;\n}\n\nbutton,\nselect {\n text-transform: none;\n}\n\nbutton,\nhtml [type=\"button\"],\n[type=\"reset\"],\n[type=\"submit\"] {\n -webkit-appearance: button;\n}\n\nbutton::-moz-focus-inner,\n[type=\"button\"]::-moz-focus-inner,\n[type=\"reset\"]::-moz-focus-inner,\n[type=\"submit\"]::-moz-focus-inner {\n padding: 0;\n border-style: none;\n}\n\ninput[type=\"radio\"],\ninput[type=\"checkbox\"] {\n box-sizing: border-box;\n padding: 0;\n}\n\ninput[type=\"date\"],\ninput[type=\"time\"],\ninput[type=\"datetime-local\"],\ninput[type=\"month\"] {\n -webkit-appearance: listbox;\n}\n\ntextarea {\n overflow: auto;\n resize: vertical;\n}\n\nfieldset {\n min-width: 0;\n padding: 0;\n margin: 0;\n border: 0;\n}\n\nlegend {\n display: block;\n width: 100%;\n max-width: 100%;\n padding: 0;\n margin-bottom: .5rem;\n font-size: 1.5rem;\n line-height: inherit;\n color: inherit;\n white-space: normal;\n}\n\nprogress {\n vertical-align: baseline;\n}\n\n[type=\"number\"]::-webkit-inner-spin-button,\n[type=\"number\"]::-webkit-outer-spin-button {\n height: auto;\n}\n\n[type=\"search\"] {\n outline-offset: -2px;\n -webkit-appearance: none;\n}\n\n[type=\"search\"]::-webkit-search-cancel-button,\n[type=\"search\"]::-webkit-search-decoration {\n -webkit-appearance: none;\n}\n\n::-webkit-file-upload-button {\n font: inherit;\n -webkit-appearance: button;\n}\n\noutput {\n display: inline-block;\n}\n\nsummary {\n display: list-item;\n cursor: pointer;\n}\n\ntemplate {\n display: none;\n}\n\n[hidden] {\n display: none !important;\n}\n\n/*# sourceMappingURL=bootstrap-reboot.css.map */","// Hover mixin and `$enable-hover-media-query` are deprecated.\n//\n// Originally added during our alphas and maintained during betas, this mixin was\n// designed to prevent `:hover` stickiness on iOS-an issue where hover styles\n// would persist after initial touch.\n//\n// For backward compatibility, we've kept these mixins and updated them to\n// always return their regular pseudo-classes instead of a shimmed media query.\n//\n// Issue: https://github.com/twbs/bootstrap/issues/25195\n\n@mixin hover {\n &:hover { @content; }\n}\n\n@mixin hover-focus {\n &:hover,\n &:focus {\n @content;\n }\n}\n\n@mixin plain-hover-focus {\n &,\n &:hover,\n &:focus {\n @content;\n }\n}\n\n@mixin hover-focus-active {\n &:hover,\n &:focus,\n &:active {\n @content;\n }\n}\n"]}
--------------------------------------------------------------------------------