Module: Kettle::Dev::TemplateHelpers

Defined in:
sig/kettle/dev.rbs

Overview

Helpers shared by kettle:dev Rake tasks for templating and file ops.

Class Method Summary collapse

Class Method Details

.apply_common_replacements ⇒ Object

Apply common token replacements used when templating text files



533
 
# File 'sig/kettle/dev.rbs', line 533

def self.apply_common_replacements: (

.ask ⇒ Boolean

Simple yes/no prompt.

Parameters:

  • prompt (String)
  • default (Boolean)

Returns:

  • (Boolean) 


503
 
# File 'sig/kettle/dev.rbs', line 503

def self.ask: (String prompt, bool default) -> bool

.copy_dir_with_prompt ⇒ void

This method returns an undefined value.

Copy a directory tree, prompting before creating or overwriting.

Parameters:

  • src_dir (String)
  • dest_dir (String) 


530
 
# File 'sig/kettle/dev.rbs', line 530

def self.copy_dir_with_prompt: (String src_dir, String dest_dir) -> void

.copy_file_with_prompt ⇒ Object

Copy a single file with interactive prompts for create/replace.



522
 
# File 'sig/kettle/dev.rbs', line 522

def self.copy_file_with_prompt: (

.ensure_clean_git! ⇒ void

This method returns an undefined value.

Ensure git working tree is clean before making changes in a task. If not a git repo, this is a no-op.

Parameters:

  • root: (String)
  • task_label: (String) 


519
 
# File 'sig/kettle/dev.rbs', line 519

def self.ensure_clean_git!: (root: String, task_label: String) -> void

.gem_checkout_root ⇒ String

Root of this gem's checkout (repository root when working from source)

Returns:

  • (String) 


500
 
# File 'sig/kettle/dev.rbs', line 500

def self.gem_checkout_root: () -> String

.gemspec_metadata ⇒ {

Parse gemspec metadata and derive useful strings When no gemspec is present, gemspec_path may be nil; gh_org/gh_repo may be nil when not derivable.

Parameters:

  • root (String)

Returns:

  • ({) 


546
 
# File 'sig/kettle/dev.rbs', line 546

def self.gemspec_metadata: (?String root) -> {

.modified_by_template? ⇒ Boolean

Returns true if the given path was created or replaced by the template task in this run

Parameters:

  • dest_path (String)

Returns:

  • (Boolean) 


515
 
# File 'sig/kettle/dev.rbs', line 515

def self.modified_by_template?: (String dest_path) -> bool

.project_root ⇒ String

Root of the host project where Rake was invoked

Returns:

  • (String) 


497
 
# File 'sig/kettle/dev.rbs', line 497

def self.project_root: () -> String

.record_template_result ⇒ void

This method returns an undefined value.

Record a template action for a destination path

Parameters:

  • dest_path (String)
  • action (template_action) 


509
 
# File 'sig/kettle/dev.rbs', line 509

def self.record_template_result: (String dest_path, template_action action) -> void

.template_results ⇒ Hash[String, { action: template_action, timestamp: ::Time }]

Access all template results (read-only clone)

Returns:

  • (Hash[String, { action: template_action, timestamp: ::Time }]) 


512
 
# File 'sig/kettle/dev.rbs', line 512

def self.template_results: () -> Hash[String, { action: template_action, timestamp: ::Time }]

.write_file ⇒ void

This method returns an undefined value.

Write file content creating directories as needed

Parameters:

  • dest_path (String)
  • content (String) 


506
 
# File 'sig/kettle/dev.rbs', line 506

def self.write_file: (String dest_path, String content) -> void