| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1 | // Go support for Protocol Buffers - Google's data interchange format |
| 2 | // |
| 3 | // Copyright 2010 Google Inc. All rights reserved. |
| 4 | // http://code.google.com/p/goprotobuf/ |
| 5 | // |
| 6 | // Redistribution and use in source and binary forms, with or without |
| 7 | // modification, are permitted provided that the following conditions are |
| 8 | // met: |
| 9 | // |
| 10 | // * Redistributions of source code must retain the above copyright |
| 11 | // notice, this list of conditions and the following disclaimer. |
| 12 | // * Redistributions in binary form must reproduce the above |
| 13 | // copyright notice, this list of conditions and the following disclaimer |
| 14 | // in the documentation and/or other materials provided with the |
| 15 | // distribution. |
| 16 | // * Neither the name of Google Inc. nor the names of its |
| 17 | // contributors may be used to endorse or promote products derived from |
| 18 | // this software without specific prior written permission. |
| 19 | // |
| 20 | // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
| 21 | // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
| 22 | // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
| 23 | // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
| 24 | // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
| 25 | // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
| 26 | // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
| 27 | // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
| 28 | // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
| 29 | // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
| 30 | // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
| 31 | |
| 32 | /* |
| 33 | The code generator for the plugin for the Google protocol buffer compiler. |
| 34 | It generates Go code from the protocol buffer description files read by the |
| 35 | main routine. |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 36 | */ |
| 37 | package generator |
| 38 | |
| 39 | import ( |
| 40 | "bytes" |
| 41 | "fmt" |
| David Symonds | b1d55a0 | 2011-04-08 09:55:06 +1000 | [diff] [blame] | 42 | "go/parser" |
| 43 | "go/printer" |
| 44 | "go/token" |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 45 | "log" |
| 46 | "os" |
| Rob Pike | 87af39e | 2010-07-19 10:48:02 -0700 | [diff] [blame] | 47 | "path" |
| David Symonds | 79eae33 | 2010-10-16 11:33:20 +1100 | [diff] [blame] | 48 | "strconv" |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 49 | "strings" |
| David Symonds | 162d003 | 2012-06-28 09:44:46 -0700 | [diff] [blame] | 50 | "unicode" |
| 51 | "unicode/utf8" |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 52 | |
| Rob Pike | 3f6f2d8 | 2011-12-18 13:55:35 -0800 | [diff] [blame] | 53 | "code.google.com/p/goprotobuf/proto" |
| Rob Pike | b7907bf | 2012-02-13 14:25:20 +1100 | [diff] [blame] | 54 | descriptor "code.google.com/p/goprotobuf/protoc-gen-go/descriptor" |
| 55 | plugin "code.google.com/p/goprotobuf/protoc-gen-go/plugin" |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 56 | ) |
| 57 | |
| 58 | // A Plugin provides functionality to add to the output during Go code generation, |
| 59 | // such as to produce RPC stubs. |
| 60 | type Plugin interface { |
| 61 | // Name identifies the plugin. |
| Rob Pike | c9e7d97 | 2010-06-10 10:30:22 -0700 | [diff] [blame] | 62 | Name() string |
| 63 | // Init is called once after data structures are built but before |
| 64 | // code generation begins. |
| 65 | Init(g *Generator) |
| 66 | // Generate produces the code generated by the plugin for this file, |
| 67 | // except for the imports, by calling the generator's methods P, In, and Out. |
| 68 | Generate(file *FileDescriptor) |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 69 | // GenerateImports produces the import declarations for this file. |
| Rob Pike | c9e7d97 | 2010-06-10 10:30:22 -0700 | [diff] [blame] | 70 | // It is called after Generate. |
| 71 | GenerateImports(file *FileDescriptor) |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 72 | } |
| 73 | |
| 74 | var plugins []Plugin |
| 75 | |
| 76 | // RegisterPlugin installs a (second-order) plugin to be run when the Go output is generated. |
| 77 | // It is typically called during initialization. |
| 78 | func RegisterPlugin(p Plugin) { |
| David Symonds | cc7142e | 2010-11-06 14:37:15 +1100 | [diff] [blame] | 79 | plugins = append(plugins, p) |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 80 | } |
| 81 | |
| 82 | // Each type we import as a protocol buffer (other than FileDescriptorProto) needs |
| 83 | // a pointer to the FileDescriptorProto that represents it. These types achieve that |
| 84 | // wrapping by placing each Proto inside a struct with the pointer to its File. The |
| 85 | // structs have the same names as their contents, with "Proto" removed. |
| 86 | // FileDescriptor is used to store the things that it points to. |
| 87 | |
| 88 | // The file and package name method are common to messages and enums. |
| 89 | type common struct { |
| David Symonds | 4decd80 | 2011-08-04 11:27:07 +1000 | [diff] [blame] | 90 | file *descriptor.FileDescriptorProto // File this object comes from. |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 91 | } |
| 92 | |
| 93 | // PackageName is name in the package clause in the generated file. |
| David Symonds | 4decd80 | 2011-08-04 11:27:07 +1000 | [diff] [blame] | 94 | func (c *common) PackageName() string { return uniquePackageOf(c.file) } |
| 95 | |
| 96 | func (c *common) File() *descriptor.FileDescriptorProto { return c.file } |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 97 | |
| 98 | // Descriptor represents a protocol buffer message. |
| 99 | type Descriptor struct { |
| 100 | common |
| 101 | *descriptor.DescriptorProto |
| 102 | parent *Descriptor // The containing message, if any. |
| 103 | nested []*Descriptor // Inner messages, if any. |
| 104 | ext []*ExtensionDescriptor // Extensions, if any. |
| 105 | typename []string // Cached typename vector. |
| 106 | } |
| 107 | |
| 108 | // TypeName returns the elements of the dotted type name. |
| 109 | // The package name is not part of this name. |
| 110 | func (d *Descriptor) TypeName() []string { |
| 111 | if d.typename != nil { |
| 112 | return d.typename |
| 113 | } |
| 114 | n := 0 |
| 115 | for parent := d; parent != nil; parent = parent.parent { |
| 116 | n++ |
| 117 | } |
| 118 | s := make([]string, n, n) |
| 119 | for parent := d; parent != nil; parent = parent.parent { |
| 120 | n-- |
| David Symonds | 8bb32ca | 2012-06-28 10:22:09 -0700 | [diff] [blame] | 121 | s[n] = parent.GetName() |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 122 | } |
| 123 | d.typename = s |
| 124 | return s |
| 125 | } |
| 126 | |
| 127 | // EnumDescriptor describes an enum. If it's at top level, its parent will be nil. |
| 128 | // Otherwise it will be the descriptor of the message in which it is defined. |
| 129 | type EnumDescriptor struct { |
| 130 | common |
| 131 | *descriptor.EnumDescriptorProto |
| 132 | parent *Descriptor // The containing message, if any. |
| 133 | typename []string // Cached typename vector. |
| 134 | } |
| 135 | |
| 136 | // TypeName returns the elements of the dotted type name. |
| 137 | // The package name is not part of this name. |
| 138 | func (e *EnumDescriptor) TypeName() (s []string) { |
| 139 | if e.typename != nil { |
| 140 | return e.typename |
| 141 | } |
| David Symonds | 8bb32ca | 2012-06-28 10:22:09 -0700 | [diff] [blame] | 142 | name := e.GetName() |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 143 | if e.parent == nil { |
| 144 | s = make([]string, 1) |
| 145 | } else { |
| 146 | pname := e.parent.TypeName() |
| 147 | s = make([]string, len(pname)+1) |
| 148 | copy(s, pname) |
| 149 | } |
| 150 | s[len(s)-1] = name |
| 151 | e.typename = s |
| 152 | return s |
| 153 | } |
| 154 | |
| 155 | // Everything but the last element of the full type name, CamelCased. |
| 156 | // The values of type Foo.Bar are call Foo_value1... not Foo_Bar_value1... . |
| 157 | func (e *EnumDescriptor) prefix() string { |
| 158 | typeName := e.TypeName() |
| 159 | ccPrefix := CamelCaseSlice(typeName[0:len(typeName)-1]) + "_" |
| 160 | if e.parent == nil { |
| 161 | // If the enum is not part of a message, the prefix is just the type name. |
| 162 | ccPrefix = CamelCase(*e.Name) + "_" |
| 163 | } |
| 164 | return ccPrefix |
| 165 | } |
| 166 | |
| 167 | // The integer value of the named constant in this enumerated type. |
| 168 | func (e *EnumDescriptor) integerValueAsString(name string) string { |
| 169 | for _, c := range e.Value { |
| David Symonds | 8bb32ca | 2012-06-28 10:22:09 -0700 | [diff] [blame] | 170 | if c.GetName() == name { |
| 171 | return fmt.Sprint(c.GetNumber()) |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 172 | } |
| 173 | } |
| David Symonds | 9d0000e | 2011-02-03 10:48:14 +1100 | [diff] [blame] | 174 | log.Fatal("cannot find value for enum constant") |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 175 | return "" |
| 176 | } |
| 177 | |
| David Symonds | 4decd80 | 2011-08-04 11:27:07 +1000 | [diff] [blame] | 178 | // ExtensionDescriptor describes an extension. If it's at top level, its parent will be nil. |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 179 | // Otherwise it will be the descriptor of the message in which it is defined. |
| 180 | type ExtensionDescriptor struct { |
| 181 | common |
| 182 | *descriptor.FieldDescriptorProto |
| Rob Pike | c9e7d97 | 2010-06-10 10:30:22 -0700 | [diff] [blame] | 183 | parent *Descriptor // The containing message, if any. |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 184 | } |
| 185 | |
| 186 | // TypeName returns the elements of the dotted type name. |
| 187 | // The package name is not part of this name. |
| 188 | func (e *ExtensionDescriptor) TypeName() (s []string) { |
| David Symonds | 8bb32ca | 2012-06-28 10:22:09 -0700 | [diff] [blame] | 189 | name := e.GetName() |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 190 | if e.parent == nil { |
| 191 | // top-level extension |
| 192 | s = make([]string, 1) |
| 193 | } else { |
| 194 | pname := e.parent.TypeName() |
| 195 | s = make([]string, len(pname)+1) |
| 196 | copy(s, pname) |
| 197 | } |
| 198 | s[len(s)-1] = name |
| 199 | return s |
| 200 | } |
| 201 | |
| David Symonds | e37856c | 2011-06-22 12:52:53 +1000 | [diff] [blame] | 202 | // DescName returns the variable name used for the generated descriptor. |
| 203 | func (e *ExtensionDescriptor) DescName() string { |
| 204 | // The full type name. |
| 205 | typeName := e.TypeName() |
| 206 | // Each scope of the extension is individually CamelCased, and all are joined with "_" with an "E_" prefix. |
| 207 | for i, s := range typeName { |
| 208 | typeName[i] = CamelCase(s) |
| 209 | } |
| 210 | return "E_" + strings.Join(typeName, "_") |
| 211 | } |
| 212 | |
| David Symonds | 4decd80 | 2011-08-04 11:27:07 +1000 | [diff] [blame] | 213 | // ImportedDescriptor describes a type that has been publicly imported from another file. |
| 214 | type ImportedDescriptor struct { |
| 215 | common |
| 216 | o Object |
| 217 | } |
| 218 | |
| 219 | func (id *ImportedDescriptor) TypeName() []string { return id.o.TypeName() } |
| 220 | |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 221 | // FileDescriptor describes an protocol buffer descriptor file (.proto). |
| 222 | // It includes slices of all the messages and enums defined within it. |
| 223 | // Those slices are constructed by WrapTypes. |
| 224 | type FileDescriptor struct { |
| 225 | *descriptor.FileDescriptorProto |
| Rob Pike | c9e7d97 | 2010-06-10 10:30:22 -0700 | [diff] [blame] | 226 | desc []*Descriptor // All the messages defined in this file. |
| 227 | enum []*EnumDescriptor // All the enums defined in this file. |
| 228 | ext []*ExtensionDescriptor // All the top-level extensions defined in this file. |
| David Symonds | 4decd80 | 2011-08-04 11:27:07 +1000 | [diff] [blame] | 229 | imp []*ImportedDescriptor // All types defined in files publicly imported by this file. |
| David Symonds | 31d58a2 | 2011-01-20 18:33:21 +1100 | [diff] [blame] | 230 | |
| David Symonds | b2a00c8 | 2011-08-04 16:52:58 +1000 | [diff] [blame] | 231 | // The full list of symbols that are exported, |
| 232 | // as a map from the exported object to its symbols. |
| David Symonds | 31d58a2 | 2011-01-20 18:33:21 +1100 | [diff] [blame] | 233 | // This is used for supporting public imports. |
| David Symonds | b2a00c8 | 2011-08-04 16:52:58 +1000 | [diff] [blame] | 234 | exported map[Object][]Symbol |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 235 | } |
| 236 | |
| 237 | // PackageName is the package name we'll use in the generated code to refer to this file. |
| 238 | func (d *FileDescriptor) PackageName() string { return uniquePackageOf(d.FileDescriptorProto) } |
| 239 | |
| David Symonds | 162d003 | 2012-06-28 09:44:46 -0700 | [diff] [blame] | 240 | // goPackageName returns the Go package name to use in the |
| 241 | // generated Go file. The result explicit reports whether the name |
| 242 | // came from an option go_package statement. If explicit is false, |
| 243 | // the name was derived from the protocol buffer's package statement |
| 244 | // or the input file name. |
| 245 | func (d *FileDescriptor) goPackageName() (name string, explicit bool) { |
| 246 | |
| Rob Pike | c9e7d97 | 2010-06-10 10:30:22 -0700 | [diff] [blame] | 247 | // Does the file have a package clause? |
| David Symonds | 8bb32ca | 2012-06-28 10:22:09 -0700 | [diff] [blame] | 248 | if pkg := d.GetPackage(); pkg != "" { |
| David Symonds | 162d003 | 2012-06-28 09:44:46 -0700 | [diff] [blame] | 249 | return pkg, false |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 250 | } |
| Rob Pike | c9e7d97 | 2010-06-10 10:30:22 -0700 | [diff] [blame] | 251 | // Use the file base name. |
| David Symonds | 8bb32ca | 2012-06-28 10:22:09 -0700 | [diff] [blame] | 252 | return BaseName(d.GetName()), false |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 253 | } |
| 254 | |
| David Symonds | b2a00c8 | 2011-08-04 16:52:58 +1000 | [diff] [blame] | 255 | func (d *FileDescriptor) addExport(obj Object, symbol Symbol) { |
| 256 | d.exported[obj] = append(d.exported[obj], symbol) |
| David Symonds | 31d58a2 | 2011-01-20 18:33:21 +1100 | [diff] [blame] | 257 | } |
| 258 | |
| 259 | // Symbol is an interface representing an exported Go symbol. |
| 260 | type Symbol interface { |
| 261 | // GenerateAlias should generate an appropriate alias |
| 262 | // for the symbol from the named package. |
| 263 | GenerateAlias(g *Generator, pkg string) |
| 264 | } |
| 265 | |
| 266 | type messageSymbol struct { |
| 267 | sym string |
| 268 | hasExtensions, isMessageSet bool |
| 269 | } |
| 270 | |
| 271 | func (ms messageSymbol) GenerateAlias(g *Generator, pkg string) { |
| 272 | remoteSym := pkg + "." + ms.sym |
| 273 | |
| 274 | g.P("type ", ms.sym, " ", remoteSym) |
| 275 | g.P("func (this *", ms.sym, ") Reset() { (*", remoteSym, ")(this).Reset() }") |
| David Symonds | e37856c | 2011-06-22 12:52:53 +1000 | [diff] [blame] | 276 | g.P("func (this *", ms.sym, ") String() string { return (*", remoteSym, ")(this).String() }") |
| David Symonds | 9f60f43 | 2012-06-14 09:45:25 +1000 | [diff] [blame] | 277 | g.P("func (*", ms.sym, ") ProtoMessage() {}") |
| David Symonds | 31d58a2 | 2011-01-20 18:33:21 +1100 | [diff] [blame] | 278 | if ms.hasExtensions { |
| David Symonds | 11db598 | 2012-08-15 10:54:05 +1000 | [diff] [blame^] | 279 | g.P("func (*", ms.sym, ") ExtensionRangeArray() []", g.Pkg["proto"], ".ExtensionRange ", |
| David Symonds | 31d58a2 | 2011-01-20 18:33:21 +1100 | [diff] [blame] | 280 | "{ return (*", remoteSym, ")(nil).ExtensionRangeArray() }") |
| David Symonds | 11db598 | 2012-08-15 10:54:05 +1000 | [diff] [blame^] | 281 | g.P("func (this *", ms.sym, ") ExtensionMap() map[int32]", g.Pkg["proto"], ".Extension ", |
| David Symonds | 31d58a2 | 2011-01-20 18:33:21 +1100 | [diff] [blame] | 282 | "{ return (*", remoteSym, ")(this).ExtensionMap() }") |
| 283 | if ms.isMessageSet { |
| Rob Pike | a17fdd9 | 2011-11-02 12:43:05 -0700 | [diff] [blame] | 284 | g.P("func (this *", ms.sym, ") Marshal() ([]byte, error) ", |
| David Symonds | 31d58a2 | 2011-01-20 18:33:21 +1100 | [diff] [blame] | 285 | "{ return (*", remoteSym, ")(this).Marshal() }") |
| Rob Pike | a17fdd9 | 2011-11-02 12:43:05 -0700 | [diff] [blame] | 286 | g.P("func (this *", ms.sym, ") Unmarshal(buf []byte) error ", |
| David Symonds | 31d58a2 | 2011-01-20 18:33:21 +1100 | [diff] [blame] | 287 | "{ return (*", remoteSym, ")(this).Unmarshal(buf) }") |
| 288 | } |
| 289 | } |
| 290 | } |
| 291 | |
| 292 | type enumSymbol string |
| 293 | |
| 294 | func (es enumSymbol) GenerateAlias(g *Generator, pkg string) { |
| 295 | s := string(es) |
| 296 | g.P("type ", s, " ", pkg, ".", s) |
| 297 | g.P("var ", s, "_name = ", pkg, ".", s, "_name") |
| 298 | g.P("var ", s, "_value = ", pkg, ".", s, "_value") |
| David Symonds | dd9ca04 | 2011-08-29 16:07:16 +1000 | [diff] [blame] | 299 | g.P("func New", s, "(x ", s, ") *", s, " { e := ", s, "(x); return &e }") |
| David Symonds | 31d58a2 | 2011-01-20 18:33:21 +1100 | [diff] [blame] | 300 | } |
| 301 | |
| 302 | type constOrVarSymbol struct { |
| 303 | sym string |
| 304 | typ string // either "const" or "var" |
| 305 | } |
| 306 | |
| 307 | func (cs constOrVarSymbol) GenerateAlias(g *Generator, pkg string) { |
| 308 | g.P(cs.typ, " ", cs.sym, " = ", pkg, ".", cs.sym) |
| 309 | } |
| 310 | |
| David Symonds | 4decd80 | 2011-08-04 11:27:07 +1000 | [diff] [blame] | 311 | // Object is an interface abstracting the abilities shared by enums, messages, extensions and imported objects. |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 312 | type Object interface { |
| 313 | PackageName() string // The name we use in our output (a_b_c), possibly renamed for uniqueness. |
| 314 | TypeName() []string |
| David Symonds | 4decd80 | 2011-08-04 11:27:07 +1000 | [diff] [blame] | 315 | File() *descriptor.FileDescriptorProto |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 316 | } |
| 317 | |
| 318 | // Each package name we generate must be unique. The package we're generating |
| David Symonds | 4decd80 | 2011-08-04 11:27:07 +1000 | [diff] [blame] | 319 | // gets its own name but every other package must have a unique name that does |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 320 | // not conflict in the code we generate. These names are chosen globally (although |
| 321 | // they don't have to be, it simplifies things to do them globally). |
| 322 | func uniquePackageOf(fd *descriptor.FileDescriptorProto) string { |
| 323 | s, ok := uniquePackageName[fd] |
| 324 | if !ok { |
| David Symonds | 8bb32ca | 2012-06-28 10:22:09 -0700 | [diff] [blame] | 325 | log.Fatal("internal error: no package name defined for", fd.GetName()) |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 326 | } |
| 327 | return s |
| 328 | } |
| 329 | |
| 330 | // Generator is the type whose methods generate the output, stored in the associated response structure. |
| 331 | type Generator struct { |
| David Symonds | f90e338 | 2010-05-05 10:53:44 +1000 | [diff] [blame] | 332 | *bytes.Buffer |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 333 | |
| 334 | Request *plugin.CodeGeneratorRequest // The input. |
| 335 | Response *plugin.CodeGeneratorResponse // The output. |
| 336 | |
| David Symonds | 162d003 | 2012-06-28 09:44:46 -0700 | [diff] [blame] | 337 | Param map[string]string // Command-line parameters. |
| 338 | PackageImportPath string // Go import path of the package we're generating code for |
| 339 | ImportPrefix string // String to prefix to imported package file names. |
| 340 | ImportMap map[string]string // Mapping from import name to generated name |
| Rob Pike | c9e7d97 | 2010-06-10 10:30:22 -0700 | [diff] [blame] | 341 | |
| David Symonds | 11db598 | 2012-08-15 10:54:05 +1000 | [diff] [blame^] | 342 | Pkg map[string]string // The names under which we import support packages |
| Rob Pike | c9e7d97 | 2010-06-10 10:30:22 -0700 | [diff] [blame] | 343 | |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 344 | packageName string // What we're calling ourselves. |
| 345 | allFiles []*FileDescriptor // All files in the tree |
| 346 | genFiles []*FileDescriptor // Those files we will generate output for. |
| 347 | file *FileDescriptor // The file we are compiling now. |
| David Symonds | f90e338 | 2010-05-05 10:53:44 +1000 | [diff] [blame] | 348 | usedPackages map[string]bool // Names of packages used in current file. |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 349 | typeNameToObject map[string]Object // Key is a fully-qualified name in input syntax. |
| 350 | indent string |
| 351 | } |
| 352 | |
| 353 | // New creates a new generator and allocates the request and response protobufs. |
| 354 | func New() *Generator { |
| 355 | g := new(Generator) |
| David Symonds | f90e338 | 2010-05-05 10:53:44 +1000 | [diff] [blame] | 356 | g.Buffer = new(bytes.Buffer) |
| David Symonds | b012753 | 2010-11-09 11:10:46 +1100 | [diff] [blame] | 357 | g.Request = new(plugin.CodeGeneratorRequest) |
| 358 | g.Response = new(plugin.CodeGeneratorResponse) |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 359 | return g |
| 360 | } |
| 361 | |
| Rob Pike | a17fdd9 | 2011-11-02 12:43:05 -0700 | [diff] [blame] | 362 | // Error reports a problem, including an error, and exits the program. |
| 363 | func (g *Generator) Error(err error, msgs ...string) { |
| 364 | s := strings.Join(msgs, " ") + ":" + err.Error() |
| Rob Pike | 5194c51 | 2010-10-14 13:02:16 -0700 | [diff] [blame] | 365 | log.Println("protoc-gen-go: error:", s) |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 366 | g.Response.Error = proto.String(s) |
| 367 | os.Exit(1) |
| 368 | } |
| 369 | |
| 370 | // Fail reports a problem and exits the program. |
| 371 | func (g *Generator) Fail(msgs ...string) { |
| 372 | s := strings.Join(msgs, " ") |
| Rob Pike | 5194c51 | 2010-10-14 13:02:16 -0700 | [diff] [blame] | 373 | log.Println("protoc-gen-go: error:", s) |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 374 | g.Response.Error = proto.String(s) |
| 375 | os.Exit(1) |
| 376 | } |
| 377 | |
| Rob Pike | c9e7d97 | 2010-06-10 10:30:22 -0700 | [diff] [blame] | 378 | // CommandLineParameters breaks the comma-separated list of key=value pairs |
| 379 | // in the parameter (a member of the request protobuf) into a key/value map. |
| 380 | // It then sets file name mappings defined by those entries. |
| 381 | func (g *Generator) CommandLineParameters(parameter string) { |
| 382 | g.Param = make(map[string]string) |
| David Symonds | 8935abf | 2011-07-04 15:53:16 +1000 | [diff] [blame] | 383 | for _, p := range strings.Split(parameter, ",") { |
| Rob Pike | c9e7d97 | 2010-06-10 10:30:22 -0700 | [diff] [blame] | 384 | if i := strings.Index(p, "="); i < 0 { |
| 385 | g.Param[p] = "" |
| 386 | } else { |
| 387 | g.Param[p[0:i]] = p[i+1:] |
| 388 | } |
| 389 | } |
| 390 | |
| 391 | g.ImportMap = make(map[string]string) |
| 392 | for k, v := range g.Param { |
| David Symonds | 162d003 | 2012-06-28 09:44:46 -0700 | [diff] [blame] | 393 | switch k { |
| 394 | case "import_prefix": |
| Rob Pike | c9e7d97 | 2010-06-10 10:30:22 -0700 | [diff] [blame] | 395 | g.ImportPrefix = v |
| David Symonds | 162d003 | 2012-06-28 09:44:46 -0700 | [diff] [blame] | 396 | case "import_path", "go_import_path": // TODO: remove go_import_path |
| 397 | g.PackageImportPath = v |
| 398 | default: |
| 399 | if len(k) > 0 && k[0] == 'M' { |
| 400 | g.ImportMap[k[1:]] = v |
| 401 | } |
| Rob Pike | c9e7d97 | 2010-06-10 10:30:22 -0700 | [diff] [blame] | 402 | } |
| 403 | } |
| 404 | } |
| 405 | |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 406 | // DefaultPackageName returns the package name printed for the object. |
| 407 | // If its file is in a different package, it returns the package name we're using for this file, plus ".". |
| 408 | // Otherwise it returns the empty string. |
| 409 | func (g *Generator) DefaultPackageName(obj Object) string { |
| 410 | pkg := obj.PackageName() |
| 411 | if pkg == g.packageName { |
| 412 | return "" |
| 413 | } |
| 414 | return pkg + "." |
| 415 | } |
| 416 | |
| 417 | // For each input file, the unique package name to use, underscored. |
| 418 | var uniquePackageName = make(map[*descriptor.FileDescriptorProto]string) |
| Rob Pike | 3f6f2d8 | 2011-12-18 13:55:35 -0800 | [diff] [blame] | 419 | |
| Rob Pike | c9e7d97 | 2010-06-10 10:30:22 -0700 | [diff] [blame] | 420 | // Package names already registered. Key is the name from the .proto file; |
| 421 | // value is the name that appears in the generated code. |
| 422 | var pkgNamesInUse = make(map[string]bool) |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 423 | |
| Rob Pike | c9e7d97 | 2010-06-10 10:30:22 -0700 | [diff] [blame] | 424 | // Create and remember a guaranteed unique package name for this file descriptor. |
| 425 | // Pkg is the candidate name. If f is nil, it's a builtin package like "proto" and |
| 426 | // has no file descriptor. |
| 427 | func RegisterUniquePackageName(pkg string, f *FileDescriptor) string { |
| David Symonds | 4138981 | 2011-07-19 14:57:40 +1000 | [diff] [blame] | 428 | // Convert dots to underscores before finding a unique alias. |
| David Symonds | 162d003 | 2012-06-28 09:44:46 -0700 | [diff] [blame] | 429 | pkg = strings.Map(BadToUnderscore, pkg) |
| David Symonds | 4138981 | 2011-07-19 14:57:40 +1000 | [diff] [blame] | 430 | |
| David Symonds | 79eae33 | 2010-10-16 11:33:20 +1100 | [diff] [blame] | 431 | for i, orig := 1, pkg; pkgNamesInUse[pkg]; i++ { |
| Rob Pike | c9e7d97 | 2010-06-10 10:30:22 -0700 | [diff] [blame] | 432 | // It's a duplicate; must rename. |
| David Symonds | 79eae33 | 2010-10-16 11:33:20 +1100 | [diff] [blame] | 433 | pkg = orig + strconv.Itoa(i) |
| Rob Pike | c9e7d97 | 2010-06-10 10:30:22 -0700 | [diff] [blame] | 434 | } |
| 435 | // Install it. |
| 436 | pkgNamesInUse[pkg] = true |
| Rob Pike | c9e7d97 | 2010-06-10 10:30:22 -0700 | [diff] [blame] | 437 | if f != nil { |
| 438 | uniquePackageName[f.FileDescriptorProto] = pkg |
| 439 | } |
| 440 | return pkg |
| 441 | } |
| 442 | |
| David Symonds | 162d003 | 2012-06-28 09:44:46 -0700 | [diff] [blame] | 443 | var isGoKeyword = map[string]bool{ |
| 444 | "break": true, |
| 445 | "case": true, |
| 446 | "chan": true, |
| 447 | "const": true, |
| 448 | "continue": true, |
| 449 | "default": true, |
| 450 | "else": true, |
| 451 | "defer": true, |
| 452 | "fallthrough": true, |
| 453 | "for": true, |
| 454 | "func": true, |
| 455 | "go": true, |
| 456 | "goto": true, |
| 457 | "if": true, |
| 458 | "import": true, |
| 459 | "interface": true, |
| 460 | "map": true, |
| 461 | "package": true, |
| 462 | "range": true, |
| 463 | "return": true, |
| 464 | "select": true, |
| 465 | "struct": true, |
| 466 | "switch": true, |
| 467 | "type": true, |
| 468 | "var": true, |
| 469 | } |
| 470 | |
| 471 | // defaultGoPackage returns the package name to use, |
| 472 | // derived from the import path of the package we're building code for. |
| 473 | func (g *Generator) defaultGoPackage() string { |
| 474 | p := g.PackageImportPath |
| 475 | if i := strings.LastIndex(p, "/"); i >= 0 { |
| 476 | p = p[i+1:] |
| 477 | } |
| 478 | if p == "" { |
| 479 | return "" |
| 480 | } |
| 481 | |
| 482 | p = strings.Map(BadToUnderscore, p) |
| 483 | // Identifier must not be keyword: insert _. |
| 484 | if isGoKeyword[p] { |
| 485 | p = "_" + p |
| 486 | } |
| 487 | // Identifier must not begin with digit: insert _. |
| 488 | if r, _ := utf8.DecodeRuneInString(p); unicode.IsDigit(r) { |
| 489 | p = "_" + p |
| 490 | } |
| 491 | return p |
| 492 | } |
| 493 | |
| Rob Pike | c9e7d97 | 2010-06-10 10:30:22 -0700 | [diff] [blame] | 494 | // SetPackageNames sets the package name for this run. |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 495 | // The package name must agree across all files being generated. |
| 496 | // It also defines unique package names for all imported files. |
| 497 | func (g *Generator) SetPackageNames() { |
| Rob Pike | c9e7d97 | 2010-06-10 10:30:22 -0700 | [diff] [blame] | 498 | // Register the name for this package. It will be the first name |
| 499 | // registered so is guaranteed to be unmodified. |
| David Symonds | 162d003 | 2012-06-28 09:44:46 -0700 | [diff] [blame] | 500 | pkg, explicit := g.genFiles[0].goPackageName() |
| 501 | |
| 502 | // Check all files for an explicit go_package option. |
| 503 | for _, f := range g.genFiles { |
| 504 | thisPkg, thisExplicit := f.goPackageName() |
| 505 | if thisExplicit { |
| 506 | if !explicit { |
| 507 | // Let this file's go_package option serve for all input files. |
| 508 | pkg, explicit = thisPkg, true |
| 509 | } else if thisPkg != pkg { |
| 510 | g.Fail("inconsistent package names:", thisPkg, pkg) |
| 511 | } |
| 512 | } |
| 513 | } |
| 514 | |
| 515 | // If we don't have an explicit go_package option but we have an |
| 516 | // import path, use that. |
| 517 | if !explicit { |
| 518 | p := g.defaultGoPackage() |
| 519 | if p != "" { |
| 520 | pkg, explicit = p, true |
| 521 | } |
| 522 | } |
| 523 | |
| 524 | // If there was no go_package and no import path to use, |
| 525 | // double-check that all the inputs have the same implicit |
| 526 | // Go package name. |
| 527 | if !explicit { |
| 528 | for _, f := range g.genFiles { |
| 529 | thisPkg, _ := f.goPackageName() |
| 530 | if thisPkg != pkg { |
| 531 | g.Fail("inconsistent package names:", thisPkg, pkg) |
| 532 | } |
| 533 | } |
| 534 | } |
| 535 | |
| Rob Pike | c9e7d97 | 2010-06-10 10:30:22 -0700 | [diff] [blame] | 536 | g.packageName = RegisterUniquePackageName(pkg, g.genFiles[0]) |
| David Symonds | 162d003 | 2012-06-28 09:44:46 -0700 | [diff] [blame] | 537 | |
| David Symonds | 11db598 | 2012-08-15 10:54:05 +1000 | [diff] [blame^] | 538 | // Register the support package names. They might collide with the |
| Rob Pike | c9e7d97 | 2010-06-10 10:30:22 -0700 | [diff] [blame] | 539 | // name of a package we import. |
| David Symonds | 11db598 | 2012-08-15 10:54:05 +1000 | [diff] [blame^] | 540 | g.Pkg = map[string]string{ |
| 541 | "json": RegisterUniquePackageName("json", nil), |
| 542 | "math": RegisterUniquePackageName("math", nil), |
| 543 | "proto": RegisterUniquePackageName("proto", nil), |
| 544 | } |
| David Symonds | 162d003 | 2012-06-28 09:44:46 -0700 | [diff] [blame] | 545 | |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 546 | AllFiles: |
| 547 | for _, f := range g.allFiles { |
| 548 | for _, genf := range g.genFiles { |
| 549 | if f == genf { |
| 550 | // In this package already. |
| 551 | uniquePackageName[f.FileDescriptorProto] = g.packageName |
| 552 | continue AllFiles |
| 553 | } |
| 554 | } |
| David Symonds | 7d5c824 | 2011-03-14 12:03:50 -0700 | [diff] [blame] | 555 | // The file is a dependency, so we want to ignore its go_package option |
| 556 | // because that is only relevant for its specific generated output. |
| David Symonds | 8bb32ca | 2012-06-28 10:22:09 -0700 | [diff] [blame] | 557 | pkg := f.GetPackage() |
| David Symonds | 7d5c824 | 2011-03-14 12:03:50 -0700 | [diff] [blame] | 558 | if pkg == "" { |
| 559 | pkg = BaseName(*f.Name) |
| 560 | } |
| 561 | RegisterUniquePackageName(pkg, f) |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 562 | } |
| 563 | } |
| 564 | |
| 565 | // WrapTypes walks the incoming data, wrapping DescriptorProtos, EnumDescriptorProtos |
| 566 | // and FileDescriptorProtos into file-referenced objects within the Generator. |
| 567 | // It also creates the list of files to generate and so should be called before GenerateAllFiles. |
| 568 | func (g *Generator) WrapTypes() { |
| 569 | g.allFiles = make([]*FileDescriptor, len(g.Request.ProtoFile)) |
| 570 | for i, f := range g.Request.ProtoFile { |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 571 | // We must wrap the descriptors before we wrap the enums |
| 572 | descs := wrapDescriptors(f) |
| 573 | g.buildNestedDescriptors(descs) |
| 574 | enums := wrapEnumDescriptors(f, descs) |
| 575 | exts := wrapExtensions(f) |
| David Symonds | 4decd80 | 2011-08-04 11:27:07 +1000 | [diff] [blame] | 576 | imps := wrapImported(f, g) |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 577 | g.allFiles[i] = &FileDescriptor{ |
| 578 | FileDescriptorProto: f, |
| 579 | desc: descs, |
| 580 | enum: enums, |
| 581 | ext: exts, |
| David Symonds | 4decd80 | 2011-08-04 11:27:07 +1000 | [diff] [blame] | 582 | imp: imps, |
| David Symonds | b2a00c8 | 2011-08-04 16:52:58 +1000 | [diff] [blame] | 583 | exported: make(map[Object][]Symbol), |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 584 | } |
| 585 | } |
| 586 | |
| 587 | g.genFiles = make([]*FileDescriptor, len(g.Request.FileToGenerate)) |
| 588 | FindFiles: |
| 589 | for i, fileName := range g.Request.FileToGenerate { |
| 590 | // Search the list. This algorithm is n^2 but n is tiny. |
| 591 | for _, file := range g.allFiles { |
| David Symonds | 8bb32ca | 2012-06-28 10:22:09 -0700 | [diff] [blame] | 592 | if fileName == file.GetName() { |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 593 | g.genFiles[i] = file |
| 594 | continue FindFiles |
| 595 | } |
| 596 | } |
| 597 | g.Fail("could not find file named", fileName) |
| 598 | } |
| 599 | g.Response.File = make([]*plugin.CodeGeneratorResponse_File, len(g.genFiles)) |
| 600 | } |
| 601 | |
| 602 | // Scan the descriptors in this file. For each one, build the slice of nested descriptors |
| 603 | func (g *Generator) buildNestedDescriptors(descs []*Descriptor) { |
| 604 | for _, desc := range descs { |
| 605 | if len(desc.NestedType) != 0 { |
| 606 | desc.nested = make([]*Descriptor, len(desc.NestedType)) |
| 607 | n := 0 |
| 608 | for _, nest := range descs { |
| 609 | if nest.parent == desc { |
| 610 | desc.nested[n] = nest |
| 611 | n++ |
| 612 | } |
| 613 | } |
| 614 | if n != len(desc.NestedType) { |
| David Symonds | 8bb32ca | 2012-06-28 10:22:09 -0700 | [diff] [blame] | 615 | g.Fail("internal error: nesting failure for", desc.GetName()) |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 616 | } |
| 617 | } |
| 618 | } |
| 619 | } |
| 620 | |
| 621 | // Construct the Descriptor and add it to the slice |
| 622 | func addDescriptor(sl []*Descriptor, desc *descriptor.DescriptorProto, parent *Descriptor, file *descriptor.FileDescriptorProto) []*Descriptor { |
| David Symonds | 4decd80 | 2011-08-04 11:27:07 +1000 | [diff] [blame] | 623 | d := &Descriptor{common{file}, desc, parent, nil, nil, nil} |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 624 | |
| 625 | d.ext = make([]*ExtensionDescriptor, len(desc.Extension)) |
| 626 | for i, field := range desc.Extension { |
| David Symonds | 4decd80 | 2011-08-04 11:27:07 +1000 | [diff] [blame] | 627 | d.ext[i] = &ExtensionDescriptor{common{file}, field, d} |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 628 | } |
| 629 | |
| David Symonds | cc7142e | 2010-11-06 14:37:15 +1100 | [diff] [blame] | 630 | return append(sl, d) |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 631 | } |
| 632 | |
| 633 | // Return a slice of all the Descriptors defined within this file |
| 634 | func wrapDescriptors(file *descriptor.FileDescriptorProto) []*Descriptor { |
| 635 | sl := make([]*Descriptor, 0, len(file.MessageType)+10) |
| 636 | for _, desc := range file.MessageType { |
| 637 | sl = wrapThisDescriptor(sl, desc, nil, file) |
| 638 | } |
| 639 | return sl |
| 640 | } |
| 641 | |
| 642 | // Wrap this Descriptor, recursively |
| 643 | func wrapThisDescriptor(sl []*Descriptor, desc *descriptor.DescriptorProto, parent *Descriptor, file *descriptor.FileDescriptorProto) []*Descriptor { |
| 644 | sl = addDescriptor(sl, desc, parent, file) |
| 645 | me := sl[len(sl)-1] |
| 646 | for _, nested := range desc.NestedType { |
| 647 | sl = wrapThisDescriptor(sl, nested, me, file) |
| 648 | } |
| 649 | return sl |
| 650 | } |
| 651 | |
| 652 | // Construct the EnumDescriptor and add it to the slice |
| 653 | func addEnumDescriptor(sl []*EnumDescriptor, desc *descriptor.EnumDescriptorProto, parent *Descriptor, file *descriptor.FileDescriptorProto) []*EnumDescriptor { |
| David Symonds | 4decd80 | 2011-08-04 11:27:07 +1000 | [diff] [blame] | 654 | return append(sl, &EnumDescriptor{common{file}, desc, parent, nil}) |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 655 | } |
| 656 | |
| 657 | // Return a slice of all the EnumDescriptors defined within this file |
| 658 | func wrapEnumDescriptors(file *descriptor.FileDescriptorProto, descs []*Descriptor) []*EnumDescriptor { |
| 659 | sl := make([]*EnumDescriptor, 0, len(file.EnumType)+10) |
| David Symonds | 5256cf6 | 2010-06-27 10:33:42 +1000 | [diff] [blame] | 660 | // Top-level enums. |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 661 | for _, enum := range file.EnumType { |
| 662 | sl = addEnumDescriptor(sl, enum, nil, file) |
| 663 | } |
| David Symonds | 5256cf6 | 2010-06-27 10:33:42 +1000 | [diff] [blame] | 664 | // Enums within messages. Enums within embedded messages appear in the outer-most message. |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 665 | for _, nested := range descs { |
| David Symonds | 5256cf6 | 2010-06-27 10:33:42 +1000 | [diff] [blame] | 666 | for _, enum := range nested.EnumType { |
| 667 | sl = addEnumDescriptor(sl, enum, nested, file) |
| 668 | } |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 669 | } |
| 670 | return sl |
| 671 | } |
| 672 | |
| 673 | // Return a slice of all the top-level ExtensionDescriptors defined within this file. |
| 674 | func wrapExtensions(file *descriptor.FileDescriptorProto) []*ExtensionDescriptor { |
| 675 | sl := make([]*ExtensionDescriptor, len(file.Extension)) |
| 676 | for i, field := range file.Extension { |
| David Symonds | 4decd80 | 2011-08-04 11:27:07 +1000 | [diff] [blame] | 677 | sl[i] = &ExtensionDescriptor{common{file}, field, nil} |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 678 | } |
| 679 | return sl |
| 680 | } |
| 681 | |
| David Symonds | 4decd80 | 2011-08-04 11:27:07 +1000 | [diff] [blame] | 682 | // Return a slice of all the types that are publicly imported into this file. |
| 683 | func wrapImported(file *descriptor.FileDescriptorProto, g *Generator) (sl []*ImportedDescriptor) { |
| 684 | for _, index := range file.PublicDependency { |
| 685 | df := g.fileByName(file.Dependency[index]) |
| 686 | for _, d := range df.desc { |
| 687 | sl = append(sl, &ImportedDescriptor{common{file}, d}) |
| 688 | } |
| 689 | for _, e := range df.enum { |
| 690 | sl = append(sl, &ImportedDescriptor{common{file}, e}) |
| 691 | } |
| 692 | for _, ext := range df.ext { |
| 693 | sl = append(sl, &ImportedDescriptor{common{file}, ext}) |
| 694 | } |
| 695 | } |
| 696 | return |
| 697 | } |
| 698 | |
| Rob Pike | c9e7d97 | 2010-06-10 10:30:22 -0700 | [diff] [blame] | 699 | // BuildTypeNameMap builds the map from fully qualified type names to objects. |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 700 | // The key names for the map come from the input data, which puts a period at the beginning. |
| 701 | // It should be called after SetPackageNames and before GenerateAllFiles. |
| 702 | func (g *Generator) BuildTypeNameMap() { |
| 703 | g.typeNameToObject = make(map[string]Object) |
| 704 | for _, f := range g.allFiles { |
| Rob Pike | c9e7d97 | 2010-06-10 10:30:22 -0700 | [diff] [blame] | 705 | // The names in this loop are defined by the proto world, not us, so the |
| 706 | // package name may be empty. If so, the dotted package name of X will |
| 707 | // be ".X"; otherwise it will be ".pkg.X". |
| David Symonds | 8bb32ca | 2012-06-28 10:22:09 -0700 | [diff] [blame] | 708 | dottedPkg := "." + f.GetPackage() |
| Rob Pike | c9e7d97 | 2010-06-10 10:30:22 -0700 | [diff] [blame] | 709 | if dottedPkg != "." { |
| 710 | dottedPkg += "." |
| 711 | } |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 712 | for _, enum := range f.enum { |
| 713 | name := dottedPkg + dottedSlice(enum.TypeName()) |
| 714 | g.typeNameToObject[name] = enum |
| 715 | } |
| 716 | for _, desc := range f.desc { |
| 717 | name := dottedPkg + dottedSlice(desc.TypeName()) |
| 718 | g.typeNameToObject[name] = desc |
| 719 | } |
| 720 | } |
| 721 | } |
| 722 | |
| 723 | // ObjectNamed, given a fully-qualified input type name as it appears in the input data, |
| 724 | // returns the descriptor for the message or enum with that name. |
| 725 | func (g *Generator) ObjectNamed(typeName string) Object { |
| David Symonds | 4decd80 | 2011-08-04 11:27:07 +1000 | [diff] [blame] | 726 | o, ok := g.typeNameToObject[typeName] |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 727 | if !ok { |
| 728 | g.Fail("can't find object with type", typeName) |
| 729 | } |
| David Symonds | 4decd80 | 2011-08-04 11:27:07 +1000 | [diff] [blame] | 730 | |
| 731 | // If the file of this object isn't a direct dependency of the current file, |
| 732 | // or in the current file, then this object has been publicly imported into |
| 733 | // a dependency of the current file. |
| 734 | // We should return the ImportedDescriptor object for it instead. |
| 735 | direct := *o.File().Name == *g.file.Name |
| 736 | if !direct { |
| 737 | for _, dep := range g.file.Dependency { |
| 738 | if *g.fileByName(dep).Name == *o.File().Name { |
| 739 | direct = true |
| 740 | break |
| 741 | } |
| 742 | } |
| 743 | } |
| 744 | if !direct { |
| 745 | found := false |
| 746 | Loop: |
| 747 | for _, dep := range g.file.Dependency { |
| 748 | df := g.fileByName(*g.fileByName(dep).Name) |
| 749 | for _, td := range df.imp { |
| 750 | if td.o == o { |
| 751 | // Found it! |
| 752 | o = td |
| 753 | found = true |
| 754 | break Loop |
| 755 | } |
| 756 | } |
| 757 | } |
| 758 | if !found { |
| 759 | log.Printf("protoc-gen-go: WARNING: failed finding publicly imported dependency for %v, used in %v", typeName, *g.file.Name) |
| 760 | } |
| 761 | } |
| 762 | |
| 763 | return o |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 764 | } |
| 765 | |
| 766 | // P prints the arguments to the generated output. It handles strings and int32s, plus |
| 767 | // handling indirections because they may be *string, etc. |
| 768 | func (g *Generator) P(str ...interface{}) { |
| 769 | g.WriteString(g.indent) |
| 770 | for _, v := range str { |
| 771 | switch s := v.(type) { |
| 772 | case string: |
| 773 | g.WriteString(s) |
| 774 | case *string: |
| 775 | g.WriteString(*s) |
| Rob Pike | c9e7d97 | 2010-06-10 10:30:22 -0700 | [diff] [blame] | 776 | case bool: |
| 777 | g.WriteString(fmt.Sprintf("%t", s)) |
| 778 | case *bool: |
| 779 | g.WriteString(fmt.Sprintf("%t", *s)) |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 780 | case *int32: |
| 781 | g.WriteString(fmt.Sprintf("%d", *s)) |
| Rob Pike | c9e7d97 | 2010-06-10 10:30:22 -0700 | [diff] [blame] | 782 | case float64: |
| 783 | g.WriteString(fmt.Sprintf("%g", s)) |
| 784 | case *float64: |
| 785 | g.WriteString(fmt.Sprintf("%g", *s)) |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 786 | default: |
| 787 | g.Fail(fmt.Sprintf("unknown type in printer: %T", v)) |
| 788 | } |
| 789 | } |
| 790 | g.WriteByte('\n') |
| 791 | } |
| 792 | |
| 793 | // In Indents the output one tab stop. |
| 794 | func (g *Generator) In() { g.indent += "\t" } |
| 795 | |
| 796 | // Out unindents the output one tab stop. |
| 797 | func (g *Generator) Out() { |
| 798 | if len(g.indent) > 0 { |
| 799 | g.indent = g.indent[1:] |
| 800 | } |
| 801 | } |
| 802 | |
| 803 | // GenerateAllFiles generates the output for all the files we're outputting. |
| 804 | func (g *Generator) GenerateAllFiles() { |
| Rob Pike | c9e7d97 | 2010-06-10 10:30:22 -0700 | [diff] [blame] | 805 | // Initialize the plugins |
| 806 | for _, p := range plugins { |
| 807 | p.Init(g) |
| 808 | } |
| David Symonds | 31d58a2 | 2011-01-20 18:33:21 +1100 | [diff] [blame] | 809 | // Generate the output. The generator runs for every file, even the files |
| 810 | // that we don't generate output for, so that we can collate the full list |
| 811 | // of exported symbols to support public imports. |
| 812 | genFileMap := make(map[*FileDescriptor]bool, len(g.genFiles)) |
| 813 | for _, file := range g.genFiles { |
| 814 | genFileMap[file] = true |
| 815 | } |
| 816 | i := 0 |
| 817 | for _, file := range g.allFiles { |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 818 | g.Reset() |
| 819 | g.generate(file) |
| David Symonds | 31d58a2 | 2011-01-20 18:33:21 +1100 | [diff] [blame] | 820 | if _, ok := genFileMap[file]; !ok { |
| 821 | continue |
| 822 | } |
| David Symonds | b012753 | 2010-11-09 11:10:46 +1100 | [diff] [blame] | 823 | g.Response.File[i] = new(plugin.CodeGeneratorResponse_File) |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 824 | g.Response.File[i].Name = proto.String(goFileName(*file.Name)) |
| 825 | g.Response.File[i].Content = proto.String(g.String()) |
| David Symonds | 31d58a2 | 2011-01-20 18:33:21 +1100 | [diff] [blame] | 826 | i++ |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 827 | } |
| 828 | } |
| 829 | |
| 830 | // Run all the plugins associated with the file. |
| 831 | func (g *Generator) runPlugins(file *FileDescriptor) { |
| 832 | for _, p := range plugins { |
| Rob Pike | c9e7d97 | 2010-06-10 10:30:22 -0700 | [diff] [blame] | 833 | p.Generate(file) |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 834 | } |
| 835 | } |
| 836 | |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 837 | // FileOf return the FileDescriptor for this FileDescriptorProto. |
| 838 | func (g *Generator) FileOf(fd *descriptor.FileDescriptorProto) *FileDescriptor { |
| 839 | for _, file := range g.allFiles { |
| 840 | if file.FileDescriptorProto == fd { |
| 841 | return file |
| 842 | } |
| 843 | } |
| David Symonds | 8bb32ca | 2012-06-28 10:22:09 -0700 | [diff] [blame] | 844 | g.Fail("could not find file in table:", fd.GetName()) |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 845 | return nil |
| 846 | } |
| 847 | |
| 848 | // Fill the response protocol buffer with the generated output for all the files we're |
| 849 | // supposed to generate. |
| 850 | func (g *Generator) generate(file *FileDescriptor) { |
| 851 | g.file = g.FileOf(file.FileDescriptorProto) |
| David Symonds | f90e338 | 2010-05-05 10:53:44 +1000 | [diff] [blame] | 852 | g.usedPackages = make(map[string]bool) |
| 853 | |
| David Symonds | 4decd80 | 2011-08-04 11:27:07 +1000 | [diff] [blame] | 854 | for _, td := range g.file.imp { |
| 855 | g.generateImported(td) |
| 856 | } |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 857 | for _, enum := range g.file.enum { |
| 858 | g.generateEnum(enum) |
| 859 | } |
| 860 | for _, desc := range g.file.desc { |
| 861 | g.generateMessage(desc) |
| 862 | } |
| 863 | for _, ext := range g.file.ext { |
| 864 | g.generateExtension(ext) |
| 865 | } |
| 866 | g.generateInitFunction() |
| David Symonds | f90e338 | 2010-05-05 10:53:44 +1000 | [diff] [blame] | 867 | |
| Rob Pike | c9e7d97 | 2010-06-10 10:30:22 -0700 | [diff] [blame] | 868 | // Run the plugins before the imports so we know which imports are necessary. |
| 869 | g.runPlugins(file) |
| 870 | |
| David Symonds | f90e338 | 2010-05-05 10:53:44 +1000 | [diff] [blame] | 871 | // Generate header and imports last, though they appear first in the output. |
| 872 | rem := g.Buffer |
| 873 | g.Buffer = new(bytes.Buffer) |
| 874 | g.generateHeader() |
| 875 | g.generateImports() |
| 876 | g.Write(rem.Bytes()) |
| David Symonds | b1d55a0 | 2011-04-08 09:55:06 +1000 | [diff] [blame] | 877 | |
| 878 | // Reformat generated code. |
| 879 | fset := token.NewFileSet() |
| 880 | ast, err := parser.ParseFile(fset, "", g, parser.ParseComments) |
| 881 | if err != nil { |
| Rob Pike | a17fdd9 | 2011-11-02 12:43:05 -0700 | [diff] [blame] | 882 | g.Fail("bad Go source code was generated:", err.Error()) |
| David Symonds | b1d55a0 | 2011-04-08 09:55:06 +1000 | [diff] [blame] | 883 | return |
| 884 | } |
| 885 | g.Reset() |
| David Symonds | 5ed980c | 2011-11-29 09:52:21 +1100 | [diff] [blame] | 886 | err = (&printer.Config{printer.TabIndent | printer.UseSpaces, 8}).Fprint(g, fset, ast) |
| David Symonds | b1d55a0 | 2011-04-08 09:55:06 +1000 | [diff] [blame] | 887 | if err != nil { |
| Rob Pike | a17fdd9 | 2011-11-02 12:43:05 -0700 | [diff] [blame] | 888 | g.Fail("generated Go source code could not be reformatted:", err.Error()) |
| David Symonds | b1d55a0 | 2011-04-08 09:55:06 +1000 | [diff] [blame] | 889 | } |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 890 | } |
| 891 | |
| David Symonds | 6253986 | 2012-08-04 10:06:55 +1000 | [diff] [blame] | 892 | // Generate the header, including package definition |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 893 | func (g *Generator) generateHeader() { |
| 894 | g.P("// Code generated by protoc-gen-go from ", Quote(*g.file.Name)) |
| 895 | g.P("// DO NOT EDIT!") |
| 896 | g.P() |
| 897 | g.P("package ", g.file.PackageName()) |
| 898 | g.P() |
| 899 | } |
| 900 | |
| David Symonds | 31d58a2 | 2011-01-20 18:33:21 +1100 | [diff] [blame] | 901 | func (g *Generator) fileByName(filename string) *FileDescriptor { |
| 902 | for _, fd := range g.allFiles { |
| David Symonds | 8bb32ca | 2012-06-28 10:22:09 -0700 | [diff] [blame] | 903 | if fd.GetName() == filename { |
| David Symonds | 31d58a2 | 2011-01-20 18:33:21 +1100 | [diff] [blame] | 904 | return fd |
| 905 | } |
| 906 | } |
| 907 | return nil |
| 908 | } |
| 909 | |
| David Symonds | 9685cb0 | 2012-02-13 08:10:34 +1100 | [diff] [blame] | 910 | // weak returns whether the ith import of the current file is a weak import. |
| 911 | func (g *Generator) weak(i int32) bool { |
| 912 | for _, j := range g.file.WeakDependency { |
| 913 | if j == i { |
| 914 | return true |
| 915 | } |
| 916 | } |
| 917 | return false |
| 918 | } |
| 919 | |
| David Symonds | 6253986 | 2012-08-04 10:06:55 +1000 | [diff] [blame] | 920 | // Generate the imports |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 921 | func (g *Generator) generateImports() { |
| Rob Pike | c9e7d97 | 2010-06-10 10:30:22 -0700 | [diff] [blame] | 922 | // We almost always need a proto import. Rather than computing when we |
| 923 | // do, which is tricky when there's a plugin, just import it and |
| Rob Pike | a17fdd9 | 2011-11-02 12:43:05 -0700 | [diff] [blame] | 924 | // reference it later. The same argument applies to the math package, |
| David Symonds | 11db598 | 2012-08-15 10:54:05 +1000 | [diff] [blame^] | 925 | // for handling bit patterns for floating-point numbers, and to the |
| 926 | // json package, for symbolic names of enum values for JSON marshaling. |
| 927 | g.P("import " + g.Pkg["proto"] + " " + Quote(g.ImportPrefix+"code.google.com/p/goprotobuf/proto")) |
| 928 | g.P("import " + g.Pkg["json"] + ` "encoding/json"`) |
| 929 | g.P("import " + g.Pkg["math"] + ` "math"`) |
| David Symonds | 9685cb0 | 2012-02-13 08:10:34 +1100 | [diff] [blame] | 930 | for i, s := range g.file.Dependency { |
| David Symonds | 31d58a2 | 2011-01-20 18:33:21 +1100 | [diff] [blame] | 931 | fd := g.fileByName(s) |
| 932 | // Do not import our own package. |
| 933 | if fd.PackageName() == g.packageName { |
| 934 | continue |
| 935 | } |
| 936 | filename := goFileName(s) |
| 937 | if substitution, ok := g.ImportMap[s]; ok { |
| 938 | filename = substitution |
| 939 | } |
| 940 | filename = g.ImportPrefix + filename |
| 941 | if strings.HasSuffix(filename, ".go") { |
| 942 | filename = filename[0 : len(filename)-3] |
| 943 | } |
| David Symonds | 9685cb0 | 2012-02-13 08:10:34 +1100 | [diff] [blame] | 944 | // Skip weak imports. |
| 945 | if g.weak(int32(i)) { |
| 946 | g.P("// skipping weak import ", fd.PackageName(), " ", Quote(filename)) |
| 947 | continue |
| 948 | } |
| David Symonds | 31d58a2 | 2011-01-20 18:33:21 +1100 | [diff] [blame] | 949 | if _, ok := g.usedPackages[fd.PackageName()]; ok { |
| 950 | g.P("import ", fd.PackageName(), " ", Quote(filename)) |
| 951 | } else { |
| David Symonds | 3fa055f | 2011-05-05 15:19:04 -0700 | [diff] [blame] | 952 | // TODO: Re-enable this when we are more feature-complete. |
| 953 | // For instance, some protos use foreign field extensions, which we don't support. |
| 954 | // Until then, this is just annoying spam. |
| 955 | //log.Printf("protoc-gen-go: discarding unused import from %v: %v", *g.file.Name, s) |
| David Symonds | 4decd80 | 2011-08-04 11:27:07 +1000 | [diff] [blame] | 956 | g.P("// discarding unused import ", fd.PackageName(), " ", Quote(filename)) |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 957 | } |
| 958 | } |
| 959 | g.P() |
| 960 | // TODO: may need to worry about uniqueness across plugins |
| 961 | for _, p := range plugins { |
| Rob Pike | c9e7d97 | 2010-06-10 10:30:22 -0700 | [diff] [blame] | 962 | p.GenerateImports(g.file) |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 963 | g.P() |
| 964 | } |
| David Symonds | 6253986 | 2012-08-04 10:06:55 +1000 | [diff] [blame] | 965 | g.P("// Reference proto, json, and math imports to suppress error if they are not otherwise used.") |
| David Symonds | 11db598 | 2012-08-15 10:54:05 +1000 | [diff] [blame^] | 966 | g.P("var _ = ", g.Pkg["proto"], ".Marshal") |
| David Symonds | 6253986 | 2012-08-04 10:06:55 +1000 | [diff] [blame] | 967 | g.P("var _ = &json.SyntaxError{}") |
| David Symonds | cea785b | 2011-01-07 11:02:30 +1100 | [diff] [blame] | 968 | g.P("var _ = math.Inf") |
| Rob Pike | c9e7d97 | 2010-06-10 10:30:22 -0700 | [diff] [blame] | 969 | g.P() |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 970 | } |
| 971 | |
| David Symonds | 4decd80 | 2011-08-04 11:27:07 +1000 | [diff] [blame] | 972 | func (g *Generator) generateImported(id *ImportedDescriptor) { |
| David Symonds | b2a00c8 | 2011-08-04 16:52:58 +1000 | [diff] [blame] | 973 | // Don't generate public import symbols for files that we are generating |
| 974 | // code for, since those symbols will already be in this package. |
| 975 | // We can't simply avoid creating the ImportedDescriptor objects, |
| 976 | // because g.genFiles isn't populated at that stage. |
| David Symonds | 4decd80 | 2011-08-04 11:27:07 +1000 | [diff] [blame] | 977 | tn := id.TypeName() |
| 978 | sn := tn[len(tn)-1] |
| David Symonds | b2a00c8 | 2011-08-04 16:52:58 +1000 | [diff] [blame] | 979 | df := g.FileOf(id.o.File()) |
| 980 | filename := *df.Name |
| 981 | for _, fd := range g.genFiles { |
| 982 | if *fd.Name == filename { |
| 983 | g.P("// Ignoring public import of ", sn, " from ", filename) |
| 984 | g.P() |
| 985 | return |
| 986 | } |
| 987 | } |
| 988 | g.P("// ", sn, " from public import ", filename) |
| 989 | g.usedPackages[df.PackageName()] = true |
| David Symonds | 4decd80 | 2011-08-04 11:27:07 +1000 | [diff] [blame] | 990 | |
| David Symonds | b2a00c8 | 2011-08-04 16:52:58 +1000 | [diff] [blame] | 991 | for _, sym := range df.exported[id.o] { |
| 992 | sym.GenerateAlias(g, df.PackageName()) |
| 993 | } |
| 994 | |
| 995 | g.P() |
| David Symonds | 4decd80 | 2011-08-04 11:27:07 +1000 | [diff] [blame] | 996 | } |
| 997 | |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 998 | // Generate the enum definitions for this EnumDescriptor. |
| 999 | func (g *Generator) generateEnum(enum *EnumDescriptor) { |
| 1000 | // The full type name |
| 1001 | typeName := enum.TypeName() |
| 1002 | // The full type name, CamelCased. |
| 1003 | ccTypeName := CamelCaseSlice(typeName) |
| 1004 | ccPrefix := enum.prefix() |
| 1005 | g.P("type ", ccTypeName, " int32") |
| David Symonds | b2a00c8 | 2011-08-04 16:52:58 +1000 | [diff] [blame] | 1006 | g.file.addExport(enum, enumSymbol(ccTypeName)) |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1007 | g.P("const (") |
| 1008 | g.In() |
| 1009 | for _, e := range enum.Value { |
| David Symonds | 31d58a2 | 2011-01-20 18:33:21 +1100 | [diff] [blame] | 1010 | name := ccPrefix + *e.Name |
| David Symonds | dd9ca04 | 2011-08-29 16:07:16 +1000 | [diff] [blame] | 1011 | g.P(name, " ", ccTypeName, " = ", e.Number) |
| David Symonds | b2a00c8 | 2011-08-04 16:52:58 +1000 | [diff] [blame] | 1012 | g.file.addExport(enum, constOrVarSymbol{name, "const"}) |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1013 | } |
| 1014 | g.Out() |
| 1015 | g.P(")") |
| David Symonds | 940b961 | 2011-04-01 10:45:23 +1100 | [diff] [blame] | 1016 | g.P("var ", ccTypeName, "_name = map[int32]string{") |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1017 | g.In() |
| Rob Pike | c9e7d97 | 2010-06-10 10:30:22 -0700 | [diff] [blame] | 1018 | generated := make(map[int32]bool) // avoid duplicate values |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1019 | for _, e := range enum.Value { |
| 1020 | duplicate := "" |
| 1021 | if _, present := generated[*e.Number]; present { |
| 1022 | duplicate = "// Duplicate value: " |
| 1023 | } |
| 1024 | g.P(duplicate, e.Number, ": ", Quote(*e.Name), ",") |
| 1025 | generated[*e.Number] = true |
| 1026 | } |
| 1027 | g.Out() |
| 1028 | g.P("}") |
| David Symonds | 940b961 | 2011-04-01 10:45:23 +1100 | [diff] [blame] | 1029 | g.P("var ", ccTypeName, "_value = map[string]int32{") |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1030 | g.In() |
| 1031 | for _, e := range enum.Value { |
| 1032 | g.P(Quote(*e.Name), ": ", e.Number, ",") |
| 1033 | } |
| 1034 | g.Out() |
| 1035 | g.P("}") |
| David Symonds | 940b961 | 2011-04-01 10:45:23 +1100 | [diff] [blame] | 1036 | |
| David Symonds | efeca9a | 2012-05-08 10:36:04 +1000 | [diff] [blame] | 1037 | g.P("func (x ", ccTypeName, ") Enum() *", ccTypeName, " {") |
| 1038 | g.In() |
| 1039 | g.P("p := new(", ccTypeName, ")") |
| 1040 | g.P("*p = x") |
| 1041 | g.P("return p") |
| 1042 | g.Out() |
| 1043 | g.P("}") |
| 1044 | |
| David Symonds | 940b961 | 2011-04-01 10:45:23 +1100 | [diff] [blame] | 1045 | g.P("func (x ", ccTypeName, ") String() string {") |
| 1046 | g.In() |
| David Symonds | 11db598 | 2012-08-15 10:54:05 +1000 | [diff] [blame^] | 1047 | g.P("return ", g.Pkg["proto"], ".EnumName(", ccTypeName, "_name, int32(x))") |
| David Symonds | 940b961 | 2011-04-01 10:45:23 +1100 | [diff] [blame] | 1048 | g.Out() |
| 1049 | g.P("}") |
| 1050 | |
| David Symonds | 6253986 | 2012-08-04 10:06:55 +1000 | [diff] [blame] | 1051 | g.P("func (x ", ccTypeName, ") MarshalJSON() ([]byte, error) {") |
| 1052 | g.In() |
| 1053 | g.P("return json.Marshal(x.String())") |
| 1054 | g.Out() |
| 1055 | g.P("}") |
| 1056 | |
| 1057 | g.P("func (x *", ccTypeName, ") UnmarshalJSON(data []byte) error {") |
| 1058 | g.In() |
| David Symonds | 11db598 | 2012-08-15 10:54:05 +1000 | [diff] [blame^] | 1059 | g.P("value, err := ", g.Pkg["proto"], ".UnmarshalJSONEnum(", ccTypeName, `_value, data, "`, ccTypeName, `")`) |
| David Symonds | 6253986 | 2012-08-04 10:06:55 +1000 | [diff] [blame] | 1060 | g.P("if err != nil {") |
| 1061 | g.In() |
| 1062 | g.P("return err") |
| 1063 | g.Out() |
| 1064 | g.P("}") |
| 1065 | g.P("*x = ", ccTypeName, "(value)") |
| 1066 | g.P("return nil") |
| 1067 | g.Out() |
| 1068 | g.P("}") |
| 1069 | |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1070 | g.P() |
| 1071 | } |
| 1072 | |
| David Symonds | 8935abf | 2011-07-04 15:53:16 +1000 | [diff] [blame] | 1073 | // The tag is a string like "varint,2,opt,name=fieldname,def=7" that |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1074 | // identifies details of the field for the protocol buffer marshaling and unmarshaling |
| 1075 | // code. The fields are: |
| 1076 | // wire encoding |
| 1077 | // protocol tag number |
| 1078 | // opt,req,rep for optional, required, or repeated |
| David Symonds | 5b7775e | 2010-12-01 10:09:04 +1100 | [diff] [blame] | 1079 | // packed whether the encoding is "packed" (optional; repeated primitives only) |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1080 | // name= the original declared name |
| 1081 | // enum= the name of the enum type if it is an enum-typed field. |
| 1082 | // def= string representation of the default value, if any. |
| 1083 | // The default value must be in a representation that can be used at run-time |
| 1084 | // to generate the default value. Thus bools become 0 and 1, for instance. |
| 1085 | func (g *Generator) goTag(field *descriptor.FieldDescriptorProto, wiretype string) string { |
| 1086 | optrepreq := "" |
| 1087 | switch { |
| 1088 | case isOptional(field): |
| 1089 | optrepreq = "opt" |
| 1090 | case isRequired(field): |
| 1091 | optrepreq = "req" |
| 1092 | case isRepeated(field): |
| 1093 | optrepreq = "rep" |
| 1094 | } |
| David Symonds | 8bb32ca | 2012-06-28 10:22:09 -0700 | [diff] [blame] | 1095 | defaultValue := field.GetDefaultValue() |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1096 | if defaultValue != "" { |
| 1097 | switch *field.Type { |
| 1098 | case descriptor.FieldDescriptorProto_TYPE_BOOL: |
| 1099 | if defaultValue == "true" { |
| 1100 | defaultValue = "1" |
| 1101 | } else { |
| 1102 | defaultValue = "0" |
| 1103 | } |
| 1104 | case descriptor.FieldDescriptorProto_TYPE_STRING, |
| 1105 | descriptor.FieldDescriptorProto_TYPE_BYTES: |
| David Symonds | b79d99b | 2011-08-29 16:38:49 +1000 | [diff] [blame] | 1106 | // Nothing to do. Quoting is done for the whole tag. |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1107 | case descriptor.FieldDescriptorProto_TYPE_ENUM: |
| 1108 | // For enums we need to provide the integer constant. |
| David Symonds | 8bb32ca | 2012-06-28 10:22:09 -0700 | [diff] [blame] | 1109 | obj := g.ObjectNamed(field.GetTypeName()) |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1110 | enum, ok := obj.(*EnumDescriptor) |
| 1111 | if !ok { |
| 1112 | g.Fail("enum type inconsistent for", CamelCaseSlice(obj.TypeName())) |
| 1113 | } |
| 1114 | defaultValue = enum.integerValueAsString(defaultValue) |
| 1115 | } |
| 1116 | defaultValue = ",def=" + defaultValue |
| 1117 | } |
| 1118 | enum := "" |
| 1119 | if *field.Type == descriptor.FieldDescriptorProto_TYPE_ENUM { |
| David Symonds | 4decd80 | 2011-08-04 11:27:07 +1000 | [diff] [blame] | 1120 | // We avoid using obj.PackageName(), because we want to use the |
| 1121 | // original (proto-world) package name. |
| David Symonds | 8bb32ca | 2012-06-28 10:22:09 -0700 | [diff] [blame] | 1122 | obj := g.ObjectNamed(field.GetTypeName()) |
| David Symonds | 4decd80 | 2011-08-04 11:27:07 +1000 | [diff] [blame] | 1123 | enum = ",enum=" |
| David Symonds | 8bb32ca | 2012-06-28 10:22:09 -0700 | [diff] [blame] | 1124 | if pkg := obj.File().GetPackage(); pkg != "" { |
| David Symonds | 4decd80 | 2011-08-04 11:27:07 +1000 | [diff] [blame] | 1125 | enum += pkg + "." |
| 1126 | } |
| 1127 | enum += CamelCaseSlice(obj.TypeName()) |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1128 | } |
| David Symonds | 5b7775e | 2010-12-01 10:09:04 +1100 | [diff] [blame] | 1129 | packed := "" |
| David Symonds | 8bb32ca | 2012-06-28 10:22:09 -0700 | [diff] [blame] | 1130 | if field.Options != nil && field.Options.GetPacked() { |
| David Symonds | 5b7775e | 2010-12-01 10:09:04 +1100 | [diff] [blame] | 1131 | packed = ",packed" |
| 1132 | } |
| David Symonds | 8bb32ca | 2012-06-28 10:22:09 -0700 | [diff] [blame] | 1133 | fieldName := field.GetName() |
| David Symonds | e37856c | 2011-06-22 12:52:53 +1000 | [diff] [blame] | 1134 | name := fieldName |
| David Symonds | 9f40281 | 2011-04-28 18:08:44 +1000 | [diff] [blame] | 1135 | if *field.Type == descriptor.FieldDescriptorProto_TYPE_GROUP { |
| 1136 | // We must use the type name for groups instead of |
| 1137 | // the field name to preserve capitalization. |
| 1138 | // type_name in FieldDescriptorProto is fully-qualified, |
| 1139 | // but we only want the local part. |
| 1140 | name = *field.TypeName |
| 1141 | if i := strings.LastIndex(name, "."); i >= 0 { |
| 1142 | name = name[i+1:] |
| 1143 | } |
| David Symonds | e37856c | 2011-06-22 12:52:53 +1000 | [diff] [blame] | 1144 | } |
| 1145 | if name == CamelCase(fieldName) { |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1146 | name = "" |
| 1147 | } else { |
| 1148 | name = ",name=" + name |
| 1149 | } |
| David Symonds | 8935abf | 2011-07-04 15:53:16 +1000 | [diff] [blame] | 1150 | return Quote(fmt.Sprintf("%s,%d,%s%s%s%s%s", |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1151 | wiretype, |
| David Symonds | 8bb32ca | 2012-06-28 10:22:09 -0700 | [diff] [blame] | 1152 | field.GetNumber(), |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1153 | optrepreq, |
| David Symonds | 5b7775e | 2010-12-01 10:09:04 +1100 | [diff] [blame] | 1154 | packed, |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1155 | name, |
| 1156 | enum, |
| 1157 | defaultValue)) |
| 1158 | } |
| 1159 | |
| 1160 | func needsStar(typ descriptor.FieldDescriptorProto_Type) bool { |
| 1161 | switch typ { |
| 1162 | case descriptor.FieldDescriptorProto_TYPE_GROUP: |
| 1163 | return false |
| 1164 | case descriptor.FieldDescriptorProto_TYPE_MESSAGE: |
| 1165 | return false |
| 1166 | case descriptor.FieldDescriptorProto_TYPE_BYTES: |
| 1167 | return false |
| 1168 | } |
| 1169 | return true |
| 1170 | } |
| 1171 | |
| 1172 | // TypeName is the printed name appropriate for an item. If the object is in the current file, |
| 1173 | // TypeName drops the package name and underscores the rest. |
| David Symonds | 7d5c824 | 2011-03-14 12:03:50 -0700 | [diff] [blame] | 1174 | // Otherwise the object is from another package; and the result is the underscored |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1175 | // package name followed by the item name. |
| 1176 | // The result always has an initial capital. |
| 1177 | func (g *Generator) TypeName(obj Object) string { |
| 1178 | return g.DefaultPackageName(obj) + CamelCaseSlice(obj.TypeName()) |
| 1179 | } |
| 1180 | |
| 1181 | // TypeNameWithPackage is like TypeName, but always includes the package |
| 1182 | // name even if the object is in our own package. |
| 1183 | func (g *Generator) TypeNameWithPackage(obj Object) string { |
| 1184 | return obj.PackageName() + CamelCaseSlice(obj.TypeName()) |
| 1185 | } |
| 1186 | |
| 1187 | // GoType returns a string representing the type name, and the wire type |
| 1188 | func (g *Generator) GoType(message *Descriptor, field *descriptor.FieldDescriptorProto) (typ string, wire string) { |
| 1189 | // TODO: Options. |
| 1190 | switch *field.Type { |
| 1191 | case descriptor.FieldDescriptorProto_TYPE_DOUBLE: |
| 1192 | typ, wire = "float64", "fixed64" |
| 1193 | case descriptor.FieldDescriptorProto_TYPE_FLOAT: |
| 1194 | typ, wire = "float32", "fixed32" |
| 1195 | case descriptor.FieldDescriptorProto_TYPE_INT64: |
| 1196 | typ, wire = "int64", "varint" |
| 1197 | case descriptor.FieldDescriptorProto_TYPE_UINT64: |
| 1198 | typ, wire = "uint64", "varint" |
| 1199 | case descriptor.FieldDescriptorProto_TYPE_INT32: |
| 1200 | typ, wire = "int32", "varint" |
| 1201 | case descriptor.FieldDescriptorProto_TYPE_UINT32: |
| 1202 | typ, wire = "uint32", "varint" |
| 1203 | case descriptor.FieldDescriptorProto_TYPE_FIXED64: |
| 1204 | typ, wire = "uint64", "fixed64" |
| 1205 | case descriptor.FieldDescriptorProto_TYPE_FIXED32: |
| 1206 | typ, wire = "uint32", "fixed32" |
| 1207 | case descriptor.FieldDescriptorProto_TYPE_BOOL: |
| 1208 | typ, wire = "bool", "varint" |
| 1209 | case descriptor.FieldDescriptorProto_TYPE_STRING: |
| 1210 | typ, wire = "string", "bytes" |
| 1211 | case descriptor.FieldDescriptorProto_TYPE_GROUP: |
| David Symonds | 8bb32ca | 2012-06-28 10:22:09 -0700 | [diff] [blame] | 1212 | desc := g.ObjectNamed(field.GetTypeName()) |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1213 | typ, wire = "*"+g.TypeName(desc), "group" |
| 1214 | case descriptor.FieldDescriptorProto_TYPE_MESSAGE: |
| David Symonds | 8bb32ca | 2012-06-28 10:22:09 -0700 | [diff] [blame] | 1215 | desc := g.ObjectNamed(field.GetTypeName()) |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1216 | typ, wire = "*"+g.TypeName(desc), "bytes" |
| 1217 | case descriptor.FieldDescriptorProto_TYPE_BYTES: |
| 1218 | typ, wire = "[]byte", "bytes" |
| 1219 | case descriptor.FieldDescriptorProto_TYPE_ENUM: |
| David Symonds | 8bb32ca | 2012-06-28 10:22:09 -0700 | [diff] [blame] | 1220 | desc := g.ObjectNamed(field.GetTypeName()) |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1221 | typ, wire = g.TypeName(desc), "varint" |
| 1222 | case descriptor.FieldDescriptorProto_TYPE_SFIXED32: |
| 1223 | typ, wire = "int32", "fixed32" |
| 1224 | case descriptor.FieldDescriptorProto_TYPE_SFIXED64: |
| 1225 | typ, wire = "int64", "fixed64" |
| 1226 | case descriptor.FieldDescriptorProto_TYPE_SINT32: |
| 1227 | typ, wire = "int32", "zigzag32" |
| 1228 | case descriptor.FieldDescriptorProto_TYPE_SINT64: |
| 1229 | typ, wire = "int64", "zigzag64" |
| 1230 | default: |
| David Symonds | 8bb32ca | 2012-06-28 10:22:09 -0700 | [diff] [blame] | 1231 | g.Fail("unknown type for", field.GetName()) |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1232 | } |
| 1233 | if isRepeated(field) { |
| 1234 | typ = "[]" + typ |
| 1235 | } else if needsStar(*field.Type) { |
| 1236 | typ = "*" + typ |
| 1237 | } |
| 1238 | return |
| 1239 | } |
| 1240 | |
| David Symonds | f90e338 | 2010-05-05 10:53:44 +1000 | [diff] [blame] | 1241 | func (g *Generator) RecordTypeUse(t string) { |
| 1242 | if obj, ok := g.typeNameToObject[t]; ok { |
| David Symonds | 4decd80 | 2011-08-04 11:27:07 +1000 | [diff] [blame] | 1243 | // Call ObjectNamed to get the true object to record the use. |
| 1244 | obj = g.ObjectNamed(t) |
| David Symonds | f90e338 | 2010-05-05 10:53:44 +1000 | [diff] [blame] | 1245 | g.usedPackages[obj.PackageName()] = true |
| 1246 | } |
| 1247 | } |
| 1248 | |
| David Symonds | 3ce5303 | 2012-02-13 10:55:03 +1100 | [diff] [blame] | 1249 | // Method names that may be generated. Fields with these names get an |
| 1250 | // underscore appended. |
| 1251 | var methodNames = [...]string{ |
| 1252 | "Reset", |
| 1253 | "String", |
| David Symonds | 9f60f43 | 2012-06-14 09:45:25 +1000 | [diff] [blame] | 1254 | "ProtoMessage", |
| David Symonds | 3ce5303 | 2012-02-13 10:55:03 +1100 | [diff] [blame] | 1255 | "Marshal", |
| 1256 | "Unmarshal", |
| 1257 | "ExtensionRangeArray", |
| 1258 | "ExtensionMap", |
| 1259 | } |
| 1260 | |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1261 | // Generate the type and default constant definitions for this Descriptor. |
| 1262 | func (g *Generator) generateMessage(message *Descriptor) { |
| 1263 | // The full type name |
| 1264 | typeName := message.TypeName() |
| 1265 | // The full type name, CamelCased. |
| 1266 | ccTypeName := CamelCaseSlice(typeName) |
| 1267 | |
| David Symonds | 3ce5303 | 2012-02-13 10:55:03 +1100 | [diff] [blame] | 1268 | usedNames := make(map[string]bool) |
| 1269 | for _, n := range methodNames { |
| 1270 | usedNames[n] = true |
| 1271 | } |
| David Symonds | 8bb32ca | 2012-06-28 10:22:09 -0700 | [diff] [blame] | 1272 | fieldNames := make(map[*descriptor.FieldDescriptorProto]string) |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1273 | g.P("type ", ccTypeName, " struct {") |
| 1274 | g.In() |
| 1275 | for _, field := range message.Field { |
| 1276 | fieldname := CamelCase(*field.Name) |
| David Symonds | 3ce5303 | 2012-02-13 10:55:03 +1100 | [diff] [blame] | 1277 | for usedNames[fieldname] { |
| 1278 | fieldname += "_" |
| 1279 | } |
| 1280 | usedNames[fieldname] = true |
| David Symonds | 8bb32ca | 2012-06-28 10:22:09 -0700 | [diff] [blame] | 1281 | fieldNames[field] = fieldname |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1282 | typename, wiretype := g.GoType(message, field) |
| David Symonds | b2a00c8 | 2011-08-04 16:52:58 +1000 | [diff] [blame] | 1283 | jsonName := *field.Name |
| David Symonds | 002ec40 | 2011-09-29 17:24:20 -0700 | [diff] [blame] | 1284 | tag := fmt.Sprintf("`protobuf:%s json:%q`", g.goTag(field, wiretype), jsonName+",omitempty") |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1285 | g.P(fieldname, "\t", typename, "\t", tag) |
| David Symonds | 8bb32ca | 2012-06-28 10:22:09 -0700 | [diff] [blame] | 1286 | g.RecordTypeUse(field.GetTypeName()) |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1287 | } |
| 1288 | if len(message.ExtensionRange) > 0 { |
| David Symonds | 11db598 | 2012-08-15 10:54:05 +1000 | [diff] [blame^] | 1289 | g.P("XXX_extensions\t\tmap[int32]", g.Pkg["proto"], ".Extension `json:\"-\"`") |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1290 | } |
| David Symonds | fd08ece | 2012-03-23 13:48:31 +1100 | [diff] [blame] | 1291 | g.P("XXX_unrecognized\t[]byte `json:\"-\"`") |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1292 | g.Out() |
| 1293 | g.P("}") |
| 1294 | |
| David Symonds | 9f60f43 | 2012-06-14 09:45:25 +1000 | [diff] [blame] | 1295 | // Reset, String and ProtoMessage methods. |
| David Symonds | e37856c | 2011-06-22 12:52:53 +1000 | [diff] [blame] | 1296 | g.P("func (this *", ccTypeName, ") Reset() { *this = ", ccTypeName, "{} }") |
| David Symonds | 11db598 | 2012-08-15 10:54:05 +1000 | [diff] [blame^] | 1297 | g.P("func (this *", ccTypeName, ") String() string { return ", g.Pkg["proto"], ".CompactTextString(this) }") |
| David Symonds | 9f60f43 | 2012-06-14 09:45:25 +1000 | [diff] [blame] | 1298 | g.P("func (*", ccTypeName, ") ProtoMessage() {}") |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1299 | |
| 1300 | // Extension support methods |
| David Symonds | 31d58a2 | 2011-01-20 18:33:21 +1100 | [diff] [blame] | 1301 | var hasExtensions, isMessageSet bool |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1302 | if len(message.ExtensionRange) > 0 { |
| David Symonds | 31d58a2 | 2011-01-20 18:33:21 +1100 | [diff] [blame] | 1303 | hasExtensions = true |
| David Symonds | 4fee3b1 | 2010-11-11 10:00:13 +1100 | [diff] [blame] | 1304 | // message_set_wire_format only makes sense when extensions are defined. |
| David Symonds | 8bb32ca | 2012-06-28 10:22:09 -0700 | [diff] [blame] | 1305 | if opts := message.Options; opts != nil && opts.GetMessageSetWireFormat() { |
| David Symonds | 31d58a2 | 2011-01-20 18:33:21 +1100 | [diff] [blame] | 1306 | isMessageSet = true |
| David Symonds | 4fee3b1 | 2010-11-11 10:00:13 +1100 | [diff] [blame] | 1307 | g.P() |
| Rob Pike | a17fdd9 | 2011-11-02 12:43:05 -0700 | [diff] [blame] | 1308 | g.P("func (this *", ccTypeName, ") Marshal() ([]byte, error) {") |
| David Symonds | 4fee3b1 | 2010-11-11 10:00:13 +1100 | [diff] [blame] | 1309 | g.In() |
| David Symonds | 11db598 | 2012-08-15 10:54:05 +1000 | [diff] [blame^] | 1310 | g.P("return ", g.Pkg["proto"], ".MarshalMessageSet(this.ExtensionMap())") |
| David Symonds | 4fee3b1 | 2010-11-11 10:00:13 +1100 | [diff] [blame] | 1311 | g.Out() |
| 1312 | g.P("}") |
| Rob Pike | a17fdd9 | 2011-11-02 12:43:05 -0700 | [diff] [blame] | 1313 | g.P("func (this *", ccTypeName, ") Unmarshal(buf []byte) error {") |
| David Symonds | 4fee3b1 | 2010-11-11 10:00:13 +1100 | [diff] [blame] | 1314 | g.In() |
| David Symonds | 11db598 | 2012-08-15 10:54:05 +1000 | [diff] [blame^] | 1315 | g.P("return ", g.Pkg["proto"], ".UnmarshalMessageSet(buf, this.ExtensionMap())") |
| David Symonds | 4fee3b1 | 2010-11-11 10:00:13 +1100 | [diff] [blame] | 1316 | g.Out() |
| 1317 | g.P("}") |
| 1318 | g.P("// ensure ", ccTypeName, " satisfies proto.Marshaler and proto.Unmarshaler") |
| David Symonds | 11db598 | 2012-08-15 10:54:05 +1000 | [diff] [blame^] | 1319 | g.P("var _ ", g.Pkg["proto"], ".Marshaler = (*", ccTypeName, ")(nil)") |
| 1320 | g.P("var _ ", g.Pkg["proto"], ".Unmarshaler = (*", ccTypeName, ")(nil)") |
| David Symonds | 4fee3b1 | 2010-11-11 10:00:13 +1100 | [diff] [blame] | 1321 | } |
| 1322 | |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1323 | g.P() |
| David Symonds | 11db598 | 2012-08-15 10:54:05 +1000 | [diff] [blame^] | 1324 | g.P("var extRange_", ccTypeName, " = []", g.Pkg["proto"], ".ExtensionRange{") |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1325 | g.In() |
| 1326 | for _, r := range message.ExtensionRange { |
| Rob Pike | c9e7d97 | 2010-06-10 10:30:22 -0700 | [diff] [blame] | 1327 | end := fmt.Sprint(*r.End - 1) // make range inclusive on both ends |
| David Symonds | 1d72f7a | 2011-08-19 18:28:52 +1000 | [diff] [blame] | 1328 | g.P("{", r.Start, ", ", end, "},") |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1329 | } |
| 1330 | g.Out() |
| 1331 | g.P("}") |
| David Symonds | 11db598 | 2012-08-15 10:54:05 +1000 | [diff] [blame^] | 1332 | g.P("func (*", ccTypeName, ") ExtensionRangeArray() []", g.Pkg["proto"], ".ExtensionRange {") |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1333 | g.In() |
| 1334 | g.P("return extRange_", ccTypeName) |
| 1335 | g.Out() |
| 1336 | g.P("}") |
| David Symonds | 11db598 | 2012-08-15 10:54:05 +1000 | [diff] [blame^] | 1337 | g.P("func (this *", ccTypeName, ") ExtensionMap() map[int32]", g.Pkg["proto"], ".Extension {") |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1338 | g.In() |
| 1339 | g.P("if this.XXX_extensions == nil {") |
| 1340 | g.In() |
| David Symonds | 11db598 | 2012-08-15 10:54:05 +1000 | [diff] [blame^] | 1341 | g.P("this.XXX_extensions = make(map[int32]", g.Pkg["proto"], ".Extension)") |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1342 | g.Out() |
| 1343 | g.P("}") |
| 1344 | g.P("return this.XXX_extensions") |
| 1345 | g.Out() |
| 1346 | g.P("}") |
| 1347 | } |
| 1348 | |
| David Symonds | b2a00c8 | 2011-08-04 16:52:58 +1000 | [diff] [blame] | 1349 | g.file.addExport(message, messageSymbol{ccTypeName, hasExtensions, isMessageSet}) |
| David Symonds | 31d58a2 | 2011-01-20 18:33:21 +1100 | [diff] [blame] | 1350 | |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1351 | // Default constants |
| David Symonds | 8bb32ca | 2012-06-28 10:22:09 -0700 | [diff] [blame] | 1352 | defNames := make(map[*descriptor.FieldDescriptorProto]string) |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1353 | for _, field := range message.Field { |
| David Symonds | 8bb32ca | 2012-06-28 10:22:09 -0700 | [diff] [blame] | 1354 | def := field.GetDefaultValue() |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1355 | if def == "" { |
| 1356 | continue |
| 1357 | } |
| 1358 | fieldname := "Default_" + ccTypeName + "_" + CamelCase(*field.Name) |
| David Symonds | 8bb32ca | 2012-06-28 10:22:09 -0700 | [diff] [blame] | 1359 | defNames[field] = fieldname |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1360 | typename, _ := g.GoType(message, field) |
| 1361 | if typename[0] == '*' { |
| 1362 | typename = typename[1:] |
| 1363 | } |
| 1364 | kind := "const " |
| 1365 | switch { |
| 1366 | case typename == "bool": |
| 1367 | case typename == "string": |
| 1368 | def = Quote(def) |
| 1369 | case typename == "[]byte": |
| 1370 | def = "[]byte(" + Quote(def) + ")" |
| 1371 | kind = "var " |
| David Symonds | cea785b | 2011-01-07 11:02:30 +1100 | [diff] [blame] | 1372 | case def == "inf", def == "-inf", def == "nan": |
| 1373 | // These names are known to, and defined by, the protocol language. |
| 1374 | switch def { |
| 1375 | case "inf": |
| 1376 | def = "math.Inf(1)" |
| 1377 | case "-inf": |
| 1378 | def = "math.Inf(-1)" |
| 1379 | case "nan": |
| 1380 | def = "math.NaN()" |
| 1381 | } |
| 1382 | if *field.Type == descriptor.FieldDescriptorProto_TYPE_FLOAT { |
| 1383 | def = "float32(" + def + ")" |
| 1384 | } |
| 1385 | kind = "var " |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1386 | case *field.Type == descriptor.FieldDescriptorProto_TYPE_ENUM: |
| 1387 | // Must be an enum. Need to construct the prefixed name. |
| David Symonds | 8bb32ca | 2012-06-28 10:22:09 -0700 | [diff] [blame] | 1388 | obj := g.ObjectNamed(field.GetTypeName()) |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1389 | enum, ok := obj.(*EnumDescriptor) |
| 1390 | if !ok { |
| Rob Pike | 5194c51 | 2010-10-14 13:02:16 -0700 | [diff] [blame] | 1391 | log.Println("don't know how to generate constant for", fieldname) |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1392 | continue |
| 1393 | } |
| Rob Pike | 87af39e | 2010-07-19 10:48:02 -0700 | [diff] [blame] | 1394 | def = g.DefaultPackageName(enum) + enum.prefix() + def |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1395 | } |
| 1396 | g.P(kind, fieldname, " ", typename, " = ", def) |
| David Symonds | b2a00c8 | 2011-08-04 16:52:58 +1000 | [diff] [blame] | 1397 | g.file.addExport(message, constOrVarSymbol{fieldname, kind}) |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1398 | } |
| 1399 | g.P() |
| 1400 | |
| David Symonds | 8bb32ca | 2012-06-28 10:22:09 -0700 | [diff] [blame] | 1401 | // Field getters |
| 1402 | // TODO: Generate getters for publicly imported aliases, if required. |
| 1403 | for _, field := range message.Field { |
| 1404 | if isRepeated(field) { |
| 1405 | continue |
| 1406 | } |
| 1407 | fname := fieldNames[field] |
| 1408 | typename, _ := g.GoType(message, field) |
| David Symonds | 8bb32ca | 2012-06-28 10:22:09 -0700 | [diff] [blame] | 1409 | mname := "Get" + fname |
| 1410 | star := "" |
| 1411 | if needsStar(*field.Type) && typename[0] == '*' { |
| 1412 | typename = typename[1:] |
| 1413 | star = "*" |
| 1414 | } |
| 1415 | g.P("func (this *", ccTypeName, ") "+mname+"() "+typename+" {") |
| 1416 | g.In() |
| 1417 | def, hasDef := defNames[field] |
| 1418 | typeDefaultIsNil := false // whether this field type's default value is a literal nil unless specified |
| 1419 | switch *field.Type { |
| 1420 | case descriptor.FieldDescriptorProto_TYPE_BYTES: |
| 1421 | typeDefaultIsNil = !hasDef |
| 1422 | case descriptor.FieldDescriptorProto_TYPE_GROUP, descriptor.FieldDescriptorProto_TYPE_MESSAGE: |
| 1423 | typeDefaultIsNil = true |
| 1424 | } |
| 1425 | if typeDefaultIsNil { |
| 1426 | // A bytes field with no explicit default needs less generated code, |
| 1427 | // as does a message or group field. |
| 1428 | g.P("if this != nil {") |
| 1429 | g.In() |
| 1430 | g.P("return this." + fname) |
| 1431 | g.Out() |
| 1432 | g.P("}") |
| 1433 | g.P("return nil") |
| 1434 | g.Out() |
| 1435 | g.P("}") |
| 1436 | g.P() |
| 1437 | continue |
| 1438 | } |
| 1439 | g.P("if this != nil && this." + fname + " != nil {") |
| 1440 | g.In() |
| 1441 | g.P("return " + star + "this." + fname) |
| 1442 | g.Out() |
| 1443 | g.P("}") |
| 1444 | if hasDef { |
| 1445 | if *field.Type != descriptor.FieldDescriptorProto_TYPE_BYTES { |
| 1446 | g.P("return " + def) |
| 1447 | } else { |
| 1448 | // The default is a []byte var. |
| 1449 | // Make a copy when returning it to be safe. |
| 1450 | g.P("return append([]byte(nil), ", def, "...)") |
| 1451 | } |
| 1452 | } else { |
| 1453 | switch *field.Type { |
| 1454 | case descriptor.FieldDescriptorProto_TYPE_BOOL: |
| 1455 | g.P("return false") |
| 1456 | case descriptor.FieldDescriptorProto_TYPE_STRING: |
| 1457 | g.P(`return ""`) |
| 1458 | default: |
| 1459 | g.P("return 0") |
| 1460 | } |
| 1461 | } |
| 1462 | g.Out() |
| 1463 | g.P("}") |
| 1464 | g.P() |
| 1465 | } |
| 1466 | |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1467 | for _, ext := range message.ext { |
| 1468 | g.generateExtension(ext) |
| 1469 | } |
| David Symonds | 525838c | 2012-07-20 15:42:49 +1000 | [diff] [blame] | 1470 | |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1471 | } |
| 1472 | |
| 1473 | func (g *Generator) generateExtension(ext *ExtensionDescriptor) { |
| David Symonds | e37856c | 2011-06-22 12:52:53 +1000 | [diff] [blame] | 1474 | ccTypeName := ext.DescName() |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1475 | |
| 1476 | extendedType := "*" + g.TypeName(g.ObjectNamed(*ext.Extendee)) |
| 1477 | field := ext.FieldDescriptorProto |
| 1478 | fieldType, wireType := g.GoType(ext.parent, field) |
| 1479 | tag := g.goTag(field, wireType) |
| David Symonds | f90e338 | 2010-05-05 10:53:44 +1000 | [diff] [blame] | 1480 | g.RecordTypeUse(*ext.Extendee) |
| David Symonds | 9f40281 | 2011-04-28 18:08:44 +1000 | [diff] [blame] | 1481 | if n := ext.FieldDescriptorProto.TypeName; n != nil { |
| 1482 | // foreign extension type |
| 1483 | g.RecordTypeUse(*n) |
| 1484 | } |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1485 | |
| David Symonds | 20c7366 | 2012-01-20 07:32:21 +1100 | [diff] [blame] | 1486 | typeName := ext.TypeName() |
| 1487 | |
| 1488 | // Special case for proto2 message sets: If this extension is extending |
| 1489 | // proto2_bridge.MessageSet, and its final name component is "message_set_extension", |
| 1490 | // then drop that last component. |
| 1491 | if extendedType == "*proto2_bridge.MessageSet" && typeName[len(typeName)-1] == "message_set_extension" { |
| 1492 | typeName = typeName[:len(typeName)-1] |
| 1493 | } |
| 1494 | |
| David Symonds | c057ad5 | 2012-02-11 15:43:42 +1100 | [diff] [blame] | 1495 | // For text formatting, the package must be exactly what the .proto file declares, |
| 1496 | // ignoring overrides such as the go_package option, and with no dot/underscore mapping. |
| 1497 | extName := strings.Join(typeName, ".") |
| 1498 | if g.file.Package != nil { |
| 1499 | extName = *g.file.Package + "." + extName |
| 1500 | } |
| 1501 | |
| David Symonds | 11db598 | 2012-08-15 10:54:05 +1000 | [diff] [blame^] | 1502 | g.P("var ", ccTypeName, " = &", g.Pkg["proto"], ".ExtensionDesc{") |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1503 | g.In() |
| 1504 | g.P("ExtendedType: (", extendedType, ")(nil),") |
| 1505 | g.P("ExtensionType: (", fieldType, ")(nil),") |
| 1506 | g.P("Field: ", field.Number, ",") |
| David Symonds | c057ad5 | 2012-02-11 15:43:42 +1100 | [diff] [blame] | 1507 | g.P(`Name: "`, extName, `",`) |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1508 | g.P("Tag: ", tag, ",") |
| 1509 | |
| 1510 | g.Out() |
| 1511 | g.P("}") |
| 1512 | g.P() |
| David Symonds | 31d58a2 | 2011-01-20 18:33:21 +1100 | [diff] [blame] | 1513 | |
| David Symonds | b2a00c8 | 2011-08-04 16:52:58 +1000 | [diff] [blame] | 1514 | g.file.addExport(ext, constOrVarSymbol{ccTypeName, "var"}) |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1515 | } |
| 1516 | |
| 1517 | func (g *Generator) generateInitFunction() { |
| 1518 | g.P("func init() {") |
| 1519 | g.In() |
| 1520 | for _, enum := range g.file.enum { |
| 1521 | g.generateEnumRegistration(enum) |
| 1522 | } |
| David Symonds | e37856c | 2011-06-22 12:52:53 +1000 | [diff] [blame] | 1523 | for _, d := range g.file.desc { |
| 1524 | for _, ext := range d.ext { |
| 1525 | g.generateExtensionRegistration(ext) |
| 1526 | } |
| 1527 | } |
| 1528 | for _, ext := range g.file.ext { |
| 1529 | g.generateExtensionRegistration(ext) |
| 1530 | } |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1531 | g.Out() |
| 1532 | g.P("}") |
| 1533 | } |
| 1534 | |
| 1535 | func (g *Generator) generateEnumRegistration(enum *EnumDescriptor) { |
| David Symonds | 4decd80 | 2011-08-04 11:27:07 +1000 | [diff] [blame] | 1536 | // // We always print the full (proto-world) package name here. |
| David Symonds | 8bb32ca | 2012-06-28 10:22:09 -0700 | [diff] [blame] | 1537 | pkg := enum.File().GetPackage() |
| David Symonds | 4decd80 | 2011-08-04 11:27:07 +1000 | [diff] [blame] | 1538 | if pkg != "" { |
| 1539 | pkg += "." |
| 1540 | } |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1541 | // The full type name |
| 1542 | typeName := enum.TypeName() |
| 1543 | // The full type name, CamelCased. |
| 1544 | ccTypeName := CamelCaseSlice(typeName) |
| David Symonds | 11db598 | 2012-08-15 10:54:05 +1000 | [diff] [blame^] | 1545 | g.P(g.Pkg["proto"]+".RegisterEnum(", Quote(pkg+ccTypeName), ", ", ccTypeName+"_name, ", ccTypeName+"_value)") |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1546 | } |
| 1547 | |
| David Symonds | e37856c | 2011-06-22 12:52:53 +1000 | [diff] [blame] | 1548 | func (g *Generator) generateExtensionRegistration(ext *ExtensionDescriptor) { |
| David Symonds | 11db598 | 2012-08-15 10:54:05 +1000 | [diff] [blame^] | 1549 | g.P(g.Pkg["proto"]+".RegisterExtension(", ext.DescName(), ")") |
| David Symonds | e37856c | 2011-06-22 12:52:53 +1000 | [diff] [blame] | 1550 | } |
| 1551 | |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1552 | // And now lots of helper functions. |
| 1553 | |
| Rob Pike | 2c7bafc | 2010-06-10 16:07:14 -0700 | [diff] [blame] | 1554 | // Is c an ASCII lower-case letter? |
| 1555 | func isASCIILower(c byte) bool { |
| 1556 | return 'a' <= c && c <= 'z' |
| 1557 | } |
| 1558 | |
| 1559 | // Is c an ASCII digit? |
| 1560 | func isASCIIDigit(c byte) bool { |
| 1561 | return '0' <= c && c <= '9' |
| 1562 | } |
| 1563 | |
| 1564 | // CamelCase returns the CamelCased name. |
| 1565 | // If there is an interior underscore followed by a lower case letter, |
| 1566 | // drop the underscore and convert the letter to upper case. |
| 1567 | // There is a remote possibility of this rewrite causing a name collision, |
| 1568 | // but it's so remote we're prepared to pretend it's nonexistent - since the |
| 1569 | // C++ generator lowercases names, it's extremely unlikely to have two fields |
| 1570 | // with different capitalizations. |
| 1571 | // In short, _my_field_name_2 becomes XMyFieldName2. |
| 1572 | func CamelCase(s string) string { |
| 1573 | if s == "" { |
| 1574 | return "" |
| 1575 | } |
| 1576 | t := make([]byte, 0, 32) |
| Rob Pike | 2c7bafc | 2010-06-10 16:07:14 -0700 | [diff] [blame] | 1577 | i := 0 |
| 1578 | if s[0] == '_' { |
| 1579 | // Need a capital letter; drop the '_'. |
| Rob Pike | 99fa2b6 | 2010-12-02 10:39:42 -0800 | [diff] [blame] | 1580 | t = append(t, 'X') |
| Rob Pike | 2c7bafc | 2010-06-10 16:07:14 -0700 | [diff] [blame] | 1581 | i++ |
| 1582 | } |
| 1583 | // Invariant: if the next letter is lower case, it must be converted |
| 1584 | // to upper case. |
| 1585 | // That is, we process a word at a time, where words are marked by _ or |
| 1586 | // upper case letter. Digits are treated as words. |
| 1587 | for ; i < len(s); i++ { |
| 1588 | c := s[i] |
| Rob Pike | 2c7bafc | 2010-06-10 16:07:14 -0700 | [diff] [blame] | 1589 | if c == '_' && i+1 < len(s) && isASCIILower(s[i+1]) { |
| 1590 | continue // Skip the underscore in s. |
| 1591 | } |
| 1592 | if isASCIIDigit(c) { |
| Rob Pike | 99fa2b6 | 2010-12-02 10:39:42 -0800 | [diff] [blame] | 1593 | t = append(t, c) |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1594 | continue |
| 1595 | } |
| Rob Pike | 2c7bafc | 2010-06-10 16:07:14 -0700 | [diff] [blame] | 1596 | // Assume we have a letter now - if not, it's a bogus identifier. |
| 1597 | // The next word is a sequence of characters that must start upper case. |
| 1598 | if isASCIILower(c) { |
| Rob Pike | 99fa2b6 | 2010-12-02 10:39:42 -0800 | [diff] [blame] | 1599 | c ^= ' ' // Make it a capital letter. |
| Rob Pike | 2c7bafc | 2010-06-10 16:07:14 -0700 | [diff] [blame] | 1600 | } |
| Rob Pike | 99fa2b6 | 2010-12-02 10:39:42 -0800 | [diff] [blame] | 1601 | t = append(t, c) // Guaranteed not lower case. |
| Rob Pike | 2c7bafc | 2010-06-10 16:07:14 -0700 | [diff] [blame] | 1602 | // Accept lower case sequence that follows. |
| 1603 | for i+1 < len(s) && isASCIILower(s[i+1]) { |
| 1604 | i++ |
| Rob Pike | 99fa2b6 | 2010-12-02 10:39:42 -0800 | [diff] [blame] | 1605 | t = append(t, s[i]) |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1606 | } |
| 1607 | } |
| Rob Pike | 2c7bafc | 2010-06-10 16:07:14 -0700 | [diff] [blame] | 1608 | return string(t) |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1609 | } |
| 1610 | |
| 1611 | // CamelCaseSlice is like CamelCase, but the argument is a slice of strings to |
| 1612 | // be joined with "_". |
| 1613 | func CamelCaseSlice(elem []string) string { return CamelCase(strings.Join(elem, "_")) } |
| 1614 | |
| 1615 | // dottedSlice turns a sliced name into a dotted name. |
| 1616 | func dottedSlice(elem []string) string { return strings.Join(elem, ".") } |
| 1617 | |
| 1618 | // Quote returns a Go-source quoted string representation of s. |
| 1619 | func Quote(s string) string { return fmt.Sprintf("%q", s) } |
| 1620 | |
| 1621 | // Given a .proto file name, return the output name for the generated Go program. |
| 1622 | func goFileName(name string) string { |
| Rob Pike | 87af39e | 2010-07-19 10:48:02 -0700 | [diff] [blame] | 1623 | ext := path.Ext(name) |
| 1624 | if ext == ".proto" || ext == ".protodevel" { |
| 1625 | name = name[0 : len(name)-len(ext)] |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1626 | } |
| 1627 | return name + ".pb.go" |
| 1628 | } |
| 1629 | |
| 1630 | // Is this field optional? |
| 1631 | func isOptional(field *descriptor.FieldDescriptorProto) bool { |
| 1632 | return field.Label != nil && *field.Label == descriptor.FieldDescriptorProto_LABEL_OPTIONAL |
| 1633 | } |
| 1634 | |
| 1635 | // Is this field required? |
| 1636 | func isRequired(field *descriptor.FieldDescriptorProto) bool { |
| 1637 | return field.Label != nil && *field.Label == descriptor.FieldDescriptorProto_LABEL_REQUIRED |
| 1638 | } |
| 1639 | |
| 1640 | // Is this field repeated? |
| 1641 | func isRepeated(field *descriptor.FieldDescriptorProto) bool { |
| 1642 | return field.Label != nil && *field.Label == descriptor.FieldDescriptorProto_LABEL_REPEATED |
| 1643 | } |
| 1644 | |
| David Symonds | 162d003 | 2012-06-28 09:44:46 -0700 | [diff] [blame] | 1645 | // BadToUnderscore is the mapping function used to generate Go names from package names, |
| 1646 | // which can be dotted in the input .proto file. It replaces non-identifier characters such as |
| 1647 | // dot or dash with underscore. |
| 1648 | func BadToUnderscore(r rune) rune { |
| 1649 | if unicode.IsLetter(r) || unicode.IsDigit(r) || r == '_' { |
| 1650 | return r |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1651 | } |
| David Symonds | 162d003 | 2012-06-28 09:44:46 -0700 | [diff] [blame] | 1652 | return '_' |
| Rob Pike | af82b4e | 2010-04-30 15:19:25 -0700 | [diff] [blame] | 1653 | } |
| Rob Pike | c9e7d97 | 2010-06-10 10:30:22 -0700 | [diff] [blame] | 1654 | |
| 1655 | // BaseName returns the last path element of the name, with the last dotted suffix removed. |
| 1656 | func BaseName(name string) string { |
| 1657 | // First, find the last element |
| 1658 | if i := strings.LastIndex(name, "/"); i >= 0 { |
| 1659 | name = name[i+1:] |
| 1660 | } |
| 1661 | // Now drop the suffix |
| 1662 | if i := strings.LastIndex(name, "."); i >= 0 { |
| 1663 | name = name[0:i] |
| 1664 | } |
| 1665 | return name |
| 1666 | } |