awswap 0.4.1

Fast AWS profile switching with credential validation and ECR authentication
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81

# Contributing

Thank you for helping improve `awswap`. Use a GitHub issue to report a bug or
suggest a change. Open a pull request when you have a tested fix.

## Development setup

1. Install Rust 1.88.0 using `rustup` or `mise`.
2. Install AWS CLI v2.
3. Install prek 0.4.12:

   ```sh
   uv tool install prek==0.4.12
   ```

4. Clone the repository:

   ```sh
   git clone https://github.com/drew-simmons/awswap.git
   cd awswap
   ```

5. Install the Git hook:

   ```sh
   prek install
   ```

6. Run the hooks and build the crate package:

   ```sh
   prek run --all-files
   cargo package --locked --allow-dirty
   ```

The hook runs repository hygiene checks, `cargo fmt`, Clippy with warnings
denied, and the test suite. The equivalent Rust commands are:

```sh
cargo fmt --all --check
cargo clippy --locked --all-targets --all-features -- -D warnings
cargo test --locked --all-targets
```

> [!IMPORTANT]
> Tests must not require live AWS credentials or change a developer's AWS,
> Docker, or Helm setup. Test parsing and command construction where possible.

## Commit messages

Use Conventional Commit subjects because release automation derives versions
and release notes from commits merged to `main`:

```text
fix: handle expired SSO sessions
feat: add profile aliases
feat!: change the shell hook protocol
```

Use `fix:` for bug fixes, `feat:` for features, and `!` or a
`BREAKING CHANGE:` footer for incompatible changes. Types such as `docs:`,
`test:`, `ci:`, and `chore:` do not trigger a release by themselves.

> [!TIP]
> The pull request title should follow this format. The project uses squash
> merges, so that title becomes the commit subject on `main`.

## Pull requests

- Keep changes focused and explain their user-visible impact.
- Add tests for new behavior and regressions.
- Update the docs when commands, environment variables, or requirements
  change.
- Do not commit credentials, AWS configuration, generated build output, or local
  tool state.

Before you open a pull request, run both checks from the setup steps and
describe any check you could not run.

By contributing, you agree that your contributions are licensed under the MIT
License.