captive-release 0.14.0 → 0.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8b6fb2c222824add2e6fe62b462240609b233535e610ef7bd70513bf6ff5f931
-  data.tar.gz: ffb5b3704f4a4a4a94cb31c6d2275683077a3437d0b8b841ac727a893d32ff2f
+  metadata.gz: 6aec56835e050f42afb89b87243974752868add0b16f258291845acce96f8e75
+  data.tar.gz: bdfc4aeba04e48e427938799f76aeb5e172bc4d7894955a9ad470030e12696a0
 SHA512:
-  metadata.gz: 4045d5e368e362b1307a2f27ce16df74ff0c7f0fc1ae021b9d62af6673441deb0b7a66c8d9623a27ae10a46662f8b51d7214c2b8d32cd1878d5c490acf56e7cc
-  data.tar.gz: 6a3f85ea5c5da1e82a3131c10f4b6f0e0dd59ec744b8134b2d470b5c47b11b4dcfe37f227d1f74285e03cdfc41fdcaa7ac9d98e39a798c6e23f6a82886fe41b5
+  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/build_dispatch_run.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 module CaptiveRelease
-  # Déclenche le workflow de build sur la branche courante, après avoir dit ce qu'il va faire :
-  # le profil, le workflow et la branche sont les trois choses qu'on vérifie avant de lancer.
+  # Tague le commit du build, puis déclenche le workflow sur la branche courante après avoir dit
+  # ce qu'il va faire : profil, workflow, branche et tag sont ce qu'on vérifie avant de lancer.
   #
   # Cette unité change quand ce qu'on déclenche change, BuildCommand quand la façon de
   # constituer la demande change.
@@ -13,7 +13,8 @@ module CaptiveRelease
 
     def call(profil:, workflow:, jeton:)
       branche = GitCommands.current_branch
