mustermann 3.1.0 → 4.0.0.alpha

data/lib/mustermann/extension.rb

@@ -1,3 +0,0 @@
-# frozen_string_literal: true
-
-fail "Mustermann extension for Sinatra has been extracted into its own gem. More information at https://github.com/sinatra/mustermann-sinatra-extension"

data/lib/mustermann/mapper.rb

@@ -1,91 +0,0 @@
-# frozen_string_literal: true
-require 'mustermann'
-require 'mustermann/expander'
-
-module Mustermann
-  # A mapper allows mapping one string to another based on pattern parsing and expanding.
-  #
-  # @example
-  #   require 'mustermann/mapper'
-  #   mapper = Mustermann::Mapper.new("/:foo" => "/:foo.html")
-  #   mapper['/example'] # => "/example.html"
-  class Mapper
-    # Creates a new mapper.
-    #
-    # @overload initialize(**options)
-    #   @param options [Hash] options The options hash
-    #   @yield block for generating mappings as a hash
-    #   @yieldreturn [Hash] see {#update}
-    #
-    #   @example
-    #     require 'mustermann/mapper'
-    #     Mustermann::Mapper.new(type: :rails) {{
-    #       "/:foo" => ["/:foo.html", "/:foo.:format"]
-    #     }}
-    #
-    # @overload initialize(**options)
-    #   @param  options [Hash] options The options hash
-    #   @yield block for generating mappings as a hash
-    #   @yieldparam mapper [Mustermann::Mapper] the mapper instance
-    #
-    #   @example
-    #     require 'mustermann/mapper'
-    #     Mustermann::Mapper.new(type: :rails) do |mapper|
-    #       mapper["/:foo"] = ["/:foo.html", "/:foo.:format"]
-    #     end
-    #
-    # @overload initialize(map = {}, **options)
-    #   @param map [Hash] see {#update}
-    #   @param [Hash] options The options hash
-    #
-    #   @example map before options
-    #     require 'mustermann/mapper'
-    #     Mustermann::Mapper.new({"/:foo" => "/:foo.html"}, type: :rails)
-    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
-
-    # Add multiple mappings.
-    #
-    # @param map [Hash{String, Pattern: String, Pattern, Arry<String, Pattern>, Expander}] the mapping
-    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
-
-    # @return [Hash{Patttern: Expander}] Hash version of the mapper.
-    def to_h
-      Hash[@map]
-    end
-
-    # Convert a string according to mappings. You can pass in additional params.
-    #
-    # @example mapping with and without additional parameters
-    #   mapper = Mustermann::Mapper.new("/:example" => "(/:prefix)?/:example.html")
-    #
-    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
-
-    # Add a single mapping.
-    #
-    # @param key [String, Pattern] format of the input string
-    # @param value [String, Pattern, Arry<String, Pattern>, Expander] format of the output string
-    def []=(key, value)
-      update key => value
-    end
-
-    alias_method :[], :convert
-  end
-end

data/lib/mustermann/pattern_cache.rb

@@ -1,50 +0,0 @@
-# frozen_string_literal: true
-require 'set'
-require 'thread'
-require 'mustermann'
-
-module Mustermann
-  # A simple, persistent cache for creating repositories.
-  #
-  # @example
-  #   require 'mustermann/pattern_cache'
-  #   cache = Mustermann::PatternCache.new
-  #
-  #   # use this instead of Mustermann.new
-  #   pattern = cache.create_pattern("/:name", type: :rails)
-  #
-  # @note
-  #   {Mustermann::Pattern.new} (which is used by {Mustermann.new}) will reuse instances that have
-  #   not yet been garbage collected. You only need an extra cache if you do not keep a reference to
-  #   the patterns around.
-  #
-  # @api private
-  class PatternCache
-    # @param [Hash] pattern_options default options used for {#create_pattern}
-    def initialize(**pattern_options)
-      @cached          = Set.new
-      @mutex           = Mutex.new
-      @pattern_options = pattern_options
-    end
-
-    # @param (see Mustermann.new)
-    # @return (see Mustermann.new)
-    # @raise (see Mustermann.new)
-    # @see Mustermann.new
-    def create_pattern(string, **pattern_options)
-      pattern = Mustermann.new(string, **pattern_options, **@pattern_options)
-      @mutex.synchronize { @cached.add(pattern) } unless @cached.include? pattern
-      pattern
-    end
-
-    # Removes all pattern instances from the cache.
-    def clear
-      @mutex.synchronize { @cached.clear }
-    end
-
-    # @return [Integer] number of currently cached patterns
-    def size
-      @mutex.synchronize { @cached.size }
-    end
-  end
-end

