Класс: Cask::DSL Закрытый

567
568
569
570
571
572
573
574
575

# File 'cask/dsl.rb', line 567

def arch(arm: nil, intel: nil)
  should_return = arm.nil? && intel.nil?

  set_unique_stanza(:arch, should_return) do
    @on_system_blocks_exist = true

    on_arch_conditional(arm:, intel:)
  end
end

686
687
688

# File 'cask/dsl.rb', line 686

def auto_updates(auto_updates = nil)
  set_unique_stanza(:auto_updates, auto_updates.nil?) { auto_updates }
end

722
723
724

# File 'cask/dsl.rb', line 722

def autobump?
  @autobump == true
end

642
643
644

# File 'cask/dsl.rb', line 642

def caskroom_path
  cask.caskroom_path
end

666
667
668
669
670
671
672
673
674
675
676
677

# File 'cask/dsl.rb', line 666

def caveats(*strings, &block)
  if block
    @caveats.eval_caveats(&block)
  elsif strings.any?
    strings.each do |string|
      @caveats.eval_caveats { string }
    end
  else
    return @caveats.to_s
  end
  @caveats
end

680

# File 'cask/dsl.rb', line 680

def caveats_object = @caveats

636
637
638
639

# File 'cask/dsl.rb', line 636

def conflicts_with(**kwargs)
  # TODO: Remove this constraint and instead merge multiple `conflicts_with` stanzas
  set_unique_stanza(:conflicts_with, kwargs.empty?) { DSL::ConflictsWith.new(**kwargs) }
end

451
452
453
454
455

# File 'cask/dsl.rb', line 451

def container(nested: nil, type: nil)
  set_unique_stanza(:container, nested.nil? && type.nil?) do
    DSL::Container.new(nested:, type:)
  end
end

609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630

# File 'cask/dsl.rb', line 609

def depends_on(arg = nil, **kwargs)
  @depends_on_set_in_block = true if @called_in_on_system_block
  if arg == :macos
    if kwargs.key?(:macos) || kwargs.key?(:maximum_macos)
      raise CaskInvalidError.new(cask, "`depends_on :macos` cannot be combined with another macOS `depends_on`")
    end

    kwargs[:macos] = :any
  elsif arg == :linux
    kwargs[:linux] = :any
  elsif arg
    raise CaskInvalidError.new(cask, "invalid 'depends_on' value: #{arg.inspect}")
  end
  return @depends_on if kwargs.empty?

  begin
    @depends_on.load(kwargs, set_in_block: @called_in_on_system_block)
  rescue RuntimeError => e
    raise CaskInvalidError.new(cask, e)
  end
  @depends_on
end

257

# File 'cask/dsl.rb', line 257

def depends_on_set_in_block? = @depends_on_set_in_block

740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761

# File 'cask/dsl.rb', line 740

def deprecate!(date:, because:, replacement: nil, replacement_formula: nil, replacement_cask: nil)
  if [replacement, replacement_formula, replacement_cask].filter_map(&:presence).length > 1
    raise ArgumentError, "more than one of replacement, replacement_formula and/or replacement_cask specified!"
  end

  if replacement
    odeprecated(
      "deprecate!(:replacement)",
      "deprecate!(:replacement_formula) or deprecate!(:replacement_cask)",
    )
  end

  @deprecate_args = { date:, because:, replacement_formula:, replacement_cask: }

  @deprecation_date = Date.parse(date)
  return if @deprecation_date > Date.today

  @deprecation_reason = because
  @deprecation_replacement_formula = replacement_formula.presence || replacement
  @deprecation_replacement_cask = replacement_cask.presence || replacement
  @deprecated = true
end

260

# File 'cask/dsl.rb', line 260

def deprecated? = @deprecated

305
306
307

# File 'cask/dsl.rb', line 305

def desc(description = nil)
  set_unique_stanza(:desc, description.nil?) { description }
end

777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808

# File 'cask/dsl.rb', line 777

