cloud_events 0.8.1 → 0.8.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5e5bb2b1e01aef9e34dca014ee2be62da7b2abaea1337c3db3f51c4dc9b6b790
-  data.tar.gz: 1c439ec71a81da471e67ebcc9de437b34be067c18a293790f0f9a098b3f0862b
+  metadata.gz: 2a711fe27eaab25a87e694f6436b2c34506b3a776457a77583c3f0f4bb0744ed
+  data.tar.gz: 01e81b176023ca2369999d2257c3157d4cef267ff0951e09a2df09f2848af0f5
 SHA512:
-  metadata.gz: 69a9b60f9d6d2a10ca5b22bbe171eba142d1864e90eed97bc8db8318d54070a64f916093ba92674eb08076e113f421584249bf114a6293f61c864ec48576e97a
-  data.tar.gz: ff8ac3a95310bbd915ee96efdb767575b4f094ae01a4b2e136a2e52e407b2c1c62d31e8dc4216c12ccb1267dec279a596eaeba7e16927d7a0768758e356817e7
+  metadata.gz: 96e2b1892b58bd5944d506ffff3e30a899fcb1bc03c31018637788cc8772def582e258b31f35786ebad8d054f22bfcbf2fdbe98e573ff098c2f89e2d8da4e1a0
+  data.tar.gz: e058c5c54f57224d02d42c9f52d7a320ef319b72573aa0d162f2362e06a0294bdd1f81f7705d55f47b40d8eadf418de85efb09c68c797978fcf0e5b49c91c1f4

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+### v0.8.3 / 2026-01-15
+
+* FIXED: Fixed default charset behavior for various non-text/plain content types
+
+### v0.8.2 / 2025-11-30
+
+* DOCS: Fixed a few typos in documentation and error messages
+
 ### v0.8.1 / 2025-11-10
 
 * DOCS: Some minor updates and corrections to the README and examples

data/lib/cloud_events/content_type.rb

@@ -22,17 +22,15 @@ module CloudEvents
     #
     # @param string [String] Content-Type header value in RFC 2045 format
     # @param default_charset [String] Optional. The charset to use if none is
-    #     specified. Defaults to `us-ascii`.
+    #     specified. Defaults to `utf-8` for all types other than `text/plain`
+    #     for which it defaults to `us-ascii`.
     #
     def initialize(string, default_charset: nil)
       @string = string.to_s
-      @media_type = "text"
-      @subtype_base = @subtype = "plain"
-      @subtype_format = nil
+      @media_type = @subtype = @subtype_base = @subtype_format = @charset = nil
       @params = []
-      @charset = default_charset || "us-ascii"
       @error_message = nil
-      parse(consume_comments(@string.strip))
+      parse(consume_comments(@string.strip), default_charset)
       @canonical_string = "#{@media_type}/#{@subtype}" +
                           @params.map { |k, v| "; #{k}=#{maybe_quote(v)}" }.join
       full_freeze
@@ -86,8 +84,10 @@ module CloudEvents
     attr_reader :params
 
     ##
-    # The charset, defaulting to "us-ascii" if none is explicitly set.
-    # @return [String]
+    # Returns the charset, which may be an appropriate default (e.g. `us-ascii`
+    # for `text/plain`, or `utf-8` for `application/json`), or may be nil for
+    # non-text cases.
+    # @return [String,nil]
     #
     attr_reader :charset
 
@@ -124,14 +124,14 @@ module CloudEvents
 
     private
 
-    def parse(str)
+    def parse(str, default_charset)
       @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")
+        name, str = consume_token(str, downcase: true, error_message: "Failed 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]
@@ -139,6 +139,13 @@ module CloudEvents
       end
     rescue ParseError => e
       @error_message = e.message
+    ensure
+      unless @subtype
+        @media_type = "text"
+        @subtype_base = @subtype = "plain"
+        @subtype_format = nil
+      end
+      @charset ||= default_charset || choose_default_charset
     end
 
     def consume_token(str, downcase: false, error_message: nil)
@@ -210,6 +217,14 @@ module CloudEvents
       "\"#{str}\""
     end
 
+    def choose_default_charset
+      if @media_type == "text" && @subtype == "plain"
+        "us-ascii"
+      elsif @media_type == "text" || @subtype_base == "json" || @subtype_format == "json"
+        "utf-8"
+      end
+    end
+
     def full_freeze
       instance_variables.each do |iv|
         instance_variable_get(iv).freeze

data/lib/cloud_events/event/opaque.rb

@@ -8,7 +8,7 @@ module CloudEvents
     # single event or a batch of events.
     #
     # The event data is retained in a form that can be reserialized (in a
-    # structured cotent mode in the same format) but cannot otherwise be
+    # structured content mode in the same format) but cannot otherwise be
     # inspected.
     #
     # This object is immutable, and Ractor-shareable on Ruby 3.

data/lib/cloud_events/format.rb

@@ -30,7 +30,7 @@ module CloudEvents
   #
   # Both the keyword arguments recognized and the returned hash members may
   # vary from formatter to formatter; similarly, the keyword arguments provided
-  # and the resturned hash members recognized may also vary for different
+  # and the returned hash members recognized may also vary for different
   # callers. This interface will define a set of common argument and result key
   # names, but both callers and formatters must gracefully handle the case of
   # missing or extra information. For example, if a formatter expects a certain

data/lib/cloud_events/text_format.rb

@@ -37,7 +37,7 @@ module CloudEvents
     end
 
     ##
-    # Trivially an event data object using text format.
+    # Trivially encode an event data object using text format.
     # See {CloudEvents::Format#encode_data} for a general description.
     #
     # Expects `:data` and `:content_type` arguments, and will decline the

data/lib/cloud_events/version.rb

@@ -5,5 +5,5 @@ module CloudEvents
   # Version of the Ruby CloudEvents SDK
   # @return [String]
   #
-  VERSION = "0.8.1"
+  VERSION = "0.8.3"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cloud_events
 version: !ruby/object:Gem::Version
-  version: 0.8.1
+  version: 0.8.3
 platform: ruby
 authors:
 - Daniel Azuma
@@ -42,10 +42,10 @@ homepage: https://github.com/cloudevents/sdk-ruby
 licenses:
 - Apache-2.0
 metadata:
-  changelog_uri: https://cloudevents.github.io/sdk-ruby/v0.8.1/file.CHANGELOG.html
+  changelog_uri: https://cloudevents.github.io/sdk-ruby/v0.8.3/file.CHANGELOG.html
   source_code_uri: https://github.com/cloudevents/sdk-ruby
   bug_tracker_uri: https://github.com/cloudevents/sdk-ruby/issues
-  documentation_uri: https://cloudevents.github.io/sdk-ruby/v0.8.1
+  documentation_uri: https://cloudevents.github.io/sdk-ruby/v0.8.3
 rdoc_options: []
 require_paths:
 - lib
@@ -60,7 +60,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.3
 specification_version: 4
 summary: Ruby SDK for CloudEvents
 test_files: []