{"id":13728060,"url":"https://github.com/cunymatthieu/tgenv","last_synced_at":"2025-05-08T00:31:00.749Z","repository":{"id":20527106,"uuid":"90166900","full_name":"cunymatthieu/tgenv","owner":"cunymatthieu","description":"Terragrunt version manager","archived":false,"fork":false,"pushed_at":"2023-10-08T16:38:28.000Z","size":21,"stargazers_count":223,"open_issues_count":30,"forks_count":70,"subscribers_count":11,"default_branch":"master","last_synced_at":"2024-11-09T11:43:39.113Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cunymatthieu.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-05-03T15:52:51.000Z","updated_at":"2024-09-09T11:12:48.000Z","dependencies_parsed_at":"2024-06-20T17:22:50.684Z","dependency_job_id":"6c11c18a-fc72-4ff0-bb6b-8b6f0d36bbe2","html_url":"https://github.com/cunymatthieu/tgenv","commit_stats":{"total_commits":18,"total_committers":7,"mean_commits":"2.5714285714285716","dds":0.5555555555555556,"last_synced_commit":"dd720f62051bb748f75eee2d83d6768171d45830"},"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cunymatthieu%2Ftgenv","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cunymatthieu%2Ftgenv/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cunymatthieu%2Ftgenv/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cunymatthieu%2Ftgenv/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cunymatthieu","download_url":"https://codeload.github.com/cunymatthieu/tgenv/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224679804,"owners_count":17351872,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-03T02:00:36.690Z","updated_at":"2024-11-14T19:30:34.316Z","avatar_url":"https://github.com/cunymatthieu.png","language":"Shell","funding_links":[],"categories":["List of \\*env-, ch\\*- and \\*vm- style version managers"],"sub_categories":[],"readme":"[![Build Status](https://travis-ci.org/cunymatthieu/tgenv.svg?branch=master)](https://travis-ci.org/cunymatthieu/tgenv)\n\n# tgenv\n[Terragrunt](https://github.com/gruntwork-io/terragrunt) version manager inspired by [tfenv](https://github.com/kamatama41/tfenv)\n\n\n## Support\nCurrently tgenv supports the following OSes\n- Mac OS X (64bit)\n- Linux (64bit)\n\n## Installation\n\n1. Check out tgenv into any path (here is `${HOME}/.tgenv`)\n\n  ```bash\n  $ git clone https://github.com/cunymatthieu/tgenv.git ~/.tgenv\n  ```\n\n2. Add `~/.tgenv/bin` to your `$PATH` any way you like\n\n  ```bash\n  $ echo 'export PATH=\"$HOME/.tgenv/bin:$PATH\"' \u003e\u003e ~/.bash_profile\n  ```\n\n  OR you can make symlinks for `tgenv/bin/*` scripts into a path that is already added to your `$PATH` (e.g. `/usr/local/bin`) `OSX/Linux Only!`\n\n  ```bash\n  $ ln -s ~/.tgenv/bin/* /usr/local/bin\n  ```\n\n## Usage\n### tgenv install\nInstall a specific version of terragrunt  \n`latest` is a syntax to install latest version\n`latest:\u003cregex\u003e` is a syntax to install latest version matching regex (used by grep -e)\n\n```bash\n$ tgenv install 0.12.12\n$ tgenv install latest\n$ tgenv install latest:^0.9\n```\n\nIf you use [.terragrunt-version](#terragrunt-version), `tgenv install` (no argument) will install the version written in it.\n\n### tgenv use\nSwitch a version to use\n`latest` is a syntax to use the latest installed version\n`latest:\u003cregex\u003e` is a syntax to use latest installed version matching regex (used by grep -e)\n\n```bash\n$ tgenv use 0.12.1\n$ tgenv use latest\n$ tgenv use latest:^0.10\n```\n\n### tgenv uninstall\nUninstall a specific version of terragrunt\n`latest` is a syntax to uninstall latest version\n`latest:\u003cregex\u003e` is a syntax to uninstall latest version matching regex (used by grep -e)\n\n```bash\n$ tgenv uninstall 0.12.1\n$ tgenv uninstall latest\n$ tgenv uninstall latest:^0.9\n```\n\n### tgenv list\nList installed versions\n\n```bash\n% tgenv list\n0.12.15\n0.12.8\n0.10.0\n0.9.9\n```\n\n### tgenv list-remote\nList installable versions\n\n```bash\n% tgenv list-remote\n0.12.15\n0.12.14\n0.12.13\n0.12.12\n0.12.11\n0.12.10\n0.12.9\n0.12.8\n0.12.7\n0.12.6\n0.12.5\n0.12.4\n0.12.3\n0.12.2\n0.12.1\n0.12.0\n0.11.1\n0.11.0\n0.10.3\n0.10.2\n0.10.1\n0.10.0\n0.9.9\n...\n```\n\n## .terragrunt-version\nIf you put `.terragrunt-version` file on your project root, tgenv detects it and use the version written in it. If the version is `latest` or `latest:\u003cregex\u003e`, the latest matching version currently installed will be selected.\n\n```bash\n$ cat .terragrunt-version\n0.9.9\n\n$ terragrunt --version\nterragrunt version v0.9.9\n\nYour version of terragrunt is out of date! The latest version\nis 0.7.3. You can update by downloading from www.terragrunt.io\n\n$ echo 0.9.9 \u003e .terragrunt-version\n\n$ terragrunt --version\nterragrunt v0.12.15\n\n$ echo latest:^0.10 \u003e .terragrunt-version\n\n$ terragrunt --version\nterragrunt v0.10.3\n```\n\n### Environment Variables\n\n#### TGENV\n\n##### `TGENV_AUTO_INSTALL`\n\nString (Default: true)\n\nShould tgenv automatically install terragrunt if the version specified by defaults or a .terragrunt-version file is not currently installed.\n\n```console\nTGENV_AUTO_INSTALL=false terragrunt plan\n```\n\n##### `TGENV_DEBUG`\n\nInteger (Default: \"\")\n\nSet the debug level for TGENV.\n\n* unset/empty-string: No debug output\n* set: Bash execution tracing\n\n## Upgrading\n```bash\n$ git --git-dir=~/.tgenv/.git pull\n```\n\n## Uninstalling\n```bash\n$ rm -rf /some/path/to/tgenv\n```\n\n## LICENSE\n- [tgenv itself](https://github.com/cunymatthieu/tgenv/blob/master/LICENSE)\n- [tfenv ](https://github.com/kamatama41/tgenv/blob/master/LICENSE) : tfenv mainly uses tfenv's source code\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcunymatthieu%2Ftgenv","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcunymatthieu%2Ftgenv","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcunymatthieu%2Ftgenv/lists"}