az2aws 1.1.0 → 1.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,3 +1,3 @@
1
1
  {
2
- ".": "1.1.0"
2
+ ".": "1.1.1"
3
3
  }
package/CHANGELOG.md CHANGED
@@ -1,5 +1,12 @@
1
1
  # Changelog
2
2
 
3
+ ## [1.1.1](https://github.com/kuma0128/az2aws/compare/v1.1.0...v1.1.1) (2026-01-19)
4
+
5
+
6
+ ### Bug Fixes
7
+
8
+ * update Snapcraft config to use npm plugin ([#59](https://github.com/kuma0128/az2aws/issues/59)) ([e574441](https://github.com/kuma0128/az2aws/commit/e57444187fc37460c3838d973c28563fe9e13913))
9
+
3
10
  ## [1.1.0](https://github.com/kuma0128/az2aws/compare/v1.0.2...v1.1.0) (2026-01-09)
4
11
 
5
12
 
package/CONTRIBUTING.md CHANGED
@@ -10,6 +10,7 @@ Thank you for your interest in contributing to az2aws! This document provides gu
10
10
  - [Pull Request Process](#pull-request-process)
11
11
  - [Coding Standards](#coding-standards)
12
12
  - [Commit Message Guidelines](#commit-message-guidelines)
13
+ - [Release Process](#release-process)
13
14
  - [Reporting Issues](#reporting-issues)
14
15
 
15
16
  ## Code of Conduct
@@ -193,7 +194,97 @@ src/
193
194
 
194
195
  ## Commit Message Guidelines
195
196
 
196
- Commit messages should be generated using some LLM model.
197
+ This project uses [Conventional Commits](https://www.conventionalcommits.org/) for commit messages. The commit message format is used by [release-please](https://github.com/googleapis/release-please) to automatically generate changelogs and determine version bumps.
198
+
199
+ ### Commit Message Format
200
+
201
+ ```
202
+ <type>(<scope>): <description>
203
+
204
+ [optional body]
205
+
206
+ [optional footer(s)]
207
+ ```
208
+
209
+ ### Commit Types and Their Effects
210
+
211
+ | Type | CHANGELOG Section | Release Trigger | Version Bump |
212
+ |------|-------------------|-----------------|--------------|
213
+ | `feat` | Features | Yes | MINOR (1.x.0) |
214
+ | `fix` | Bug Fixes | Yes | PATCH (1.0.x) |
215
+ | `docs` | Not included | No | - |
216
+ | `chore` | Not included | No | - |
217
+ | `refactor` | Not included | No | - |
218
+ | `test` | Not included | No | - |
219
+ | `style` | Not included | No | - |
220
+ | `perf` | Performance Improvements | Yes | PATCH (1.0.x) |
221
+
222
+ ### Breaking Changes
223
+
224
+ For breaking changes, add `!` after the type or include `BREAKING CHANGE:` in the footer:
225
+
226
+ ```
227
+ feat!: remove deprecated --legacy flag
228
+
229
+ BREAKING CHANGE: The --legacy flag has been removed. Use --mode instead.
230
+ ```
231
+
232
+ Breaking changes trigger a MAJOR version bump (x.0.0).
233
+
234
+ ### Examples
235
+
236
+ ```sh
237
+ # New feature (triggers MINOR release, appears in CHANGELOG)
238
+ feat: add support for credential_process
239
+
240
+ # Bug fix (triggers PATCH release, appears in CHANGELOG)
241
+ fix: resolve proxy configuration conflict
242
+
243
+ # Documentation only (no release, not in CHANGELOG)
244
+ docs: update installation instructions
245
+
246
+ # If you want documentation changes to appear in CHANGELOG, use feat:
247
+ feat(docs): add mise installation guide
248
+
249
+ # Maintenance (no release, not in CHANGELOG)
250
+ chore: update dependencies
251
+ ```
252
+
253
+ ### Important Notes
254
+
255
+ - **PR titles matter**: When a PR is squash-merged, the PR title becomes the commit message. Ensure your PR title follows this format.
256
+ - **Use `feat(docs):`** if you want documentation changes to appear in the changelog and trigger a release.
257
+ - Commit messages can be generated using an LLM model, but ensure they follow the Conventional Commits format.
258
+
259
+ ## Release Process
260
+
261
+ This project uses [release-please](https://github.com/googleapis/release-please) for automated releases.
262
+
263
+ ### How It Works
264
+
265
+ 1. When PRs are merged to `main`, release-please analyzes commit messages
266
+ 2. If releasable commits exist (`feat`, `fix`, `perf`, or breaking changes), release-please creates/updates a Release PR
267
+ 3. The Release PR contains:
268
+ - Version bump in `package.json`
269
+ - Updated `CHANGELOG.md` with all changes since the last release
270
+ 4. When the Release PR is merged, a new GitHub release is created with the appropriate tag
271
+
272
+ ### What Triggers a Release
273
+
274
+ | Commit Type | Triggers Release? | Example |
275
+ |-------------|-------------------|---------|
276
+ | `feat:` | Yes (MINOR) | `feat: add SSO support` |
277
+ | `fix:` | Yes (PATCH) | `fix: handle timeout error` |
278
+ | `perf:` | Yes (PATCH) | `perf: optimize credential caching` |
279
+ | `feat!:` / `BREAKING CHANGE` | Yes (MAJOR) | `feat!: change config format` |
280
+ | `docs:` | No | `docs: update README` |
281
+ | `chore:` | No | `chore: update deps` |
282
+
283
+ ### Tips for Contributors
284
+
285
+ - If your change should appear in the release notes, use `feat:` or `fix:`
286
+ - For documentation improvements that benefit users, consider using `feat(docs):` to include them in the release
287
+ - Multiple commits of the same type are grouped together in the CHANGELOG
197
288
 
198
289
  ## Reporting Issues
199
290
 
package/README.md CHANGED
@@ -9,50 +9,60 @@ If your organization uses [Azure Active Directory](https://azure.microsoft.com)
9
9
 
10
10
  ## Installation
11
11
 
12
- Installation can be done in any of the following platform - Windows, Linux, Docker, Snap
12
+ ### mise (Recommended)
13
13
 
14
- ### Windows
14
+ [mise](https://mise.jdx.dev/) is a polyglot version manager that can install az2aws directly.
15
15
 
16
- Install [Node.js](https://nodejs.org/) v24 or higher. Then install az2aws with npm:
16
+ Install mise:
17
17
 
18
- npm install -g az2aws
18
+ curl https://mise.run | sh
19
19
 
20
- You may need to install puppeteer dependency, if you're getting missing chrome or chromium message
20
+ Activate mise in your shell:
21
21
 
22
- node <node_modules_dir>/az2aws/node_modules/puppeteer/install.js
22
+ # For zsh (macOS default)
23
+ echo 'eval "$(~/.local/bin/mise activate zsh)"' >> ~/.zshrc
24
+ source ~/.zshrc
23
25
 
24
- ### Linux
26
+ # For bash (Linux default)
27
+ echo 'eval "$(~/.local/bin/mise activate bash)"' >> ~/.bashrc
28
+ source ~/.bashrc
25
29
 
26
- In Linux you can either install for all users or just the current user. In either case, you must first install [Node.js](https://nodejs.org/) v24 or higher and any [puppeteer dependencies](https://github.com/GoogleChrome/puppeteer/blob/master/docs/troubleshooting.md#chrome-headless-doesnt-launch). Then follow the appropriate instructions.
30
+ Install az2aws:
27
31
 
28
- #### Option A: Install for All Users
32
+ mise use -g npm:az2aws
29
33
 
30
- Install az2aws globally with npm:
34
+ ### npm
31
35
 
32
- sudo npm install -g az2aws --unsafe-perm
36
+ Install [Node.js](https://nodejs.org/) v24 or higher, then install az2aws:
33
37
 
34
- Puppeteer doesn't install globally with execution permissions for all users so you'll need to modify them:
38
+ npm install -g az2aws
35
39
 
36
- sudo chmod -R go+rx $(npm root -g)
40
+ #### Linux Notes
41
+
42
+ You must install [puppeteer dependencies](https://github.com/GoogleChrome/puppeteer/blob/master/docs/troubleshooting.md#chrome-headless-doesnt-launch) first.
43
+
44
+ **Install for all users:**
37
45
 
38
- #### Option B: Install Only for Current User
46
+ sudo npm install -g az2aws --unsafe-perm
47
+ sudo chmod -R go+rx $(npm root -g)
39
48
 
40
- First configure npm to install global packages in [your home directory](https://docs.npmjs.com/getting-started/fixing-npm-permissions):
49
+ **Install for current user only:**
41
50
 
42
51
  mkdir ~/.npm-global
43
52
  npm config set prefix '~/.npm-global'
44
- export PATH=~/.npm-global/bin:$PATH
45
- source ~/.profile
46
53
  echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.profile
47
54
  source ~/.profile
55
+ npm install -g az2aws
48
56
 
49
- Then install az2aws:
57
+ #### Windows Notes
50
58
 
51
- npm install -g az2aws
59
+ If you get a missing Chrome/Chromium error, install the puppeteer dependency manually:
60
+
61
+ node <node_modules_dir>/az2aws/node_modules/puppeteer/install.js
52
62
 
53
63
  ### Docker
54
64
 
55
- A Docker image has been built with az2aws preinstalled. You simply need to run the command with a volume mounted to your AWS configuration directory.
65
+ Run az2aws with a volume mounted to your AWS configuration directory:
56
66
 
57
67
  docker run --rm -it -v ~/.aws:/root/.aws az2aws/az2aws
58
68
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "az2aws",
3
- "version": "1.1.0",
3
+ "version": "1.1.1",
4
4
  "description": "Use Azure AD SSO to log into the AWS CLI. A modern, actively maintained alternative to aws-azure-login.",
5
5
  "main": "index.js",
6
6
  "author": {
@@ -55,6 +55,7 @@
55
55
  "dependencies": {
56
56
  "@aws-sdk/client-sts": "^3.723.0",
57
57
  "@smithy/node-http-handler": "^2.5.0",
58
+ "az2aws": "^1.1.0",
58
59
  "bluebird": "^3.7.2",
59
60
  "cheerio": "^1.0.0-rc.10",
60
61
  "commander": "^9.5.0",