{"id":15176285,"url":"https://github.com/hashicorp/terraform-provider-local","last_synced_at":"2026-03-08T21:02:17.808Z","repository":{"id":37899639,"uuid":"93446129","full_name":"hashicorp/terraform-provider-local","owner":"hashicorp","description":"Utility provider used to manage local resources, such as creating files.","archived":false,"fork":false,"pushed_at":"2025-05-15T17:31:10.000Z","size":11180,"stargazers_count":224,"open_issues_count":36,"forks_count":68,"subscribers_count":25,"default_branch":"main","last_synced_at":"2025-05-15T18:37:01.068Z","etag":null,"topics":["local","terraform","terraform-provider"],"latest_commit_sha":null,"homepage":"https://registry.terraform.io/providers/hashicorp/local/latest","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hashicorp.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":".github/SUPPORT.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2017-06-05T20:54:15.000Z","updated_at":"2025-05-15T17:31:13.000Z","dependencies_parsed_at":"2023-07-13T13:57:35.052Z","dependency_job_id":"2699fe67-e111-4353-9276-da9aa753f41c","html_url":"https://github.com/hashicorp/terraform-provider-local","commit_stats":{"total_commits":413,"total_committers":34,"mean_commits":"12.147058823529411","dds":0.6537530266343825,"last_synced_commit":"c1e507704407cf37acbe8cdc62b9eae5ecced72d"},"previous_names":["terraform-providers/terraform-provider-local"],"tags_count":22,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hashicorp%2Fterraform-provider-local","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hashicorp%2Fterraform-provider-local/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hashicorp%2Fterraform-provider-local/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hashicorp%2Fterraform-provider-local/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hashicorp","download_url":"https://codeload.github.com/hashicorp/terraform-provider-local/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254509476,"owners_count":22082891,"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":["local","terraform","terraform-provider"],"created_at":"2024-09-27T13:01:34.518Z","updated_at":"2025-12-12T00:36:33.360Z","avatar_url":"https://github.com/hashicorp.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Terraform Provider: Local\n\nThe Local provider is used to manage local resources, such as files.\n\n\n**Note** Terraform primarily deals with remote resources which are able\nto outlive a single Terraform run, and so local resources can sometimes violate\nits assumptions. The resources here are best used with care, since depending\non local state can make it hard to apply the same Terraform configuration on\nmany different local systems where the local resources may not be universally\navailable. See specific notes in each resource for more information.\n\n\n## Documentation, questions and discussions\n\nOfficial documentation on how to use this provider can be found on the\n[Terraform Registry](https://registry.terraform.io/providers/hashicorp/local/latest/docs).\nIn case of specific questions or discussions, please use the\nHashiCorp [Terraform Providers Discuss forums](https://discuss.hashicorp.com/c/terraform-providers/31),\nin accordance with HashiCorp [Community Guidelines](https://www.hashicorp.com/community-guidelines).\n\nWe also provide:\n\n* [Support](.github/SUPPORT.md) page for help when using the provider\n* [Contributing](.github/CONTRIBUTING.md) guidelines in case you want to help this project\n\nThe remainder of this document will focus on the development aspects of the provider.\n\n## Compatibility\n\nCompatibility table between this provider, the [Terraform Plugin Protocol](https://www.terraform.io/plugin/how-terraform-works#terraform-plugin-protocol)\nversion it implements, and Terraform:\n\n| TLS Provider | Terraform Plugin Protocol | Terraform |\n|:------------:|:-------------------------:|:---------:|\n|   `\u003e= 2.x`   |            `5`            | `\u003e= 0.12` |\n|  `\u003e= 1.1.x`  |        `4` and `5`        | `\u003c= 0.12` |\n|   `\u003e= 0.x`   |            `4`            | `\u003c= 0.11` |\n\nDetails can be found querying the [Registry API](https://www.terraform.io/internals/provider-registry-protocol#list-available-versions)\nthat return all the details about which version are currently available for a particular provider.\n[Here](https://registry.terraform.io/v1/providers/hashicorp/local/versions) are the details for Local (JSON response).\n\n## Requirements\n\n* [Terraform](https://www.terraform.io/downloads)\n* [Go](https://go.dev/doc/install) (1.23)\n* [GNU Make](https://www.gnu.org/software/make/)\n* [golangci-lint](https://golangci-lint.run/usage/install/#local-installation) (optional)\n\n## Development\n\n### Building\n\n1. `git clone` this repository and `cd` into its directory\n2. `make` will trigger the Golang build\n\nThe provided `GNUmakefile` defines additional commands generally useful during development,\nlike for running tests, generating documentation, code formatting and linting.\nTaking a look at it's content is recommended.\n\n### Testing\n\nIn order to test the provider, you can run\n\n* `make test` to run provider tests\n* `make testacc` to run provider acceptance tests\n\nIt's important to note that acceptance tests (`testacc`) will actually spawn\n`terraform` and the provider. Read more about they work on the\n[official page](https://www.terraform.io/plugin/sdkv2/testing/acceptance-tests).\n\n### Generating documentation\n\nThis provider uses [terraform-plugin-docs](https://github.com/hashicorp/terraform-plugin-docs/)\nto generate documentation and store it in the `docs/` directory.\nOnce a release is cut, the Terraform Registry will download the documentation from `docs/`\nand associate it with the release version. Read more about how this works on the\n[official page](https://www.terraform.io/registry/providers/docs).\n\nUse `make generate` to ensure the documentation is regenerated with any changes.\n\n### Using a development build\n\nIf [running tests and acceptance tests](#testing) isn't enough, it's possible to set up a local terraform configuration\nto use a development builds of the provider. This can be achieved by leveraging the Terraform CLI\n[configuration file development overrides](https://www.terraform.io/cli/config/config-file#development-overrides-for-provider-developers).\n\nFirst, use `make install` to place a fresh development build of the provider in your\n[`${GOBIN}`](https://pkg.go.dev/cmd/go#hdr-Compile_and_install_packages_and_dependencies)\n(defaults to `${GOPATH}/bin` or `${HOME}/go/bin` if `${GOPATH}` is not set). Repeat\nthis every time you make changes to the provider locally.\n\nThen, setup your environment following [these instructions](https://www.terraform.io/plugin/debugging#terraform-cli-development-overrides)\nto make your local terraform use your local build.\n\n### Testing GitHub Actions\n\nThis project uses [GitHub Actions](https://docs.github.com/en/actions/automating-builds-and-tests) to realize its CI.\n\nSometimes it might be helpful to locally reproduce the behaviour of those actions,\nand for this we use [act](https://github.com/nektos/act). Once installed, you can _simulate_ the actions executed\nwhen opening a PR with:\n\n```shell\n# List of workflows for the 'pull_request' action\n$ act -l pull_request\n\n# Execute the workflows associated with the `pull_request' action \n$ act pull_request\n```\n\n## Releasing\n\nThe releasable builds are generated from the [build GH workflow](./.github/workflows/build.yml) and the release/promotion process\nis completed via internal HashiCorp deployment tooling. Prior to release, the changelog should be updated in `main` with\nthe changie tool, example:\n\n```sh\nchangie batch 2.5.3 \u0026\u0026 changie merge\n```\n\n## License\n\n[Mozilla Public License v2.0](./LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhashicorp%2Fterraform-provider-local","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhashicorp%2Fterraform-provider-local","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhashicorp%2Fterraform-provider-local/lists"}