Class: Bibliothecary::Dependency

Inherits:
Object
  • Object
show all
Defined in:
lib/bibliothecary/dependency.rb

Overview

Dependency represents a single unique dependency that was parsed out of a manifest.

Constant Summary collapse

FIELDS = 
i[
  name
  requirement
  original_requirement
  platform
  type
  direct
  deprecated
  local
  optional
  original_name
  source
].freeze

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(name:, requirement:, original_requirement: nil, platform: nil, type: nil, direct: nil, deprecated: nil, local: nil, optional: nil, original_name: nil, source: nil) ⇒ Dependency 



40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
 
# File 'lib/bibliothecary/dependency.rb', line 40

def initialize(
  name:,
  requirement:,
  original_requirement: nil,
  platform: nil,
  type: nil,
  direct: nil,
  deprecated: nil,
  local: nil,
  optional: nil,
  original_name: nil,
  source: nil
)
  @name = name
  @platform = platform
  @requirement = requirement || "*"
  @original_requirement = original_requirement
  @type = type
  @direct = direct
  @deprecated = deprecated
  @local = local
  @optional = optional
  @original_name = original_name
  @source = source
end

Instance Attribute Details

#deprecated ⇒ Boolean (readonly)

Is this dependency deprecated? (default: nil)



23
24
25
 
# File 'lib/bibliothecary/dependency.rb', line 23

def deprecated
  @deprecated
end

#direct ⇒ Boolean (readonly)

Is this dependency a direct dependency (vs transitive dependency)? (default: nil)



23
24
25
 
# File 'lib/bibliothecary/dependency.rb', line 23

def direct
  @direct
end

#local ⇒ Boolean (readonly)

Is this dependency local? (default: nil)



23
24
25
 
# File 'lib/bibliothecary/dependency.rb', line 23

def local
  @local
end

#name ⇒ String (readonly)

The name of the package, e.g. “ansi-string-colors”



23
24
25
 
# File 'lib/bibliothecary/dependency.rb', line 23

def name
  @name
end

#optional ⇒ Boolean (readonly)

Is this dependency optional? (default: nil)



23
24
25
 
# File 'lib/bibliothecary/dependency.rb', line 23

def optional
  @optional
end

#original_name ⇒ String (readonly)

The original name used to require the dependency, for cases where it did not match the resolved name. This can be used for features like aliasing.



23
24
25
 
# File 'lib/bibliothecary/dependency.rb', line 23

def original_name
  @original_name
end

#original_requirement ⇒ String (readonly)

The original requirement used to require the dependency, for cases where it did not match the resolved name. This can be used for features like aliasing.



23
24
25
 
# File 'lib/bibliothecary/dependency.rb', line 23

def original_requirement
  @original_requirement
end

#platform ⇒ String (readonly)

The platform of the package, e.g. “maven”. This is optional because it’s implicit in most parser results, and the analyzer returns the platform name itself. One exception are multi-parsers like DependenciesCSV, because they may return deps from multiple platforms. Bibliothecary could start returning this field for all deps in future, and make it required. (default: nil)



23
24
25
 
# File 'lib/bibliothecary/dependency.rb', line 23

def platform
  @platform
end

#requirement ⇒ String (readonly)

The version requirement of the release, e.g. “1.0.0” or “^1.0.0”



23
24
25
 
# File 'lib/bibliothecary/dependency.rb', line 23

def requirement
  @requirement
end

#type ⇒ String (readonly)

The type of dependency, e.g. “runtime” or “test”



23
24
25
 
# File 'lib/bibliothecary/dependency.rb', line 23

def type
  @type
end

Instance Method Details

#[](key) ⇒ Object 



71
72
73
 
# File 'lib/bibliothecary/dependency.rb', line 71

def [](key)
  public_send(key)
end

#eql?(other) ⇒ Boolean Also known as: == 



66
67
68
 
# File 'lib/bibliothecary/dependency.rb', line 66

def eql?(other)
  FIELDS.all? { |f| public_send(f) == other.public_send(f) }
end

#hash ⇒ Object 



79
80
81
 
# File 'lib/bibliothecary/dependency.rb', line 79

def hash
  FIELDS.map { |f| public_send(f) }.hash
end

#to_h ⇒ Object 



75
76
77
 
# File 'lib/bibliothecary/dependency.rb', line 75

def to_h
  FIELDS.to_h { |f| [f, public_send(f)] }
end