Class: Synvert::Core::Rewriter

Inherits:
Object
  • Object
show all
Defined in:
lib/synvert/core/rewriter.rb

Overview

Rewriter is the top level namespace in a snippet.

One Rewriter can contain one or many [Synvert::Core::Rewriter::Instance], which define the behavior what files and what codes to detect and rewrite to what code.

Synvert::Rewriter.new 'factory_girl_short_syntax', 'use FactoryGirl short syntax' do
  if_gem 'factory_girl', '>= 2.0.0'

  within_files 'spec/**/*.rb' do
    with_node type: 'send', receiver: 'FactoryGirl', message: 'create' do
      replace_with "create({{arguments}})"
    end
  end
end

Defined Under Namespace

Modules: Helper Classes: Action, AddAction, AnyValue, AppendAction, Condition, DeleteAction, GemSpec, GotoScope, IfExistCondition, IfOnlyExistCondition, InsertAction, InsertAfterAction, Instance, PrependAction, RemoveAction, ReplaceAction, ReplaceErbStmtWithExprAction, ReplaceWithAction, RubyVersion, Scope, UnlessExistCondition, Warning, WithinScope

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(group, name, &block) ⇒ Synvert::Core::Rewriter

Initialize a rewriter. When a rewriter is initialized, it is also registered.



168
169
170
171
172
173
174
175
176
177
 
# File 'lib/synvert/core/rewriter.rb', line 168

def initialize(group, name, &block)
  @group = group
  @name = name
  @block = block
  @helpers = []
  @sub_snippets = []
  @warnings = []
  @affected_files = Set.new
  self.class.register(@group, @name, self)
end

Instance Attribute Details

#affected_files ⇒ Set (readonly) 



159
 
# File 'lib/synvert/core/rewriter.rb', line 159

attr_reader :group, :name, :sub_snippets, :helpers, :warnings, :affected_files, :ruby_version, :gem_spec

#gem_spec ⇒ Object (readonly)

Returns the value of attribute gem_spec.



159
 
# File 'lib/synvert/core/rewriter.rb', line 159

attr_reader :group, :name, :sub_snippets, :helpers, :warnings, :affected_files, :ruby_version, :gem_spec

#group ⇒ String (readonly) 



159
160
161
 
# File 'lib/synvert/core/rewriter.rb', line 159

def group
  @group
end

#helper ⇒ Array (readonly) 



159
 
# File 'lib/synvert/core/rewriter.rb', line 159

attr_reader :group, :name, :sub_snippets, :helpers, :warnings, :affected_files, :ruby_version, :gem_spec

#helpers ⇒ Object (readonly)

Returns the value of attribute helpers.



159
160
161
 
# File 'lib/synvert/core/rewriter.rb', line 159

def helpers
  @helpers
end

#name ⇒ String (readonly) 



159
 
# File 'lib/synvert/core/rewriter.rb', line 159

attr_reader :group, :name, :sub_snippets, :helpers, :warnings, :affected_files, :ruby_version, :gem_spec

#ruby_version ⇒ Rewriter::RubyVersion (readonly) 



159
 
# File 'lib/synvert/core/rewriter.rb', line 159

attr_reader :group, :name, :sub_snippets, :helpers, :warnings, :affected_files, :ruby_version, :gem_spec

#sub_snippets ⇒ Array<Synvert::Core::Rewriter> (readonly) 



159
 
# File 'lib/synvert/core/rewriter.rb', line 159

attr_reader :group, :name, :sub_snippets, :helpers, :warnings, :affected_files, :ruby_version, :gem_spec

#warnings ⇒ Array<Synvert::Core::Rewriter::Warning> (readonly) 



159
 
# File 'lib/synvert/core/rewriter.rb', line 159

attr_reader :group, :name, :sub_snippets, :helpers, :warnings, :affected_files, :ruby_version, :gem_spec

Class Method Details

.availables ⇒ Hash<String, Hash<String, Rewriter>>

Get all available rewriters



127
128
129
 
# File 'lib/synvert/core/rewriter.rb', line 127

def availables
  rewriters
end

.call(group, name, sandbox = false) ⇒ Synvert::Core::Rewriter

Get a registered rewriter by group and name, then process that rewriter.

Raises:



93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
 
# File 'lib/synvert/core/rewriter.rb', line 93

def call(group, name, sandbox = false)
  group = group.to_s
  name = name.to_s
  if exist? group, name
    rewriter = rewriters[group][name]
    if sandbox
      rewriter.process_with_sandbox
    else
      rewriter.process
    end
    rewriter
  else
    raise RewriterNotFound, "Rewriter #{group}/#{name} not found"
  end
end

.clear ⇒ Object

Clear all registered rewriters.



132
133
134
 
# File 'lib/synvert/core/rewriter.rb', line 132

def clear
  rewriters.clear
end

.execute(&block) ⇒ Object

Execute the temporary rewriter without group and name.



54
55
56
 
# File 'lib/synvert/core/rewriter.rb', line 54

def execute(&block)
  Rewriter.new('', '', &block).process
end

.exist?(group, name) ⇒ Boolean

Check if one rewriter exist.



114
115
116
117
118
119
120
121
122
 
