contrast-agent 6.3.0 → 6.4.0

data/lib/protobuf/optionable.rb

@@ -0,0 +1,72 @@
+require 'active_support/core_ext/object/try'
+
+module Protobuf
+  module Optionable
+    module ClassMethods
+      def get_option(name)
+        name = name.to_s
+        option = optionable_descriptor_class.get_field(name, true)
+        fail ArgumentError, "invalid option=#{name}" unless option
+        unless option.fully_qualified_name.to_s == name
+          # Eventually we'll deprecate the use of simple names of fields completely, but for now make sure people
+          # are accessing options correctly. We allow simple names in other places for backwards compatibility.
+          fail ArgumentError, "must access option using its fully qualified name: #{option.fully_qualified_name.inspect}"
+        end
+        value =
+          if @_optionable_options.try(:key?, name)
+            @_optionable_options[name]
+          else
+            option.default_value
+          end
+        if option.type_class < ::Protobuf::Message
+          option.type_class.new(value)
+        else
+          value
+        end
+      end
+
+      def get_option!(name)
+        get_option(name) if @_optionable_options.try(:key?, name.to_s)
+      end
+
+      private
+
+      def set_option(name, value = true)
+        @_optionable_options ||= {}
+        @_optionable_options[name.to_s] = value
+      end
+    end
+
+    def get_option(name)
+      self.class.get_option(name)
+    end
+
+    def get_option!(name)
+      self.class.get_option!(name)
+    end
+
+    def self.inject(base_class, extend_class = true, &block)
+      unless block_given?
+        fail ArgumentError, 'missing option class block (e.g: ::CSGoogle::Protobuf::MessageOptions)'
+      end
+      if extend_class
+        # Check if optionable_descriptor_class is already defined and short circuit if so.
+        # File options are injected per module, and since a module can be defined more than once,
+        # we will get a warning if we try to define optionable_descriptor_class twice.
+        if base_class.respond_to?(:optionable_descriptor_class)
+          # Don't define optionable_descriptor_class twice
+          return  if base_class.optionable_descriptor_class == block.call
+
+          fail 'A class is being defined with two different descriptor classes, something is very wrong'
+        end
+
+        base_class.extend(ClassMethods)
+        base_class.__send__(:include, self)
+        base_class.define_singleton_method(:optionable_descriptor_class, block)
+      else
+        base_class.__send__(:include, ClassMethods)
+        base_class.module_eval { define_method(:optionable_descriptor_class, block) }
+      end
+    end
+  end
+end

data/lib/protobuf/tasks/compile.rake

@@ -0,0 +1,80 @@
+require "fileutils"
+
+namespace :protobuf do
+
+  desc "Clean & Compile the protobuf source to ruby classes. Pass PB_NO_CLEAN=1 if you do not want to force-clean first."
+  task :compile, [:package, :source, :destination, :plugin, :file_extension] do |_tasks, args|
+    binpath = ::File.expand_path("../../../../bin", __FILE__)
+
+    args.with_defaults(:destination => "lib")
+    args.with_defaults(:source => "definitions")
+    args.with_defaults(:plugin => "protoc-gen-ruby-protobuf=#{binpath}/protoc-gen-ruby")
+    args.with_defaults(:file_extension => ".pb.rb")
+
+    # The local Ruby generator collides with the builtin Ruby generator
+    #
+    # From the protoc docs:
+    #
+    #   --plugin=EXECUTABLE
+    #
+    #   ...EXECUTABLE may be of the form NAME=PATH, in which case the given plugin name
+    #   is mapped to the given executable even if the executable"s own name differs.
+    #
+    # Use the NAME=PATH form to specify an alternative plugin name that avoids the name collision
+    #
+    plugin_name, _plugin_path = args[:plugin].split("=")
+
+    # The plugin name MUST have the protoc-gen- prefix in order to work, but that prefix is dropped
+    # when using the plugin to generate definitions
+    plugin_name.gsub!("protoc-gen-", "")
+
+    unless do_not_clean?
+      force_clean!
+      ::Rake::Task[:clean].invoke(args[:package], args[:destination], args[:file_extension])
+    end
+
+    command = []
+    command << "protoc"
+    command << "--plugin=#{args[:plugin]}"
+    command << "--#{plugin_name}_out=#{args[:destination]}"
+    command << "-I #{args[:source]}"
+    command << Dir["#{args[:source]}/#{args[:package]}/**/*.proto"].join(" ")
+    full_command = command.join(" ")
+
+    puts full_command
+    system(full_command)
+  end
+
+  desc "Clean the generated *.pb.rb files from the destination package. Pass PB_FORCE_CLEAN=1 to skip confirmation step."
+  task :clean, [:package, :destination, :file_extension] do |_task, args|
+    args.with_defaults(:destination => "lib")
+    args.with_defaults(:file_extension => ".pb.rb")
+
+    file_extension = args[:file_extension].sub(/\*?\.+/, "")
+    files_to_clean = ::File.join(args[:destination], args[:package], "**", "*.#{file_extension}")
+
+    if force_clean? || permission_to_clean?(files_to_clean)
+      ::Dir.glob(files_to_clean).each do |file|
+        ::FileUtils.rm(file)
+      end
+    end
+  end
+
+  def do_not_clean?
+    ! ::ENV.key?("PB_NO_CLEAN")
+  end
+
+  def force_clean?
+    ::ENV.key?("PB_FORCE_CLEAN")
+  end
+
+  def force_clean!
+    ::ENV["PB_FORCE_CLEAN"] = "1"
+  end
+
+  def permission_to_clean?(files_to_clean)
+    puts "Do you really want to remove files matching pattern #{files_to_clean}? (y/n)"
+    ::STDIN.gets.chomp =~ /y(es)?/i
+  end
+
+end