def disable!(date:, because:, replacement: nil, replacement_formula: nil, replacement_cask: nil)
  if [replacement, replacement_formula, replacement_cask].filter_map(&:presence).length > 1
    raise ArgumentError, "more than one of replacement, replacement_formula and/or replacement_cask specified!"
  end

  # odeprecate: remove this remapping when the :unsigned reason is removed
  because = :fails_gatekeeper_check if because == :unsigned

  if replacement
    odeprecated(
      "disable!(:replacement)",
      "disable!(:replacement_formula) or disable!(:replacement_cask)",
    )
  end

  @disable_args = { date:, because:, replacement_formula:, replacement_cask: }

  @disable_date = Date.parse(date)

  if @disable_date > Date.today
    @deprecation_reason = because
    @deprecation_replacement_formula = replacement_formula.presence || replacement
    @deprecation_replacement_cask = replacement_cask.presence || replacement
    @deprecated = true
    return
  end

  @disable_reason = because
  @disable_replacement_formula = replacement_formula.presence || replacement
  @disable_replacement_cask = replacement_cask.presence || replacement
  @disabled = true
end

263

# File 'cask/dsl.rb', line 263

def disabled? = @disabled

349
350
351

# File 'cask/dsl.rb', line 349

def homepage(homepage = nil)
  set_unique_stanza(:homepage, homepage.nil?) { homepage }
end

861
862
863
864
865

# File 'cask/dsl.rb', line 861

def install_step_artifact_class(dsl_key)
  INSTALL_STEP_FLIGHT_BLOCK_CLASSES.find do |_step_class, (_block_class, block_dsl_key)|
    block_dsl_key == dsl_key
  end&.first
end

854
855
856
857
858

# File 'cask/dsl.rb', line 854

def install_step_artifact_defined?(dsl_key)
  return false unless (klass = install_step_artifact_class(dsl_key))

  artifacts.any?(klass)
end

363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380

# File 'cask/dsl.rb', line 363

def language(*args, default: false, &block)
  if args.empty?
    language_eval
  elsif block
    @language_blocks[args] = block

    return unless default

    if !@cask.allow_reassignment && @language_blocks.default.present?
      raise CaskInvalidError.new(cask, "Only one default language may be defined.")
    end

    @language_blocks.default = block
    nil
  else
    raise CaskInvalidError.new(cask, "No block given to language stanza.")
  end
end

383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407

# File 'cask/dsl.rb', line 383

def language_eval
  return @language_eval unless @language_eval.nil?

  return @language_eval = nil if @language_blocks.empty?

  if (language_blocks_default = @language_blocks.default).nil?
    raise CaskInvalidError.new(cask, "No default language specified.")
  end

  locales = cask.config.languages
                .filter_map do |language|
                  Locale.parse(language)
                rescue Locale::ParserError
                  nil
                end

  locales.each do |locale|
    key = T.cast(locale.detect(@language_blocks.keys), T.nilable(T::Array[String]))
    next if key.nil? || (language_block = @language_blocks[key]).nil?

    return @language_eval = language_block.call
  end

  @language_eval = language_blocks_default.call
end

410
411
412

# File 'cask/dsl.rb', line 410

def languages
  @language_blocks.keys.flatten
end

694
695
696
697
698
699
700
701
702
703
704
705

# File 'cask/dsl.rb', line 694

def livecheck(&block)
  return @livecheck unless block

  if !@cask.allow_reassignment && @livecheck_defined
    raise CaskInvalidError.new(cask, "'livecheck' stanza may only appear once.")
  end

  @livecheck_defined = true
  @livecheck.instance_eval(&block)
  set_no_autobump(because: :extract_plist) if @livecheck.strategy == :extract_plist && !no_autobump_defined?
  @livecheck
end

266

# File 'cask/dsl.rb', line 266

def livecheck_defined? = @livecheck_defined

289
290
291
292
293

# File 'cask/dsl.rb', line 289

def name(*args)
  return @name if args.empty?

  @name.concat(args.flatten)
end

711
712
713
714
715
716
717
718

# File 'cask/dsl.rb', line 711

def no_autobump!(because:)
  tap = @cask.tap
  if tap && !tap.official?
    raise CaskInvalidError.new(cask, "'no_autobump!' can only be used in official Homebrew taps.")
  end

  set_no_autobump(because:)
end

272

# File 'cask/dsl.rb', line 272

def on_os_blocks_exist? = @on_os_blocks_exist

269

# File 'cask/dsl.rb', line 269

def on_system_blocks_exist? = @on_system_blocks_exist

592
593
594
595
596
597
598
599
600
601

# File 'cask/dsl.rb', line 592

def os(macos: nil, linux: nil)
  should_return = macos.nil? && linux.nil?

  set_unique_stanza(:os, should_return) do
    @on_system_blocks_exist = true
    @on_os_blocks_exist = true

    on_system_conditional(macos:, linux:)
  end
end

898
899
900