# File 'lib/synvert/core/rewriter.rb', line 114

def exist?(group, name)
  group = group.to_s
  name = name.to_s
  if rewriters[group] && rewriters[group][name]
    true
  else
    false
  end
end

.fetch(group, name) ⇒ Synvert::Core::Rewriter

Fetch a rewriter by group and name.

Raises:



76
77
78
79
80
81
82
83
84
 
# File 'lib/synvert/core/rewriter.rb', line 76

def fetch(group, name)
  group = group.to_s
  name = name.to_s
  if exist? group, name
    rewriters[group][name]
  else
    raise RewriterNotFound, "Rewriter #{group} #{name} not found"
  end
end

.register(group, name, rewriter) ⇒ Object

Register a rewriter with its group and name.



63
64
65
66
67
68
 
# File 'lib/synvert/core/rewriter.rb', line 63

def register(group, name, rewriter)
  group = group.to_s
  name = name.to_s
  rewriters[group] ||= {}
  rewriters[group][name] = rewriter
end

Instance Method Details

#add_affected_file(file_path) ⇒ Object

Add an affected file.



206
207
208
 
# File 'lib/synvert/core/rewriter.rb', line 206

def add_affected_file(file_path)
  @affected_files.add(file_path)
end

#add_file(filename, content) ⇒ Object

Parses add_file dsl, it adds a new file.



263
264
265
266
267
268
269
270
271
272
273
274
275
276
 
# File 'lib/synvert/core/rewriter.rb', line 263

def add_file(filename, content)
  return if @sandbox

  filepath = File.join(Configuration.path, filename)
  if File.exist?(filepath)
    puts "File #{filepath} already exists."
    return
  end

  FileUtils.mkdir_p File.dirname(filepath)
  File.open filepath, 'w' do |file|
    file.write content
  end
end

#add_snippet(group, name) ⇒ Object

Parse add_snippet dsl, it calls anther rewriter.



292
293
294
 
# File 'lib/synvert/core/rewriter.rb', line 292

def add_snippet(group, name)
  @sub_snippets << self.class.call(group.to_s, name.to_s, @sandbox)
end

#add_warning(warning) ⇒ Object

Add a warning.



199
200
201
 
# File 'lib/synvert/core/rewriter.rb', line 199

def add_warning(warning)
  @warnings << warning
end

#description(description = nil) ⇒ Object

Parse description dsl, it sets description of the rewrite. Or get description.



219
220
221
222
223
224
225
 
# File 'lib/synvert/core/rewriter.rb', line 219

def description(description = nil)
  if description
    @description = description
  else
    @description
  end
end

#helper_method(name, &block) ⇒ Object

Parse helper_method dsl, it defines helper method for [Synvert::Core::Rewriter::Instance].



300
301
302
 
# File 'lib/synvert/core/rewriter.rb', line 300

def helper_method(name, &block)
  @helpers << { name: name, block: block }
end

#if_gem(name, version) ⇒ Object

Parse if_gem dsl, it compares version of the specified gem.



238
239
240
 
# File 'lib/synvert/core/rewriter.rb', line 238

def if_gem(name, version)
  @gem_spec = Rewriter::GemSpec.new(name, version)
end

#if_ruby(version) ⇒ Object

Parse if_ruby dal, it checks if ruby version if greater than or equal to the specified ruby version.



230
231
232
 
# File 'lib/synvert/core/rewriter.rb', line 230

def if_ruby(version)
  @ruby_version = Rewriter::RubyVersion.new(version)
end

#process ⇒ Object

Process the rewriter. It will call the block.



181
182
183
 
# File 'lib/synvert/core/rewriter.rb', line 181

def process
  instance_eval(&@block)
end

#process_with_sandbox ⇒ Object

Process rewriter with sandbox mode. It will call the block but doesn’t change any file.



187
188
189
190
191
192
193
194
 
# File 'lib/synvert/core/rewriter.rb', line 187

def process_with_sandbox
  @sandbox = true
  begin
    process
  ensure
    @sandbox = false
  end
end

#remove_file(filename) ⇒ Object

Parses remove_file dsl, it removes a file.



281
282
283
284
285
286
 
# File 'lib/synvert/core/rewriter.rb', line 281

def remove_file(filename)
  return if @sandbox

  file_path = File.join(Configuration.path, filename)
  File.delete(file_path) if File.exist?(file_path)
end

#todo(todo = nil) ⇒ String

Parse todo dsl, it sets todo of the rewriter. Or get todo.



309
310
311
312
313
314
315
 
# File 'lib/synvert/core/rewriter.rb', line 309

def todo(todo = nil)
  if todo
    @todo = todo
  else
    @todo
  end
end

#within_files(file_pattern, options = {}, &block) ⇒ Object Also known as: within_file

Parse within_files dsl, it finds specified files. It creates a [Synvert::Core::Rewriter::Instance] to rewrite code.



248
249
250
251
252
253
254
 
# File 'lib/synvert/core/rewriter.rb', line 248

def within_files(file_pattern, options = {}, &block)
  return if @sandbox

  if (!@ruby_version || @ruby_version.match?) && (!@gem_spec || @gem_spec.match?)
    Rewriter::Instance.new(self, file_pattern, options, &block).process
  end
end