data/lib/protobuf/tasks.rb

@@ -0,0 +1 @@
+load 'protobuf/tasks/compile.rake'

data/lib/protobuf/varint.rb

@@ -0,0 +1,20 @@
+module Protobuf
+  class Varint
+    if defined?(::Varint)
+      extend ::Varint
+
+      def self.encode(value)
+        bytes = []
+        until value < 128
+          bytes << (0x80 | (value & 0x7f))
+          value >>= 7
+        end
+        (bytes << value).pack('C*')
+      end
+    elsif defined?(::ProtobufJavaHelpers)
+      extend ::ProtobufJavaHelpers::EncodeDecode
+    else
+      extend VarintPure
+    end
+  end
+end

data/lib/protobuf/varint_pure.rb

@@ -0,0 +1,31 @@
+module Protobuf
+  module VarintPure
+    CACHE_LIMIT = 2048
+
+    def cached_varint(value)
+      @_varint_cache ||= {}
+      (@_varint_cache[value] ||= encode(value, false)).dup
+    end
+
+    def decode(stream)
+      value = index = 0
+      begin
+        byte = stream.readbyte
+        value |= (byte & 0x7f) << (7 * index)
+        index += 1
+      end while (byte & 0x80).nonzero?
+      value
+    end
+
+    def encode(value, use_cache = true)
+      return cached_varint(value) if use_cache && value >= 0 && value <= CACHE_LIMIT
+
+      bytes = []
+      until value < 128
+        bytes << (0x80 | (value & 0x7f))
+        value >>= 7
+      end
+      (bytes << value).pack('C*')
+    end
+  end
+end

data/lib/protobuf/version.rb

@@ -0,0 +1,3 @@
+module Protobuf
+  VERSION = '3.10.6' # rubocop:disable Style/MutableConstant
+end

data/lib/protobuf/wire_type.rb

@@ -0,0 +1,10 @@
+module Protobuf
+  module WireType
+    VARINT           = 0
+    FIXED64          = 1
+    LENGTH_DELIMITED = 2
+    START_GROUP      = 3
+    END_GROUP        = 4
+    FIXED32          = 5
+  end
+end

data/lib/protobuf.rb

@@ -0,0 +1,91 @@
+require 'base64'
+require 'logger'
+require 'pp'
+require 'socket'
+require 'stringio'
+
+# All top-level run time code requires, ordered by necessity
+require 'protobuf/wire_type'
+
+require 'protobuf/varint_pure'
+require 'protobuf/varint'
+
+require 'protobuf/exceptions'
+require 'protobuf/deprecation'
+require 'protobuf/logging'
+
+require 'protobuf/encoder'
+require 'protobuf/decoder'
+
+require 'protobuf/optionable'
+require 'protobuf/field'
+require 'protobuf/enum'
+require 'protobuf/message'
+require 'protobuf/descriptors'
+
+module Protobuf
+  class << self
+    # Client Host
+    #
+    # Default: `hostname` of the system
+    #
+    # The name or address of the host to use during client RPC calls.
+    attr_writer :client_host
+  end
+
+  def self.after_server_bind
+    ::ActiveSupport::Notifications.subscribe('after_server_bind') do |*args|
+      yield(*args)
+    end
+  end
+
+  def self.before_server_bind
+    ::ActiveSupport::Notifications.subscribe('before_server_bind') do |*args|
+      yield(*args)
+    end
+  end
+
+  def self.client_host
+    @client_host ||= Socket.gethostname
+  end
+
+  def self.connector_type_class
+    @connector_type_class ||= ::Protobuf::Rpc::Connectors::Socket
+  end
+
+  def self.connector_type_class= type_class
+    @connector_type_class = type_class
+  end
+
+  # GC Pause during server requests
+  #
+  # Default: false
+  #
+  # Boolean value to tell the server to disable
+  # the Garbage Collector when handling an rpc request.
+  # Once the request is completed, the GC is enabled again.
+  # This optomization provides a huge boost in speed to rpc requests.
+  def self.gc_pause_server_request?
+    return @gc_pause_server_request unless @gc_pause_server_request.nil?
+
+    self.gc_pause_server_request = false
+  end
+
+  def self.gc_pause_server_request= value
+    @gc_pause_server_request = !!value
+  end
+
+  # Permit unknown field on Message initialization
+  #
+  # Default: true
+  #
+  # Simple boolean to define whether we want to permit unknown fields
+  # on Message intialization; otherwise a ::Protobuf::FieldNotDefinedError is thrown.
+  def self.ignore_unknown_fields?
+    !defined?(@ignore_unknown_fields) || @ignore_unknown_fields
+  end
+
+  def self.ignore_unknown_fields= value
+    @ignore_unknown_fields = !!value
+  end
+end