data/lib/mustermann/simple_match.rb

@@ -1,49 +0,0 @@
-# frozen_string_literal: true
-module Mustermann
-  # Fakes MatchData for patterns that do not support capturing.
-  # @see http://ruby-doc.org/core-2.0/MatchData.html MatchData
-  class SimpleMatch
-    # @api private
-    def initialize(string = "", names: [], captures: [])
-      @string   = string.dup
-      @names    = names
-      @captures = captures
-    end
-
-    # @return [String] the string that was matched against
-    def to_s
-      @string.dup
-    end
-
-    # @return [Array<String>] empty array for imitating MatchData interface
-    def names
-      @names.dup
-    end
-
-    # @return [Array<String>] empty array for imitating MatchData interface
-    def captures
-      @captures.dup
-    end
-
-    # @return [nil] imitates MatchData interface
-    def [](*args)
-      args.map! do |arg|
-        next arg unless arg.is_a? Symbol or arg.is_a? String
-        names.index(arg.to_s)
-      end
-      @captures[*args]
-    end
-
-    # @!visibility private
-    def +(other)
-      SimpleMatch.new(@string + other.to_s,
-          names:    @names    + other.names,
-          captures: @captures + other.captures)
-    end
-
-    # @return [String] string representation
-    def inspect
-      "#<%p %p>" % [self.class, @string]
-    end
-  end
-end

data/lib/mustermann/to_pattern.rb

@@ -1,51 +0,0 @@
-# frozen_string_literal: true
-require 'mustermann'
-
-module Mustermann
-  # Mixin for adding {#to_pattern} ducktyping to objects.
-  #
-  # @example
-  #   require 'mustermann/to_pattern'
-  #
-  #   class Foo
-  #     include Mustermann::ToPattern
-  #
-  #     def to_s
-  #       ":foo/:bar"
-  #     end
-  #   end
-  #
-  #   Foo.new.to_pattern # => #<Mustermann::Sinatra:":foo/:bar">
-  #
-  # By default included into String, Symbol, Regexp, Array and {Mustermann::Pattern}.
-  module ToPattern
-    PRIMITIVES = [String, Symbol, Array, Regexp, Mustermann::Pattern]
-    private_constant :PRIMITIVES
-
-    # Converts the object into a {Mustermann::Pattern}.
-    #
-    # @example converting a string
-    #   ":name.png".to_pattern # => #<Mustermann::Sinatra:":name.png">
-    #
-    # @example converting a string with options
-    #   "/*path".to_pattern(type: :rails) # => #<Mustermann::Rails:"/*path">
-    #
-    # @example converting a regexp
-    #   /.*/.to_pattern # => #<Mustermann::Regular:".*">
-    #
-    # @example converting a pattern
-    #   Mustermann.new("foo").to_pattern # => #<Mustermann::Sinatra:"foo">
-    #
-    # @param [Hash] options The options hash.
-    # @return [Mustermann::Pattern] pattern corresponding to object.
-    def to_pattern(**options)
-      input   = self if PRIMITIVES.any? { |p| self.is_a? p }
-      input ||= __getobj__ if respond_to?(:__getobj__)
-      Mustermann.new(input || to_s, **options)
-    end
-
-    PRIMITIVES.each do |klass|
-      append_features(klass)
-    end
-  end
-end