Class: Squared::Workspace::Application

Inherits:
Object
  • Object
show all
Includes:
Enumerable, Rake::DSL, Common::Format, Git, Repo, Utils
Defined in:
lib/squared/workspace/application.rb

Constant Summary

Constants included from Common

Common::ARG, Common::PATH

Class Attribute Summary collapse

Instance Attribute Summary collapse

Attributes included from Git

#revfile

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Repo

#repo, #repo?

Methods included from Git

#git, #git_clone?, #git_repo, #rev_clear, #rev_entry, #rev_timesince, #rev_timeutc, #rev_write, #revbuild

Methods included from Common::Format

emphasize, #enable_aixterm, #enable_drawing, message

Constructor Details

#initialize(home = (ARG[:HOME] && ENV[ARG[:HOME]]) || Dir.pwd, main: nil, prefix: nil, verbose: , common: , pipe: , exception: ) ⇒ Application

Returns a new instance of Application.



96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
 
# File 'lib/squared/workspace/application.rb', line 96

def initialize(home = (ARG[:HOME] && ENV[ARG[:HOME]]) || Dir.pwd, *, main: nil, prefix: nil,
               verbose: ARG[:VERBOSE], common: ARG[:COMMON], pipe: ARG[:PIPE], exception: ARG[:FAIL], **)
  home = Pathname.new(home)
  basename = home.basename.to_s
  if main
    @main = main.to_s.freeze
    home += @main unless @main == basename || (windows? && @main.casecmp?(basename))
  else
    @main = basename.freeze
  end
  @prefix = prefix
  @project = {}
  @base = Set.new
  @kind = Support.hashlist
  @config = {}
  @extensions = Set.new
  @finalize = Set.new(%i[__chain__ __join__])
  @envname = env_key(@main).freeze
  @closed = false
  @stage = Support.hashlist
  self.home = home
  self.exception = env_bool exception
  self.pipe = $DEBUG ? 2 : env_pipe(pipe, (ARG[:OUT] && env(ARG[:OUT])) || 1, root: home)
  self.verbose = if $VERBOSE.nil?
                   false
                 elsif verbose.nil?
                   @pipe != 0
                 else
                   env_bool(verbose, verbose.is_a?(String) ? @pipe != 0 : verbose, index: true)
                 end
  self.warning = @verbose != false
  @theme = common ? __get__(:theme)[:workspace] : {}
  @chain = Support.hashlist
  @script = Struct::SessionData.new
  @join = Struct::SessionData.new
  @events = Struct::SessionData.new
  @pass = Struct::SessionData.new
  @banner = Struct::SessionData.new
  @timeout = Struct::SessionData.new
  @global = Hash.new do |data, key|
    data[key] = { group: {}, ref: {}, exclude: [], extras: {}, module: nil, script: nil }
  end
  initialize_session
end

Class Attribute Details

.attr_banner ⇒ Object (readonly)

Returns the value of attribute attr_banner.



83
84
85
 
# File 'lib/squared/workspace/application.rb', line 83

def attr_banner
  @attr_banner
end

.impl_series ⇒ Object

Returns the value of attribute impl_series.



84
85
86
 
# File 'lib/squared/workspace/application.rb', line 84

def impl_series
  @impl_series
end

.kind_project ⇒ Object (readonly)

Returns the value of attribute kind_project.



83
84
85
 
# File 'lib/squared/workspace/application.rb', line 83

def kind_project
  @kind_project
end

.load_project ⇒ Object (readonly)

Returns the value of attribute load_project.



83
84
85
 
# File 'lib/squared/workspace/application.rb', line 83

def load_project
  @load_project
end

.session ⇒ Object (readonly)

Returns the value of attribute session.



83
84
85
 
# File 'lib/squared/workspace/application.rb', line 83

def session
  @session
end

Instance Attribute Details

#closed ⇒ Object

Returns the value of attribute closed.



93
94
95
 
# File 'lib/squared/workspace/application.rb', line 93

def closed
  @closed
end

#exception ⇒ Object

Returns the value of attribute exception.



94
95
96
 
# File 'lib/squared/workspace/application.rb', line 94

def exception
  @exception
end

#home ⇒ Object

Returns the value of attribute home.



93
94
95
 
# File 'lib/squared/workspace/application.rb', line 93

def home
  @home
end

#main ⇒ Object (readonly)

Returns the value of attribute main.



