Contents

module Renc
  ERR_MESSAGE_ENCODING = 'argument `encoding` is not a Encoding Class'.freeze
  ERR_MESSAGE_OPTIONS  = 'argument `options` is not a Hash Class'.freeze

  # namespace
  module Configuration
    # this gem's default configured encoding
    # @see Encoding.default_external
    DEFAULT_ENCODING = Encoding.default_external

    # this gem's default options for String#encode
    # @see String#encode
    DEFAULT_OPTIONS = { undef: :replace }.freeze

    # return @default_encoding
    # @return [Encoding] @default_encoding
    # @see DEFAULT_ENCODING
    def default_encoding
      @default_encoding ||= DEFAULT_ENCODING
    end

    # configure default encoding
    # @example
    #   Renc.default_encoding = 1 # => TypeError
    #   Renc.default_encoding = Encoding::ASCII
    # @param encoding [Encoding]
    def default_encoding=(encoding)
      raise TypeError, ERR_MESSAGE_ENCODING unless encoding.is_a?(Encoding)
      @default_encoding = encoding
    end

    # return @default_options
    # @return [Encoding] @default_options
    # @see DEFAULT_OPTIONS
    def default_options
      @default_options ||= DEFAULT_OPTIONS
    end

    # configure default options
    # @example
    #   Renc.default_options = 1 # => TypeError
    #   Renc.default_options = { undef: nil }
    # @param options [Hash]
    def default_options=(options)
      raise TypeError, ERR_MESSAGE_OPTIONS unless options.is_a?(Hash)
      @default_options = options
    end
  end
end

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
renc-2.2.0	lib/renc/configuration.rb