https://github.com/abyss/tfws

Terraform Workspace Selector
https://github.com/abyss/tfws

Last synced: about 1 month ago
JSON representation

Terraform Workspace Selector

• Host: GitHub
• URL: https://github.com/abyss/tfws
• Owner: abyss
• License: mit
• Created: 2023-06-16T16:52:08.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-06-19T16:32:26.000Z (7 months ago)
• Last Synced: 2024-07-24T08:24:34.362Z (5 months ago)
• Language: Go
• Size: 13.7 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# tfws - Terraform Workspace Selector

The Terraform Workspace Selector is a command-line tool that helps you interactively select a Terraform workspace from the available options.

## Functionality

The application provides the following basic functionality:

- Retrieves the list of Terraform workspaces using the `terraform workspace list` command.

- Displays an interactive prompt that allows you to select a workspace.

- Sets the selected workspace using the `terraform workspace select` command.

## Requirements

`tfws` calls `terraform` directly, so terraform will need to be resolvable from your PATH. Tools like [tenv](https://github.com/tofuutils/tenv) or [asdf](https://github.com/asdf-vm/asdf) should natively work.

## Install

The Terraform Workspace Selector can be installed on macOS, Linux, or Windows, and should work with most standard shells, including PowerShell.

To install Terraform Workspace Selector, you can do either of the following:

- Install using Homebrew: `brew install abyss/tools/tfws`

- Download a binary from the [GitHub releases page](https://github.com/abyss/tfws/releases) and put it in your PATH.

## Usage

To use the Terraform Workspace Selector, just run `tfws` in a Terraform project with multiple workspaces.

Upon running the application, it will retrieve the list of Terraform workspaces and display an interactive prompt. Use the arrow keys or fuzzy search to navigate the options and press Enter to select a workspace. The selected workspace will be set using the `terraform workspace select` command.

## Contributing

Contributions in the form of issues and pull requests are welcome. 😄

## License

This project is licensed under the [ISC License](LICENSE.md).

Copyright (c) 2024 Abyss