93
94
95
 
# File 'lib/squared/workspace/application.rb', line 93

def main
  @main
end

#pipe ⇒ Object

Returns the value of attribute pipe.



94
95
96
 
# File 'lib/squared/workspace/application.rb', line 94

def pipe
  @pipe
end

#prefix ⇒ Object (readonly)

Returns the value of attribute prefix.



93
94
95
 
# File 'lib/squared/workspace/application.rb', line 93

def prefix
  @prefix
end

#root ⇒ Object (readonly)

Returns the value of attribute root.



93
94
95
 
# File 'lib/squared/workspace/application.rb', line 93

def root
  @root
end

#series ⇒ Object (readonly)

Returns the value of attribute series.



93
94
95
 
# File 'lib/squared/workspace/application.rb', line 93

def series
  @series
end

#theme ⇒ Object (readonly)

Returns the value of attribute theme.



93
94
95
 
# File 'lib/squared/workspace/application.rb', line 93

def theme
  @theme
end

#verbose ⇒ Object

Returns the value of attribute verbose.



94
95
96
 
# File 'lib/squared/workspace/application.rb', line 94

def verbose
  @verbose
end

#warning ⇒ Object

Returns the value of attribute warning.



94
95
96
 
# File 'lib/squared/workspace/application.rb', line 94

def warning
  @warning
end

Class Method Details

.baseref ⇒ Object 



75
76
77
 
# File 'lib/squared/workspace/application.rb', line 75

def baseref
  impl_project.ref
end

.extends(obj) ⇒ Object 



67
68
69
 
# File 'lib/squared/workspace/application.rb', line 67

def extends(obj)
  @kind_extend.any? { |impl| obj < impl }
end

.find(ref: nil, path: nil) ⇒ Object 



32
33
34
35
36
37
38
39
 
# File 'lib/squared/workspace/application.rb', line 32

def find(ref: nil, path: nil)
  if ref && (ret = kind_project.find { |proj| proj.ref == ref })
    ret
  elsif path
    (kind_project - @kind_extend).find { |proj| proj.config?(path) } ||
    @kind_extend.find { |proj| proj.config?(path) }
  end
end

.impl_project ⇒ Object 



71
72
73
 
# File 'lib/squared/workspace/application.rb', line 71

def impl_project
  @kind_extend.first
end

.implement(*objs, base: nil) ⇒ Object 



15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
 
# File 'lib/squared/workspace/application.rb', line 15

def implement(*objs, base: nil)
  objs.each_with_index do |obj, index|
    if base && index == 0
      case base
      when 0, true
        @kind_extend[0] = obj
        next
      when 1
        @kind_extend.insert(1, obj)
      else
        @kind_extend.push(obj)
      end
    end
    kind_project.unshift(obj) if extends(obj)
  end
end

.load_ref(path, gem: nil) ⇒ Object 



46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
 
# File 'lib/squared/workspace/application.rb', line 46

def load_ref(path, gem: nil)
  if gem
    unless @gemsdir
      IO.popen('bundle env').each do |val|
        next unless val =~ /^\s+Gem Home\s+(.+)$/

        @gemsdir = File.join($1, 'gems')
        break
      end
    end
    dir = if gem.match?(/-\d+(\.|$)/)
            gem
          else
            Dir.glob("#{gem}-*", base: @gemsdir).pop
          end
    path = File.join(@gemsdir, dir, path) if dir
  end
  path = Pathname.new(path)
  @load_project.unshift(path.cleanpath.to_s) if path.absolute? && path.exist?
end

.register(app, base, exclude: []) ⇒ Object 



41
42
43
44
 
# File 'lib/squared/workspace/application.rb', line 41

def register(app, base, exclude: [])
  @session << app
  impl_series.new(app, (@kind_extend + base).uniq, exclude: exclude.map(&:to_sym))
end

.to_s ⇒ Object 



79
80
81
 
# File 'lib/squared/workspace/application.rb', line 79

def to_s
  super[/[^:]+\z/, 0]
end

Instance Method Details

#add(path, project = nil, **kwargs, &blk) ⇒ Object 



385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
 
# File 'lib/squared/workspace/application.rb', line 385

