Class: GrapePathHelpers::DecoratedRoute

Inherits:
Object
  • Object
show all
Defined in:
lib/grape-path-helpers/decorated_route.rb

Overview

wrapper around Grape::Route that adds a helper method

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(route) ⇒ DecoratedRoute

Returns a new instance of DecoratedRoute.



11
12
13
14
15
16
17
18
 
# File 'lib/grape-path-helpers/decorated_route.rb', line 11

def initialize(route)
  @route = route
  @route_options = route.options
  @helper_names = []
  @helper_arguments = required_helper_segments
  @extension = default_extension
  define_path_helpers
end

Instance Attribute Details

#extension ⇒ Object (readonly)

Returns the value of attribute extension.



4
5
6
 
# File 'lib/grape-path-helpers/decorated_route.rb', line 4

def extension
  @extension
end

#helper_arguments ⇒ Object (readonly)

Returns the value of attribute helper_arguments.



4
5
6
 
# File 'lib/grape-path-helpers/decorated_route.rb', line 4

def helper_arguments
  @helper_arguments
end

#helper_names ⇒ Object (readonly)

Returns the value of attribute helper_names.



4
5
6
 
# File 'lib/grape-path-helpers/decorated_route.rb', line 4

def helper_names
  @helper_names
end

#route ⇒ Object (readonly)

Returns the value of attribute route.



4
5
6
 
# File 'lib/grape-path-helpers/decorated_route.rb', line 4

def route
  @route
end

#route_options ⇒ Object (readonly)

Returns the value of attribute route_options.



4
5
6
 
# File 'lib/grape-path-helpers/decorated_route.rb', line 4

def route_options
  @route_options
end

Class Method Details

.sanitize_method_name(string) ⇒ Object 



7
8
9
 
# File 'lib/grape-path-helpers/decorated_route.rb', line 7

def self.sanitize_method_name(string)
  string.gsub(/\W|^[0-9]/, '_')
end

Instance Method Details

#default_extension ⇒ Object 



20
21
22
23
24
25
26
27
28
29
30
 
# File 'lib/grape-path-helpers/decorated_route.rb', line 20

def default_extension
  pattern = /\((\.\:?\w+)\)$/
  match = route_path.match(pattern)
  return '' unless match
  ext = match.captures.first
  if ext == '.:format'
    ''
  else
    ext
  end
end

#define_path_helper(method_name, route_attributes) ⇒ Object 



41
42
43
44
45
46
47
48
49
50
51
52
53
54
 
# File 'lib/grape-path-helpers/decorated_route.rb', line 41

def define_path_helper(method_name, route_attributes)
  method_body = "    def \#{method_name}(attributes = {})\n      attrs = \#{route_attributes}.merge(attributes)\n\n      query_params = attrs.delete(:params)\n      content_type = attrs.delete(:format)\n      path = '/' + path_segments_with_values(attrs).join('/')\n\n      path + content_type + query_string(query_params)\n    end\n  RUBY\n  instance_eval method_body\nend\n"

#define_path_helpers ⇒ Object 



32
33
34
35
36
37
38
39
 
# File 'lib/grape-path-helpers/decorated_route.rb', line 32

def define_path_helpers
  route_versions.each do |version|
    route_attributes = { version: version, format: extension }
    method_name = path_helper_name(route_attributes)
    @helper_names << method_name
    define_path_helper(method_name, route_attributes)
  end
end

#dynamic_path_segments ⇒ Object 



112
113
114
115
116
117
 
# File 'lib/grape-path-helpers/decorated_route.rb', line 112

def dynamic_path_segments
  segments = path_segments.select do |segment|
    dynamic_segment?(segment)
  end
  segments.map { |s| s.slice(1..-1) }
end

#dynamic_segment?(segment) ⇒ Boolean

Returns:

  • (Boolean) 


119
120
121
 
# File 'lib/grape-path-helpers/decorated_route.rb', line 119

def dynamic_segment?(segment)
  segment.start_with?(':')
end

#path_helper_name(opts = {}) ⇒ Object 



75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
 
# File 'lib/grape-path-helpers/decorated_route.rb', line 75

def path_helper_name(opts = {})
  if route_options[:as]
    name = route_options[:as].to_s
  else
    segments = path_segments_with_values(opts)

    name = if segments.empty?
             'root'
           else
             segments.join('_')
           end
  end

  sanitized_name = self.class.sanitize_method_name(name)
  sanitized_name + '_path'
end

#path_segments ⇒ Object 



107
108
109
110
 
# File 'lib/grape-path-helpers/decorated_route.rb', line 107

def path_segments
  pattern = %r{\(/?\.:?\w+\)|/|\??\*}
  route_path.split(pattern).reject(&:blank?)
end

#path_segments_with_values(opts) ⇒ Object 



102
103
104
105
 
# File 'lib/grape-path-helpers/decorated_route.rb', line 102

def path_segments_with_values(opts)
  segments = path_segments.map { |s| segment_to_value(s, opts) }
  segments.reject(&:blank?)
end

#query_string(params) ⇒ Object 



56
57
58
59
60
61
62
 
# File 'lib/grape-path-helpers/decorated_route.rb', line 56

def query_string(params)
  if params.nil?
    ''
  else
    '?' + params.to_param
  end
end

#required_helper_segments ⇒ Object 



123
124
125
126
127
128
 
# File 'lib/grape-path-helpers/decorated_route.rb', line 123

def required_helper_segments
  segments_in_options = dynamic_path_segments.select do |segment|
    route.options[segment.to_sym]
  end
  dynamic_path_segments - segments_in_options
end

#route_method ⇒ Object 



156
157
158
 
# File 'lib/grape-path-helpers/decorated_route.rb', line 156

def route_method
  route.request_method
end

#route_namespace ⇒ Object 



152
153
154
 
# File 'lib/grape-path-helpers/decorated_route.rb', line 152

def route_namespace
  route.namespace
end

#route_path ⇒ Object 



144
145
146
 
# File 'lib/grape-path-helpers/decorated_route.rb', line 144

def route_path
  route.path
end

#route_version ⇒ Object 



148
149
150
 
# File 'lib/grape-path-helpers/decorated_route.rb', line 148

def route_version
  route.version
end

#route_versions ⇒ Object 



64
65
66
67
68
69
70
71
72
73
 
# File 'lib/grape-path-helpers/decorated_route.rb', line 64

def route_versions
  if route_version.is_a?(Array)
    route_version
  elsif route_version
    version_pattern = /[^\[",\]\s]+/
    route_version.scan(version_pattern)
  else
    [nil]
  end
end

#segment_to_value(segment, opts = {}) ⇒ Object 



92
93
94
95
96
97
98
99
100
 
# File 'lib/grape-path-helpers/decorated_route.rb', line 92

def segment_to_value(segment, opts = {})
  if dynamic_segment?(segment)
    options = route.options.merge(stringify_keys(opts))
    key = segment.slice(1..-1).to_sym
    options[key]
  else
    segment
  end
end

#special_keys ⇒ Object 



130
131
132
 
# File 'lib/grape-path-helpers/decorated_route.rb', line 130

def special_keys
  %w[format params]
end

#uses_segments_in_path_helper?(segments) ⇒ Boolean

Returns:

  • (Boolean) 


134
135
136
137
138
139
140
141
142
 
# File 'lib/grape-path-helpers/decorated_route.rb', line 134

def uses_segments_in_path_helper?(segments)
  segments = segments.reject { |x| special_keys.include?(x) }

  if required_helper_segments.empty? && segments.any?
    false
  else
    required_helper_segments.all? { |x| segments.include?(x) }
  end
end