Class: Cask::URL Private

Inherits:

SimpleDelegator

• Object
• SimpleDelegator
• Cask::URL

Includes:

Kernel

Defined in:

cask/url.rb,
sorbet/rbi/dsl/cask/url.rbi

Overview

This class is part of a private API. This class may only be used in the Homebrew/brew repository. Third parties should avoid using this class if possible, as it may be removed or changed without warning.

Class corresponding to the url stanza.

Defined Under Namespace

Classes: BlockDSL, DSL

Constant Summary

BlockReturn =

This constant is part of a private API. This constant may only be used in the Homebrew/brew repository. Third parties should avoid using this constant if possible, as it may be removed or changed without warning.

T.type_alias do
  T.any(URI::Generic, String, [T.any(URI::Generic, String), T::Hash[Symbol, T.untyped]])
end

Constants included from Kernel

Kernel::IGNORE_INTERRUPTS_MUTEX

Instance Method Summary

• #branch ⇒ T.untyped private
• #cookies ⇒ Hash{::String => ::String}^? private
• #data ⇒ T.untyped private
• #from_block? ⇒ Boolean private
• #header ⇒ ::String, ... private
• #initialize(uri = nil, verified: nil, using: nil, tag: nil, branch: nil, revisions: nil, revision: nil, trust_cert: nil, cookies: nil, referer: nil, header: nil, user_agent: nil, data: nil, only_path: nil, caller_location: caller_locations.fetch(0), dsl: nil, &block) ⇒ void constructor private
• #location ⇒ Homebrew::SourceLocation private
• #only_path ⇒ T.untyped private
• #path ⇒ T.untyped private
• #referer ⇒ ::String, ... private
• #revision ⇒ T.untyped private
• #revisions ⇒ Array<::String>^? private
• #scheme ⇒ T.untyped private
• #specs ⇒ Hash{::Symbol => T.untyped} private
• #tag ⇒ ::String^? private
• #trust_cert ⇒ Boolean^? private
• #unversioned?(ignore_major_version: false) ⇒ Boolean private
• #uri ⇒ ::String, ::URI::Generic private
• #user_agent ⇒ ::String, ... private
• #using ⇒ ::Symbol, ... private
• #verified ⇒ T.untyped private

Methods included from Kernel

#disk_usage_readable, #ensure_executable!, #ensure_formula_installed!, #exec_browser, #exec_editor, #ignore_interrupts, #interactive_shell, #number_readable, #odebug, #odeprecated, #odie, #odisabled, #ofail, #oh1, #oh1_title, #ohai, #ohai_title, #onoe, #opoo, #paths, #pretty_duration, #pretty_installed, #pretty_outdated, #pretty_uninstalled, #quiet_system, #redact_secrets, #redirect_stdout, #require?, #safe_system, #tap_and_name_comparison, #truncate_text_to_approximate_size, #which, #which_all, #which_editor, #with_custom_locale, #with_env, #with_homebrew_path

Constructor Details

#initialize(uri = nil, verified: nil, using: nil, tag: nil, branch: nil, revisions: nil, revision: nil, trust_cert: nil, cookies: nil, referer: nil, header: nil, user_agent: nil, data: nil, only_path: nil, caller_location: caller_locations.fetch(0), dsl: nil, &block) ⇒ void

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Parameters:

• uri (URI::Generic, String, nil) (defaults to: nil)
• verified (String, nil) (defaults to: nil)
• using (T::Class[AbstractDownloadStrategy], Symbol, nil) (defaults to: nil)
• tag (String, nil) (defaults to: nil)
• branch (String, nil) (defaults to: nil)
• revisions (Array<String>, nil) (defaults to: nil)
• revision (String, nil) (defaults to: nil)
• trust_cert (Boolean, nil) (defaults to: nil)
• cookies (Hash{String => String}, nil) (defaults to: nil)
• referer (URI::Generic, String, nil) (defaults to: nil)
• header (String, Array<String>, nil) (defaults to: nil)
• user_agent (Symbol, String, nil) (defaults to: nil)
• data (Hash{String => String}, nil) (defaults to: nil)
• only_path (String, nil) (defaults to: nil)
• caller_location (Thread::Backtrace::Location) (defaults to: caller_locations.fetch(0))
• dsl (::Cask::DSL, nil) (defaults to: nil)
• block (T.proc.params(arg0: T.all(String, BlockDSL::PageWithURL)).returns(BlockReturn), nil)

# File 'cask/url.rb', line 214

