pulumi-language-ruby 0.0.1

data/pulumi/converter.proto

@@ -0,0 +1,94 @@
+// Copyright 2016-2023, Pulumi Corporation.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+import "pulumi/codegen/hcl.proto";
+
+package pulumirpc;
+
+option go_package = "github.com/pulumi/pulumi/sdk/v3/proto/go;pulumirpc";
+
+// Converter is a service for converting between other ecosystems and Pulumi.
+// This is currently unstable and experimental.
+service Converter {
+    // ConvertState converts state from the target ecosystem into a form that can be imported into Pulumi.
+    rpc ConvertState(ConvertStateRequest) returns (ConvertStateResponse) {}
+
+    // ConvertProgram converts a program from the target ecosystem into a form that can be used with Pulumi.
+    rpc ConvertProgram(ConvertProgramRequest) returns (ConvertProgramResponse) {}
+}
+
+message ConvertStateRequest {
+    // the gRPC target of the mapper service.
+    string mapper_target = 1;
+    // the args passed to `pulumi import` for this conversion. Normally used to specifiy a state file to
+    // import from.
+    repeated string args = 2;
+}
+
+// A ResourceImport specifies a resource to import.
+message ResourceImport {
+    // the type token for the resource.
+    string type = 1;
+    // the name of the resource.
+    string name = 2;
+    // the ID of the resource.
+    string id = 3;
+
+    // the provider version to use for the resource, if any.
+    string version = 4;
+    // the provider PluginDownloadURL to use for the resource, if any.
+    string pluginDownloadURL = 5;
+
+    // the logical name of the resource.
+    string logical_name = 6;
+
+    // true if this is a component resource.
+    bool is_component = 7;
+    // true if this is a remote resource. Ignored if is_component is false.
+    bool is_remote = 8;
+}
+
+message ConvertStateResponse {
+
+    // a list of resources to import.
+    repeated ResourceImport resources = 1;
+
+    // any diagnostics from state conversion.
+    repeated pulumirpc.codegen.Diagnostic diagnostics = 2;
+}
+
+message ConvertProgramRequest {
+    // the source directory containing the program to convert from.
+    string source_directory = 1;
+    // a target directory to write the resulting PCL code and project file to.
+    string target_directory = 2;
+    // the gRPC target of the mapper service.
+    string mapper_target = 3;
+    // The target of a codegen.LoaderServer to use for loading schemas.
+    string loader_target = 4;
+    // the args passed to `pulumi convert` for this conversion. Normally used to specifiy a root file, or conversion options.
+    repeated string args = 5;
+    // the directory where the final generated project for the eventual destination language will be written.
+    // use to determine relative paths of any asset that will be copied over.
+    // Do not write files to this directory as these files might be overwritten in 
+    // the project generation process.
+    string generated_project_directory = 6;
+}
+
+message ConvertProgramResponse {
+    // any diagnostics from code generation.
+    repeated pulumirpc.codegen.Diagnostic diagnostics = 1;
+}

data/pulumi/engine.proto

