Class: Mustermann::Mapper

Inherits:
Object
  • Object
show all
Defined in:
lib/mustermann/mapper.rb

Overview

A mapper allows mapping one string to another based on pattern parsing and expanding.

Examples:

require 'mustermann/mapper'
mapper = Mustermann::Mapper.new("/:foo" => "/:foo.html")
mapper['/example'] # => "/example.html"

Instance Method Summary collapse

Constructor Details

#initialize(**options) { ... } ⇒ Mapper #initialize(**options) {|mapper| ... } ⇒ Mapper #initialize(map = {}, **options) ⇒ Mapper

Creates a new mapper.

Overloads:

  • #initialize(**options) { ... } ⇒ Mapper

    Examples:

    require 'mustermann/mapper'
    Mustermann::Mapper.new(type: :rails) {{
      "/:foo" => ["/:foo.html", "/:foo.:format"]
    }}

    Parameters:

    • options (Hash)

      options The options hash

    Yields:

    • block for generating mappings as a hash

    Yield Returns:

  • #initialize(**options) {|mapper| ... } ⇒ Mapper

    Examples:

    require 'mustermann/mapper'
    Mustermann::Mapper.new(type: :rails) do |mapper|
      mapper["/:foo"] = ["/:foo.html", "/:foo.:format"]
    end

    Parameters:

    • options (Hash)

      options The options hash

    Yields:

    • block for generating mappings as a hash

    Yield Parameters:

  • #initialize(map = {}, **options) ⇒ Mapper

    Examples:

    map before options

    require 'mustermann/mapper'
    Mustermann::Mapper.new("/:foo" => "/:foo.html", type: :rails)

    map after options

    require 'mustermann/mapper'
    Mustermann::Mapper.new(type: :rails, "/:foo" => "/:foo.html")

    Parameters:

    • map (Hash) (defaults to: {})

      see #update

    • options (Hash)

      The options hash



47
48
49
50
51
52
53
# File 'lib/mustermann/mapper.rb', line 47

def initialize(map = {}, additional_values: :ignore, **options, &block)
  @map               = []
  @options           = options
  @additional_values = additional_values
  block.arity == 0 ? update(yield) : yield(self) if block
  update(map) if map
end

Instance Method Details

#[]=(key, value) ⇒ Object

Add a single mapping.

Parameters:



88
89
90
# File 'lib/mustermann/mapper.rb', line 88

def []=(key, value)
  update key => value
end

#convert(input, values = {}) ⇒ Object Also known as: []

Convert a string according to mappings. You can pass in additional params.

Examples:

mapping with and without additional parameters

mapper = Mustermann::Mapper.new("/:example" => "(/:prefix)?/:example.html")


76
77
78
79
80
81
82
# File 'lib/mustermann/mapper.rb', line 76

def convert(input, values = {})
  @map.inject(input) do |current, (pattern, expander)|
    params = pattern.params(current)
    params &&= Hash[values.merge(params).map { |k,v| [k.to_s, v] }]
    expander.expandable?(params) ? expander.expand(params) : current
  end
end

#to_hHash{Patttern: Expander}

Returns Hash version of the mapper.

Returns:

  • (Hash{Patttern: Expander})

    Hash version of the mapper.



67
68
69
# File 'lib/mustermann/mapper.rb', line 67

def to_h
  Hash[@map]
end

#update(map) ⇒ Object

Add multiple mappings.

Parameters:



58
59
60
61
62
63
64
# File 'lib/mustermann/mapper.rb', line 58

def update(map)
  map.to_h.each_pair do |input, output|
    input  = Mustermann.new(input, **@options)
    output = Expander.new(*output, additional_values: @additional_values, **@options) unless output.is_a? Expander
    @map << [input, output]
  end
end