captive-release 0.15.0 → 0.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 615663c58dbf71da94afba56edf11a7c269c288e419458ab147109174cb32b70
-  data.tar.gz: c00fa194187b633dd2b2560cb14f5fce0b9de2247734c3f5cb1caf8ba23cbade
+  metadata.gz: 6aec56835e050f42afb89b87243974752868add0b16f258291845acce96f8e75
+  data.tar.gz: bdfc4aeba04e48e427938799f76aeb5e172bc4d7894955a9ad470030e12696a0
 SHA512:
-  metadata.gz: 98ec33d80bc912c27c262225173c783aa94d34013219377dab148ce633f975f14cd8214e17d7e25608d03ea79c8b2bcde1b3549840ada1665881a2448bd7170e
-  data.tar.gz: 516607116274624df99f5a98ce15cf13881e1fb75d697fc7e451eb8258f1b14fcede77c5855fb3045bcb78f51755c484fd7f9c7b25876bebd16a6a264d7cefa2
+  metadata.gz: ec482bf2fa5e0fa0eb93f23229ab9c9b2c1881965911c8636aaf1a07532b998cd89c0c37c4bbea2f607ab65e16a55123560b318cec9dcf379274b18665ae3f10
+  data.tar.gz: 712f8c60ac915352808867261630b3014b2aa42e9e7cb0f28a3421d6471ea06886faf396fb6215c372f9eb3d766f943626f15456b065836992a69c5ad34b0d2d

data/lib/captive_release/arrow_select.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module CaptiveRelease
+  # Le choix au clavier : ↑/↓ déplacent le curseur, Entrée valide, et rend le rang choisi.
+  #
+  # Cette unité change quand le geste au clavier ou son rendu change, Menu quand la façon de
+  # choisir entre ce geste et la liste numérotée change.
+  class ArrowSelect
+    MOUVEMENTS = { up: -1, down: 1 }.freeze
+
+    def initialize(terminal:, keys:)
+      @terminal = terminal
+      @keys     = keys
+    end
+
+    def call(libelles)
+      rang = 0
+      loop do
+        draw(libelles, rang)
+        touche = @keys.read
+        return rang if touche == :enter
+
+        rang = (rang + MOUVEMENTS.fetch(touche, 0)) % libelles.size
+        # Remonte d'autant de lignes que le menu en occupe, pour le redessiner sur place.
+        @terminal.prompt "\e[#{libelles.size}A\e[J"
+      end
+    end
+
+    private
+
+    def draw(libelles, choisi)
+      libelles.each_with_index do |libelle, rang|
+        @terminal.say rang == choisi ? @terminal.ok("  › #{libelle}") : "    #{@terminal.dim(libelle)}"
+      end
+    end
+  end
+end

data/lib/captive_release/build_config_prompt.rb

@@ -11,11 +11,9 @@ module CaptiveRelease
     end
 
     def call(framework, workflow_par_defaut)
-      @terminal.say "\n#{@terminal.bold(Messages.t(:framework_detected, framework: framework))} " \
-                    "#{Messages.t(:configure_build)}\n"
-      @terminal.say "  #{@terminal.dim("1)")} #{Messages.t(:yes)}"
-      @terminal.say "  #{@terminal.dim("2)")} #{Messages.t(:no)}"
-      return nil unless @terminal.ask_choice == 1
+      titre = "\n#{@terminal.bold(Messages.t(:framework_detected, framework: framework))} " \
+              "#{Messages.t(:configure_build)}"
+      return nil unless Menu.new(terminal: @terminal).choose(titre, Messages.t(:yes) => true, Messages.t(:no) => false)
 
       BuildConfig.new(build_workflow: workflow(workflow_par_defaut))
     end

data/lib/captive_release/key_reader.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require "io/console"
+
+module CaptiveRelease
+  # Le clavier touche par touche, en mode raw, pour le sélecteur à flèches.
+  #
+  # Cette unité change quand la lecture des touches change, Terminal quand l'habillage ou la
+  # saisie ligne à ligne change.
+  class KeyReader
+    KEYS = { "\e[A" => :up, "\e[B" => :down, "\r" => :enter, "\n" => :enter, "k" => :up, "j" => :down }.freeze
+
+    # Une flèche arrive d'un bloc en trois octets (`\e[A`) : les lire en une fois évite
+    # d'attendre une suite qui ne viendrait pas après un Échap seul.
+    RAFALE = 3
+
+    def initialize(input: $stdin, output: $stdout)
+      @input  = input
+      @output = output
+    end
+
+    # Le mode raw exige un vrai terminal des deux côtés. Ailleurs (CI, pipe, specs), le menu
+    # numéroté prend le relais.
+    def interactive? = @input.tty? && @output.tty?
+
+    # :up, :down, :enter, ou le caractère lu. Ctrl-C reste une interruption, le mode raw
+    # l'ayant sinon avalé.
+    def read
+      touche = @input.raw { |io| io.readpartial(RAFALE) }
+      raise Interrupt if touche == "\u0003"
+
+      KEYS.fetch(touche, touche)
+    end
+  end
+end

data/lib/captive_release/menu.rb

@@ -3,28 +3,31 @@
 module CaptiveRelease
   # Une liste numérotée, un choix, et le refus de ce qui n'est pas dans la liste.
   #