def add(path, project = nil, **kwargs, &blk)
  kwargs = Support.hashdup(@withargs).update(kwargs) if @withargs
  ref = kwargs.key?(:ref) ? kwargs.delete(:ref) : @ref
  kwargs[:group] = @group if @group && !kwargs.key?(:group)
  path = rootpath path
  project = (project || path.basename).to_s
  name = task_name project
  index = 0
  while @project[name]
    index += 1
    name = task_name "#{project}-#{index}"
  end
  unless ref.is_a?(Symbol) && (proj = @base.find { |item| item.ref == ref })
    proj = if !ref.is_a?(Class)
             require_project(ref) || Application.find(ref: ref, path: path)
           elsif Application.extends(ref)
             ref
           end || @kind[name]&.last
    if proj
      @base << proj
      @banner.items.concat(Array(proj.bannerargs))
    else
      proj = Application.impl_project
    end
  end
  proj = proj.new(self, path, name, **kwargs)
  proj.__send__(:index_set, size)
  @project[name] = proj
  __get__(:project)[name] = proj unless kwargs[:private]
  proj.instance_eval(&blk) if block_given?
  self
end

#apply(&blk) ⇒ Object 



438
439
440
441
 
# File 'lib/squared/workspace/application.rb', line 438

def apply(&blk)
  instance_eval(&blk)
  self
end
 


328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
 
# File 'lib/squared/workspace/application.rb', line 328

def banner(*args, command: true, styles: nil, border: nil, group: @group, ref: @ref)
  data = Struct::BannerData.new(command, check_style(styles, empty: false), check_style(border))
  args.each do |meth|
    if meth.is_a?(Array)
      found = false
      meth = meth.select do |val|
        case val
        when Symbol
          found = true
          banner_include?(val)
        when String
          true
        else
          false
        end
      end
      if !found
        next
      elsif meth.size == 1
        meth = meth.first
      end
    elsif !banner_include?(meth = meth.to_sym)
      next
    end
    data.order << meth
  end
  Array(if group
          label = :group
          group
        else
          label = :ref
          ref || :_
        end).each { |val| @banner[label][val.to_sym] = data }
  self
end
 


672
673
674
675
676
677
678
679
 
# File 'lib/squared/workspace/application.rb', line 672

def banner_get(*ref, group: nil)
  if group && @banner.group.key?(group = group.to_sym)
    @banner.group[group]
  else
    ref.reverse_each { |val| return @banner.ref[val] if @banner.ref.key?(val) }
    @banner.ref[:_] if @banner.ref.key?(:_)
  end
end

#baseref ⇒ Object 



773
774
775
 
# File 'lib/squared/workspace/application.rb', line 773

def baseref
  Application.baseref
end

#batch(*args) ⇒ Object 



375
376
377
378
 
# File 'lib/squared/workspace/application.rb', line 375

def batch(*args)
  (@config[:batch] ||= []) << args
  self
end

#build(parallel: [], **kwargs) ⇒ Object 



147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
 
# File 'lib/squared/workspace/application.rb', line 147

def build(parallel: [], **kwargs)
  return self unless enabled? && !@closed

  self.closed = 'init'
  kwargs[:parallel] = if kwargs[:pattern].is_a?(Array)
                        parallel.map(&:to_s)
                      else
                        kwargs[:pattern] = []
                        parallel.reject { |val| kwargs[:pattern] << val if val.is_a?(Regexp) }.map(&:to_s)
                      end
  @pass.items.concat(kwargs[:pass].map { |val| val.is_a?(Regexp) ? val : val.to_s }) if kwargs[:pass]
  @series = Application.register(self, @base.to_a, exclude: kwargs.fetch(:exclude, []))
  self.closed = 'begin'
  pb = @stage.key?('project:begin')
  pe = @stage.key?('project:end')
  keys = @series.keys
  each do |proj|
    self.closed = ['project:begin', proj] if pb
    if proj.enabled?
      proj.populate(keys.dup, **kwargs)
    elsif proj.enabled?(base: false)
      proj.generate([], **kwargs)
    else
      next
    end
    @series.populate(proj, **kwargs)
    self.closed = ['project:end', proj] if pe
  end
  self.closed = 'populate'
  @base.each { |obj| obj.populate(self, **kwargs) }
  self.closed = 'extensions'
  @extensions.each { |ext| __send__(ext, **kwargs) }
  self.closed = 'series'
  @series.build(**kwargs)
  __build__(**kwargs)
  if block_given?
    self.closed = 'yield:begin'
    yield self
    self.closed = 'yield:end'
  end
  self.closed = 'finalize'
  @finalize.each { |ext| __send__(ext, **kwargs) }
  self.closed = 'end'
  @closed = true
  self