def initialize(
  uri = nil, verified: nil, using: nil, tag: nil, branch: nil, revisions: nil, revision: nil, trust_cert: nil,
  cookies: nil, referer: nil, header: nil, user_agent: nil, data: nil, only_path: nil,
  caller_location: caller_locations.fetch(0), dsl: nil, &block
)
  super(
    if block
      LazyObject.new do
        uri2, options = *BlockDSL.new(uri, dsl: T.must(dsl), &block).call
        options ||= {}
        DSL.new(uri2, **options)
      end
    else
      DSL.new(T.must(uri), verified:, using:, tag:, branch:, revisions:, revision:, trust_cert:, cookies:,
      referer:, header:, user_agent:, data:, only_path:)
    end
  )

  @from_block = T.let(!block.nil?, T::Boolean)
  @caller_location = T.let(caller_location, Thread::Backtrace::Location)
end

Instance Method Details

#branch ⇒ T.untyped

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:

• (T.untyped)

# File 'sorbet/rbi/dsl/cask/url.rbi', line 12

def branch; end

#cookies ⇒ Hash{::String => ::String}^?

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:

• (Hash{::String => ::String}, nil)

# File 'sorbet/rbi/dsl/cask/url.rbi', line 15

def cookies; end

#data ⇒ T.untyped

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:

• (T.untyped)

# File 'sorbet/rbi/dsl/cask/url.rbi', line 18

def data; end

#from_block? ⇒ Boolean

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:

• (Boolean)

# File 'cask/url.rb', line 254

def from_block?
  @from_block
end

#header ⇒ ::String, ...

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:

• (::String, Array<::String>, nil)

# File 'sorbet/rbi/dsl/cask/url.rbi', line 21

def header; end

#location ⇒ Homebrew::SourceLocation

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:

• (Homebrew::SourceLocation)

# File 'cask/url.rb', line 237

def location
  Homebrew::SourceLocation.new(@caller_location.lineno, raw_url_line&.index("url"))
end

#only_path ⇒ T.untyped

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:

• (T.untyped)

# File 'sorbet/rbi/dsl/cask/url.rbi', line 24

def only_path; end

#path ⇒ T.untyped

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:

• (T.untyped)

# File 'sorbet/rbi/dsl/cask/url.rbi', line 27

def path; end

#referer ⇒ ::String, ...

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:

• (::String, ::URI::Generic, nil)

# File 'sorbet/rbi/dsl/cask/url.rbi', line 30

def referer; end

#revision ⇒ T.untyped

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:

• (T.untyped)

# File 'sorbet/rbi/dsl/cask/url.rbi', line 33

def revision; end

#revisions ⇒ Array<::String>^?

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:

• (Array<::String>, nil)

# File 'sorbet/rbi/dsl/cask/url.rbi', line 36

def revisions; end

#scheme ⇒ T.untyped

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:

• (T.untyped)

# File 'sorbet/rbi/dsl/cask/url.rbi', line 39

def scheme; end

#specs ⇒ Hash{::Symbol => T.untyped}

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:

• (Hash{::Symbol => T.untyped})

# File 'sorbet/rbi/dsl/cask/url.rbi', line 42

def specs; end

#tag ⇒ ::String^?

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:

• (::String, nil)

# File 'sorbet/rbi/dsl/cask/url.rbi', line 45

def tag; end

#trust_cert ⇒ Boolean^?

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:

• (Boolean, nil)

# File 'sorbet/rbi/dsl/cask/url.rbi', line 51

def trust_cert; end

#unversioned?(ignore_major_version: false) ⇒ Boolean

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Parameters:

• ignore_major_version (Boolean) (defaults to: false)

Returns:

• (Boolean)

# File 'cask/url.rb', line 242

def unversioned?(ignore_major_version: false)
  interpolated_url = raw_url_line&.then { |line| line[/url\s+"([^"]+)"/, 1] }

  return false unless interpolated_url

  interpolated_url = interpolated_url.gsub(/\#{\s*arch\s*}/, "")
  interpolated_url = interpolated_url.gsub(/\#{\s*version\s*\.major\s*}/, "") if ignore_major_version

  interpolated_url.exclude?('#{')
end

#uri ⇒ ::String, ::URI::Generic

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:

• (::String, ::URI::Generic)

# File 'sorbet/rbi/dsl/cask/url.rbi', line 54

def uri; end

#user_agent ⇒ ::String, ...

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:

• (::String, ::Symbol, nil)

# File 'sorbet/rbi/dsl/cask/url.rbi', line 57

def user_agent; end

#using ⇒ ::Symbol, ...

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:

• (::Symbol, T::Class[::AbstractDownloadStrategy], nil)

# File 'sorbet/rbi/dsl/cask/url.rbi', line 60

def using; end

#verified ⇒ T.untyped

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.

Returns:

• (T.untyped)

# File 'sorbet/rbi/dsl/cask/url.rbi', line 63

def verified; end