Class: LicenseFinder::Package

Inherits:
Object
  • Object
show all
Defined in:
lib/license_finder/package.rb

Overview

Super-class that adapts data from different package management systems (gems, npm, pip, etc.) to a common interface.

Guidance on adding a new system

  • subclass Package, and initialize based on the data you receive from the package manager

  • if the package specs will report license names, pass :spec_licenses in the constructor options

  • if the package’s files can be searched for licenses pass :install_path in the constructor options

  • otherwise, override #licenses_from_spec or #license_files

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(name, version = nil, options = {}) ⇒ Package

Returns a new instance of Package.



32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
 
# File 'lib/license_finder/package.rb', line 32

def initialize(name, version = nil, options={})
  @logger = options[:logger] || Core.default_logger

  ## DESCRIPTION
  @name = name
  @version = version
  @authors = options[:authors] || ""
  @summary = options[:summary] || ""
  @description = options[:description] || ""
  @homepage = options[:homepage] || ""
  @children = options[:children] || []
  @parents = Set.new # will be figured out later by package manager
  @groups = options[:groups] || []

  ## APPROVAL
  @whitelisted = false
  @blacklisted = false
  @manual_approval = nil

  ## LICENSING
  @license_names_from_spec = options[:spec_licenses] || []
  @install_path = options[:install_path]
  @missing = options[:missing] || false
  @decided_licenses = Set.new
end

Instance Attribute Details

#authors ⇒ Object (readonly)

DESCRIPTION



60
61
62
 
# File 'lib/license_finder/package.rb', line 60

def authors
  @authors
end

#children ⇒ Object (readonly)

DESCRIPTION



60
61
62
 
# File 'lib/license_finder/package.rb', line 60

def children
  @children
end

#description ⇒ Object (readonly)

DESCRIPTION



60
61
62
 
# File 'lib/license_finder/package.rb', line 60

def description
  @description
end

#groups ⇒ Object (readonly)

DESCRIPTION



60
61
62
 
# File 'lib/license_finder/package.rb', line 60

def groups
  @groups
end

#homepage ⇒ Object (readonly)

DESCRIPTION



60
61
62
 
# File 'lib/license_finder/package.rb', line 60

def homepage
  @homepage
end

#install_path ⇒ Object (readonly)

checked in tests, otherwise private



118
119
120
 
# File 'lib/license_finder/package.rb', line 118

def install_path
  @install_path
end

#license_names_from_spec ⇒ Object (readonly)

LICENSING



117
118
119
 
# File 'lib/license_finder/package.rb', line 117

def license_names_from_spec
  @license_names_from_spec
end

#logger ⇒ Object (readonly)

Returns the value of attribute logger.



18
19
20
 
# File 'lib/license_finder/package.rb', line 18

def logger
  @logger
end

#manual_approval ⇒ Object (readonly)

Returns the value of attribute manual_approval.



97
98
99
 
# File 'lib/license_finder/package.rb', line 97

def manual_approval
  @manual_approval
end

#name ⇒ Object (readonly)

DESCRIPTION



60
61
62
 
# File 'lib/license_finder/package.rb', line 60

def name
  @name
end

#parents ⇒ Object (readonly)

DESCRIPTION



60
61
62
 
# File 'lib/license_finder/package.rb', line 60

def parents
  @parents
end

#summary ⇒ Object (readonly)

DESCRIPTION



60
61
62
 
# File 'lib/license_finder/package.rb', line 60

def summary
  @summary
end

#version ⇒ Object (readonly)

DESCRIPTION



60
61
62
 
# File 'lib/license_finder/package.rb', line 60

def version
  @version
end

Class Method Details

.license_names_from_standard_spec(spec) ⇒ Object 



20
21
22
23
24
25
26
27
28
29
30
 
# File 'lib/license_finder/package.rb', line 20

