Add support for operational arguments protobuf.

recipe_engine/arguments.proto

Index: recipe_engine/arguments.proto
diff --git a/recipe_engine/arguments.proto b/recipe_engine/arguments.proto
new file mode 100644
index 0000000000000000000000000000000000000000..801911b0f16d496f7ea792d715214f337eb182d1
--- /dev/null
+++ b/recipe_engine/arguments.proto
@@ -0,0 +1,56 @@
+// Copyright 2016 The LUCI Authors. All rights reserved.
+// Use of this source code is governed under the Apache License, Version 2.0
+// that can be found in the LICENSE file.
+
+// Recompile with libprotoc 2.5.0:
+// protoc -I recipe_engine recipe_engine/package.proto --python_out=recipe_engine

[martiniss, 2016/08/10 21:38:25]

Do we need this? You put this here, right? This should be automatically
recompiled by the bootstrap script.

[dnj, 2016/08/10 22:04:41]

Oops, yeah no.

+
+syntax = "proto3";
+
+package recipe_engine;
+
+// Arguments is a protobuf that can be supplied to the recipe engine through its
+// "--operational-args-path" command-line parameter in JSONPB format.
+message Arguments {
+  // A single recipe engine Property value.
+  message Property {
+    // The property value.
+    oneof value {

[martiniss, 2016/08/10 21:38:25]

What about lists? Currently for the recipe roller, we have a list of strings of
projects we want to roll. How would I represent this in this protobuf?

[dnj, 2016/08/10 22:04:41]

I wasn't aware of those. I'll add list.

+      // A string value.
+      string s = 1;
+
+      // An int64 value.
+      int64 int = 2;
+
+      // A uint64 value.
+      uint64 uint = 3;
+
+      // A double value.
+      double d = 4;
+
+      // A boolean value.
+      bool b = 5;
+
+      // Byte value.
+      bytes data = 6;
+
+      // Nested properties.
+      PropertyMap properties = 7;
+    }
+  }
+  message PropertyMap {
+    // A map of property key to value.
+    map<string, Property> property = 1;
+  }
+
+  // Input Properties.
+  PropertyMap properties = 1;
+
+  // Message containing the set of supported annotation control flags.
+  message AnnotationFlags {
+    // If true, emit CURRENT_TIMESTAMP annotations.
+    bool emit_timestamp = 1;
+  }
+  // Annotation control flags.
+  AnnotationFlags annotation_flags = 2;
+}