Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/warrensbox/terraform-switcher

A command line tool to switch between different versions of terraform (install with homebrew and more)
https://github.com/warrensbox/terraform-switcher

go golang terraform

Last synced: about 1 month ago
JSON representation

A command line tool to switch between different versions of terraform (install with homebrew and more)

Host: GitHub
URL: https://github.com/warrensbox/terraform-switcher
Owner: warrensbox
License: mit
Created: 2018-04-30T19:54:04.000Z (over 6 years ago)
Default Branch: master
Last Pushed: 2024-04-13T18:14:28.000Z (7 months ago)
Last Synced: 2024-04-14T05:37:21.580Z (7 months ago)
Topics: go, golang, terraform
Language: Go
Homepage: https://tfswitch.warrensbox.com
Size: 41 MB
Stars: 1,294
Watchers: 15
Forks: 130
Open Issues: 36
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

awesome-golang-repositories - terraform-switcher
awesome-sysadmin-tools - tfswitch - The tfswitch command line tool lets you switch between different versions of terraform (Infrastructure / Terraform)
awesomeness - Terraform Switcher - Easily manage multiple versions of Terraform. (📜 Infrastructure as Code (IaC))

README

[![Build Status](https://github.com/warrensbox/terraform-switcher/actions/workflows/build.yml/badge.svg)](https://github.com/warrensbox/terraform-switcher/actions/workflows/build.yml)
[![Go Report Card](https://goreportcard.com/badge/github.com/warrensbox/terraform-switcher)](https://goreportcard.com/report/github.com/warrensbox/terraform-switcher)
![GitHub Release](https://img.shields.io/github/v/release/warrensbox/terraform-switcher)
![GitHub Downloads (all assets, all releases)](https://img.shields.io/github/downloads/warrensbox/terraform-switcher/total)
![GitHub go.mod Go version](https://img.shields.io/github/go-mod/go-version/warrensbox/terraform-switcher)

# Terraform Switcher

drawing

The `tfswitch` command line tool lets you switch between different versions of [Terraform](https://www.terraform.io/).
If you do not have a particular version of Terraform installed, `tfswitch` will download and verify the version you desire.
The installation is minimal and easy.
Once installed, simply select the version you require from the dropdown and start using Terraform.

## Documentation

Click [here](https://tfswitch.warrensbox.com) for our extended documentation.

## NOTE

Going forward we will change the version identifier of `tfswitch` to align with the common go package versioning.
Please be advised to change any automated implementation you might have that is relying on the `tfswitch` version string.
**Old version string:** `0.1.2412`
**New version string:** `v1.0.0` Note the `v` that is preceding all version numbers.

## Installation

`tfswitch` is available as a binary and on various package managers (eg. Homebrew).

## Windows

Download and extract the Windows version of `tfswitch` that is compatible with your system.
We are building binaries for 386, amd64, arm6 and arm7 CPU structure.
See the [release page](https://github.com/warrensbox/terraform-switcher/releases/latest) for your download.

## Homebrew

For macOS or various Linux distributions, Homebrew offers the simplest installation process. If you do not have homebrew installed, click here.

```shell
brew install warrensbox/tap/tfswitch
```

## Linux

Installation for Linux operating systems.

```sh
curl -L https://raw.githubusercontent.com/warrensbox/terraform-switcher/master/install.sh | bash
```

## Arch User Repository (AUR) packages for Arch Linux

```sh
# compiled from source
yay tfswitch

# precompiled
yay tfswitch-bin
```

## Install from source

Alternatively, you can install the binary from the source here.

See [our installation documentation](https://tfswitch.warrensbox.com/Installation) for more details.

> [!IMPORTANT]
> The version identifier of `tfswitch` has changed to align with the common `go` package versioning.
>
> Version numbers will now be prefixed with a `v` - eg. `v1.0.3`.
>
> Please change any automated implementations relying on the `tfswitch` version string.
>
> **Old version string:** `0.1.2412`
> **New version string:** `v1.0.3`

[Having trouble installing](https://tfswitch.warrensbox.com/Troubleshoot/)

## Quick Start

### Dropdown Menu

Execute `tfswitch` and select the desired Terraform version via the dropdown menu.

### Version on command line

Use `tfswitch 1.7.0` to install Terraform version 1.7.0. Replace the version number as required.

More [usage guide here](https://tfswitch.warrensbox.com/usage/commandline/)

## How to contribute

An open source project becomes meaningful when people collaborate to improve the code.
Feel free to look at the code, critique and make suggestions. Let's make `tfswitch` better!

See step-by-step instructions on how to contribute here: [Contribute](https://tfswitch.warrensbox.com/How-to-Contribute/)

## Additional Info

See how to [*upgrade* and *uninstall*](https://tfswitch.warrensbox.com/Upgrade-or-Uninstall/) or [*troubleshoot*](https://tfswitch.warrensbox.com/Troubleshoot/)

## Issues

Please open *issues* here: [New Issue](https://github.com/warrensbox/terraform-switcher/issues)