def self.license_names_from_standard_spec(spec)
  licenses = spec["licenses"] || [spec["license"]].compact
  licenses = [licenses] unless licenses.is_a?(Array)
  licenses.map do |license|
    if license.is_a? Hash
      license["type"]
    else
      license
    end
  end
end

Instance Method Details

#<=>(other) ⇒ Object

EQUALITY



101
102
103
104
105
 
# File 'lib/license_finder/package.rb', line 101

def <=>(other)
  eq_name = name <=> other.name
  return eq_name unless eq_name == 0
  version <=> other.version
end

#activations ⇒ Object 



124
125
126
127
128
 
# File 'lib/license_finder/package.rb', line 124

def activations
  licensing.activations.tap do |activations|
    activations.each { |activation| logger.activation(activation) }
  end
end

#approved? ⇒ Boolean

Returns:

  • (Boolean) 


74
75
76
77
78
79
 
# File 'lib/license_finder/package.rb', line 74

def approved?
  # Question: is `!blacklisted?` redundant?
  # DecisionApplier does not call `whitelisted!` or `approved_manually!`
  # if a Package has been blacklisted.
  (approved_manually? || whitelisted?) && !blacklisted?
end

#approved_manually!(approval) ⇒ Object

APPROVAL



66
67
68
 
# File 'lib/license_finder/package.rb', line 66

def approved_manually!(approval)
  @manual_approval = approval
end

#approved_manually? ⇒ Boolean

Returns:

  • (Boolean) 


70
71
72
 
# File 'lib/license_finder/package.rb', line 70

def approved_manually?
  !@manual_approval.nil?
end

#blacklisted! ⇒ Object 



89
90
91
 
# File 'lib/license_finder/package.rb', line 89

def blacklisted!
  @blacklisted = true
end

#blacklisted? ⇒ Boolean

Returns:

  • (Boolean) 


93
94
95
 
# File 'lib/license_finder/package.rb', line 93

def blacklisted?
  @blacklisted
end

#decide_on_license(license) ⇒ Object 



134
135
136
 
# File 'lib/license_finder/package.rb', line 134

def decide_on_license(license)
  @decided_licenses << license
end

#eql?(other) ⇒ Boolean

Returns:

  • (Boolean) 


107
108
109
 
# File 'lib/license_finder/package.rb', line 107

def eql?(other)
  name == other.name && version == other.version
end

#hash ⇒ Object 



111
112
113
 
# File 'lib/license_finder/package.rb', line 111

def hash
  [name,version].hash
end

#license_files ⇒ Object 



144
145
146
 
# File 'lib/license_finder/package.rb', line 144

def license_files
  LicenseFiles.find(install_path)
end

#licenses ⇒ Object 



120
121
122
 
# File 'lib/license_finder/package.rb', line 120

def licenses
  @licenses ||= activations.map(&:license).to_set
end

#licenses_from_spec ⇒ Object 



138
139
140
141
142
 
# File 'lib/license_finder/package.rb', line 138

def licenses_from_spec
  license_names_from_spec
    .map { |name| License.find_by_name(name) }
    .to_set
end

#licensing ⇒ Object 



130
131
132
 
# File 'lib/license_finder/package.rb', line 130

def licensing
  Licensing.new(self, @decided_licenses, licenses_from_spec, license_files)
end

#missing? ⇒ Boolean

Returns:

  • (Boolean) 


152
153
154
 
# File 'lib/license_finder/package.rb', line 152

def missing?
  @missing
end

#package_manager ⇒ Object 



148
149
150
 
# File 'lib/license_finder/package.rb', line 148

def package_manager
  "unknown"
end

#whitelisted! ⇒ Object 



81
82
83
 
# File 'lib/license_finder/package.rb', line 81

def whitelisted!
  @whitelisted = true
end

#whitelisted? ⇒ Boolean

Returns:

  • (Boolean) 


85
86
87
 
# File 'lib/license_finder/package.rb', line 85

def whitelisted?
  @whitelisted
end