From c8561f901aa5c2e4e9c82a51d3b0008a802bb110 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Romain=20Tarti=C3=A8re?= <romain@blogreen.org>
Date: Tue, 19 Aug 2025 06:49:56 -1000
Subject: [PATCH] Add a utility script to bump supported OS versions

Add support for a newer version of an Operating System if the previous
version is supported.  Update metadata.json, create a feature branch,
commit, and open a PR automatically.

If the previous version was not supported but older version are, prompt
the user interactively for what to do.

If the OS is not supported at all, do nothing.

Typical usage (when Debian 13 is released):

```
bundle exec msync execute -B -- git pull
bundle exec msync execute -B -- $PWD/bin/add-support-for-new-os -o Debian -v 13
```
---
 bin/add-support-for-new-os | 151 +++++++++++++++++++++++++++++++++++++
 1 file changed, 151 insertions(+)
 create mode 100755 bin/add-support-for-new-os

diff --git a/bin/add-support-for-new-os b/bin/add-support-for-new-os
new file mode 100755
index 00000000..c83cb269
--- /dev/null
+++ b/bin/add-support-for-new-os
@@ -0,0 +1,151 @@
+#!/usr/bin/env ruby
+#
+# Add support for a newer version of an Operating System if the previous
+# version is supported.  Update metadata.json, create a feature branch, commit,
+# and open a PR automatically.
+# If the previous version was not supported but older version are, prompt the
+# user interactively for what to do.
+# If the OS is not supported at all, do nothing.
+#
+# Typical usage (when Debian 13 is released):
+#
+#     bundle exec msync execute -B -- git pull
+#     bundle exec msync execute -B -- $PWD/bin/add-support-for-new-os -o Debian -v 13
+
+require 'json'
+require 'optparse'
+
+require 'tty-prompt'
+
+class Options
+  attr_accessor :os, :version
+  attr_writer :noop, :interactive
+
+  def initialize
+    @noop = false
+  end
+
+  def branch_name
+    @branch_name ||= "#{os.downcase}-#{version}"
+  end
+
+  def noop?
+    @noop
+  end
+
+  def interactive?
+    @interactive
+  end
+
+  def previous_version
+    (version.to_i - 1).to_s
+  end
+end
+
+pastel = Pastel.new
+
+options = Options.new
+
+OptionParser.new do |opts|
+  opts.banner = "Usage: #{$PROGRAM_NAME} -o <os> -v <version>"
+
+  opts.on("-o", "--operating-system=VALUE", "The name of the Operating System to operate on (e.g. Debian)") do |os|
+    options.os = os
+  end
+
+  opts.on("-v", "--version=VALUE", "The version of the Operating System to add (e.g. 12)") do |version|
+    options.version = version
+  end
+
+  opts.on("--interactive", "Ask before doing an update") do |interactive|
+    options.interactive = interactive
+  end
+
+  opts.on("--noop", "Do not perform anything, show what would be done") do |noop|
+    options.noop = noop
+  end
+end.parse!
+
+if !options.os || !options.version
+  puts(pastel.red("An Operating System name and a version must be provided"))
+  exit 1
+end
+
+if !File.exist?('metadata.json')
+  puts(pastel.cyan("No metadata file.  Nothing to do."))
+  exit 0
+end
+
+metadata = JSON.parse(File.read('metadata.json'))
+
+os_metadata = metadata['operatingsystem_support']
+unless os_metadata
+  puts(pastel.cyan("Module does not claim any operating system support.  Nothing to do."))
+  exit 0
+end
+
+os_metadata = os_metadata.select { |os| os['operatingsystem'] == options.os }.first
+
+unless os_metadata
+  puts(pastel.cyan("Module does not support #{options.os}.  Nothing to do."))
+  exit 0
+end
+
+if os_metadata['operatingsystemrelease'].nil? || os_metadata['operatingsystemrelease'].empty?
+  puts(pastel.cyan("Module support #{options.os} but does not define versions.  Nothing to do."))
+  exit 0
+end
+
+if os_metadata['operatingsystemrelease'].include?(options.version)
+  puts(pastel.cyan("Module already support #{options.os} #{options.version}.  Nothing to do."))
+  exit 0
+end
+
+if os_metadata['operatingsystemrelease'].all? { |v| options.version.to_i < v.to_i }
+  puts(pastel.cyan("Module support only newer versions of #{options.os} (#{os_metadata['operatingsystemrelease'].join(', ')}).  Ignoring."))
+  exit 0
+end
+
+puts(pastel.cyan("Module does not support #{options.os} #{options.version} (it supports #{os_metadata['operatingsystemrelease'].join(', ')})."))
+
+if options.interactive?
+  $stdout.write pastel.yellow("\nAdd support for #{options.os} #{options.version} [yN]")
+  unless TTY::Prompt.new.read_keypress == 'y'
+    puts
+    puts(pastel.cyan("Nothing to do."))
+    exit 0
+  end
+  puts
+end
+
+unless os_metadata['operatingsystemrelease'].include?(options.previous_version)
+  puts(pastel.red("Module does not support #{options.os} #{options.previous_version} neither!"))
+  $stdout.write pastel.yellow("Does it make sense to add support for #{options.os} #{options.version} [yN]")
+  unless TTY::Prompt.new.read_keypress == 'y'
+    puts
+    puts(pastel.cyan("Nothing to do."))
+    exit 0
+  end
+  puts
+end
+
+puts(pastel.green("Adding support for #{options.os} #{options.version}..."))
+
+os_index = metadata['operatingsystem_support'].map { |os| os['operatingsystem'] }.index(options.os)
+
+metadata['operatingsystem_support'][os_index]['operatingsystemrelease'] << options.version
+
+pp_metadata = JSON.pretty_generate(metadata)
+
+if options.noop?
+  r, w = IO.pipe
+  w.puts(pp_metadata)
+  w.close
+  system "diff", "-u", "metadata.json", "-", in: r
+else
+  system "git", "checkout", "-b", options.branch_name
+  File.write('metadata.json', "#{pp_metadata}\n")
+  system "git", "add", "metadata.json"
+  system "git", "commit", "-m", "Add support for #{options.os} #{options.version}"
+  system "gh", "pr", "create", "--fill", "--draft", "--label", "enhancement"
+end