package runtime

// RawExtension is used to hold extensions in external versions.
//
// To use this, make a field which has RawExtension as its type in your
// external, versioned struct, and Object in your internal struct. You also
// need to register your various plugin types.
//
// // Internal package:
//
// type MyAPIObject struct {
// runtime.TypeMeta `json:",inline"`
// MyPlugin runtime.Object `json:"myPlugin"`
// }
//
// type PluginA struct {
// AOption string `json:"aOption"`
// }
//
// // External package:
//
// type MyAPIObject struct {
// runtime.TypeMeta `json:",inline"`
// MyPlugin runtime.RawExtension `json:"myPlugin"`
// }
//
// type PluginA struct {
// AOption string `json:"aOption"`
// }
//
// // On the wire, the JSON will look something like this:
//
// {
// "kind":"MyAPIObject",
// "apiVersion":"v1",
// "myPlugin": {
// "kind":"PluginA",
// "aOption":"foo",
// },
// }
//
// So what happens? Decode first uses json or yaml to unmarshal the serialized
// data into your external MyAPIObject. That causes the raw JSON to be stored,
// but not unpacked. The next step is to copy (using pkg/conversion) into the
// internal struct. The runtime package's DefaultScheme has conversion
// functions installed which will unpack the JSON stored in RawExtension,
// turning it into the correct object type, and storing it in the Object.
// (TODO: In the case where the object is of an unknown type, a runtime.Unknown
// object will be created and stored.)
#RawExtension: {}