icalendar 2.12.3 → 2.12.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7c417db33a0e54ccf03627a5e966cf86206e55e032dc66ba4aaf3f5ac9ec690a
-  data.tar.gz: cebd6eb2f86f758e92b23fb0dc990032b866f0d1ccc825b05d823c4a56927e04
+  metadata.gz: 6a9a656fd81bc80eb43cf61e14d95a3b582f66bae80417da16a7e5d621910581
+  data.tar.gz: df88f0f0a1619dbdcba157316aba616019d146fe74e46aba6d7603dc30b40c26
 SHA512:
-  metadata.gz: e4674fc5afbca40a1852ffd90a8e7d4b13364c4b9c4a7c966ab4cc4bd1ec06abf3df9bf9651bd99fd6083710717ef72af2520c4dcc75a252bd84ce73e281096c
-  data.tar.gz: 835f7c88d1af3248ba9c57e7a68a8fc1198a3ed6cd73c540ca83f8e2fb831cebf364128f28d08384005df11f62c05d64462e60ced3a1cfbc799fee2effa7a0c7
+  metadata.gz: a0ad4eb07a4123fba9260916530046bd008a9f076a26a276f09a31cce789aa0801a38fff3d553b7b11fcb3de072c72aff758921ad601d7e643b808495425b0df
+  data.tar.gz: 06bab135b068613fdf8c4d10554a327a35b2072eb5e37c5e7bc7509b8e62b05e596153cfa8985065b2739e99eb7bc90dd8282c173972929900aa763d58e218b1

data/CHANGELOG.md

@@ -1,5 +1,8 @@
 ## Unreleased
 
+## 2.12.4 - 2026-07-31
+- TEXT unescape fix - Vincent Gao
+
 ## 2.12.3 - 2026-05-13
 - Memory use optimization - Jared Menard
 - Run CI against Ruby 4.0 - Artem Chubchenko

data/lib/icalendar/values/text.rb

@@ -3,11 +3,11 @@
 module Icalendar
   module Values
     class Text < Value
+      UNESCAPE_GSUB_REGEX = /\\([\\,;nN])/.freeze
+
       def initialize(value, *args)
-        value = value.gsub('\n', "\n")
-        value.gsub!('\,', ',')
-        value.gsub!('\;', ';')
-        value.gsub!('\\\\') { '\\' }
+        # One left-to-right pass keeps unescape the exact inverse of value_ical; \n and \N are newline.
+        value = value.gsub(UNESCAPE_GSUB_REGEX) { |_| %w[n N].include?($1) ? "\n" : $1 }
         super value, *args
       end
 

data/lib/icalendar/version.rb

@@ -2,6 +2,6 @@
 
 module Icalendar
 
-  VERSION = '2.12.3'
+  VERSION = '2.12.4'
 
 end

data/spec/values/text_spec.rb

@@ -30,6 +30,39 @@ describe Icalendar::Values::Text do
     end
   end
 
+  describe 'unescape is the exact inverse of value_ical' do
+    bs = "\\"
+    {
+      'a literal backslash before n (windows path)' => ["C:#{bs}#{bs}next", "C:#{bs}next"],
+      'a UNC path with several backslashes'         => ["#{bs * 4}srv#{bs * 2}sh", "#{bs * 2}srv#{bs}sh"],
+      'an escaped backslash alone'                  => ["a#{bs}#{bs}b", "a#{bs}b"],
+      'an escaped comma'                            => ["a#{bs},b", 'a,b'],
+      'an escaped semicolon'                        => ["a#{bs};b", 'a;b'],
+      'a lowercase newline escape'                  => ["a#{bs}nb", "a\nb"],
+      'plain text without backslashes'              => ['plain summary text', 'plain summary text'],
+    }.each do |desc, (onwire, content)|
+      context "given #{desc}" do
+        subject { described_class.new onwire.dup }
+
+        it 'decodes to the original content' do
+          expect(subject.value).to eq content
+        end
+
+        it 'round-trips back to the on-wire form' do
+          expect(subject.value_ical).to eq onwire
+        end
+      end
+    end
+
+    it 'decodes a capital-N newline escape (RFC 5545 3.3.11)' do
+      expect(described_class.new("a#{bs}Nb").value).to eq "a\nb"
+    end
+
+    it 'leaves a backslash before a non-escape char untouched' do
+      expect(described_class.new("a#{bs}:b").value).to eq "a#{bs}:b"
+    end
+  end
+
   describe 'escapes parameter text properly' do
     subject { described_class.new escaped, {'param' => param_value} }
     context 'single value, no special characters' do

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: icalendar
 version: !ruby/object:Gem::Version
-  version: 2.12.3
+  version: 2.12.4
 platform: ruby
 authors:
 - Ryan Ahearn