# File 'cask/dsl.rb', line 898

def os_version
  nil
end

868
869
870
871
872
873
874
875
876
877
878
879
880

# File 'cask/dsl.rb', line 868

def remove_conflicting_flight_blocks(klass)
  flight_block_class, dsl_key = INSTALL_STEP_FLIGHT_BLOCK_CLASSES.fetch(klass)
  conflicting_flight_blocks = artifacts.select do |artifact|
    next false unless artifact.is_a?(flight_block_class)

    artifact.directives.key?(dsl_key)
  end

  conflicting_flight_blocks.each do |artifact|
    warn_on_install_step_conflict(dsl_key, klass.dsl_key)
    artifacts.delete(artifact)
  end
end

473
474
475
476
477

# File 'cask/dsl.rb', line 473

def rename(from = T.unsafe(nil), to = T.unsafe(nil))
  return @rename if from.nil?

  @rename << DSL::Rename.new(from, to)
end

893
894
895

# File 'cask/dsl.rb', line 893

def respond_to_missing?(_method_name, _include_private = false)
  false
end

318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337

# File 'cask/dsl.rb', line 318

def set_unique_stanza(stanza, should_return, &_block)
  return instance_variable_get(:"@#{stanza}") if should_return

  unless @cask.allow_reassignment
    if !instance_variable_get(:"@#{stanza}").nil? && !@called_in_on_system_block
      raise CaskInvalidError.new(cask, "'#{stanza}' stanza may only appear once.")
    end

    if instance_variable_get(:"@#{stanza}_set_in_block") && @called_in_on_system_block
      raise CaskInvalidError.new(cask, "'#{stanza}' stanza may only be overridden once.")
    end
  end

  instance_variable_set(:"@#{stanza}_set_in_block", true) if @called_in_on_system_block
  instance_variable_set(:"@#{stanza}", yield)
rescue CaskInvalidError
  raise
rescue => e
  raise CaskInvalidError.new(cask, "'#{stanza}' stanza failed with: #{e}")
end

532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555

# File 'cask/dsl.rb', line 532

def sha256(arg = nil, arm: nil, intel: nil, x86_64: nil, x86_64_linux: nil, arm64_linux: nil)
  should_return = arg.nil? && arm.nil? && (intel.nil? || x86_64.nil?) && x86_64_linux.nil? && arm64_linux.nil?

  x86_64 ||= intel if intel.present? && x86_64.nil?
  set_unique_stanza(:sha256, should_return) do
    if arm.present? || x86_64.present? || x86_64_linux.present? || arm64_linux.present?
      @on_system_blocks_exist = true
    end
    @sha256_set_for_linux = true if x86_64_linux.present? || arm64_linux.present?

    val = arg || on_system_conditional(
      macos: on_arch_conditional(arm:, intel: x86_64),
      linux: on_arch_conditional(arm: arm64_linux, intel: x86_64_linux),
    )
    case val
    when :no_check
      :no_check
    when String
      Checksum.new(val)
    else
      raise CaskInvalidError.new(cask, "invalid 'sha256' value: #{val.inspect}")
    end
  end
end

275

# File 'cask/dsl.rb', line 275

def sha256_set_for_linux? = @sha256_set_for_linux

650
651
652
653
654
655

# File 'cask/dsl.rb', line 650

def staged_path
  return @staged_path if @staged_path

  cask_version = version || :unknown
  @staged_path = caskroom_path.join(cask_version.to_s)
end

424
425
426
427
428
429
430
431

# File 'cask/dsl.rb', line 424

def url(uri = nil, **options)
  caller_location = caller_locations.fetch(0)
  return @url unless uri

  set_unique_stanza(:url, false) do
    URL.new(uri, **options, caller_location:)
  end
end

490
491
492
493
494
495
496
497
498
499
500

# File 'cask/dsl.rb', line 490

def version(arg = nil)
  set_unique_stanza(:version, arg.nil?) do
    if !arg.is_a?(String) && arg != :latest
      raise CaskInvalidError.new(cask, "invalid 'version' value: #{arg.inspect}")
    end

    set_no_autobump(because: :latest_version) if arg == :latest && !no_autobump_defined?

    DSL::Version.new(arg)
  end
end

883
884
885

# File 'cask/dsl.rb', line 883

def warn_on_install_step_conflict(dsl_key, steps_key)
  opoo "#{token}: `#{dsl_key}` is ignored because `#{steps_key}` is defined!"
end