end

#chain(task, *action, project: nil, step: 0, with: nil, before: nil, after: nil, sync: false, group: @group, ref: @ref) ⇒ Object 



254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
 
# File 'lib/squared/workspace/application.rb', line 254

def chain(task, *action, project: nil, step: 0, with: nil, before: nil, after: nil, sync: false,
          group: @group, ref: @ref)
  tasks = if project
            action.map { |val| task_join(project.name, val) }
          elsif (target = group || ref)
            action.map { |val| task_name(task_join(val, target)) }
          else
            keys = @project.keys unless prefix
            action.map { |val| task_name(val) }
          end
  ns = lambda do |val|
    return if (ret = as_a(val, :to_s, flat: true)).empty?

    ret.map do |arg|
      if arg.include?(':') || (keys && !keys.include?(arg))
        task_name(arg)
      else
        /#{Regexp.escape(arg)}:/
      end
    end
  end
  data = Struct::ChainData.new(tasks, step, ns.call(with), ns.call(before), ns.call(after), sync)
  @chain[task_name(task.to_s)] << data
  self
end

#clean(script = nil, group: @group, ref: @ref, on: nil, &blk) ⇒ Object 



292
293
294
 
# File 'lib/squared/workspace/application.rb', line 292

def clean(script = nil, group: @group, ref: @ref, on: nil, &blk)
  script_command :clean, script, group, ref, on, &blk
end

#compose(name, &blk) ⇒ Object 



433
434
435
436
 
# File 'lib/squared/workspace/application.rb', line 433

def compose(name, &blk)
  namespace(task_name(name), &blk)
  self
end

#config_get(key, default = nil, &blk) ⇒ Object 



688
689
690
 
# File 'lib/squared/workspace/application.rb', line 688

def config_get(key, default = nil, &blk)
  @config.fetch(key, block_given? ? blk : default)
end

#depend(script = nil, group: @group, ref: @ref, on: nil, &blk) ⇒ Object 



284
285
286
 
# File 'lib/squared/workspace/application.rb', line 284

def depend(script = nil, group: @group, ref: @ref, on: nil, &blk)
  script_command :depend, script, group, ref, on, &blk
end

#describe(data) ⇒ Object 



477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
 
# File 'lib/squared/workspace/application.rb', line 477

def describe(data)
  @describe ||= {
    alias: {},
    replace: [],
    pattern: {}
  }
  data.each do |key, val|
    key = key.to_s
    if key.start_with?('\A', '^') || key.end_with?('\z', '$')
      @describe[:replace] << [Regexp.new(key), val]
    else
      @describe[val.is_a?(Regexp) ? :pattern : :alias][key] = val
    end
  end
  self
end

#dev?(**kwargs) ⇒ Boolean

Returns:

  • (Boolean) 


725
726
727
 
# File 'lib/squared/workspace/application.rb', line 725

def dev?(**kwargs)
  script?(:dev, **kwargs)
end

#doc(script = nil, group: @group, ref: @ref, on: nil, &blk) ⇒ Object 



296
297
298
 
# File 'lib/squared/workspace/application.rb', line 296

def doc(script = nil, group: @group, ref: @ref, on: nil, &blk)
  script_command :doc, script, group, ref, on, &blk
end

#docker? ⇒ Boolean

Returns:

  • (Boolean) 


745
746
747
 
# File 'lib/squared/workspace/application.rb', line 745

def docker?
  !Dir['/.dockerenv', '/docker-*.{sh,d}'].empty?
end

#each(&blk) ⇒ Object 



141
142
143
144
145
 
# File 'lib/squared/workspace/application.rb', line 141

def each(&blk)
  return to_enum(:each) unless block_given?

  @project.each_value(&blk)
end

#enabled? ⇒ Boolean

Returns:

  • (Boolean) 


692
693
694
 
# File 'lib/squared/workspace/application.rb', line 692

def enabled?
  !@extensions.empty? || any? { |proj| proj.enabled?(base: false) }
end

#events_get(*args, group: nil, ref: nil) ⇒ Object 



668
669
670
 
# File 'lib/squared/workspace/application.rb', line 668

def events_get(*args, group: nil, ref: nil)
  data_get(*args, target: @events, group: group, ref: ref)
end

#exclude(base, group: @group, ref: @ref) ⇒ Object 



