mirror of
https://github.com/apple/pkl.git
synced 2026-09-10 11:51:53 +02:00
Daniel Chao
adee565a8c
This moves the protobuf module from experimental to deprecated Rationale: * This is very seldom used, if used at all * Not fully fleshed out (this really should be paired with a protoc-gen-pkl, which doesn't exist) * There is a ProtoJSON wire format that we can already render to
67 lines
2.5 KiB
Plaintext
67 lines
2.5 KiB
Plaintext
//===----------------------------------------------------------------------===//
|
|
// Copyright © 2024-2026 Apple Inc. and the Pkl project authors. All rights reserved.
|
|
//
|
|
// 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
|
|
//
|
|
// https://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.
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
/// A renderer for [Protocol Buffers](https://developers.google.com/protocol-buffers).
|
|
///
|
|
/// WARNING:
|
|
/// This module is deprecated, and scheduled for removal without replacement.
|
|
/// For rendering into a protobuf wire format, consider rendering to
|
|
/// [ProtoJSON](https://protobuf.dev/programming-guides/json/) using [json.Renderer].
|
|
@ModuleInfo { minPklVersion = "0.33.0" }
|
|
@Deprecated { since = "0.33.0"; message = "Scheduled for removal without replacement" }
|
|
module pkl.protobuf
|
|
|
|
import "pkl:json"
|
|
import "pkl:reflect"
|
|
|
|
/// A renderer for [Protocol Buffers](https://developers.google.com/protocol-buffers).
|
|
/// Note: This class is _experimental_ and not ready for production use.
|
|
///
|
|
/// As of this release, only Protocol Buffers' text format is supported.
|
|
///
|
|
/// The [Property] annotation can be used to change how a property name renders into Protobuf.
|
|
///
|
|
/// Example:
|
|
/// ```
|
|
/// import "pkl:protobuf"
|
|
///
|
|
/// @protobuf.Property { name = "wing_span" }
|
|
/// wingSpan: Int
|
|
/// ```
|
|
class Renderer extends ValueRenderer {
|
|
/// The characters to use for indenting output.
|
|
///
|
|
/// Defaults to two spaces.
|
|
indent: String = " "
|
|
|
|
external function renderDocument(value: Any): String
|
|
|
|
external function renderValue(value: Any): String
|
|
|
|
/// Returns the canonical name for [type].
|
|
external function renderType(type: reflect.Type): String
|
|
}
|
|
|
|
/// Annotate properties of classes and modules with this class to override how a [Renderer]
|
|
/// interprets a property's name.
|
|
@Since { version = "0.31.0" }
|
|
class Property extends ConvertProperty {
|
|
/// The new name to use for the annotated property when rendered by [Renderer].
|
|
name: String
|
|
|
|
render = (prop, renderer) -> if (renderer is Renderer) Pair(name, prop.value) else prop
|
|
}
|