@@ -0,0 +1,113 @@
+// Copyright 2016-2026, Pulumi Corporation.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+import "google/protobuf/empty.proto";
+import "google/protobuf/struct.proto";
+
+package pulumirpc;
+
+option go_package = "github.com/pulumi/pulumi/sdk/v3/proto/go;pulumirpc";
+
+// Engine is an auxiliary service offered to language and resource provider plugins. Its main purpose today is
+// to serve as a common logging endpoint, but it also serves as a state storage mechanism for language hosts
+// that can't store their own global state.
+service Engine {
+    // Log logs a global message in the engine, including errors and warnings.
+    rpc Log(LogRequest) returns (google.protobuf.Empty) {}
+
+    // GetRootResource gets the URN of the root resource, the resource that should be the root of all
+    // otherwise-unparented resources.
+    rpc GetRootResource(GetRootResourceRequest) returns (GetRootResourceResponse) {}
+
+    // SetRootResource sets the URN of the root resource.
+    rpc SetRootResource(SetRootResourceRequest) returns (SetRootResourceResponse) {}
+
+    // StartDebugging indicates to the engine that the program has started under a debugger, and the engine
+    // should notify the user of how to connect to the debugger.
+    rpc StartDebugging(StartDebuggingRequest) returns (google.protobuf.Empty) {}
+
+    // RequirePulumiVersion checks that the version of the engine satisfies the passed in range.
+    rpc RequirePulumiVersion(RequirePulumiVersionRequest) returns (RequirePulumiVersionResponse) {}
+}
+
+// LogSeverity is the severity level of a log message.  Errors are fatal; all others are informational.
+enum LogSeverity {
+    DEBUG = 0;   // a debug-level message not displayed to end-users (the default).
+    INFO = 1;    // an informational message printed to output during resource operations.
+    WARNING = 2; // a warning to indicate that something went wrong.
+    ERROR = 3;   // a fatal error indicating that the tool should stop processing subsequent resource operations.
+}
+
+message LogRequest {
+    // the logging level of this message.
+    LogSeverity severity = 1;
+
+    // the contents of the logged message.
+    string message = 2;
+
+    // the (optional) resource urn this log is associated with.
+    string urn = 3;
+
+    // the (optional) stream id that a stream of log messages can be associated with. This allows
+    // clients to not have to buffer a large set of log messages that they all want to be
+    // conceptually connected.  Instead the messages can be sent as chunks (with the same stream id)
+    // and the end display can show the messages as they arrive, while still stitching them together
+    // into one total log message.
+    //
+    // 0/not-given means: do not associate with any stream.
+    int32 streamId = 4;
+
+    // Optional value indicating whether this is a status message.
+    bool ephemeral = 5;
+}
+
+message GetRootResourceRequest {
+    // empty.
+}
+
+message GetRootResourceResponse {
+    // the URN of the root resource, or the empty string if one was not set.
+    string urn = 1;
+}
+
+message SetRootResourceRequest {
+    // the URN of the root resource, or the empty string.
+    string urn = 1;
+}
+
+message SetRootResourceResponse {
+    // empty.
+}
+
+message StartDebuggingRequest {
+    // the debug configuration parameters.  These are meant to be in the right format for the DAP protocol to consume.
+    google.protobuf.Struct config = 1;
+    // the string to display to the user with instructions on how to connect to the debugger.
+    string message = 2;
+}
+
+message RequirePulumiVersionRequest {
+    // A version range to check against the engine (CLI) version. If the version is not compatible with the specified
+    // range, an error is returned. The supported syntax for ranges is that of
+    // https://pkg.go.dev/github.com/blang/semver#ParseRange. For example ">=3.0.0", or "!3.1.2". Ranges can be AND-ed
+    // together by concatenating with spaces ">=3.5.0 !3.7.7", meaning greater-or-equal to 3.5.0 and not exactly 3.7.7.
+    // Ranges can be OR-ed with the `||` operator: "<3.4.0 || >3.8.0", meaning less-than 3.4.0 or greater-than 3.8.0.
+    string pulumi_version_range = 1;
+}
+
+message RequirePulumiVersionResponse {
+    // empty
+}

data/pulumi/errors.proto

@@ -0,0 +1,38 @@
+// Copyright 2016-2018, Pulumi Corporation.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package pulumirpc;
+
+option go_package = "github.com/pulumi/pulumi/sdk/v3/proto/go;pulumirpc";
+
+message ErrorCause {
+    string message = 1;
+    string stackTrace = 2;
+}
+
+// An error that can be returned from a component provider and includes details of the
+// error, which can be multiple properties.
+message InputPropertiesError {
+    // A single invalid input property.
+    message PropertyError {
+        // The path to the property that is invalid.
+        string property_path = 1;
+	// The reason the property is invalid.
+        string reason = 2;
+    }
+    // The list of invalid input properties.
+    repeated PropertyError errors = 1;
+}

data/pulumi/events.proto

@@ -0,0 +1,39 @@
+// Copyright 2025, Pulumi Corporation.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+import "google/protobuf/empty.proto";
+
+package pulumirpc;
+
+option go_package = "github.com/pulumi/pulumi/sdk/v3/proto/go;pulumirpc";
+
+// Events is a service for receiving engine events over gRPC.
+// This service allows the Pulumi CLI to send engine events to clients
+// (such as the Automation API) over a gRPC stream instead of writing them to
+// a file on the filesystem and reading them from there.
+service Events {
+    // StreamEvents allows the client to stream multiple engine events to the server.
+    // The client sends multiple EventRequest messages over the stream, and the server
+    // processes them as they arrive. When the client is done sending events, it closes
+    // the stream.
+    rpc StreamEvents(stream EventRequest) returns (google.protobuf.Empty) {}
+}
+
+// EventRequest contains a single engine event.
+message EventRequest {
+    // event is a JSON-encoded string containing the engine event data.
+    string event = 1;
+}