312
313
314
 
# File 'lib/squared/workspace/application.rb', line 312

def exclude(base, group: @group, ref: @ref)
  script_command :exclude, as_a(base, :to_sym).freeze, group, ref
end

#find(path = nil, name: nil, group: nil, ref: nil, &blk) ⇒ Object 



494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
 
# File 'lib/squared/workspace/application.rb', line 494

def find(path = nil, name: nil, group: nil, ref: nil, &blk)
  return @project.values.find(&blk) if block_given? && !path && !name && !group && !ref

  ret = group ? select { |item| item.group == group } : []
  if path.is_a?(Symbol)
    ref ||= path
    path = nil
  end
  if ret.empty?
    ret = select { |item| item.ref?(ref) } if ref
    if ret.empty? && (path || name)
      path &&= rootpath path
      name &&= name.to_s
      if (proj = find { |item| item.path == path || item.name == name })
        ret << proj
      end
    end
  end
  return (group || ref ? ret : ret.first) unless block_given?

  ret.each(&blk)
  self
end

#find_base(obj) ⇒ Object 



526
527
528
 
# File 'lib/squared/workspace/application.rb', line 526

def find_base(obj)
  @base.find { |proj| obj.instance_of?(proj) }
end

#format_desc(val, opts = nil, arg: 'opts*', before: nil, after: nil, out: false) ⇒ Object 



625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
 
# File 'lib/squared/workspace/application.rb', line 625

def format_desc(val, opts = nil, arg: 'opts*', before: nil, after: nil, out: false)
  return unless TASK_METADATA

  val = val.split(':') if val.is_a?(String)
  if before || after || opts
    pos = []
    pos << (before.is_a?(Array) ? before.join(',') : before) if before
    if opts
      pos << if opts.is_a?(Array)
               arg ? "#{arg}=#{opts.join(',')}" : opts.join('|')
             else
               opts
             end
    end
    pos << (after.is_a?(Array) ? after.join(',') : after) if after
    val << "#{val.pop}[#{pos.join(',')}]"
  end
  out ? message(*val) : task_desc(*val)
end

#get(name, &blk) ⇒ Object 



518
519
520
521
522
523
524
 
# File 'lib/squared/workspace/application.rb', line 518

def get(name, &blk)
  ret = @project[name.to_s]
  return ret unless block_given?

  ret&.instance_eval(&blk)
  self
end

#graph(script, group: @group, ref: @ref, on: nil) ⇒ Object 



288
289
290
 
# File 'lib/squared/workspace/application.rb', line 288

def graph(script, group: @group, ref: @ref, on: nil)
  script_command :graph, as_a(script, :to_s).freeze, group, ref, on
end

#group(path, val, override: {}, **kwargs, &blk) ⇒ Object 



418
419
420
421
422
423
424
425
426
427
428
429
430
431
 
# File 'lib/squared/workspace/application.rb', line 418

def group(path, val, override: {}, **kwargs, &blk)
  rootpath(path).children.map do |dir|
    next unless dir.directory?

    basename = dir.basename.to_s
    [dir, basename, override[basename.to_sym]]
  end
  .each do |dir, basename, opts|
    args = kwargs.dup
    args.update(opts) if opts
    add(dir, basename, group: val, **args, &blk)
  end
  self
end

#home? ⇒ Boolean

Returns:

  • (Boolean) 


733
734
735
 
# File 'lib/squared/workspace/application.rb', line 733

def home?
  !!find(home)&.enabled?
end

#homepath(*args) ⇒ Object 



765
766
767
 
# File 'lib/squared/workspace/application.rb', line 765

def homepath(*args)
  home.join(*args)
end

#inspect ⇒ Object 



789
790
791
 
# File 'lib/squared/workspace/application.rb', line 789

def inspect
  "#<#{self.class}: #{main} => #{self}>"
end

#invokeargs ⇒ Object 



777
778
779
 
# File 'lib/squared/workspace/application.rb', line 777

def invokeargs
  { exception: exception?, warning: warning }
end

#join(task, *cmd, invoke: nil, args: [], group: @group, ref: @ref, **kwargs, &blk) ⇒ Object 



241
242
243
244
245
246
247
248
 
# File 'lib/squared/workspace/application.rb', line 241

