rosett-ai 1.3.3

data/lib/scripts/generated/docker_hub_tags.rb

@@ -0,0 +1,126 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# SPDX-License-Identifier: GPL-3.0-only
+
+# =============================================================================
+# Docker Hub Tag Query Utility
+# =============================================================================
+# Queries the Docker Hub Registry API v2 for available image tags.
+# Useful for verifying Ruby image availability before CI pipeline changes.
+#
+# Usage:
+#   ruby docker_hub_tags.rb --image ruby --version 3.3.10 --distro bookworm
+#   ruby docker_hub_tags.rb --image ruby --list
+#
+# Copyright (C) 2026 NeatNerds
+# =============================================================================
+
+require 'json'
+require 'net/http'
+require 'uri'
+require 'optparse'
+
+# Queries Docker Hub Registry API v2 for official image tags.
+module DockerHub
+  REGISTRY_API = 'https://registry.hub.docker.com/v2'
+  PAGE_SIZE = 100
+
+  # Fetch tags for a library (official) image from Docker Hub.
+  # Returns an array of tag name strings.
+  def self.fetch_tags(image, page_size: PAGE_SIZE)
+    url = "#{REGISTRY_API}/repositories/library/#{image}/tags?page_size=#{page_size}"
+    collect_all_pages(url)
+  end
+
+  # Check whether a specific tag exists for an image.
+  def self.tag_exists?(image, tag)
+    uri = URI.parse("#{REGISTRY_API}/repositories/library/#{image}/tags/#{tag}")
+    response = Net::HTTP.get_response(uri)
+    response.is_a?(Net::HTTPSuccess)
+  end
+
+  # Fetch a single page of tags from the API. Returns [tag_names, next_url].
+  def self.fetch_page(url)
+    response = Net::HTTP.get_response(URI.parse(url))
+    unless response.is_a?(Net::HTTPSuccess)
+      warn "HTTP #{response.code}: #{response.message}"
+      return [[], nil]
+    end
+
+    data = JSON.parse(response.body)
+    [data['results'].map { |entry| entry['name'] }, data['next']]
+  end
+
+  # Paginate through Docker Hub API results, collecting tag names.
+  def self.collect_all_pages(url)
+    tags = []
+    while url
+      page_tags, url = fetch_page(url)
+      tags.concat(page_tags)
+    end
+    tags
+  end
+
+  private_class_method :collect_all_pages, :fetch_page
+end
+
+if __FILE__ == $PROGRAM_NAME
+  options = { image: 'ruby' }
+
+  parser = OptionParser.new do |opts|
+    opts.banner = "Usage: #{$PROGRAM_NAME} [options]"
+
+    opts.on('--image IMAGE', 'Docker Hub image name (default: ruby)') do |val|
+      options[:image] = val
+    end
+
+    opts.on('--version VERSION', 'Ruby version to check (e.g. 3.3.10)') do |val|
+      options[:version] = val
+    end
+
+    opts.on('--distro DISTRO', 'Debian release codename (e.g. bookworm)') do |val|
+      options[:distro] = val
+    end
+
+    opts.on('--list', 'List all available tags') do
+      options[:list] = true
+    end
+
+    opts.on('--filter PATTERN', 'Filter tags by substring') do |val|
+      options[:filter] = val
+    end
+
+    opts.on('-h', '--help', 'Show this help') do
+      puts opts
+      exit
+    end
+  end
+
+  parser.parse!
+
+  if options[:list]
+    tags = DockerHub.fetch_tags(options[:image])
+    tags = tags.select { |entry| entry.include?(options[:filter]) } if options[:filter]
+    tags.each { |entry| puts entry }
+    exit
+  end
+
+  if options[:version]
+    tag = if options[:distro]
+            "#{options[:version]}-#{options[:distro]}"
+          else
+            options[:version]
+          end
+
+    if DockerHub.tag_exists?(options[:image], tag)
+      puts "OK: #{options[:image]}:#{tag} exists on Docker Hub"
+      exit 0
+    else
+      warn "NOT FOUND: #{options[:image]}:#{tag}"
+      exit 1
+    end
+  end
+
+  puts parser
+end