functions_framework 0.4.1 → 0.7.0

data/lib/functions_framework/version.rb

@@ -17,5 +17,5 @@ module FunctionsFramework
   # Version of the Ruby Functions Framework
   # @return [String]
   #
-  VERSION = "0.4.1".freeze
+  VERSION = "0.7.0".freeze
 end

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: functions_framework
 version: !ruby/object:Gem::Version
-  version: 0.4.1
+  version: 0.7.0
 platform: ruby
 authors:
 - Daniel Azuma
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-07-08 00:00:00.000000000 Z
+date: 2020-09-25 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: cloud_events
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
 - !ruby/object:Gem::Dependency
   name: puma
   requirement: !ruby/object:Gem::Requirement
@@ -38,7 +52,10 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.1'
-description: The Functions Framework implementation for Ruby.
+description: The Functions Framework is an open source framework for writing lightweight,
+  portable Ruby functions that run in a serverless environment. Functions written
+  to this Framework will run on Google Cloud Functions, Google Cloud Run, or any other
+  Knative-based environment.
 email:
 - dazuma@google.com
 executables:
@@ -60,15 +77,6 @@ files:
 - docs/writing-functions.md
 - lib/functions_framework.rb
 - lib/functions_framework/cli.rb
-- lib/functions_framework/cloud_events.rb
-- lib/functions_framework/cloud_events/content_type.rb
-- lib/functions_framework/cloud_events/errors.rb
-- lib/functions_framework/cloud_events/event.rb
-- lib/functions_framework/cloud_events/event/field_interpreter.rb
-- lib/functions_framework/cloud_events/event/v0.rb
-- lib/functions_framework/cloud_events/event/v1.rb
-- lib/functions_framework/cloud_events/http_binding.rb
-- lib/functions_framework/cloud_events/json_format.rb
 - lib/functions_framework/function.rb
 - lib/functions_framework/legacy_event_converter.rb
 - lib/functions_framework/registry.rb
@@ -79,10 +87,10 @@ homepage: https://github.com/GoogleCloudPlatform/functions-framework-ruby
 licenses:
 - Apache-2.0
 metadata:
-  changelog_uri: https://github.com/GoogleCloudPlatform/functions-framework-ruby/blob/master/CHANGELOG.md
+  changelog_uri: https://googlecloudplatform.github.io/functions-framework-ruby/v0.7.0/file.CHANGELOG.html
   source_code_uri: https://github.com/GoogleCloudPlatform/functions-framework-ruby
   bug_tracker_uri: https://github.com/GoogleCloudPlatform/functions-framework-ruby/issues
-  documentation_uri: https://rubydoc.info/gems/functions_framework/0.4.1
+  documentation_uri: https://googlecloudplatform.github.io/functions-framework-ruby/v0.7.0
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -91,14 +99,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.4.0
+      version: 2.5.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
+rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
 summary: Functions Framework for Ruby

data/lib/functions_framework/cloud_events.rb

@@ -1,45 +0,0 @@
-# Copyright 2020 Google LLC
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     https://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-require "functions_framework/cloud_events/content_type"
-require "functions_framework/cloud_events/errors"
-require "functions_framework/cloud_events/event"
-require "functions_framework/cloud_events/http_binding"
-require "functions_framework/cloud_events/json_format"
-
-module FunctionsFramework
-  ##
-  # CloudEvents implementation.
-  #
-  # This is a Ruby implementation of the [CloudEvents](https://cloudevents.io)
-  # specification. It supports both
-  # [CloudEvents 0.3](https://github.com/cloudevents/spec/blob/v0.3/spec.md) and
-  # [CloudEvents 1.0](https://github.com/cloudevents/spec/blob/v1.0/spec.md).
-  #
-  module CloudEvents
-    # @private
-    SUPPORTED_SPEC_VERSIONS = ["0.3", "1.0"].freeze
-
-    class << self
-      ##
-      # The spec versions supported by this implementation.
-      #
-      # @return [Array<String>]
-      #
-      def supported_spec_versions
-        SUPPORTED_SPEC_VERSIONS
-      end
-    end
-  end
-end

data/lib/functions_framework/cloud_events/content_type.rb

