Add CloudflareProtectedEmailAddress

lib/cloudflare_protected_email_address.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+require 'cgi'
+
+class CloudflareProtectedEmailAddress
+  def initialize(obfuscated)
+    @obfuscated = obfuscated
+  end
+
+  def human_readable
+    return obfuscated unless unescaped.include?('@')
+    unescaped
+  end
+
+  private
+
+  attr_accessor :obfuscated
+
+  def components
+    obfuscated.scan(/.{2}/).map(&:hex)
+  end
+
+  def obfuscated_characters
+    components.drop(1)
+  end
+
+  def key
+    components.first
+  end
+
+  def escaped
+    obfuscated_characters.map { |char| (char ^ key).to_s(16).prepend('%') }.join
+  end
+
+  def unescaped
+    CGI.unescape(escaped)
+  end
+end

test/cloudflare_protected_email_address_test.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require_relative './test_helper'
+require_relative '../lib/cloudflare_protected_email_address'
+
+describe CloudflareProtectedEmailAddress do
+  it 'will make an obfuscated email address human readable' do
+    CloudflareProtectedEmailAddress.new('b3d2dfd7dcc5d6c1d2f3d7dac3c6c7d2d7dcc09dd4dcc59dc3ca')
+                                   .human_readable
+                                   .must_equal '[email protected]'
+  end
+
+  it 'returns the initialization email when it is not obfuscated' do
+    CloudflareProtectedEmailAddress.new('[email protected]')
+                                   .human_readable
+                                   .must_equal '[email protected]'
+  end
+
+  it 'returns the original string when the initialization string is not an obfuscated email' do
+    CloudflareProtectedEmailAddress.new('xyz789')
+                                   .human_readable
+                                   .must_equal 'xyz789'
+  end
+end