def join(task, *cmd, invoke: nil, args: [], group: @group, ref: @ref, **kwargs, &blk)
  unless block_given?
    invoke ||= cmd.shift
    args = cmd if (args = Array(args)).empty?
    args.unshift(invoke)
  end
  script_command task.to_sym, args, group, ref, @join, kwargs, &blk
end

#lint(script = nil, group: @group, ref: @ref, on: nil, &blk) ⇒ Object 



300
301
302
 
# File 'lib/squared/workspace/application.rb', line 300

def lint(script = nil, group: @group, ref: @ref, on: nil, &blk)
  script_command :lint, script, group, ref, on, &blk
end

#log(script, group: @group, ref: @ref) ⇒ Object 



308
309
310
 
# File 'lib/squared/workspace/application.rb', line 308

def log(script, group: @group, ref: @ref)
  script_command :log, script, group, ref
end

#mri? ⇒ Boolean

Returns:

  • (Boolean) 


741
742
743
 
# File 'lib/squared/workspace/application.rb', line 741

def mri?
  RUBY_ENGINE == 'ruby'
end

#pass(name, group: @group, ref: @ref, &blk) ⇒ Object 



316
317
318
319
320
321
322
323
324
325
326
 
# File 'lib/squared/workspace/application.rb', line 316

def pass(name, group: @group, ref: @ref, &blk)
  data = if group
           @pass.group[group.to_s]
         elsif ref
           @pass.ref[ref.to_sym]
         else
           @pass.store
         end
  data[name.to_sym] = blk
  self
end

#powershell? ⇒ Boolean

Returns:

  • (Boolean) 


749
750
751
752
753
754
755
756
757
758
759
 
# File 'lib/squared/workspace/application.rb', line 749

def powershell?
  return true if ENV['SHELL']&.end_with?(File.join('', 'pwsh'))
  return false unless windows?

  case ENV['TERM_PROGRAM']
  when 'powershell.exe', 'vscode'
    true
  else
    ENV.fetch('PSModulePath', '').split(';', 2).size > 1
  end
end

#prod?(**kwargs) ⇒ Boolean

Returns:

  • (Boolean) 


729
730
731
 
# File 'lib/squared/workspace/application.rb', line 729

def prod?(**kwargs)
  script?(:prod, **kwargs)
end

#pwd ⇒ Object 



769
770
771
 
# File 'lib/squared/workspace/application.rb', line 769

def pwd
  Pathname.new(Rake.application.original_dir)
end

#rename(task, val) ⇒ Object 



380
381
382
383
 
# File 'lib/squared/workspace/application.rb', line 380

def rename(task, val)
  (@config[:rename] ||= {})[task.to_sym] = val.to_s
  self
end

#rootpath(*args) ⇒ Object 



761
762
763
 
# File 'lib/squared/workspace/application.rb', line 761

def rootpath(*args)
  root.join(*args)
end

#run(script = nil, group: @group, ref: @ref, on: nil, &blk) ⇒ Object 



250
251
252
 
# File 'lib/squared/workspace/application.rb', line 250

def run(script = nil, group: @group, ref: @ref, on: nil, &blk)
  script_command :run, script, group, ref, on, &blk
end

#script(script, group: @group, ref: @ref, on: nil) ⇒ Object 



280
281
282
 
# File 'lib/squared/workspace/application.rb', line 280

def script(script, group: @group, ref: @ref, on: nil)
  script_command :script, script, group, ref, on
end

#script_find(*args, name: nil) ⇒ Object 



645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
 
# File 'lib/squared/workspace/application.rb', line 645

def script_find(*args, name: nil)
  target = @global[name || '_']
  group, ref, exclude = target.fetch_values(:group, :ref, :exclude)
  ret = nil
  args.reverse_each do |val|
    next unless val

    if exclude.include?(val)
      ret = nil
      break
    elsif ret
      next
    elsif (ret = val.is_a?(Symbol) ? ref[val] : group[val]) && exclude.empty?
      break
    end
  end
  ret || (target[:script] ||= scriptobj)
end

#script_get(*args, group: nil, ref: nil) ⇒ Object 



664
665
666
 
# File 'lib/squared/workspace/application.rb', line 664

def script_get(*args, group: nil, ref: nil)
  data_get(*args, target: @script, group: group, ref: ref)
end

#size ⇒ Object 



781
782
783
 
# File 'lib/squared/workspace/application.rb', line 781

def size
  @project.size
end

#stage(val, first: false, &blk) ⇒ Object 



