Sha256: e137564b5e50006f75e6000426075bae7c9f604e894bd0b04d9372b139c65d0b
Contents?: true
Size: 1.94 KB
Versions: 14
Compression:
Stored size: 1.94 KB
Contents
module GlobalSession
module Session
end
end
require 'global_session/session/abstract'
require 'global_session/session/v1'
require 'global_session/session/v2'
require 'global_session/session/v3'
# Ladies and gentlemen: the one and only, star of the show, GLOBAL SESSION!
#
# Session is designed to act as much like a Hash as possible. You can use
# most of the methods you would use with Hash: [], has_key?, each, etc. It has a
# few additional methods that are specific to itself, mostly involving whether
# it's expired, valid, supports a certain key, etc.
#
# Global sessions are versioned, and each version may have its own encoding
# strategy. This module acts as a namespace for the different versions, each
# of which is represented by a class in the module. They all inherit
# from the abstract base class in order to ensure that they are internally
# compatible with other components of this gem.
#
# This module also acts as a façade for reading global session cookies generated
# by the different versions; it is responsible for detecting the version of
# a given cookie, then instantiating a suitable session object.
module GlobalSession::Session
# Decode a global session cookie without checking signature or expiration. Good for debugging.
def self.decode_cookie(cookie)
guess_version(cookie).decode_cookie(cookie)
end
# Decode a global session cookie. Use a heuristic to determine the version.
# @raise [GlobalSession::MalformedCookie] if the cookie is not a valid serialized global session
def self.new(directory, cookie=nil, valid_signature_digest=nil)
guess_version(cookie).new(directory, cookie)
end
def self.guess_version(cookie)
case cookie
when /^WzM/ # == "[3"
V3
when /^l9/ # == binary msgpack symbol for "beginning of array"
V2
when /^eN/ # == zlib-compressed form of "{"
V1
else
V1 # due to zlib compression, there might be corner cases with the eN prefix
end
end
end
Version data entries
14 entries across 14 versions & 1 rubygems