-  # Un rang négatif est refusé comme un rang trop grand : sans cette garde, une saisie non
+  # Un rang hors liste est refusé, négatif compris : sans cette garde, une saisie non
   # numérique vaut 0, donc l'indice -1, et Ruby rendait silencieusement la dernière entrée.
+  # Dans un terminal, le choix se fait aux flèches (ArrowSelect) et ne peut sortir de la liste.
   class Menu
-    def initialize(terminal:)
+    def initialize(terminal:, keys: KeyReader.new)
       @terminal = terminal
+      @keys     = keys
     end
 
     # entries : un Hash {libellé affiché => valeur rendue}, dans l'ordre d'affichage.
     def choose(title, entries)
       @terminal.say "#{title}\n"
-      entries.each_key.with_index do |libelle, rang|
-        @terminal.say "  #{@terminal.dim("#{rang + 1})")} #{libelle}"
-      end
-
-      rang = @terminal.ask_choice - 1
-      refuse if rang.negative? || rang >= entries.size
-
-      entries.values[rang]
+      libelles = entries.keys
+      entries.values[@keys.interactive? ? ArrowSelect.new(terminal: @terminal, keys: @keys).call(libelles) : numbered(libelles)]
     end
 
     private
 
+    def numbered(libelles)
+      libelles.each_with_index { |libelle, rang| @terminal.say "  #{@terminal.dim("#{rang + 1})")} #{libelle}" }
+      rang = @terminal.ask_choice - 1
+      refuse unless rang.between?(0, libelles.size - 1)
+      rang
+    end
+
     def refuse
       @terminal.say @terminal.error(Messages.t(:invalid_choice))
       exit 1

data/lib/captive_release/terminal.rb

@@ -6,9 +6,12 @@ module CaptiveRelease
   # Cette unité change quand l'habillage change, les commandes quand leur geste change. Les
   # deux flux sont injectés, ce qui rend chaque commande testable sans toucher à $stdin.
   class Terminal
-    def initialize(input: $stdin, output: $stdout)
+    # https://no-color.org : la couleur s'éteint avec NO_COLOR, ou quand la sortie n'est pas un
+    # terminal (pipe, fichier de log) où les séquences ANSI deviendraient du bruit.
+    def initialize(input: $stdin, output: $stdout, color: output.tty? && ENV.fetch("NO_COLOR", "").empty?)
       @input  = input
       @output = output
+      @color  = color
     end
 
     def say(message = "") = @output.puts(message)
@@ -33,11 +36,15 @@ module CaptiveRelease
     # pas eux-mêmes pour les liens OSC 8.
     def link(url, texte = url) = "\e]8;;#{url}\e\\#{underline(texte)}\e]8;;\e\\"
 
-    def bold(str)      = "\e[1m#{str}\e[0m"
-    def underline(str) = "\e[4m#{str}\e[0m"
-    def dim(str)       = "\e[2m#{str}\e[0m"
-    def ok(str)        = "\e[32m#{str}\e[0m"
-    def warn(str)      = "\e[33m#{str}\e[0m"
-    def error(str)     = "\e[31m#{str}\e[0m"
+    def bold(str)      = paint(1, str)
+    def underline(str) = paint(4, str)
+    def dim(str)       = paint(2, str)
+    def ok(str)        = paint(32, str)
+    def warn(str)      = paint(33, str)
+    def error(str)     = paint(31, str)
+
+    private
+
+    def paint(code, str) = @color ? "\e[#{code}m#{str}\e[0m" : str.to_s
   end
 end

data/lib/captive_release/update_check.rb

@@ -29,7 +29,7 @@ module CaptiveRelease
       derniere = @thread&.join(ATTENTE)&.value
       return unless derniere && Gem::Version.new(derniere) > Gem::Version.new(courante)
 
-      @output.puts "\e[33m#{Messages.t(:update_available, current: courante, latest: derniere)}\e[0m"
+      @output.puts Terminal.new(output: @output).warn(Messages.t(:update_available, current: courante, latest: derniere))
     end
 
     private

data/lib/captive_release/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module CaptiveRelease
-  VERSION = "0.15.0"
+  VERSION = "0.16.0"
 end

data/lib/captive_release.rb

@@ -3,6 +3,8 @@
 require_relative "captive_release/version"
 require_relative "captive_release/messages"
 require_relative "captive_release/semver"
+require_relative "captive_release/arrow_select"
+require_relative "captive_release/key_reader"
 require_relative "captive_release/prerelease_iteration"
 require_relative "captive_release/version_bumper"
 require_relative "captive_release/ruby_gems_version"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: captive-release
 version: !ruby/object:Gem::Version
-  version: 0.15.0
+  version: 0.16.0
 platform: ruby
 authors:
 - Captive Studio
@@ -20,6 +20,7 @@ extra_rdoc_files: []
 files:
 - bin/captive-release
 - lib/captive_release.rb
+- lib/captive_release/arrow_select.rb
 - lib/captive_release/build_command.rb
 - lib/captive_release/build_config.rb
 - lib/captive_release/build_config_prompt.rb
@@ -50,6 +51,7 @@ files:
 - lib/captive_release/gitmoji_severity.rb
 - lib/captive_release/help.rb
 - lib/captive_release/init_command.rb
+- lib/captive_release/key_reader.rb
 - lib/captive_release/locale.rb
 - lib/captive_release/locales/en.yml
 - lib/captive_release/locales/fr.yml