protobuf 2.8.0.beta9 → 2.8.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (204) hide show
  1. checksums.yaml +7 -0
  2. data/.gitignore +0 -1
  3. data/{UPGRADING.md → CHANGES.md} +20 -12
  4. data/LICENSE.txt +14 -0
  5. data/README.md +60 -74
  6. data/bin/protoc-gen-ruby +26 -0
  7. data/bin/rprotoc +4 -58
  8. data/lib/protobuf.rb +15 -13
  9. data/lib/protobuf/code_generator.rb +41 -0
  10. data/lib/protobuf/descriptors/google/protobuf/compiler/plugin.pb.rb +51 -0
  11. data/lib/protobuf/descriptors/google/protobuf/descriptor.pb.rb +248 -0
  12. data/lib/protobuf/field/base_field.rb +0 -1
  13. data/lib/protobuf/field/bytes_field.rb +1 -1
  14. data/lib/protobuf/field/message_field.rb +2 -4
  15. data/lib/protobuf/field/varint_field.rb +4 -7
  16. data/lib/protobuf/generators/base.rb +71 -0
  17. data/lib/protobuf/generators/enum_generator.rb +31 -0
  18. data/lib/protobuf/generators/extension_generator.rb +28 -0
  19. data/lib/protobuf/generators/field_generator.rb +132 -0
  20. data/lib/protobuf/generators/file_generator.rb +140 -0
  21. data/lib/protobuf/generators/group_generator.rb +113 -0
  22. data/lib/protobuf/generators/message_generator.rb +99 -0
  23. data/lib/protobuf/generators/printable.rb +161 -0
  24. data/lib/protobuf/generators/service_generator.rb +27 -0
  25. data/lib/protobuf/lifecycle.rb +7 -3
  26. data/lib/protobuf/message.rb +51 -34
  27. data/lib/protobuf/rpc/connectors/common.rb +4 -6
  28. data/lib/protobuf/rpc/server.rb +1 -1
  29. data/lib/protobuf/rpc/servers/zmq/server.rb +2 -2
  30. data/lib/protobuf/rpc/servers/zmq/worker.rb +2 -2
  31. data/lib/protobuf/rpc/service.rb +3 -3
  32. data/lib/protobuf/rpc/service_directory.rb +24 -12
  33. data/lib/protobuf/version.rb +1 -1
  34. data/proto/google/protobuf/compiler/plugin.proto +147 -0
  35. data/proto/google/protobuf/descriptor.proto +620 -0
  36. data/protobuf.gemspec +12 -21
  37. data/spec/bin/protoc-gen-ruby_spec.rb +18 -0
  38. data/spec/data/data.bin +3 -0
  39. data/{test/data/unk.png → spec/data/types.bin} +0 -0
  40. data/spec/encoding/all_types_spec.rb +91 -0
  41. data/spec/encoding/extreme_values_spec.rb +0 -0
  42. data/spec/lib/protobuf/code_generator_spec.rb +60 -0
  43. data/spec/lib/protobuf/generators/base_spec.rb +87 -0
  44. data/spec/lib/protobuf/generators/enum_generator_spec.rb +45 -0
  45. data/spec/lib/protobuf/generators/extension_generator_spec.rb +43 -0
  46. data/spec/lib/protobuf/generators/field_generator_spec.rb +99 -0
  47. data/spec/lib/protobuf/generators/file_generator_spec.rb +29 -0
  48. data/spec/lib/protobuf/generators/message_generator_spec.rb +0 -0
  49. data/spec/lib/protobuf/generators/service_generator_spec.rb +43 -0
  50. data/spec/lib/protobuf/lifecycle_spec.rb +31 -1
  51. data/spec/lib/protobuf/logger_spec.rb +5 -0
  52. data/spec/lib/protobuf/message_spec.rb +22 -8
  53. data/spec/lib/protobuf/rpc/connectors/common_spec.rb +1 -1
  54. data/spec/lib/protobuf/rpc/service_directory_spec.rb +45 -7
  55. data/spec/lib/protobuf/rpc/service_spec.rb +3 -3
  56. data/spec/spec_helper.rb +15 -16
  57. data/spec/support/test/all_types.data.bin +0 -0
  58. data/spec/support/test/all_types.data.txt +119 -0
  59. data/spec/support/test/defaults.pb.rb +25 -0
  60. data/spec/support/test/defaults.proto +9 -0
  61. data/spec/support/test/enum.pb.rb +10 -8
  62. data/spec/support/test/extended.pb.rb +5 -3
  63. data/spec/support/test/extreme_values.data.bin +0 -0
  64. data/spec/support/test/google_unittest.pb.rb +543 -0
  65. data/spec/support/test/google_unittest.proto +713 -0
  66. data/spec/support/test/google_unittest_import.pb.rb +37 -0
  67. data/{ext/protobuf-2.4.1/src/google/protobuf/io/package_info.h → spec/support/test/google_unittest_import.proto} +27 -17
  68. data/spec/support/test/google_unittest_import_public.pb.rb +8 -0
  69. data/{ext/protobuf-2.4.1/src/google/protobuf/io/coded_stream_inl.h → spec/support/test/google_unittest_import_public.proto} +5 -31
  70. data/spec/support/test/multi_field_extensions.pb.rb +29 -7
  71. data/spec/support/test/multi_field_extensions.proto +12 -2
  72. data/spec/support/test/resource.pb.rb +20 -16
  73. metadata +149 -236
  74. data/examples/addressbook.pb.rb +0 -55
  75. data/examples/addressbook.proto +0 -24
  76. data/examples/reading_a_message.rb +0 -32
  77. data/examples/writing_a_message.rb +0 -46
  78. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/code_generator.h +0 -142
  79. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/command_line_interface.h +0 -318
  80. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_enum.h +0 -99
  81. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_enum_field.h +0 -103
  82. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_extension.h +0 -85
  83. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_field.h +0 -167
  84. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_file.h +0 -98
  85. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_generator.h +0 -72
  86. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_helpers.h +0 -159
  87. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_message.h +0 -170
  88. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_message_field.h +0 -102
  89. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_primitive_field.h +0 -103
  90. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_service.h +0 -118
  91. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_string_field.h +0 -104
  92. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/cpp/cpp_test_bad_identifiers.pb.h +0 -2721
  93. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/importer.h +0 -303
  94. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_enum.h +0 -84
  95. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_enum_field.h +0 -121
  96. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_extension.h +0 -77
  97. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_field.h +0 -108
  98. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_file.h +0 -101
  99. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_generator.h +0 -72
  100. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_helpers.h +0 -213
  101. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_message.h +0 -109
  102. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_message_field.h +0 -134
  103. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_primitive_field.h +0 -121
  104. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_service.h +0 -113
  105. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/java/java_string_field.h +0 -120
  106. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/mock_code_generator.h +0 -113
  107. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/package_info.h +0 -64
  108. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/parser.h +0 -434
  109. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/plugin.h +0 -73
  110. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/plugin.pb.h +0 -790
  111. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/python/python_generator.h +0 -156
  112. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/subprocess.h +0 -108
  113. data/ext/protobuf-2.4.1/src/google/protobuf/compiler/zip_writer.h +0 -93
  114. data/ext/protobuf-2.4.1/src/google/protobuf/descriptor.h +0 -1367
  115. data/ext/protobuf-2.4.1/src/google/protobuf/descriptor.pb.h +0 -5223
  116. data/ext/protobuf-2.4.1/src/google/protobuf/descriptor_database.h +0 -366
  117. data/ext/protobuf-2.4.1/src/google/protobuf/dynamic_message.h +0 -136
  118. data/ext/protobuf-2.4.1/src/google/protobuf/extension_set.h +0 -904
  119. data/ext/protobuf-2.4.1/src/google/protobuf/generated_message_reflection.h +0 -424
  120. data/ext/protobuf-2.4.1/src/google/protobuf/generated_message_util.h +0 -82
  121. data/ext/protobuf-2.4.1/src/google/protobuf/io/coded_stream.h +0 -1102
  122. data/ext/protobuf-2.4.1/src/google/protobuf/io/gzip_stream.h +0 -207
  123. data/ext/protobuf-2.4.1/src/google/protobuf/io/printer.h +0 -136
  124. data/ext/protobuf-2.4.1/src/google/protobuf/io/tokenizer.h +0 -313
  125. data/ext/protobuf-2.4.1/src/google/protobuf/io/zero_copy_stream.h +0 -238
  126. data/ext/protobuf-2.4.1/src/google/protobuf/io/zero_copy_stream_impl.h +0 -357
  127. data/ext/protobuf-2.4.1/src/google/protobuf/io/zero_copy_stream_impl_lite.h +0 -340
  128. data/ext/protobuf-2.4.1/src/google/protobuf/message.h +0 -692
  129. data/ext/protobuf-2.4.1/src/google/protobuf/message_lite.h +0 -239
  130. data/ext/protobuf-2.4.1/src/google/protobuf/package_info.h +0 -64
  131. data/ext/protobuf-2.4.1/src/google/protobuf/reflection_ops.h +0 -80
  132. data/ext/protobuf-2.4.1/src/google/protobuf/repeated_field.h +0 -1295
  133. data/ext/protobuf-2.4.1/src/google/protobuf/service.h +0 -291
  134. data/ext/protobuf-2.4.1/src/google/protobuf/stubs/common.h +0 -1211
  135. data/ext/protobuf-2.4.1/src/google/protobuf/stubs/hash.h +0 -220
  136. data/ext/protobuf-2.4.1/src/google/protobuf/stubs/map-util.h +0 -119
  137. data/ext/protobuf-2.4.1/src/google/protobuf/stubs/once.h +0 -123
  138. data/ext/protobuf-2.4.1/src/google/protobuf/stubs/stl_util-inl.h +0 -121
  139. data/ext/protobuf-2.4.1/src/google/protobuf/stubs/strutil.h +0 -457
  140. data/ext/protobuf-2.4.1/src/google/protobuf/stubs/substitute.h +0 -170
  141. data/ext/protobuf-2.4.1/src/google/protobuf/test_util.h +0 -174
  142. data/ext/protobuf-2.4.1/src/google/protobuf/test_util_lite.h +0 -101
  143. data/ext/protobuf-2.4.1/src/google/protobuf/testing/file.h +0 -83
  144. data/ext/protobuf-2.4.1/src/google/protobuf/testing/googletest.h +0 -98
  145. data/ext/protobuf-2.4.1/src/google/protobuf/text_format.h +0 -285
  146. data/ext/protobuf-2.4.1/src/google/protobuf/unittest.pb.h +0 -11915
  147. data/ext/protobuf-2.4.1/src/google/protobuf/unittest_custom_options.pb.h +0 -2895
  148. data/ext/protobuf-2.4.1/src/google/protobuf/unittest_embed_optimize_for.pb.h +0 -211
  149. data/ext/protobuf-2.4.1/src/google/protobuf/unittest_empty.pb.h +0 -56
  150. data/ext/protobuf-2.4.1/src/google/protobuf/unittest_import.pb.h +0 -188
  151. data/ext/protobuf-2.4.1/src/google/protobuf/unittest_import_lite.pb.h +0 -151
  152. data/ext/protobuf-2.4.1/src/google/protobuf/unittest_lite.pb.h +0 -4752
  153. data/ext/protobuf-2.4.1/src/google/protobuf/unittest_lite_imports_nonlite.pb.h +0 -150
  154. data/ext/protobuf-2.4.1/src/google/protobuf/unittest_mset.pb.h +0 -816
  155. data/ext/protobuf-2.4.1/src/google/protobuf/unittest_no_generic_services.pb.h +0 -197
  156. data/ext/protobuf-2.4.1/src/google/protobuf/unittest_optimize_for.pb.h +0 -403
  157. data/ext/protobuf-2.4.1/src/google/protobuf/unknown_field_set.h +0 -268
  158. data/ext/protobuf-2.4.1/src/google/protobuf/wire_format.h +0 -304
  159. data/ext/protobuf-2.4.1/src/google/protobuf/wire_format_lite.h +0 -620
  160. data/ext/protobuf-2.4.1/src/google/protobuf/wire_format_lite_inl.h +0 -774
  161. data/ext/ruby_generator/Makefile +0 -10
  162. data/ext/ruby_generator/RubyGenerator.cpp +0 -544
  163. data/ext/ruby_generator/RubyGenerator.h +0 -206
  164. data/ext/ruby_generator/extconf.rb +0 -35
  165. data/test/data/data_source.py +0 -14
  166. data/test/data/types_source.py +0 -22
  167. data/test/proto/addressbook.pb.rb +0 -66
  168. data/test/proto/addressbook.proto +0 -33
  169. data/test/proto/addressbook_base.pb.rb +0 -58
  170. data/test/proto/addressbook_base.proto +0 -26
  171. data/test/proto/addressbook_ext.pb.rb +0 -20
  172. data/test/proto/addressbook_ext.proto +0 -6
  173. data/test/proto/collision.pb.rb +0 -17
  174. data/test/proto/collision.proto +0 -5
  175. data/test/proto/ext_collision.pb.rb +0 -24
  176. data/test/proto/ext_collision.proto +0 -8
  177. data/test/proto/ext_range.pb.rb +0 -22
  178. data/test/proto/ext_range.proto +0 -7
  179. data/test/proto/float_default.proto +0 -10
  180. data/test/proto/lowercase.pb.rb +0 -30
  181. data/test/proto/lowercase.proto +0 -9
  182. data/test/proto/merge.pb.rb +0 -39
  183. data/test/proto/merge.proto +0 -15
  184. data/test/proto/nested.pb.rb +0 -30
  185. data/test/proto/nested.proto +0 -9
  186. data/test/proto/optional_field.pb.rb +0 -35
  187. data/test/proto/optional_field.proto +0 -12
  188. data/test/proto/packed.pb.rb +0 -22
  189. data/test/proto/packed.proto +0 -6
  190. data/test/proto/rpc.proto +0 -6
  191. data/test/proto/types.pb.rb +0 -84
  192. data/test/proto/types.proto +0 -37
  193. data/test/test_addressbook.rb +0 -56
  194. data/test/test_enum_value.rb +0 -41
  195. data/test/test_extension.rb +0 -36
  196. data/test/test_lowercase.rb +0 -11
  197. data/test/test_message.rb +0 -128
  198. data/test/test_optional_field.rb +0 -103
  199. data/test/test_packed_field.rb +0 -40
  200. data/test/test_parse.rb +0 -15
  201. data/test/test_repeated_types.rb +0 -132
  202. data/test/test_serialize.rb +0 -61
  203. data/test/test_standard_message.rb +0 -96
  204. data/test/test_types.rb +0 -226
