Class: Pantograph::PantFile
- Inherits:
-
Object
- Object
- Pantograph::PantFile
- Defined in:
- pantograph/lib/pantograph/pant_file.rb
Constant Summary collapse
Instance Attribute Summary collapse
-
#current_platform ⇒ Object
the platform in which we’re currently in when parsing the Pantfile This is used to identify the platform in which the lane is in.
-
#runner ⇒ Object
Stores all relevant information from the currently running process.
DSL collapse
-
#after_all(&block) ⇒ Object
Is executed after each test run.
-
#after_each(&block) ⇒ Object
Is executed before each lane.
-
#before_all(&block) ⇒ Object
Is executed before each test run.
-
#before_each(&block) ⇒ Object
Is executed before each lane.
-
#error(&block) ⇒ Object
Is executed if an error occurred during pantograph execution.
-
#lane(lane_name, &block) ⇒ Object
User defines a new lane.
-
#method_missing(method_sym, *arguments, &_block) ⇒ Object
Is used to look if the method is implemented as an action.
-
#override_lane(lane_name, &block) ⇒ Object
User defines a lane that can overwrite existing lanes.
-
#platform(platform_name) ⇒ Object
User defines a platform block.
-
#private_lane(lane_name, &block) ⇒ Object
User defines a new private lane, which can’t be called from the CLI.
Other things collapse
- .sh(*command, log: true, error_callback: nil, &b) ⇒ Object
- #actions_path(path) ⇒ Object
- #desc(string) ⇒ Object
- #desc_collection ⇒ Object
- #generated_pantfile_id(id) ⇒ Object
- #import(path = nil) ⇒ Object
- #import_from_git(url: nil, branch: 'master', path: 'pantograph/Pantfile', version: nil) ⇒ Object
-
#is_platform_block?(key) ⇒ Boolean
Is the given key a platform block or a lane?.
- #pantograph_require(gem_name) ⇒ Object
-
#sh(*args, &b) ⇒ Object
Execute shell command Accepts arguments with with and without the command named keyword so that sh behaves like other actions with named keywords github.com/urbanquakers/pantograph/issues/14930.
Versioning helpers collapse
Overwriting Ruby methods collapse
- #action_completed(action_name, status: nil) ⇒ Object
- #action_launched(action_name) ⇒ Object
- #puts(value) ⇒ Object
-
#say(value) ⇒ Object
Speak out loud.
- #test(params = {}) ⇒ Object
Instance Method Summary collapse
-
#initialize(path = nil) ⇒ Object
constructor
The runner which can be executed to trigger the given actions.
- #parse(data, path = nil) ⇒ Object
- #parsing_binding ⇒ Object
Constructor Details
#initialize(path = nil) ⇒ Object
Returns The runner which can be executed to trigger the given actions.
15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 |
# File 'pantograph/lib/pantograph/pant_file.rb', line 15 def initialize(path = nil) return unless (path || '').length > 0 UI.user_error!("Could not find Pantfile at path '#{path}'") unless File.exist?(path) @path = File.(path) content = File.read(path, encoding: "utf-8") # From https://github.com/orta/danger/blob/master/lib/danger/Dangerfile.rb if content.tr!('“”‘’‛', %(""''')) UI.error("Your #{File.basename(path)} has had smart quotes sanitised. " \ 'To avoid issues in the future, you should not use ' \ 'TextEdit for editing it. If you are not using TextEdit, ' \ 'you should turn off smart quotes in your editor of choice.') end content.scan(/^\s*require ["'](.*?)["']/).each do |current| gem_name = current.last next if gem_name.include?(".") # these are local gems begin require(gem_name) rescue LoadError UI.important("You have required a gem, if this is a third party gem, please use `pantograph_require '#{gem_name}'` to ensure the gem is installed locally.") end end parse(content, @path) end |
Dynamic Method Handling
This class handles dynamic methods through the method_missing method
#method_missing(method_sym, *arguments, &_block) ⇒ Object
Is used to look if the method is implemented as an action
158 159 160 |
# File 'pantograph/lib/pantograph/pant_file.rb', line 158 def method_missing(method_sym, *arguments, &_block) self.runner.trigger_action_by_name(method_sym, nil, false, *arguments) end |
Instance Attribute Details
#current_platform ⇒ Object
the platform in which we’re currently in when parsing the Pantfile This is used to identify the platform in which the lane is in
10 11 12 |
# File 'pantograph/lib/pantograph/pant_file.rb', line 10 def current_platform @current_platform end |
#runner ⇒ Object
Stores all relevant information from the currently running process
6 7 8 |
# File 'pantograph/lib/pantograph/pant_file.rb', line 6 def runner @runner end |
Class Method Details
.sh(*command, log: true, error_callback: nil, &b) ⇒ Object
215 216 217 218 219 220 |
# File 'pantograph/lib/pantograph/pant_file.rb', line 215 def self.sh(*command, log: true, error_callback: nil, &b) command_header = log ? Actions.shell_command_from_args(*command) : "shell command" Actions.execute_action(command_header) do Actions.sh_no_action(*command, log: log, error_callback: error_callback, &b) end end |
Instance Method Details
#action_completed(action_name, status: nil) ⇒ Object
376 377 378 379 380 381 |
# File 'pantograph/lib/pantograph/pant_file.rb', line 376 def action_completed(action_name, status: nil) completion_context = PantographCore::ActionCompletionContext.context_for_action_name(action_name, args: ARGV, status: status) PantographCore.session.action_completed(completion_context: completion_context) end |
#action_launched(action_name) ⇒ Object
369 370 371 372 373 374 |
# File 'pantograph/lib/pantograph/pant_file.rb', line 369 def action_launched(action_name) action_launch_context = PantographCore::ActionLaunchContext.context_for_action_name(action_name, pantograph_client_language: :ruby, args: ARGV) PantographCore.session.action_launched(launch_context: action_launch_context) end |
#actions_path(path) ⇒ Object
183 184 185 186 187 |
# File 'pantograph/lib/pantograph/pant_file.rb', line 183 def actions_path(path) UI.crash!("Path '#{path}' not found!") unless File.directory?(path) Actions.load_external_actions(path) end |
#after_all(&block) ⇒ Object
Is executed after each test run
143 144 145 |
# File 'pantograph/lib/pantograph/pant_file.rb', line 143 def after_all(&block) @runner.set_after_all(@current_platform, block) end |
#after_each(&block) ⇒ Object
Is executed before each lane
148 149 150 |
# File 'pantograph/lib/pantograph/pant_file.rb', line 148 def after_each(&block) @runner.set_after_each(@current_platform, block) end |
#before_all(&block) ⇒ Object
Is executed before each test run
133 134 135 |
# File 'pantograph/lib/pantograph/pant_file.rb', line 133 def before_all(&block) @runner.set_before_all(@current_platform, block) end |
#before_each(&block) ⇒ Object
Is executed before each lane
138 139 140 |
# File 'pantograph/lib/pantograph/pant_file.rb', line 138 def before_each(&block) @runner.set_before_each(@current_platform, block) end |
#desc(string) ⇒ Object
222 223 224 |
# File 'pantograph/lib/pantograph/pant_file.rb', line 222 def desc(string) desc_collection << string end |
#desc_collection ⇒ Object
226 227 228 |
# File 'pantograph/lib/pantograph/pant_file.rb', line 226 def desc_collection @desc_collection ||= [] end |
#error(&block) ⇒ Object
Is executed if an error occurred during pantograph execution
153 154 155 |
# File 'pantograph/lib/pantograph/pant_file.rb', line 153 def error(&block) @runner.set_error(@current_platform, block) end |
#fetch_remote_tags(folder: nil) ⇒ Object
325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 |
# File 'pantograph/lib/pantograph/pant_file.rb', line 325 def (folder: nil) UI.("Fetching remote git tags...") Helper.with_env_values('GIT_TERMINAL_PROMPT' => '0') do Actions.sh("cd #{folder.shellescape} && git fetch --all --tags -q") end # Fetch all possible tags = Actions.sh("cd #{folder.shellescape} && git tag -l") = .split("\n") # Sort tags based on their version number return .select { |tag| PantographCore::TagVersion.correct?(tag) } .sort_by { |tag| PantographCore::TagVersion.new(tag) } end |
#generated_pantfile_id(id) ⇒ Object
234 235 236 |
# File 'pantograph/lib/pantograph/pant_file.rb', line 234 def generated_pantfile_id(id) UI.important("The `generated_pantfile_id` action was deprecated, you can remove the line from your `Pantfile`") end |
#import(path = nil) ⇒ Object
238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 |
# File 'pantograph/lib/pantograph/pant_file.rb', line 238 def import(path = nil) if path.nil? UI.user_error!("Please pass a path to the `import` action") end path = path.dup.gsub("~", Dir.home) unless Pathname.new(path).absolute? # unless an absolute path path = File.join(File.('..', @path), path) end unless File.exist?(path) UI.user_error!("Could not find Pantfile at path '#{path}'") end # First check if there are local actions to import in the same directory as the Pantfile actions_path = File.join(File.("..", path), 'actions') Pantograph::Actions.load_external_actions(actions_path) if File.directory?(actions_path) action_launched('import') return_value = parse(File.read(path), path) action_completed('import', status: PantographCore::ActionCompletionStatus::SUCCESS) return return_value end |
#import_from_git(url: nil, branch: 'master', path: 'pantograph/Pantfile', version: nil) ⇒ Object
269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 |
# File 'pantograph/lib/pantograph/pant_file.rb', line 269 def import_from_git(url: nil, branch: 'master', path: 'pantograph/Pantfile', version: nil) if url.to_s.length == 0 UI.user_error!("Please pass the git url to the `import_from_git` action") end Actions.execute_action('import_from_git') do require 'tmpdir' action_launched('import_from_git') # Checkout the repo repo_name = url.split('/').last checkout_param = branch Dir.mktmpdir('pant_clone') do |tmp_path| clone_folder = File.join(tmp_path, repo_name) UI.('Cloning remote git repo...') Helper.with_env_values('GIT_TERMINAL_PROMPT' => '0') do Actions.sh("git clone #{url.shellescape} #{clone_folder.shellescape} --depth 1 -n --branch #{branch}") end unless version.nil? req = Gem::Requirement.new(version) = (folder: clone_folder) checkout_param = .select { |t| req =~ PantographCore::TagVersion.new(t) }.last UI.user_error!("No tag found matching #{version.inspect}") if checkout_param.nil? end Actions.sh("cd #{clone_folder.shellescape} && git checkout #{checkout_param.shellescape} #{path.shellescape}") # We also want to check out all the local actions of this pantograph setup containing = path.split(File::SEPARATOR)[0..-2] containing = "." if containing.count == 0 actions_folder = File.join(containing, "actions") begin Actions.sh("cd #{clone_folder.shellescape} && git checkout #{checkout_param.shellescape} #{actions_folder.shellescape}") rescue # We don't care about a failure here, as local actions are optional end import(File.join(clone_folder, path)) action_completed( 'import_from_git', status: PantographCore::ActionCompletionStatus::SUCCESS ) end end end |
#is_platform_block?(key) ⇒ Boolean
Is the given key a platform block or a lane?
167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 |
# File 'pantograph/lib/pantograph/pant_file.rb', line 167 def is_platform_block?(key) UI.crash!('No key given') unless key return false if self.runner.lanes.fetch(nil, {}).fetch(key.to_sym, nil) return true if self.runner.lanes[key.to_sym].kind_of?(Hash) if key.to_sym == :update # The user ran `pantograph update`, instead of `pantograph update_pantograph` # We're gonna be nice and understand what the user is trying to do require 'pantograph/one_off' Pantograph::OneOff.run(action: "update_pantograph", parameters: {}) else UI.user_error!("Could not find '#{key}'. Available lanes: #{self.runner.available_lanes.join(', ')}") end end |
#lane(lane_name, &block) ⇒ Object
User defines a new lane
83 84 85 86 87 88 89 90 91 92 93 |
# File 'pantograph/lib/pantograph/pant_file.rb', line 83 def lane(lane_name, &block) UI.user_error!("You have to pass a block using 'do' for lane '#{lane_name}'. Make sure you read the docs on GitHub.") unless block self.runner.add_lane(Lane.new(platform: self.current_platform, block: block, description: desc_collection, name: lane_name, is_private: false)) @desc_collection = nil # reset the collected description again for the next lane end |
#override_lane(lane_name, &block) ⇒ Object
User defines a lane that can overwrite existing lanes. Useful when importing a Pantfile
109 110 111 112 113 114 115 116 117 118 119 |
# File 'pantograph/lib/pantograph/pant_file.rb', line 109 def override_lane(lane_name, &block) UI.user_error!("You have to pass a block using 'do' for lane '#{lane_name}'. Make sure you read the docs on GitHub.") unless block self.runner.add_lane(Lane.new(platform: self.current_platform, block: block, description: desc_collection, name: lane_name, is_private: false), true) @desc_collection = nil # reset the collected description again for the next lane end |
#pantograph_require(gem_name) ⇒ Object
230 231 232 |
# File 'pantograph/lib/pantograph/pant_file.rb', line 230 def pantograph_require(gem_name) PantographRequire.install_gem_if_needed(gem_name: gem_name, require_gem: true) end |
#parse(data, path = nil) ⇒ Object
47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 |
# File 'pantograph/lib/pantograph/pant_file.rb', line 47 def parse(data, path = nil) @runner ||= Runner.new Dir.chdir(PantographCore::PantographFolder.path || Dir.pwd) do # context: pantograph subfolder # create nice path that we want to print in case of some problem relative_path = path.nil? ? '(eval)' : Pathname.new(path).relative_path_from(Pathname.new(Dir.pwd)).to_s begin # We have to use #get_binding method, because some test files defines method called `path` (for example SwitcherPantfile) # and local variable has higher priority, so it causes to remove content of original Pantfile for example. With #get_binding # is this always clear and safe to declare any local variables we want, because the eval function uses the instance scope # instead of local. # rubocop:disable Security/Eval eval(data, parsing_binding, relative_path) # using eval is ok for this case # rubocop:enable Security/Eval rescue SyntaxError => ex match = ex.to_s.match(/#{Regexp.escape(relative_path)}:(\d+)/) if match line = match[1] UI.content_error(data, line) UI.user_error!("Syntax error in your Pantfile on line #{line}: #{ex}") else UI.user_error!("Syntax error in your Pantfile: #{ex}") end end end self end |
#parsing_binding ⇒ Object
43 44 45 |
# File 'pantograph/lib/pantograph/pant_file.rb', line 43 def parsing_binding binding end |
#platform(platform_name) ⇒ Object
User defines a platform block
122 123 124 125 126 127 128 129 130 |
# File 'pantograph/lib/pantograph/pant_file.rb', line 122 def platform(platform_name) SupportedPlatforms.verify!(platform_name) self.current_platform = platform_name yield self.current_platform = nil end |
#private_lane(lane_name, &block) ⇒ Object
User defines a new private lane, which can’t be called from the CLI
96 97 98 99 100 101 102 103 104 105 106 |
# File 'pantograph/lib/pantograph/pant_file.rb', line 96 def private_lane(lane_name, &block) UI.user_error!("You have to pass a block using 'do' for lane '#{lane_name}'. Make sure you read the docs on GitHub.") unless block self.runner.add_lane(Lane.new(platform: self.current_platform, block: block, description: desc_collection, name: lane_name, is_private: true)) @desc_collection = nil # reset the collected description again for the next lane end |
#puts(value) ⇒ Object
354 355 356 357 358 359 360 361 362 |
# File 'pantograph/lib/pantograph/pant_file.rb', line 354 def puts(value) # Overwrite this, since there is already a 'puts' method defined in the Ruby standard library value ||= yield if block_given? action_launched('puts') return_value = Pantograph::Actions::PutsAction.run([value]) action_completed('puts', status: PantographCore::ActionCompletionStatus::SUCCESS) return return_value end |
#say(value) ⇒ Object
Speak out loud
346 347 348 349 350 351 352 |
# File 'pantograph/lib/pantograph/pant_file.rb', line 346 def say(value) # Overwrite this, since there is already a 'say' method defined in the Ruby standard library value ||= yield value = { text: value } if value.kind_of?(String) || value.kind_of?(Array) self.runner.trigger_action_by_name(:say, nil, false, value) end |
#sh(*args, &b) ⇒ Object
Execute shell command Accepts arguments with with and without the command named keyword so that sh behaves like other actions with named keywords github.com/urbanquakers/pantograph/issues/14930
Example:
sh("ls")
sh("ls", log: false)
sh(command: "ls")
sh(command: "ls", log: false)
199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 |
# File 'pantograph/lib/pantograph/pant_file.rb', line 199 def sh(*args, &b) # First accepts hash (or named keywords) like other actions # Otherwise uses sh method that doesn't have an interface like an action if args.count == 1 && args.first.kind_of?(Hash) hash = args.first command = hash.delete(:command) raise ArgumentError, "sh requires :command keyword in argument" if command.nil? new_args = [*command, hash] PantFile.sh(*new_args, &b) else PantFile.sh(*args, &b) end end |
#test(params = {}) ⇒ Object
364 365 366 367 |
# File 'pantograph/lib/pantograph/pant_file.rb', line 364 def test(params = {}) # Overwrite this, since there is already a 'test' method defined in the Ruby standard library self.runner.try_switch_to_lane(:test, [params]) end |