Module: PyPI

Defined in:
brew/Library/Homebrew/utils/pypi.rb

Constant Summary collapse

PYTHONHOSTED_URL_PREFIX =
"https://files.pythonhosted.org/packages/"
AUTOMATIC_RESOURCE_UPDATE_BLOCKLIST =
%w[
  ansible
  ansible@2.8
  cloudformation-cli
  diffoscope
  dxpy
  molecule
].freeze

Class Method Summary collapse

Class Method Details

.get_pypi_info(package, version) ⇒ Object

Get name, url and sha256 for a given pypi package



34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
# File 'brew/Library/Homebrew/utils/pypi.rb', line 34

def get_pypi_info(package, version)
   = "https://pypi.org/pypi/#{package}/#{version}/json"
  out, _, status = curl_output , "--location"

  return unless status.success?

  begin
    json = JSON.parse out
  rescue JSON::ParserError
    return
  end

  sdist = json["urls"].find { |url| url["packagetype"] == "sdist" }
  return json["info"]["name"] if sdist.nil?

  [json["info"]["name"], sdist["url"], sdist["digests"]["sha256"]]
end

.update_pypi_url(url, version) ⇒ Object



25
26
27
28
29
30
31
# File 'brew/Library/Homebrew/utils/pypi.rb', line 25

def update_pypi_url(url, version)
  package = url_to_pypi_package_name url
  return if package.nil?

  _, url = get_pypi_info(package, version)
  url
end

.update_python_resources!(formula, version = nil, print_only: false, silent: false, ignore_non_pypi_packages: false) ⇒ Object



52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
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
140
141
142
143
144
145
146
147
148
149
150
151
152
# File 'brew/Library/Homebrew/utils/pypi.rb', line 52

def update_python_resources!(formula, version = nil, print_only: false, silent: false,
                             ignore_non_pypi_packages: false)

  if !print_only && AUTOMATIC_RESOURCE_UPDATE_BLOCKLIST.include?(formula.full_name)
    odie "The resources for \"#{formula.name}\" need special attention. Please update them manually."
    return
  end

  # PyPI package name isn't always the same as the formula name. Try to infer from the URL.
  pypi_name = if formula.stable.url.start_with?(PYTHONHOSTED_URL_PREFIX)
    url_to_pypi_package_name formula.stable.url
  else
    formula.name
  end

  version ||= formula.version

  if get_pypi_info(pypi_name, version).blank?
    odie "\"#{pypi_name}\" at version #{version} is not available on PyPI." unless ignore_non_pypi_packages
    return
  end

  non_pypi_resources = formula.resources.reject do |resource|
    resource.url.start_with? PYTHONHOSTED_URL_PREFIX
  end

  if non_pypi_resources.present? && !print_only
    odie "\"#{formula.name}\" contains non-PyPI resources. Please update the resources manually."
  end

  @pipgrip_installed ||= Formula["pipgrip"].any_version_installed?
  odie '"pipgrip" must be installed (`brew install pipgrip`)' unless @pipgrip_installed

  ohai "Retrieving PyPI dependencies for \"#{pypi_name}==#{version}\"..." if !print_only && !silent
  pipgrip_output = Utils.popen_read Formula["pipgrip"].bin/"pipgrip", "--json", "--no-cache-dir",
                                    "#{pypi_name}==#{version}"
  unless $CHILD_STATUS.success?
    odie <<~EOS
      Unable to determine dependencies for \"#{pypi_name}\" because of a failure when running
      `pipgrip --json --no-cache-dir #{pypi_name}==#{version}`.
      Please update the resources for \"#{formula.name}\" manually.
    EOS
  end

  packages = JSON.parse(pipgrip_output).sort.to_h

  # Remove extra packages that may be included in pipgrip output
  exclude_list = %W[#{pypi_name} argparse pip setuptools wheel wsgiref]
  packages.delete_if do |package|
    exclude_list.include? package
  end

  new_resource_blocks = ""
  packages.each do |package, package_version|
    ohai "Getting PyPI info for \"#{package}==#{package_version}\"" if !print_only && !silent
    name, url, checksum = get_pypi_info package, package_version
    # Fail if unable to find name, url or checksum for any resource
    if name.blank?
      odie "Unable to resolve some dependencies. Please update the resources for \"#{formula.name}\" manually."
    elsif url.blank? || checksum.blank?
      odie <<~EOS
        Unable to find the URL and/or sha256 for the \"#{name}\" resource.
        Please update the resources for \"#{formula.name}\" manually.
      EOS
    end

    # Append indented resource block
    new_resource_blocks += <<-EOS
resource "#{name}" do
  url "#{url}"
  sha256 "#{checksum}"
end

    EOS
  end

  if print_only
    puts new_resource_blocks.chomp
    return
  end

  # Check whether resources already exist (excluding homebrew-virtualenv)
  if formula.resources.blank? ||
     (formula.resources.length == 1 && formula.resources.first.name == "homebrew-virtualenv")
    # Place resources above install method
    inreplace_regex = /  def install/
    new_resource_blocks += "  def install"
  else
    # Replace existing resource blocks with new resource blocks
    inreplace_regex = /  (resource .* do\s+url .*\s+sha256 .*\s+ end\s*)+/
    new_resource_blocks += "  "
  end

  ohai "Updating resource blocks" unless silent
  Utils::Inreplace.inreplace formula.path do |s|
    if s.inreplace_string.scan(inreplace_regex).length > 1
      odie "Unable to update resource blocks for \"#{formula.name}\" automatically. Please update them manually."
    end
    s.sub! inreplace_regex, new_resource_blocks
  end
end

.url_to_pypi_package_name(url) ⇒ Object



19
20
21
22
23
# File 'brew/Library/Homebrew/utils/pypi.rb', line 19

def url_to_pypi_package_name(url)
  return unless url.start_with? PYTHONHOSTED_URL_PREFIX

  File.basename(url).match(/^(.+)-[a-z\d.]+$/)[1]
end