443
444
445
446
447
448
449
450
451
452
453
 
# File 'lib/squared/workspace/application.rb', line 443

def stage(val, first: false, &blk)
  data = @stage[val]
  if first == true
    data.unshift(blk)
  elsif first.is_a?(Numeric) && first < data.size
    data.insert(first, blk)
  else
    data.push(blk)
  end
  self
end

#style(obj, *args, target: nil, empty: false) ⇒ Object 



455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
 
# File 'lib/squared/workspace/application.rb', line 455

def style(obj, *args, target: nil, empty: false)
  data = nil
  if target
    Array(target).each_with_index do |key, i|
      if i == 0
        break unless (data = __get__(:theme)[key.to_sym])
      else
        data = data[key.to_sym] ||= {}
      end
    end
  end
  if obj.is_a?(String)
    obj = begin
      JSON.parse(homepath(obj).read, { symbolize_names: true })
    rescue => e
      warn log_message(Logger::ERROR, e)
    end
  end
  apply_style(data || theme, obj, args, empty: empty) if obj && (!target || data)
  self
end

#task_base?(key) ⇒ Boolean

Returns:

  • (Boolean) 


696
697
698
 
# File 'lib/squared/workspace/application.rb', line 696

def task_base?(key)
  series.base?(key)
end

#task_defined?(*key) ⇒ Boolean

Returns:

  • (Boolean) 


721
722
723
 
# File 'lib/squared/workspace/application.rb', line 721

def task_defined?(*key)
  Rake::Task.task_defined?(key.size == 1 ? key.first : task_join(*key))
end

#task_desc(*args, **kwargs) ⇒ Object 



538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
 
# File 'lib/squared/workspace/application.rb', line 538

def task_desc(*args, **kwargs)
  return unless TASK_METADATA

  name = kwargs.delete(:name)
  if @describe
    val = name || task_join(*args)
    found = false
    sub = lambda do |data, out|
      index = data.size
      data.to_a.reverse_each { |group| out.sub!("%#{index -= 1}", group) }
      out
    end
    @describe[:replace].each do |pat, tmpl|
      next unless val =~ pat

      val = sub.call($~, tmpl.dup)
      found = true
    end
    if (out = @describe[:alias][val])
      val = out
      found = true
    else
      @describe[:pattern].each do |key, pat|
        next unless val =~ pat

        val = sub.call($~, key.dup)
        found = true
        break
      end
    end
    args = split_escape(val, char: ':').map { |s| s.gsub('\\:', ':') } if found
  end
  desc message(*args, **kwargs)
end

#task_exclude?(key, obj = nil) ⇒ Boolean

Returns:

  • (Boolean) 


710
711
712
713
714
715
716
717
718
719
 
# File 'lib/squared/workspace/application.rb', line 710

def task_exclude?(key, obj = nil)
  if obj
    data = obj.group ? @pass.group[obj.group] : @pass.ref[obj.ref]
    blk = (data && data[key.to_sym]) || @pass.store[key.to_sym]
    return true if blk && obj.instance_eval(&blk)

    key = task_join(task_localname(obj.name), key)
  end
  @pass.items.any? { |item| item.is_a?(Regexp) ? item.match?(key) : item == key }
end

#task_extend?(obj, key) ⇒ Boolean

Returns:

  • (Boolean) 


700
701
702
 
# File 'lib/squared/workspace/application.rb', line 700

def task_extend?(obj, key)
  series.extend?(obj, key)
end

#task_include?(obj, key, ref: nil) ⇒ Boolean

Returns:

  • (Boolean) 


704
705
706
707
708
 
# File 'lib/squared/workspace/application.rb', line 704

def task_include?(obj, key, ref: nil)
  return false if series.exclude?(key)

  task_base?(key) ? obj.has?(key, ref: ref || baseref) : task_extend?(obj, key)
end

#task_localname(val) ⇒ Object 



534
535
536
 
# File 'lib/squared/workspace/application.rb', line 534

