https://github.com/cappyzawa/tfswitch

Command for switching the terraform version, which can run the terraform binary.
https://github.com/cappyzawa/tfswitch

cli go terraform

Last synced: about 2 months ago
JSON representation

Command for switching the terraform version, which can run the terraform binary.

• Host: GitHub
• URL: https://github.com/cappyzawa/tfswitch
• Owner: cappyzawa
• License: mpl-2.0
• Created: 2021-01-14T08:33:13.000Z (almost 4 years ago)
• Default Branch: main
• Last Pushed: 2024-06-05T02:28:43.000Z (7 months ago)
• Last Synced: 2024-06-19T05:58:21.804Z (6 months ago)
• Topics: cli, go, terraform
• Language: Go
• Homepage:
• Size: 150 KB
• Stars: 12
• Watchers: 1
• Forks: 3
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# tfswitch

[![BuildStatus](https://github.com/cappyzawa/tfswitch/actions/workflows/ci.yml/badge.svg)](https://github.com/cappyzawa/tfswitch/actions?query=workflow%3ACI)

[![Go Report Card](https://goreportcard.com/badge/github.com/cappyzawa/tfswitch)](https://goreportcard.com/report/github.com/cappyzawa/tfswitch)

[![PkgGoDev](https://pkg.go.dev/badge/github.com/cappyzawa/tfswitch)](https://pkg.go.dev/github.com/cappyzawa/tfswitch)

## Motivation

[tfutils/tfenv: Terraform version manager](https://github.com/tfutils/tfenv) is great tool for switching the terraform version used in local.

However, There is an issue that it takes extra time to execute the command. (This is referred by [terraform executions delayed by ~ 1 second · Issue \#196 · tfutils/tfenv](https://github.com/tfutils/tfenv/issues/196)). If you want to display the terraform version in the prompt, you will have to wait almost a second every time the it is updated.

This tool can also switch the terraform version. This installs binary from https://releases.hashicorp.com/terraform/ if specified version does not found in your machine. 

`tfenv` runs own script instead of binary, but this tool runs binary directly.

## How to use

### Install

```bash

$ go install github.com/cappyzawa/tfswitch/v2/cmd/tfswitch@latest

```

or download from [Releases · cappyzawa/tfswitch](https://github.com/cappyzawa/tfswitch/releases).

### Use

```bash

$ tfswitch -h

Usage: tfswitch [--version] [--help]  []

Available commands are:

    local-list     display available terraform versions in local.

    remote-list    display available terraform versions in remote. (https://releases.hashicorp.com/terraform/)

    use            use specified terraform version.

```

```bash

$ tfswitch use [version]

# e.g., If you want to use 0.14.4

$ tfswitch use 0.14.4

Switched terraform version to 0.14.4

# This tool creates or replaces symbolic links.

$ ls -l `which terraform`

lrwxr-xr-x  1 cappyzawa  admin  54 Jan 14 20:14 /usr/local/bin/terraform@ -> /Users/cappyzawa/.local/share/tfswitch/terraform_0.14.4

$ tfswitch 0.14.3

$ ls -l `which terraform`

lrwxr-xr-x  1 cappyzawa  admin  54 Jan 14 20:18 /usr/local/bin/terraform@ -> /Users/cappyzawa/.local/share/tfswitch/terraform_0.14.3

```

#### Available Environments

* `XDG_DATA_HOME` (Default: `~/.local/share`): The specified version of `terraform` will be saved as `$XDG_DATA_HOME/tfswitch/terraform_[version]`

#### Interactive switch

```bash

# from remote-list

$ tfswitch remote-list | fzf --reverse | xargs tfswitch use

# from local-list

$ tfswitch local-list | fzf --reverse | xargs tfswitch use

```