@@ -1,303 +0,0 @@
1
- // Protocol Buffers - Google's data interchange format
2
- // Copyright 2008 Google Inc. All rights reserved.
3
- // http://code.google.com/p/protobuf/
4
- //
5
- // Redistribution and use in source and binary forms, with or without
6
- // modification, are permitted provided that the following conditions are
7
- // met:
8
- //
9
- // * Redistributions of source code must retain the above copyright
10
- // notice, this list of conditions and the following disclaimer.
11
- // * Redistributions in binary form must reproduce the above
12
- // copyright notice, this list of conditions and the following disclaimer
13
- // in the documentation and/or other materials provided with the
14
- // distribution.
15
- // * Neither the name of Google Inc. nor the names of its
16
- // contributors may be used to endorse or promote products derived from
17
- // this software without specific prior written permission.
18
- //
19
- // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
20
- // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
21
- // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
22
- // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
23
- // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
24
- // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
25
- // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
26
- // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
27
- // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
28
- // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
29
- // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
30
-
31
- // Author: kenton@google.com (Kenton Varda)
32
- // Based on original Protocol Buffers design by
33
- // Sanjay Ghemawat, Jeff Dean, and others.
34
- //
35
- // This file is the public interface to the .proto file parser.
36
-
37
- #ifndef GOOGLE_PROTOBUF_COMPILER_IMPORTER_H__
38
- #define GOOGLE_PROTOBUF_COMPILER_IMPORTER_H__
39
-
40
- #include <string>
41
- #include <vector>
42
- #include <set>
43
- #include <utility>
44
- #include <google/protobuf/descriptor.h>
45
- #include <google/protobuf/descriptor_database.h>
46
- #include <google/protobuf/compiler/parser.h>
47
-
48
- namespace google {
49
- namespace protobuf {
50
-
51
- namespace io { class ZeroCopyInputStream; }
52
-
53
- namespace compiler {
54
-
55
- // Defined in this file.
56
- class Importer;
57
- class MultiFileErrorCollector;
58
- class SourceTree;
59
- class DiskSourceTree;
60
-
61
- // TODO(kenton): Move all SourceTree stuff to a separate file?
62
-
63
- // An implementation of DescriptorDatabase which loads files from a SourceTree
64
- // and parses them.
65
- //
66
- // Note: This class is not thread-safe since it maintains a table of source
67
- // code locations for error reporting. However, when a DescriptorPool wraps
68
- // a DescriptorDatabase, it uses mutex locking to make sure only one method
69
- // of the database is called at a time, even if the DescriptorPool is used
70
- // from multiple threads. Therefore, there is only a problem if you create
71
- // multiple DescriptorPools wrapping the same SourceTreeDescriptorDatabase
72
- // and use them from multiple threads.
73
- //
74
- // Note: This class does not implement FindFileContainingSymbol() or
75
- // FindFileContainingExtension(); these will always return false.
76
- class LIBPROTOBUF_EXPORT SourceTreeDescriptorDatabase : public DescriptorDatabase {
77
- public:
78
- SourceTreeDescriptorDatabase(SourceTree* source_tree);
79
- ~SourceTreeDescriptorDatabase();
80
-
81
- // Instructs the SourceTreeDescriptorDatabase to report any parse errors
82
- // to the given MultiFileErrorCollector. This should be called before
83
- // parsing. error_collector must remain valid until either this method
84
- // is called again or the SourceTreeDescriptorDatabase is destroyed.
85
- void RecordErrorsTo(MultiFileErrorCollector* error_collector) {
86
- error_collector_ = error_collector;
87
- }
88
-
89
- // Gets a DescriptorPool::ErrorCollector which records errors to the
90
- // MultiFileErrorCollector specified with RecordErrorsTo(). This collector
91
- // has the ability to determine exact line and column numbers of errors
92
- // from the information given to it by the DescriptorPool.
93
- DescriptorPool::ErrorCollector* GetValidationErrorCollector() {
94
- using_validation_error_collector_ = true;
95
- return &validation_error_collector_;
96
- }
97
-
98
- // implements DescriptorDatabase -----------------------------------
99
- bool FindFileByName(const string& filename, FileDescriptorProto* output);
100
- bool FindFileContainingSymbol(const string& symbol_name,
101
- FileDescriptorProto* output);
102
- bool FindFileContainingExtension(const string& containing_type,
103
- int field_number,
104
- FileDescriptorProto* output);
105
-
106
- private:
107
- class SingleFileErrorCollector;
108
-
109
- SourceTree* source_tree_;
110
- MultiFileErrorCollector* error_collector_;
111
-
112
- class LIBPROTOBUF_EXPORT ValidationErrorCollector : public DescriptorPool::ErrorCollector {
113
- public:
114
- ValidationErrorCollector(SourceTreeDescriptorDatabase* owner);
115
- ~ValidationErrorCollector();
116
-
117
- // implements ErrorCollector ---------------------------------------
118
- void AddError(const string& filename,
119
- const string& element_name,
120
- const Message* descriptor,
121
- ErrorLocation location,
122
- const string& message);
123
-
124
- private:
125
- SourceTreeDescriptorDatabase* owner_;
126
- };
127
- friend class ValidationErrorCollector;
128
-
129
- bool using_validation_error_collector_;
130
- SourceLocationTable source_locations_;
131
- ValidationErrorCollector validation_error_collector_;
132
- };
133
-
134
- // Simple interface for parsing .proto files. This wraps the process
135
- // of opening the file, parsing it with a Parser, recursively parsing all its
136
- // imports, and then cross-linking the results to produce a FileDescriptor.
137
- //
138
- // This is really just a thin wrapper around SourceTreeDescriptorDatabase.
139
- // You may find that SourceTreeDescriptorDatabase is more flexible.
140
- //
141
- // TODO(kenton): I feel like this class is not well-named.
142
- class LIBPROTOBUF_EXPORT Importer {
143
- public:
144
- Importer(SourceTree* source_tree,
145
- MultiFileErrorCollector* error_collector);
146
- ~Importer();
147
-
148
- // Import the given file and build a FileDescriptor representing it. If
149
- // the file is already in the DescriptorPool, the existing FileDescriptor
150
- // will be returned. The FileDescriptor is property of the DescriptorPool,
151
- // and will remain valid until it is destroyed. If any errors occur, they
152
- // will be reported using the error collector and Import() will return NULL.
153
- //
154
- // A particular Importer object will only report errors for a particular
155
- // file once. All future attempts to import the same file will return NULL
156
- // without reporting any errors. The idea is that you might want to import
157
- // a lot of files without seeing the same errors over and over again. If
158
- // you want to see errors for the same files repeatedly, you can use a
159
- // separate Importer object to import each one (but use the same
160
- // DescriptorPool so that they can be cross-linked).
161
- const FileDescriptor* Import(const string& filename);
162
-
163
- // The DescriptorPool in which all imported FileDescriptors and their
164
- // contents are stored.
165
- inline const DescriptorPool* pool() const {
166
- return &pool_;
167
- }
168
-
169
- private:
170
- SourceTreeDescriptorDatabase database_;
171
- DescriptorPool pool_;
172
-
173
- GOOGLE_DISALLOW_EVIL_CONSTRUCTORS(Importer);
174
- };
175
-
176
- // If the importer encounters problems while trying to import the proto files,
177
- // it reports them to a MultiFileErrorCollector.
178
- class LIBPROTOBUF_EXPORT MultiFileErrorCollector {
179
- public:
180
- inline MultiFileErrorCollector() {}
181
- virtual ~MultiFileErrorCollector();
182
-
183
- // Line and column numbers are zero-based. A line number of -1 indicates
184
- // an error with the entire file (e.g. "not found").
185
- virtual void AddError(const string& filename, int line, int column,
186
- const string& message) = 0;
187
-
188
- private:
189
- GOOGLE_DISALLOW_EVIL_CONSTRUCTORS(MultiFileErrorCollector);
190
- };
191
-
192
- // Abstract interface which represents a directory tree containing proto files.
193
- // Used by the default implementation of Importer to resolve import statements
194
- // Most users will probably want to use the DiskSourceTree implementation,
195
- // below.
196
- class LIBPROTOBUF_EXPORT SourceTree {
197
- public:
198
- inline SourceTree() {}
199
- virtual ~SourceTree();
200
-
201
- // Open the given file and return a stream that reads it, or NULL if not
202
- // found. The caller takes ownership of the returned object. The filename
203
- // must be a path relative to the root of the source tree and must not
204
- // contain "." or ".." components.
205
- virtual io::ZeroCopyInputStream* Open(const string& filename) = 0;
206
-
207
- private:
208
- GOOGLE_DISALLOW_EVIL_CONSTRUCTORS(SourceTree);
209
- };
210
-
211
- // An implementation of SourceTree which loads files from locations on disk.
212
- // Multiple mappings can be set up to map locations in the DiskSourceTree to
213
- // locations in the physical filesystem.
214
- class LIBPROTOBUF_EXPORT DiskSourceTree : public SourceTree {
215
- public:
216
- DiskSourceTree();
217
- ~DiskSourceTree();
218
-
219
- // Map a path on disk to a location in the SourceTree. The path may be
220
- // either a file or a directory. If it is a directory, the entire tree
221
- // under it will be mapped to the given virtual location. To map a directory
222
- // to the root of the source tree, pass an empty string for virtual_path.
223
- //
224
- // If multiple mapped paths apply when opening a file, they will be searched
225
- // in order. For example, if you do:
226
- // MapPath("bar", "foo/bar");
227
- // MapPath("", "baz");
228
- // and then you do:
229
- // Open("bar/qux");
230
- // the DiskSourceTree will first try to open foo/bar/qux, then baz/bar/qux,
231
- // returning the first one that opens successfuly.
232
- //
233
- // disk_path may be an absolute path or relative to the current directory,
234
- // just like a path you'd pass to open().
235
- void MapPath(const string& virtual_path, const string& disk_path);
236
-
237
- // Return type for DiskFileToVirtualFile().
238
- enum DiskFileToVirtualFileResult {
239
- SUCCESS,
240
- SHADOWED,
241
- CANNOT_OPEN,
242
- NO_MAPPING
243
- };
244
-
245
- // Given a path to a file on disk, find a virtual path mapping to that
246
- // file. The first mapping created with MapPath() whose disk_path contains
247
- // the filename is used. However, that virtual path may not actually be
248
- // usable to open the given file. Possible return values are:
249
- // * SUCCESS: The mapping was found. *virtual_file is filled in so that
250
- // calling Open(*virtual_file) will open the file named by disk_file.
251
- // * SHADOWED: A mapping was found, but using Open() to open this virtual
252
- // path will end up returning some different file. This is because some
253
- // other mapping with a higher precedence also matches this virtual path
254
- // and maps it to a different file that exists on disk. *virtual_file
255
- // is filled in as it would be in the SUCCESS case. *shadowing_disk_file
256
- // is filled in with the disk path of the file which would be opened if
257
- // you were to call Open(*virtual_file).
258
- // * CANNOT_OPEN: The mapping was found and was not shadowed, but the
259
- // file specified cannot be opened. When this value is returned,
260
- // errno will indicate the reason the file cannot be opened. *virtual_file
261
- // will be set to the virtual path as in the SUCCESS case, even though
262
- // it is not useful.
263
- // * NO_MAPPING: Indicates that no mapping was found which contains this
264
- // file.
265
- DiskFileToVirtualFileResult
266
- DiskFileToVirtualFile(const string& disk_file,
267
- string* virtual_file,
268
- string* shadowing_disk_file);
269
-
270
- // Given a virtual path, find the path to the file on disk.
271
- // Return true and update disk_file with the on-disk path if the file exists.
272
- // Return false and leave disk_file untouched if the file doesn't exist.
273
- bool VirtualFileToDiskFile(const string& virtual_file, string* disk_file);
274
-
275
- // implements SourceTree -------------------------------------------
276
- io::ZeroCopyInputStream* Open(const string& filename);
277
-
278
- private:
279
- struct Mapping {
280
- string virtual_path;
281
- string disk_path;
282
-
283
- inline Mapping(const string& virtual_path, const string& disk_path)
284
- : virtual_path(virtual_path), disk_path(disk_path) {}
285
- };
286
- vector<Mapping> mappings_;
287
-
288
- // Like Open(), but returns the on-disk path in disk_file if disk_file is
289
- // non-NULL and the file could be successfully opened.
290
- io::ZeroCopyInputStream* OpenVirtualFile(const string& virtual_file,
291
- string* disk_file);
292
-
293
- // Like Open() but given the actual on-disk path.
294
- io::ZeroCopyInputStream* OpenDiskFile(const string& filename);
295
-
296
- GOOGLE_DISALLOW_EVIL_CONSTRUCTORS(DiskSourceTree);
297
- };
298
-
299
- } // namespace compiler
300
- } // namespace protobuf
301
-
302
- } // namespace google
303
- #endif // GOOGLE_PROTOBUF_COMPILER_IMPORTER_H__
@@ -1,84 +0,0 @@
1
- // Protocol Buffers - Google's data interchange format
2
- // Copyright 2008 Google Inc. All rights reserved.
3
- // http://code.google.com/p/protobuf/
4
- //
5
- // Redistribution and use in source and binary forms, with or without
6
- // modification, are permitted provided that the following conditions are
7
- // met:
8
- //
9
- // * Redistributions of source code must retain the above copyright
10
- // notice, this list of conditions and the following disclaimer.
11
- // * Redistributions in binary form must reproduce the above
12
- // copyright notice, this list of conditions and the following disclaimer
13
- // in the documentation and/or other materials provided with the
14
- // distribution.
15
- // * Neither the name of Google Inc. nor the names of its
16
- // contributors may be used to endorse or promote products derived from
17
- // this software without specific prior written permission.
18
- //
19
- // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
20
- // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
21
- // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
22
- // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
23
- // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
24
- // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
25
- // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
26
- // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
27
- // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
28
- // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
29
- // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
30
-
31
- // Author: kenton@google.com (Kenton Varda)
32
- // Based on original Protocol Buffers design by
33
- // Sanjay Ghemawat, Jeff Dean, and others.
34
-
35
- #ifndef GOOGLE_PROTOBUF_COMPILER_JAVA_ENUM_H__
36
- #define GOOGLE_PROTOBUF_COMPILER_JAVA_ENUM_H__
37
-
38
- #include <string>
39
- #include <vector>
40
- #include <google/protobuf/descriptor.h>
41
-
42
- namespace google {
43
- namespace protobuf {
44
- namespace io {
45
- class Printer; // printer.h
46
- }
47
- }
48
-
49
- namespace protobuf {
50
- namespace compiler {
51
- namespace java {
52
-
53
- class EnumGenerator {
54
- public:
55
- explicit EnumGenerator(const EnumDescriptor* descriptor);
56
- ~EnumGenerator();
57
-
58
- void Generate(io::Printer* printer);
59
-
60
- private:
61
- const EnumDescriptor* descriptor_;
62
-
63
- // The proto language allows multiple enum constants to have the same numeric
64
- // value. Java, however, does not allow multiple enum constants to be
65
- // considered equivalent. We treat the first defined constant for any
66
- // given numeric value as "canonical" and the rest as aliases of that
67
- // canonical value.
68
- vector<const EnumValueDescriptor*> canonical_values_;
69
-
70
- struct Alias {
71
- const EnumValueDescriptor* value;
72
- const EnumValueDescriptor* canonical_value;
73
- };
74
- vector<Alias> aliases_;
75
-
76
- GOOGLE_DISALLOW_EVIL_CONSTRUCTORS(EnumGenerator);
77
- };
78
-
79
- } // namespace java
80
- } // namespace compiler
81
- } // namespace protobuf
82
-
83
- } // namespace google
84
- #endif // GOOGLE_PROTOBUF_COMPILER_JAVA_ENUM_H__
@@ -1,121 +0,0 @@
1
- // Protocol Buffers - Google's data interchange format
2
- // Copyright 2008 Google Inc. All rights reserved.
3
- // http://code.google.com/p/protobuf/
4
- //
5
- // Redistribution and use in source and binary forms, with or without
6
- // modification, are permitted provided that the following conditions are
7
- // met:
8
- //
9
- // * Redistributions of source code must retain the above copyright
10
- // notice, this list of conditions and the following disclaimer.
11
- // * Redistributions in binary form must reproduce the above
12
- // copyright notice, this list of conditions and the following disclaimer
13
- // in the documentation and/or other materials provided with the
14
- // distribution.
15
- // * Neither the name of Google Inc. nor the names of its
16
- // contributors may be used to endorse or promote products derived from
17
- // this software without specific prior written permission.
18
- //
19
- // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
20
- // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
21
- // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
22
- // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
23
- // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
24
- // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
25
- // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
26
- // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
27
- // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
28
- // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
29
- // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
30
-
31
- // Author: kenton@google.com (Kenton Varda)
32
- // Based on original Protocol Buffers design by
33
- // Sanjay Ghemawat, Jeff Dean, and others.
34
-
35
- #ifndef GOOGLE_PROTOBUF_COMPILER_JAVA_ENUM_FIELD_H__
36
- #define GOOGLE_PROTOBUF_COMPILER_JAVA_ENUM_FIELD_H__
37
-
38
- #include <map>
39
- #include <string>
40
- #include <google/protobuf/compiler/java/java_field.h>
41
-
42
- namespace google {
43
- namespace protobuf {
44
- namespace compiler {
45
- namespace java {
46
-
47
- class EnumFieldGenerator : public FieldGenerator {
48
- public:
49
- explicit EnumFieldGenerator(const FieldDescriptor* descriptor,
50
- int messageBitIndex, int builderBitIndex);
51
- ~EnumFieldGenerator();
52
-
53
- // implements FieldGenerator ---------------------------------------
54
- int GetNumBitsForMessage() const;
55
- int GetNumBitsForBuilder() const;
56
- void GenerateInterfaceMembers(io::Printer* printer) const;
57
- void GenerateMembers(io::Printer* printer) const;
58
- void GenerateBuilderMembers(io::Printer* printer) const;
59
- void GenerateInitializationCode(io::Printer* printer) const;
60
- void GenerateBuilderClearCode(io::Printer* printer) const;
61
- void GenerateMergingCode(io::Printer* printer) const;
62
- void GenerateBuildingCode(io::Printer* printer) const;
63
- void GenerateParsingCode(io::Printer* printer) const;
64
- void GenerateSerializationCode(io::Printer* printer) const;
65
- void GenerateSerializedSizeCode(io::Printer* printer) const;
66
- void GenerateFieldBuilderInitializationCode(io::Printer* printer) const;
67
- void GenerateEqualsCode(io::Printer* printer) const;
68
- void GenerateHashCode(io::Printer* printer) const;
69
-
70
- string GetBoxedType() const;
71
-
72
- private:
73
- const FieldDescriptor* descriptor_;
74
- map<string, string> variables_;
75
- const int messageBitIndex_;
76
- const int builderBitIndex_;
77
-
78
- GOOGLE_DISALLOW_EVIL_CONSTRUCTORS(EnumFieldGenerator);
79
- };
80
-
81
- class RepeatedEnumFieldGenerator : public FieldGenerator {
82
- public:
83
- explicit RepeatedEnumFieldGenerator(const FieldDescriptor* descriptor,
84
- int messageBitIndex, int builderBitIndex);
85
- ~RepeatedEnumFieldGenerator();
86
-
87
- // implements FieldGenerator ---------------------------------------
88
- int GetNumBitsForMessage() const;
89
- int GetNumBitsForBuilder() const;
90
- void GenerateInterfaceMembers(io::Printer* printer) const;
91
- void GenerateMembers(io::Printer* printer) const;
92
- void GenerateBuilderMembers(io::Printer* printer) const;
93
- void GenerateInitializationCode(io::Printer* printer) const;
94
- void GenerateBuilderClearCode(io::Printer* printer) const;
95
- void GenerateMergingCode(io::Printer* printer) const;
96
- void GenerateBuildingCode(io::Printer* printer) const;
97
- void GenerateParsingCode(io::Printer* printer) const;
98
- void GenerateParsingCodeFromPacked(io::Printer* printer) const;
99
- void GenerateSerializationCode(io::Printer* printer) const;
100
- void GenerateSerializedSizeCode(io::Printer* printer) const;
101
- void GenerateFieldBuilderInitializationCode(io::Printer* printer) const;
102
- void GenerateEqualsCode(io::Printer* printer) const;
103
- void GenerateHashCode(io::Printer* printer) const;
104
-
105
- string GetBoxedType() const;
106
-
107
- private:
108
- const FieldDescriptor* descriptor_;
109
- map<string, string> variables_;
110
- const int messageBitIndex_;
111
- const int builderBitIndex_;
112
-
113
- GOOGLE_DISALLOW_EVIL_CONSTRUCTORS(RepeatedEnumFieldGenerator);
114
- };
115
-
116
- } // namespace java
117
- } // namespace compiler
118
- } // namespace protobuf
119
-
120
- } // namespace google
121
- #endif // GOOGLE_PROTOBUF_COMPILER_JAVA_ENUM_FIELD_H__