def task_localname(val)
  prefix && val.is_a?(String) ? val.sub(/^#{Regexp.escape(prefix)}:/, '') : val.to_s
end

#task_name(val) ⇒ Object 



530
531
532
 
# File 'lib/squared/workspace/application.rb', line 530

def task_name(val)
  prefix ? task_join(prefix, val) : val.to_s
end

#task_namespace(val, first: false) ⇒ Object 



573
574
575
576
577
 
# File 'lib/squared/workspace/application.rb', line 573

def task_namespace(val, first: false)
  return unless (ret = val.to_s.split(':')).size > 1

  first ? ret.first : task_join(*ret[0..-2])
end

#task_resolve(obj, key) ⇒ Object 



579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
 
# File 'lib/squared/workspace/application.rb', line 579

def task_resolve(obj, key)
  tasks = []
  if (base = task_base?(key))
    tasks << key if obj.has?(key, ref: baseref)
  elsif (batch = series.batch_get(key))
    obj.allref do |ref|
      next unless obj.has?(key, ref: ref, missing: series.missing?(ref, key)) && (data = batch[ref])

      data.each do |val|
        if (items = task_resolve(obj, val)).empty?
          tasks.clear
          break
        end
        tasks.concat(items)
      end
      return tasks unless tasks.empty?
    end
  elsif task_extend?(obj, key)
    tasks << key
  end
  ret = []
  if tasks.empty?
    return [] if (base && !obj.ref?(baseref)) || !(data = series.alias_get(key))

    obj.allref do |ref|
      next unless obj.has?(key, ref: ref) && (alt = data[ref])

      ret = task_resolve obj, alt
      break unless ret.empty?
    end
  else
    tasks.each do |val|
      target = task_join(obj.name, series.name_get(val))
      return [] unless task_defined?(target)

      ret << target
    end
  end
  ret
end

#task_sync(key) ⇒ Object 



620
621
622
623
 
# File 'lib/squared/workspace/application.rb', line 620

def task_sync(key)
  key = task_name key
  task_defined?(ret = task_join(key, 'sync')) ? ret : key
end

#test(script = nil, group: @group, ref: @ref, on: nil, &blk) ⇒ Object 



304
305
306
 
# File 'lib/squared/workspace/application.rb', line 304

def test(script = nil, group: @group, ref: @ref, on: nil, &blk)
  script_command :test, script, group, ref, on, &blk
end

#timeout(data, group: @group, ref: @ref) ⇒ Object 



364
365
366
367
368
369
370
371
372
373
 
# File 'lib/squared/workspace/application.rb', line 364

def timeout(data, group: @group, ref: @ref)
  if group
    @timeout.group[group.to_s].update(data)
  elsif ref
    @timeout.ref[ref.to_sym].update(data)
  else
    @timeout.store.update(data)
  end
  self
end

#timeout_get(*ref, group: nil) ⇒ Object 



681
682
683
684
685
686
 
# File 'lib/squared/workspace/application.rb', line 681

def timeout_get(*ref, group: nil)
  ret = @timeout.store.dup
  ref.each { |val| ret.update(@timeout.ref[val]) if @timeout.ref.key?(val) }
  ret.update(@timeout.group[group]) if group && @timeout.group.key?(group)
  ret
end

#to_s ⇒ Object 



785
786
787
 
# File 'lib/squared/workspace/application.rb', line 785

def to_s
  (home? ? home : root).to_s
end

#windows? ⇒ Boolean

Returns:

  • (Boolean) 


737
738
739
 
# File 'lib/squared/workspace/application.rb', line 737

def windows?
  Rake::Win32.windows?
end

#with(*val, hide: false, group: nil, **kwargs, &blk) ⇒ Object 



194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
 
# File 'lib/squared/workspace/application.rb', line 194

def with(*val, hide: false, group: nil, **kwargs, &blk)
  if hide
    return self if hide == true

    Array(hide).each do |args|
      if args.is_a?(Array)
        if respond_to?(hint = args.first)
          next unless __send__(*args)

          return self
        end
      elsif respond_to?(args)
        next unless __send__(args)

        return self
      end
      raise 'method not found'
    rescue => e
      warn log_message(Logger::WARN, e, subject: main, hint: hint || args)
    end
  end
  @group = nil
  @ref = nil
  @withargs = unless kwargs.empty?
                kwargs.delete(:parent)
                kwargs
              end
  val = as_a(group || kwargs[:ref], flat: true, compact: true) if val.empty?
  kind = val.first
  val = kind if val.size == 1
  case kind
  when String
    @group = val
  when Symbol
    @ref = val
  else
    raise TypeError, message('not a group/ref', hint: kind || 'nil') if block_given?
  end
  if block_given?
    instance_eval(&blk)
    @group = nil
    @ref = nil
    @withargs = nil
  end
  self
end