data/proto/dynamic_discovery.proto

@@ -0,0 +1,46 @@
+// Copyright (c) 2013 MoneyDesktop, Inc.
+//
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// of this software and associated documentation files (the "Software"), to deal
+// in the Software without restriction, including without limitation the rights
+// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+//
+// The above copyright notice and this permission notice shall be included in
+// all copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+// THE SOFTWARE.
+
+// Authors: Devin Christensen
+//
+// Protobufs needed for dynamic discovery zmq server and client.
+
+syntax = "proto2";
+
+package protobuf.rpc.dynamicDiscovery;
+
+enum BeaconType {
+  HEARTBEAT = 0;
+  FLATLINE = 1;
+}
+
+message Server {
+  optional string uuid = 1;
+  optional string address = 2;
+  optional string port = 3;
+  optional int32 ttl = 4;
+  repeated string services = 5;
+}
+
+message Beacon {
+  optional BeaconType beacon_type = 1;
+  optional Server server = 2;
+}
+

data/proto/google/protobuf/compiler/plugin.proto

@@ -0,0 +1,183 @@
+// Protocol Buffers - Google's data interchange format
+// Copyright 2008 Google Inc.  All rights reserved.
+// https://developers.google.com/protocol-buffers/
+//
+// Redistribution and use in source and binary forms, with or without
+// modification, are permitted provided that the following conditions are
+// met:
+//
+//     * Redistributions of source code must retain the above copyright
+// notice, this list of conditions and the following disclaimer.
+//     * Redistributions in binary form must reproduce the above
+// copyright notice, this list of conditions and the following disclaimer
+// in the documentation and/or other materials provided with the
+// distribution.
+//     * Neither the name of Google Inc. nor the names of its
+// contributors may be used to endorse or promote products derived from
+// this software without specific prior written permission.
+//
+// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+// Author: kenton@google.com (Kenton Varda)
+//
+// WARNING:  The plugin interface is currently EXPERIMENTAL and is subject to
+//   change.
+//
+// protoc (aka the Protocol Compiler) can be extended via plugins.  A plugin is
+// just a program that reads a CodeGeneratorRequest from stdin and writes a
+// CodeGeneratorResponse to stdout.
+//
+// Plugins written using C++ can use google/protobuf/compiler/plugin.h instead
+// of dealing with the raw protocol defined here.
+//
+// A plugin executable needs only to be placed somewhere in the path.  The
+// plugin should be named "protoc-gen-$NAME", and will then be used when the
+// flag "--${NAME}_out" is passed to protoc.
+
+syntax = "proto2";
+
+package google.protobuf.compiler;
+option java_package = "com.google.protobuf.compiler";
+option java_outer_classname = "PluginProtos";
+
+option go_package = "google.golang.org/protobuf/types/pluginpb";
+
+import "google/protobuf/descriptor.proto";
+
+// The version number of protocol compiler.
+message Version {
+  optional int32 major = 1;
+  optional int32 minor = 2;
+  optional int32 patch = 3;
+  // A suffix for alpha, beta or rc release, e.g., "alpha-1", "rc2". It should
+  // be empty for mainline stable releases.
+  optional string suffix = 4;
+}
+
+// An encoded CodeGeneratorRequest is written to the plugin's stdin.
+message CodeGeneratorRequest {
+  // The .proto files that were explicitly listed on the command-line.  The
+  // code generator should generate code only for these files.  Each file's
+  // descriptor will be included in proto_file, below.
+  repeated string file_to_generate = 1;
+
+  // The generator parameter passed on the command-line.
+  optional string parameter = 2;
+
+  // FileDescriptorProtos for all files in files_to_generate and everything
+  // they import.  The files will appear in topological order, so each file
+  // appears before any file that imports it.
+  //
+  // protoc guarantees that all proto_files will be written after
+  // the fields above, even though this is not technically guaranteed by the
+  // protobuf wire format.  This theoretically could allow a plugin to stream
+  // in the FileDescriptorProtos and handle them one by one rather than read
+  // the entire set into memory at once.  However, as of this writing, this
+  // is not similarly optimized on protoc's end -- it will store all fields in
+  // memory at once before sending them to the plugin.
+  //
+  // Type names of fields and extensions in the FileDescriptorProto are always
+  // fully qualified.
+  repeated FileDescriptorProto proto_file = 15;
+
+  // The version number of protocol compiler.
+  optional Version compiler_version = 3;
+
+}
+
+// The plugin writes an encoded CodeGeneratorResponse to stdout.
+message CodeGeneratorResponse {
+  // Error message.  If non-empty, code generation failed.  The plugin process
+  // should exit with status code zero even if it reports an error in this way.
+  //
+  // This should be used to indicate errors in .proto files which prevent the
+  // code generator from generating correct code.  Errors which indicate a
+  // problem in protoc itself -- such as the input CodeGeneratorRequest being
+  // unparseable -- should be reported by writing a message to stderr and
+  // exiting with a non-zero status code.
+  optional string error = 1;
+
+  // A bitmask of supported features that the code generator supports.
+  // This is a bitwise "or" of values from the Feature enum.
+  optional uint64 supported_features = 2;
+
+  // Sync with code_generator.h.
+  enum Feature {
+    FEATURE_NONE = 0;
+    FEATURE_PROTO3_OPTIONAL = 1;
+  }
+
+  // Represents a single generated file.
+  message File {
+    // The file name, relative to the output directory.  The name must not
+    // contain "." or ".." components and must be relative, not be absolute (so,
+    // the file cannot lie outside the output directory).  "/" must be used as
+    // the path separator, not "\".
+    //
+    // If the name is omitted, the content will be appended to the previous
+    // file.  This allows the generator to break large files into small chunks,
+    // and allows the generated text to be streamed back to protoc so that large
+    // files need not reside completely in memory at one time.  Note that as of
+    // this writing protoc does not optimize for this -- it will read the entire
+    // CodeGeneratorResponse before writing files to disk.
+    optional string name = 1;
+
+    // If non-empty, indicates that the named file should already exist, and the
+    // content here is to be inserted into that file at a defined insertion
+    // point.  This feature allows a code generator to extend the output
+    // produced by another code generator.  The original generator may provide
+    // insertion points by placing special annotations in the file that look
+    // like:
+    //   @@protoc_insertion_point(NAME)
+    // The annotation can have arbitrary text before and after it on the line,
+    // which allows it to be placed in a comment.  NAME should be replaced with
+    // an identifier naming the point -- this is what other generators will use
+    // as the insertion_point.  Code inserted at this point will be placed
+    // immediately above the line containing the insertion point (thus multiple
+    // insertions to the same point will come out in the order they were added).
+    // The double-@ is intended to make it unlikely that the generated code
+    // could contain things that look like insertion points by accident.
+    //
+    // For example, the C++ code generator places the following line in the
+    // .pb.h files that it generates:
+    //   // @@protoc_insertion_point(namespace_scope)
+    // This line appears within the scope of the file's package namespace, but
+    // outside of any particular class.  Another plugin can then specify the
+    // insertion_point "namespace_scope" to generate additional classes or
+    // other declarations that should be placed in this scope.
+    //
+    // Note that if the line containing the insertion point begins with
+    // whitespace, the same whitespace will be added to every line of the
+    // inserted text.  This is useful for languages like Python, where
+    // indentation matters.  In these languages, the insertion point comment
+    // should be indented the same amount as any inserted code will need to be
+    // in order to work correctly in that context.
+    //
+    // The code generator that generates the initial file and the one which
+    // inserts into it must both run as part of a single invocation of protoc.
+    // Code generators are executed in the order in which they appear on the
+    // command line.
+    //
+    // If |insertion_point| is present, |name| must also be present.
+    optional string insertion_point = 2;
+
+    // The file contents.
+    optional string content = 15;
+
+    // Information describing the file content being inserted. If an insertion
+    // point is used, this information will be appropriately offset and inserted
+    // into the code generation metadata for the generated files.
+    optional GeneratedCodeInfo generated_code_info = 16;
+  }
+  repeated File file = 15;
+}