cel-cpp/internal/json.h at master · cel-expr/cel-cpp · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
// Copyright 2024 Google LLC
//
// 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.

#ifndef THIRD_PARTY_CEL_CPP_INTERNAL_JSON_H_
#define THIRD_PARTY_CEL_CPP_INTERNAL_JSON_H_

#include <string>

#include "google/protobuf/struct.pb.h"
#include "absl/base/nullability.h"
#include "absl/status/status.h"
#include "google/protobuf/descriptor.h"
#include "google/protobuf/message.h"

namespace cel::internal {

// Converts the given message to its `google.protobuf.Value` equivalent
// representation. This is similar to `google::protobuf::json::MessageToJsonString()`,
// except that this results in structured serialization.
absl::Status MessageToJson(
    const google::protobuf::Message& message,
    const google::protobuf::DescriptorPool* absl_nonnull descriptor_pool,
    google::protobuf::MessageFactory* absl_nonnull message_factory,
    google::protobuf::Value* absl_nonnull result);
absl::Status MessageToJson(
    const google::protobuf::Message& message,
    const google::protobuf::DescriptorPool* absl_nonnull descriptor_pool,
    google::protobuf::MessageFactory* absl_nonnull message_factory,
    google::protobuf::Struct* absl_nonnull result);
absl::Status MessageToJson(
    const google::protobuf::Message& message,
    const google::protobuf::DescriptorPool* absl_nonnull descriptor_pool,
    google::protobuf::MessageFactory* absl_nonnull message_factory,
    google::protobuf::Message* absl_nonnull result);

// Converts the given message field to its `google.protobuf.Value` equivalent
// representation. This is similar to `google::protobuf::json::MessageToJsonString()`,
// except that this results in structured serialization.
absl::Status MessageFieldToJson(
    const google::protobuf::Message& message,
    const google::protobuf::FieldDescriptor* absl_nonnull field,
    const google::protobuf::DescriptorPool* absl_nonnull descriptor_pool,
    google::protobuf::MessageFactory* absl_nonnull message_factory,
    google::protobuf::Value* absl_nonnull result);
absl::Status MessageFieldToJson(
    const google::protobuf::Message& message,
    const google::protobuf::FieldDescriptor* absl_nonnull field,
    const google::protobuf::DescriptorPool* absl_nonnull descriptor_pool,
    google::protobuf::MessageFactory* absl_nonnull message_factory,
    google::protobuf::ListValue* absl_nonnull result);
absl::Status MessageFieldToJson(
    const google::protobuf::Message& message,
    const google::protobuf::FieldDescriptor* absl_nonnull field,
    const google::protobuf::DescriptorPool* absl_nonnull descriptor_pool,
    google::protobuf::MessageFactory* absl_nonnull message_factory,
    google::protobuf::Struct* absl_nonnull result);
absl::Status MessageFieldToJson(
    const google::protobuf::Message& message,
    const google::protobuf::FieldDescriptor* absl_nonnull field,
    const google::protobuf::DescriptorPool* absl_nonnull descriptor_pool,
    google::protobuf::MessageFactory* absl_nonnull message_factory,
    google::protobuf::Message* absl_nonnull result);

// Checks that the instance of `google.protobuf.Value` has a descriptor which is
// well formed.
inline absl::Status CheckJson(const google::protobuf::Value&) {
  return absl::OkStatus();
}
absl::Status CheckJson(const google::protobuf::MessageLite& message);

// Checks that the instance of `google.protobuf.ListValue` has a descriptor
// which is well formed.
inline absl::Status CheckJsonList(const google::protobuf::ListValue&) {
  return absl::OkStatus();
}
absl::Status CheckJsonList(const google::protobuf::MessageLite& message);

// Checks that the instance of `google.protobuf.Struct` has a descriptor which
// is well formed.
inline absl::Status CheckJsonMap(const google::protobuf::Struct&) {
  return absl::OkStatus();
}
absl::Status CheckJsonMap(const google::protobuf::MessageLite& message);

// Produces a debug string for the given instance of `google.protobuf.Value`.
std::string JsonDebugString(const google::protobuf::Value& message);
std::string JsonDebugString(const google::protobuf::Message& message);

// Produces a debug string for the given instance of
// `google.protobuf.ListValue`.
std::string JsonListDebugString(const google::protobuf::ListValue& message);
std::string JsonListDebugString(const google::protobuf::Message& message);

// Produces a debug string for the given instance of `google.protobuf.Struct`.
std::string JsonMapDebugString(const google::protobuf::Struct& message);
std::string JsonMapDebugString(const google::protobuf::Message& message);

// Compares the given instances of `google.protobuf.Value` for equality.
bool JsonEquals(const google::protobuf::Value& lhs,
                const google::protobuf::Value& rhs);
bool JsonEquals(const google::protobuf::Value& lhs, const google::protobuf::Message& rhs);
bool JsonEquals(const google::protobuf::Message& lhs, const google::protobuf::Value& rhs);
bool JsonEquals(const google::protobuf::Message& lhs, const google::protobuf::Message& rhs);
bool JsonEquals(const google::protobuf::MessageLite& lhs, const google::protobuf::MessageLite& rhs);

// Compares the given instances of `google.protobuf.ListValue` for equality.
bool JsonListEquals(const google::protobuf::ListValue& lhs,
                    const google::protobuf::ListValue& rhs);
bool JsonListEquals(const google::protobuf::ListValue& lhs,
                    const google::protobuf::Message& rhs);
bool JsonListEquals(const google::protobuf::Message& lhs,
                    const google::protobuf::ListValue& rhs);
bool JsonListEquals(const google::protobuf::Message& lhs, const google::protobuf::Message& rhs);
bool JsonListEquals(const google::protobuf::MessageLite& lhs,
                    const google::protobuf::MessageLite& rhs);

// Compares the given instances of `google.protobuf.Struct` for equality.
bool JsonMapEquals(const google::protobuf::Struct& lhs,
                   const google::protobuf::Struct& rhs);
bool JsonMapEquals(const google::protobuf::Struct& lhs,
                   const google::protobuf::Message& rhs);
bool JsonMapEquals(const google::protobuf::Message& lhs,
                   const google::protobuf::Struct& rhs);
bool JsonMapEquals(const google::protobuf::Message& lhs, const google::protobuf::Message& rhs);
bool JsonMapEquals(const google::protobuf::MessageLite& lhs,
                   const google::protobuf::MessageLite& rhs);

}  // namespace cel::internal

#endif  // THIRD_PARTY_CEL_CPP_INTERNAL_JSON_H_