opentofu/internal/tfplugin5/generate.sh

#!/bin/bash

# We do not run protoc under go:generate because we want to ensure that all
# dependencies of go:generate are "go get"-able for general dev environment
# usability. To compile all protobuf files in this repository, run
# "make protobuf" at the top-level.

set -eu

SOURCE="${BASH_SOURCE[0]}"
while [ -h "$SOURCE" ] ; do SOURCE="$(readlink "$SOURCE")"; done
DIR="$( cd -P "$( dirname "$SOURCE" )" && pwd )"

cd "$DIR"

protoc -I ./ tfplugin5.proto --go_out=plugins=grpc:./
build: Take protoc out of the "go generate" path Since protoc is not go-gettable, and most development tasks in Terraform won't involve recompiling protoc files anyway, we'll use a separate mechanism for these. This way "go generate" only depends on things we can "go get" in the "make tools" target. In a later commit we should also in some way specify a particular version of protoc to use so that we don't get "flapping" regenerations as developers work with different versions, but the priority here is just to make "make generate" minimally usable again to restore the dev workflow documented in the README. This also includes some updates that resulted from running "make generate" and "make protobuf" after those Makefile changes were in place. 2018-10-18 11:27:48 -05:00			`#!/bin/bash`

			`# We do not run protoc under go:generate because we want to ensure that all`
			`# dependencies of go:generate are "go get"-able for general dev environment`
			`# usability. To compile all protobuf files in this repository, run`
			`# "make protobuf" at the top-level.`

			`set -eu`

			`SOURCE="${BASH_SOURCE[0]}"`
			`while [ -h "$SOURCE" ] ; do SOURCE="$(readlink "$SOURCE")"; done`
			`DIR="$( cd -P "$( dirname "$SOURCE" )" && pwd )"`

			`cd "$DIR"`

plugin: Establish our current plugin protocol as version 5 The main significant change here is that the package name for the proto definition is "tfplugin5", which is important because this name is part of the wire protocol for references to types defined in our package. Along with that, we also move the generated package into "internal" to make it explicit that importing the generated Go package from elsewhere is not the right approach for externally-implemented SDKs, which should instead vendor the proto definition they are using and generate their own stubs to ensure that the wire protocol is the only hard dependency between Terraform Core and plugins. After this is merged, any provider binaries built against our helper/schema package will need to be rebuilt so that they use the new "tfplugin5" package name instead of "proto". In a future commit we will include more elaborate and organized documentation on how an external codebase might make use of our RPC interface definition to implement an SDK, but the primary concern here is to ensure we have the right wire package name before release. 2018-11-19 11:39:16 -06:00			`protoc -I ./ tfplugin5.proto --go_out=plugins=grpc:./`