-      annoncer(profil, workflow, branche)
+      tag     = BuildTag.pose!
+      annoncer(profil, workflow, branche, tag)
 
       url = GithubDispatch.dispatch(workflow_file: workflow, ref: branche,
                                     inputs: { "profile" => profil },
@@ -21,17 +22,18 @@ module CaptiveRelease
 
       @terminal.done Messages.t(:build_dispatched)
       @terminal.say "     #{url}\n"
-    rescue WorkflowIntrouvable => e
+    rescue WorkflowIntrouvable, BuildTagImpossible => e
       @terminal.say @terminal.error(e.message)
       exit 1
     end
 
     private
 
-    def annoncer(profil, workflow, branche)
+    def annoncer(profil, workflow, branche, tag)
       @terminal.say Messages.t(:dispatch_profile, value: @terminal.bold(profil))
       @terminal.say Messages.t(:dispatch_workflow, value: @terminal.bold(workflow))
       @terminal.say Messages.t(:dispatch_branch, value: @terminal.bold(branche))
+      @terminal.say Messages.t(:dispatch_tag, value: @terminal.bold(tag))
       @terminal.say "\n#{Messages.t(:dispatching)}\n"
     end
   end

data/lib/captive_release/build_tag.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module CaptiveRelease
+  # Le build ne peut pas être tagué : HEAD absent du remote, ou aucun tag de release.
+  class BuildTagImpossible < StandardError; end
+
+  # Le tag qui marque le commit d'un build : build/<prochaine version>-build.<N>+g<sha>.
+  #
+  # Il ne commence jamais par v, préfixe qui déclenche les déploiements. Sans build/, il reste
+  # un semver qui se trie entre la release qu'il suit et la suivante.
+  module BuildTag
+    DESCRIBE = /\Av(?<version>.+)-(?<distance>\d+)-(?<sha>g\h+)\z/
+
+    def self.pose!
+      raise BuildTagImpossible, Messages.t(:build_head_not_pushed) unless GitCommands.head_pushed?
+
+      tag = nom(GitCommands.describe_release)
+      GitCommands.tag_and_push(tag)
+      tag
+    rescue RuntimeError => e # tag ou push refusé par git : un message, pas une trace
+      raise BuildTagImpossible, e.message
+    end
+
+    # Depuis une pré-release, la prochaine version est son cœur : on prolonge la pré-release
+    # plutôt que de viser un patch qui sortirait après elle.
+    def self.nom(describe)
+      morceaux = describe.match(DESCRIBE)
+      raise BuildTagImpossible, Messages.t(:build_no_release_tag) unless morceaux && Semver.valid?(morceaux[:version])
+
+      version, distance, sha = morceaux.values_at(:version, :distance, :sha)
+      base = Semver.prerelease?(version) ? "#{version}." : "#{VersionBumper.bump(version, "patch")}-"
+      "build/#{base}build.#{distance}+#{sha}"
+    end
+  end
+end

data/lib/captive_release/git_commands.rb

@@ -49,6 +49,22 @@ module CaptiveRelease
       Shell.run? "git push origin HEAD"
     end
 
+    # --match ignore les tags build/ : seul un tag de release sert de point de départ.
+    def self.describe_release
+      Shell.capture("git describe --tags --long --match 'v[0-9]*' 2>/dev/null")
+    end
+
+    # Vu depuis les branches de suivi locales : un commit qu'aucune ne contient n'existe pas
+    # pour le workflow qui le buildera.
+    def self.head_pushed? = !Shell.capture("git branch -r --contains HEAD 2>/dev/null").empty?
+
+    # Relancer un build sur le même commit retombe sur le même tag : on le repousse sans
+    # le recréer.
+    def self.tag_and_push(nom)
+      Shell.run! "git tag #{Shell.escape(nom)}" unless tag?(Shell.escape(nom))
+      Shell.run! "git push origin refs/tags/#{Shell.escape(nom)}"
+    end
+
     # Pousse HEAD sous un autre nom sans quitter la branche courante.
     def self.push_branch(nom)
       Shell.run! "git push origin HEAD:refs/heads/#{Shell.escape(nom)}"

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/locales/en.yml

@@ -71,6 +71,9 @@ en:
     dispatch_profile: 'Profile:  %{value}'
     dispatch_workflow: 'Workflow: %{value}'
     dispatch_branch: 'Branch:   %{value}'
+    build_head_not_pushed: HEAD is not pushed to the remote. Push the branch before building.
+    build_no_release_tag: No v* release tag found. Make a first release with captive-release new.
+    dispatch_tag: 'Tag:      %{value}'
     dispatching: Dispatching...
     build_dispatched: Build dispatched!
     workflow_not_found: |-

data/lib/captive_release/locales/fr.yml

@@ -71,6 +71,9 @@ fr:
     dispatch_profile: 'Profil :   %{value}'
     dispatch_workflow: 'Workflow : %{value}'
     dispatch_branch: 'Branche :  %{value}'
+    build_head_not_pushed: HEAD n'est pas poussé sur le remote. Poussez la branche avant de lancer le build.
+    build_no_release_tag: Aucun tag de release v* trouvé. Faites une première release avec captive-release new.
+    dispatch_tag: 'Tag :      %{value}'
     dispatching: Déclenchement...
     build_dispatched: Build déclenché !
     workflow_not_found: |-

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.14.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"
@@ -37,6 +39,7 @@ require_relative "captive_release/config_writer"
 require_relative "captive_release/version_files_argument"
 require_relative "captive_release/version_file_bootstrap"
 require_relative "captive_release/init_command"
+require_relative "captive_release/build_tag"
 require_relative "captive_release/build_dispatch_run"
 require_relative "captive_release/build_command"
 require_relative "captive_release/menu"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: captive-release
 version: !ruby/object:Gem::Version
-  version: 0.14.0
+  version: 0.16.0
 platform: ruby
 authors:
 - Captive Studio
@@ -20,10 +20,12 @@ 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
 - lib/captive_release/build_dispatch_run.rb
+- lib/captive_release/build_tag.rb
 - lib/captive_release/bump_safety_net.rb
 - lib/captive_release/bump_severity.rb
 - lib/captive_release/bump_suggestion.rb
@@ -49,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