@@ -1,222 +0,0 @@
-# Copyright 2020 Google LLC
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     https://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-module FunctionsFramework
-  module CloudEvents
-    ##
-    # A parsed content-type header.
-    #
-    # This object represents the information contained in a Content-Type,
-    # obtained by parsing the header according to RFC 2045.
-    #
-    # Case-insensitive fields, such as media_type and subtype, are normalized
-    # to lower case.
-    #
-    # If parsing fails, this class will try to get as much information as it
-    # can, and fill the rest with defaults as recommended in RFC 2045 sec 5.2.
-    # In case of a parsing error, the {#error_message} field will be set.
-    #
-    class ContentType
-      ##
-      # Parse the given header value.
-      #
-      # @param string [String] Content-Type header value in RFC 2045 format
-      #
-      def initialize string
-        @string = string
-        @media_type = "text"
-        @subtype_base = @subtype = "plain"
-        @subtype_format = nil
-        @params = []
-        @charset = "us-ascii"
-        @error_message = nil
-        parse consume_comments string.strip
-        @canonical_string = "#{@media_type}/#{@subtype}" +
-                            @params.map { |k, v| "; #{k}=#{maybe_quote v}" }.join
-      end
-
-      ##
-      # The original header content string.
-      # @return [String]
-      #
-      attr_reader :string
-      alias to_s string
-
-      ##
-      # A "canonical" header content string with spacing and capitalization
-      # normalized.
-      # @return [String]
-      #
-      attr_reader :canonical_string
-
-      ##
-      # The media type.
-      # @return [String]
-      #
-      attr_reader :media_type
-
-      ##
-      # The entire content subtype (which could include an extension delimited
-      # by a plus sign).
-      # @return [String]
-      #
-      attr_reader :subtype
-
-      ##
-      # The portion of the content subtype before any plus sign.
-      # @return [String]
-      #
-      attr_reader :subtype_base
-
-      ##
-      # The portion of the content subtype after any plus sign, or nil if there
-      # is no plus sign in the subtype.
-      # @return [String,nil]
-      #
-      attr_reader :subtype_format
-
-      ##
-      # An array of parameters, each element as a two-element array of the
-      # parameter name and value.
-      # @return [Array<Array(String,String)>]
-      #
-      attr_reader :params
-
-      ##
-      # The charset, defaulting to "us-ascii" if none is explicitly set.
-      # @return [String]
-      #
-      attr_reader :charset
-
-      ##
-      # The error message when parsing, or `nil` if there was no error message.
-      # @return [String,nil]
-      #
-      attr_reader :error_message
-
-      ##
-      # An array of values for the given parameter name
-      # @param key [String]
-      # @return [Array<String>]
-      #
-      def param_values key
-        key = key.downcase
-        @params.inject([]) { |a, (k, v)| key == k ? a << v : a }
-      end
-
-      ## @private
-      def == other
-        other.is_a?(ContentType) && canonical_string == other.canonical_string
-      end
-      alias eql? ==
-
-      ## @private
-      def hash
-        canonical_string.hash
-      end
-
-      ## @private
-      class ParseError < ::StandardError
-      end
-
-      private
-
-      def parse str
-        @media_type, str = consume_token str, downcase: true, error_message: "Failed to parse media type"
-        str = consume_special str, "/"
-        @subtype, str = consume_token str, downcase: true, error_message: "Failed to parse subtype"
-        @subtype_base, @subtype_format = @subtype.split "+", 2
-        until str.empty?
-          str = consume_special str, ";"
-          name, str = consume_token str, downcase: true, error_message: "Faled to parse attribute name"
-          str = consume_special str, "=", error_message: "Failed to find value for attribute #{name}"
-          val, str = consume_token_or_quoted str, error_message: "Failed to parse value for attribute #{name}"
-          @params << [name, val]
-          @charset = val if name == "charset"
-        end
-      rescue ParseError => e
-        @error_message = e.message
-      end
-
-      def consume_token str, downcase: false, error_message: nil
-        match = /^([\w!#\$%&'\*\+\.\^`\{\|\}-]+)(.*)$/.match str
-        raise ParseError, error_message || "Expected token" unless match
-        token = match[1]
-        token.downcase! if downcase
-        str = consume_comments match[2].strip
-        [token, str]
-      end
-
-      def consume_special str, expected, error_message: nil
-        raise ParseError, error_message || "Expected #{expected.inspect}" unless str.start_with? expected
-        consume_comments str[1..-1].strip
-      end
-
-      def consume_token_or_quoted str, error_message: nil
-        return consume_token str unless str.start_with? '"'
-        arr = []
-        index = 1
-        loop do
-          char = str[index]
-          case char
-          when nil
-            raise ParseError, error_message || "Quoted-string never finished"
-          when "\""
-            break
-          when "\\"
-            char = str[index + 1]
-            raise ParseError, error_message || "Quoted-string never finished" unless char
-            arr << char
-            index += 2
-          else
-            arr << char
-            index += 1
-          end
-        end
-        index += 1
-        str = consume_comments str[index..-1].strip
-        [arr.join, str]
-      end
-
-      def consume_comments str
-        return str unless str.start_with? "("
-        index = 1
-        loop do
-          char = str[index]
-          case char
-          when nil
-            raise ParseError, "Comment never finished"
-          when ")"
-            break
-          when "\\"
-            index += 2
-          when "("
-            str = consume_comments str[index..-1]
-            index = 0
-          else
-            index += 1
-          end
-        end
-        index += 1
-        consume_comments str[index..-1].strip
-      end
-
-      def maybe_quote str
-        return str if /^[\w!#\$%&'\*\+\.\^`\{\|\}-]+$/ =~ str
-        str = str.gsub("\\", "\\\\\\\\").gsub("\"", "\\\\\"")
-        "\"#{str}\""
-      end
-    end
-  end
-end

data/lib/functions_framework/cloud_events/errors.rb

@@ -1,42 +0,0 @@
-# Copyright 2020 Google LLC
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     https://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-module FunctionsFramework
-  module CloudEvents
-    ##
-    # Base class for all CloudEvents errors.
-    #
-    class CloudEventsError < ::StandardError
-    end
-
-    ##
-    # Errors indicating unsupported or incorrectly formatted HTTP content or
-    # headers.
-    #
-    class HttpContentError < CloudEventsError
-    end
-
-    ##
-    # Errors indicating an unsupported or incorrect spec version.
-    #
-    class SpecVersionError < CloudEventsError
-    end
-
-    ##
-    # Errors related to CloudEvent attributes.
-    #
-    class AttributeError < CloudEventsError
-    end
-  end
-end

data/lib/functions_framework/cloud_events/event.rb

@@ -1,84 +0,0 @@
-# Copyright 2020 Google LLC
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     https://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-require "date"
-require "uri"
-
-require "functions_framework/cloud_events/event/field_interpreter"
-require "functions_framework/cloud_events/event/v0"
-require "functions_framework/cloud_events/event/v1"
-
-module FunctionsFramework
-  module CloudEvents
-    ##
-    # An Event object represents a complete CloudEvent, including both data and
-    # context attributes. The following are true of all event objects:
-    #
-    #  *  Event classes are defined within this module. For example, events
-    #     conforming to the CloudEvents 1.0 specification are of type
-    #     {FunctionsFramework::CloudEvents::Event::V1}.
-    #  *  All event classes include this module, so you can use
-    #     `is_a? FunctionsFramework::CloudEvents::Event` to test whether an
-    #     object is an event.
-    #  *  All event objects are immutable. Data and atribute values can be
-    #     retrieved but not modified. To "modify" an event, make a copy with
-    #     the desired changes. Generally, event classes will provide a helper
-    #     method for this purpose.
-    #  *  All event objects have a `spec_version` method that returns the
-    #     version of the CloudEvents spec implemented by that event. (Other
-    #     methods may be different, depending on the spec version.)
-    #
-    # To create an event, you may either:
-    #
-    #  *  Construct an instance of the event class directly, for example by
-    #     calling {Event::V1.new} and passing a set of attributes.
-    #  *  Call {Event.create} and pass a spec version and a set of attributes.
-    #     This will choose the appropriate event class based on the version.
-    #  *  Decode an event from another representation. For example, use
-    #     {CloudEvents::JsonFormat} to decode an event from JSON, or use
-    #     {CloudEvents::HttpBinding} to decode an event from an HTTP request.
-    #
-    # See https://github.com/cloudevents/spec for more information about
-    # CloudEvents. The documentation for the individual event classes
-    # {FunctionsFramework::CloudEvents::Event::V0} and
-    # {FunctionsFramework::CloudEvents::Event::V1} also include links to their
-    # respective specifications.
-    #
-    module Event
-      class << self
-        ##
-        # Create a new cloud event object with the given version. Generally,
-        # you must also pass additional keyword arguments providing the event's
-        # data and attributes. For example, if you pass `1.0` as the
-        # `spec_version`, the remaining keyword arguments will be passed
-        # through to the {Event::V1.new} constructor.
-        #
-        # @param spec_version [String] The required `specversion` field.
-        # @param kwargs [keywords] Additional parameters for the event.
-        #
-        def create spec_version:, **kwargs
-          case spec_version
-          when "0.3"
-            V0.new spec_version: spec_version, **kwargs
-          when /^1(\.|$)/
-            V1.new spec_version: spec_version, **kwargs
-          else
-            raise SpecVersionError, "Unrecognized specversion: #{spec_version}"
-          end
-        end
-        alias new create
-      end
-    end
-  end
-end