Alpine package version #11591

#!/usr/bin/env python3
#
#  Get Alpine Package Details
#
#  Downloads  and parses the APKINDEX file from the Alpine Linux repository
#  and extracts the metadata for any matching package(s).
#
#  Copyright(C) 2025 - MT
#
#  This  program is free software: you can redistribute it and/or modify it
#  under  the terms of the GNU General Public License as published  by  the
#  Free  Software Foundation, either version 3 of the License, or (at  your
#  option) any later version.
#
#  This  program  is distributed in the hope that it will  be  useful,  but
#  WITHOUT   ANY   WARRANTY;   without even   the   implied   warranty   of
#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
#  Public License for more details.
#
#  You  should have received a copy of the GNU General Public License along
#  with this program.  If not, see <http://www.gnu.org/licenses/>.
#
#  24 Dec 25  0.1.0001  - Initial version - MT
#

import io, sys, os, json, tarfile
from urllib import request
from fnmatch import fnmatch

def get_alpine_package_details(pattern, repository="main", release="latest-stable", arch="x86_64"):  # Sensible defaults...
   url = "https://dl-cdn.alpinelinux.org/alpine/" + release + "/" + repository + "/" + arch + "/APKINDEX.tar.gz"  # URL for package information
   try:
      resp = request.urlopen(url, timeout=15)  # Fetch the tar.gz achive from Alpine mirror (with timeout)
      data = resp.read()
   except Exception as error:
      raise RuntimeError("Failed to fetch URL " + url + "\n" + str(error))
      # return [{"error": "Failed to fetch URL", "url": url, "reason": str(error)}]  # Return error as JSON
   try:
      with tarfile.open(fileobj=io.BytesIO(data), mode="r:gz") as archive:  # Open the tar.gz archive in memory
         index = archive.extractfile("APKINDEX")  # Extract package index file
         if index is None:  # File not found in archive
            raise RuntimeError("APKINDEX not found in archive")  # Throw an error
            # return [{"error": "APKINDEX not found in archive"}]  # Return error as JSON
         data = index.read().decode("utf-8", "ignore")  # Read contents of package index
   except Exception as error:
      raise RuntimeError("Failed to parse APKINDEX "+ str(error))  # Throw an error
      # return [{"error": "Failed to parse APKINDEX", "reason": str(error)}]  # Return error as JSON
   results = []  # Details of all matching packages
   pkg = {}  # Dictionary to hold current package details
   found = False
   for line in data.splitlines():  # Parse package details line by line
      if line.startswith("P:"):  # It is a package name
         if found:  # If we already found a package, append it to the results before starting the next
            results.append(pkg)
            pkg = {}
            found = False
         name = line[2:].strip()  # Extract package name
         if fnmatch(name, pattern):  # Check if the package name matches the pattern
            found = True
            pkg["name"] = name
      elif found and line.startswith("V:"):  # Package version
         pkg["version"] = "v" + line[2:].strip().split("-", 1)[0]  # Ignore anything after a '-'
      elif found and line.startswith("T:"):  # Package text (description)
         pkg["description"] = line[2:].strip()
      elif found and line.startswith("L:"):  # Package licence
         pkg["license"] = line[2:].strip()
      elif found and line.startswith("U:"):  # Package URL
         pkg["url"] = line[2:].strip()
      elif not line.strip() and found:
         results.append(pkg)  # End of package detals append it to results
         pkg = {}
         found = False
   if found and pkg:  # Append the last package (if file ends without a blank line)
      results.append(pkg)
   return results

if __name__ == "__main__":
   if len(sys.argv) < 2:  # Require at least one argument
      sys.exit("Usage: " + os.path.basename(sys.argv[0]) + " <package> [repository] [release] [archecture]")
   try:
      pkg = get_alpine_package_details(*sys.argv[1:])  # Expand all command-line arguments and pass to get_alpine_package_details()
      sys.stderr.write(json.dumps(pkg, indent=2) + "\n")  # Print results as JSON
   except Exception as error:
      # raise error
      sys.stderr.write("Error: " + str(error) + "\n")