captive-release 0.10.0 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9814ab9187493f6122ec99042578ab98456b44581b22b6c2925a5d1985cdc46f
-  data.tar.gz: dedfed153b9ca6fa4a4b43eb1a844d3733053828eb24b0b2582ae62d1451a2ad
+  metadata.gz: 6a8fd7809824a87b08805de31f9ddc40af157b6ba41e0b76e19f90edd4c9ade2
+  data.tar.gz: 33dff63edd19f1889f5fa014271eff8640b6cba8effc7937ab9332fe2bf14316
 SHA512:
-  metadata.gz: cea079ba56805defa3e5380cc9d145edceaa8acf799c16d859ed01da7910490b00696e2a4fee3e0b73037ca2a8db3198c93026e2f65eca2307670e65c6c73326
-  data.tar.gz: 1c74d0e65fa4634858556cb06caa312b6dd654d366bf3bd85ad1cb0fa1c181da5c295c8e7907aef47fb80bec606ae9f6dc52400b422608e4eba520f58c5c30e5
+  metadata.gz: 9cfbc9751d8b2607e05512a7120f3773d3553526786e57d47a45d557e97bda793e26f09be493f015c3caaf982329f5363576a61e14399ecef1fa4157d913b352
+  data.tar.gz: 6a114be8ba3248b560619b8e345e1ec8e9a9d9b009b73d7723be59ba743bae25ba519f1f9baf533e772e16608741d0a77fdc1ab42007a359a6a38b49b266ffee

data/lib/captive_release/cli.rb

@@ -8,11 +8,22 @@ module CaptiveRelease
       new(argv.dup).run
     end
 
-    def initialize(argv)
-      @options = Options.new(argv)
+    def initialize(argv, update_check: UpdateCheck.new)
+      @options      = Options.new(argv)
+      @update_check = update_check
     end
 
+    # Le verdict de mise à jour s'affiche après une commande menée à terme ; une commande
+    # inconnue sort avant (exit 1) et n'en a pas.
     def run
+      @update_check.start
+      dispatch
+      @update_check.report
+    end
+
+    private
+
+    def dispatch
       command = @options.next_argument
 
       case command
@@ -25,8 +36,6 @@ module CaptiveRelease
       end
     end
 
-    private
-
     def run_init
       InitCommand.new(terminal: terminal).run(@options.value("--files"))
     end

data/lib/captive_release/direct_commits.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module CaptiveRelease
+  # Complète les notes générées par GitHub, qui ne listent que les PR mergées : un commit
+  # poussé directement sur la branche n'y apparaît jamais, même quand il porte la feature
+  # qui justifie le bump.
+  class DirectCommits
+    COMMIT_VERSION = /\A🔖 Set version /
+
+    def initialize(api)
+      @api = api
+    end
+
+    # Sans plage, il n'y a pas de tag précédent : lister les commits reviendrait à lister
+    # l'historique entier.
+    def completer(notes)
+      plage = notes.plage or return notes
+      lignes = commits(*plage).map { ligne(_1) }
+      lignes.empty? ? notes : notes.ajouter("## Commits directs\n#{lignes.join("\n")}\n")
+    end
+
+    private
+
+    def commits(depuis, jusqu_a)
+      @api.get("compare/#{depuis}...#{jusqu_a}")["commits"].reject do |commit|
+        titre(commit).match?(COMMIT_VERSION) || !@api.get("commits/#{commit["sha"]}/pulls").empty?
+      end
+    end
+
+    def ligne(commit)
+      auteur = commit.dig("author", "login")
+      "* #{titre(commit)}#{" by @#{auteur}" if auteur} in #{commit["sha"]}"
+    end
+
+    def titre(commit) = commit.dig("commit", "message")[/.*/]
+  end
+end

data/lib/captive_release/github_api.rb

@@ -23,15 +23,22 @@ module CaptiveRelease
       @http  = http || GithubHttp.new(token: token)
     end
 
+    def get(chemin) = analyser(@http.get(adresse(chemin)), "200")
+
     def post(chemin, corps, attendu:)
-      reponse = @http.post(URI("#{HOTE}/#{depot.path(chemin)}"), JSON.generate(corps))
+      analyser(@http.post(adresse(chemin), JSON.generate(corps)), attendu)
+    end
+
+    private
+
+    def adresse(chemin) = URI("#{HOTE}/#{depot.path(chemin)}")
+
+    def analyser(reponse, attendu)
       refuser(reponse) unless reponse.code == attendu
 
       reponse.body.to_s.empty? ? nil : JSON.parse(reponse.body)
     end
 
-    private
-
     def refuser(reponse)
       raise Messages.t(:github_api_error, code: reponse.code, message: GithubErrorMessage.from(reponse.body.to_s))
     end

data/lib/captive_release/github_http.rb

@@ -4,7 +4,7 @@ require "net/http"
 require "uri"
 
 module CaptiveRelease
-  # Le transport : poster sur l'API GitHub, authentifié, en suivant les redirections qu'elle
+  # Le transport : lire et poster sur l'API GitHub, authentifié, en suivant les redirections qu'elle
   # sert quand un dépôt a été renommé. Elle ne sait rien de ce qui est posté ni de ce qui
   # compte comme un échec, qui appartiennent à GithubApi.
   class GithubHttp
@@ -20,9 +20,17 @@ module CaptiveRelease
       @token = token
     end
 
+    def get(uri) = suivre(uri) { |cible| Net::HTTP::Get.new(cible.path) }
+
     def post(uri, corps)
+      suivre(uri) { |cible| Net::HTTP::Post.new(cible.path).tap { |requete| requete.body = corps } }
+    end
+
+    private
+
+    def suivre(uri)
       MAX_REDIRECTIONS.times do
-        reponse = envoyer(uri, corps)
+        reponse = envoyer(uri, yield(uri))
         return reponse unless REDIRECTIONS.include?(reponse.code)
 
         uri = URI(ailleurs!(reponse))
@@ -31,15 +39,11 @@ module CaptiveRelease
       raise Messages.t(:too_many_redirects)
     end
 
-    private
-
-    def envoyer(uri, corps)
+    def envoyer(uri, requete)
       http = Net::HTTP.new(uri.host, uri.port)
       http.use_ssl = true
-      requete = Net::HTTP::Post.new(uri.path)
       EN_TETES.each { |nom, valeur| requete[nom] = valeur }
       requete["Authorization"] = "token #{@token}"
-      requete.body = corps
       http.request(requete)
     end
 

data/lib/captive_release/github_release.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
 require_relative "github_api"
+require_relative "direct_commits"
+require_relative "release_notes"
 
 module CaptiveRelease
   # Crée la release GitHub d'une version. Elle compose ce qu'elle demande ; l'API, son
@@ -9,7 +11,6 @@ module CaptiveRelease
     # GitHub refuse (422) un corps de release plus long. Sans tag précédent, les notes
     # générées couvrent tout l'historique et dépassent vite cette limite.
     CORPS_MAX = 125_000
-    COUPURE   = "\n\n…"
 
     def self.create(version:, remote_url:, token:, api: nil)
       api ||= GithubApi.new(remote_url: remote_url, token: token)
@@ -35,21 +36,7 @@ module CaptiveRelease
 
     def notes(tag)
       corps = @api.post("releases/generate-notes", { "tag_name" => tag }, attendu: "200")["body"].to_s
-      corps.length > CORPS_MAX ? tronquer(corps) : corps
-    end
-
-    # Coupe à une fin de ligne et garde le lien Full Changelog final, qui mène à la liste complète.
-    def tronquer(corps)
-      tete, pied = separer_pied(corps)
-      place = CORPS_MAX - COUPURE.length - pied.length
-      coupe = tete[0, place]
-      coupe = coupe[0, coupe.rindex("\n")] if coupe.include?("\n")
-      "#{coupe}#{COUPURE}#{pied}"
-    end
-
-    def separer_pied(corps)
-      index = corps.rindex("\n**Full Changelog**")
-      index ? [ corps[0, index], "\n#{corps[index..]}" ] : [ corps, "" ]
+      DirectCommits.new(@api).completer(ReleaseNotes.new(corps)).tronquer(CORPS_MAX).to_s
     end
   end
 end

data/lib/captive_release/locales/en.yml

@@ -41,6 +41,7 @@ en:
     'no': 'No'
     invalid_choice: Invalid choice.
     unknown_command: 'Unknown command: %{command}'
+    update_available: 'A new version of captive-release is available: %{current} → %{latest}. Run: brew upgrade captive-release'
     scanning: Scanning for version files...
     no_version_files_found: No version files found (package.json, VERSION).
     no_files_selected: No files selected.

data/lib/captive_release/locales/fr.yml

@@ -41,6 +41,7 @@ fr:
     'no': Non
     invalid_choice: Choix invalide.
     unknown_command: 'Commande inconnue : %{command}'
+    update_available: 'Une nouvelle version de captive-release est disponible : %{current} → %{latest}. Lancez : brew upgrade captive-release'
     scanning: Recherche des fichiers de version...
     no_version_files_found: Aucun fichier de version trouvé (package.json, VERSION).
     no_files_selected: Aucun fichier sélectionné.

data/lib/captive_release/prerelease_iteration.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module CaptiveRelease
+  # L'itération d'une pré-release : même canal, dernier identifiant + 1 ; sans numéro final,
+  # on en ouvre un (.1). Changer de canal (alpha → beta) reste une saisie manuelle.
+  #
+  # Cette unité change quand la règle d'itération change, VersionBumper quand les types de
+  # bump changent.
+  module PrereleaseIteration
+    def self.next(version)
+      raise ArgumentError, Messages.t(:nothing_to_iterate) unless Semver.prerelease?(version)
+
+      dernier = version[/\d+\z/]
+      return "#{version}.1" unless dernier && version.match?(/[.-]\d+\z/)
+
+      version.delete_suffix(dernier) + (dernier.to_i + 1).to_s
+    end
+  end
+end

data/lib/captive_release/release_notes.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module CaptiveRelease
+  # Le texte des notes d'une release, découpé autour de son pied : le lien Full Changelog,
+  # qui mène à la liste complète et doit survivre à tout ajout ou toute coupe.
+  class ReleaseNotes
+    PIED        = /(?:\n|\A)\*\*Full Changelog\*\*/
+    COMPARAISON = %r{/compare/(?<depuis>\S+?)\.\.\.(?<jusqu_a>\S+)}
+    COUPURE     = "\n\n…"
+
+    def initialize(corps)
+      index = corps.rindex(PIED)
+      @tete, @pied = index ? [ corps[0, index], corps[index..] ] : [ corps, "" ]
+    end
+
+    # Les tags qui bornent les notes ; nil sans tag précédent.
+    def plage = @pied.match(COMPARAISON)&.captures
+
+    def ajouter(section) = ReleaseNotes.new("#{@tete.rstrip}\n\n#{section}#{@pied}")
+
+    # Coupe à une fin de ligne, pour ne pas laisser un lien ou un émoji à moitié.
+    def tronquer(max)
+      return self if to_s.length <= max
+
+      coupe = @tete[0, max - COUPURE.length - @pied.length - 1]
+      coupe = coupe[0, coupe.rindex("\n")] if coupe.include?("\n")
+      ReleaseNotes.new("#{coupe}#{COUPURE}\n#{@pied}")
+    end
+
+    def to_s = "#{@tete}#{@pied}"
+  end
+end

data/lib/captive_release/update_check.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require "json"
+
+module CaptiveRelease
+  # Signale qu'une version plus récente est publiée, à la manière de Scalingo CLI : la requête
+  # part au démarrage dans un thread, le verdict s'affiche après la commande. Le dépôt est
+  # privé, d'où le jeton ; sans jeton, pas de vérification.
+  #
+  # Cette unité change quand la source de la dernière version change. Toute erreur est muette :
+  # un réseau absent ne doit jamais gêner une release. L'attente est bornée par le join, pas
+  # par la requête : un thread encore en vol meurt avec le process.
+  class UpdateCheck
+    LATEST    = URI("https://api.github.com/repos/captive-studio/captive-release/releases/latest")
+    ATTENTE   = 2
+    DESACTIVE = "CAPTIVE_RELEASE_DISABLE_UPDATE_CHECKER"
+
+    def initialize(output: $stderr, token_provider: GithubToken.method(:call))
+      @output         = output
+      @token_provider = token_provider
+    end
+
+    def start
+      @thread = Thread.new { derniere_version rescue nil } unless ENV[DESACTIVE] # rubocop:disable Style/RescueModifier
+      self
+    end
+
+    def report(courante = VERSION)
+      derniere = @thread&.join(ATTENTE)&.value
+      return unless derniere && Gem::Version.new(derniere) > Gem::Version.new(courante)
+
+      @output.puts "\e[31m#{Messages.t(:update_available, current: courante, latest: derniere)}\e[0m"
+    end
+
+    private
+
+    def derniere_version
+      token   = @token_provider.call or return
+      reponse = GithubHttp.new(token: token).get(LATEST)
+      JSON.parse(reponse.body).fetch("tag_name").delete_prefix("v") if reponse.is_a?(Net::HTTPSuccess)
+    end
+  end
+end

data/lib/captive_release/version.rb

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

data/lib/captive_release/version_bumper.rb

@@ -26,7 +26,7 @@ module CaptiveRelease
       when "minor" then "#{@major}.#{@minor + 1}.0"
       when "patch" then "#{@major}.#{@minor}.#{@patch + 1}"
       when PROMOTE then promouvoir
-      when ITERATE then iterer
+      when ITERATE then PrereleaseIteration.next(@current)
       else saisie(type)
       end
     end
@@ -47,16 +47,6 @@ module CaptiveRelease
       Semver.core(@current)
     end
 
-    # Même canal, dernier identifiant + 1 ; sans numéro final, on en ouvre un (.1).
-    def iterer
-      raise ArgumentError, Messages.t(:nothing_to_iterate) unless Semver.prerelease?(@current)
-
-      dernier = @current[/\d+\z/]
-      return "#{@current}.1" unless dernier && @current.match?(/[.-]\d+\z/)
-
-      @current.delete_suffix(dernier) + (dernier.to_i + 1).to_s
-    end
-
     def saisie(type)
       raise ArgumentError, Messages.t(:invalid_version, value: type) unless Semver.valid?(type)
 

data/lib/captive_release.rb

@@ -3,6 +3,7 @@
 require_relative "captive_release/version"
 require_relative "captive_release/messages"
 require_relative "captive_release/semver"
+require_relative "captive_release/prerelease_iteration"
 require_relative "captive_release/version_bumper"
 require_relative "captive_release/ruby_gems_version"
 require_relative "captive_release/version_format"
@@ -50,6 +51,7 @@ require_relative "captive_release/release_preconditions"
 require_relative "captive_release/release_overview"
 require_relative "captive_release/release_confirmation"
 require_relative "captive_release/release_command"
+require_relative "captive_release/update_check"
 require_relative "captive_release/help"
 require_relative "captive_release/cli"
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: captive-release
 version: !ruby/object:Gem::Version
-  version: 0.10.0
+  version: 0.12.0
 platform: ruby
 authors:
 - Captive Studio
@@ -33,6 +33,7 @@ files:
 - lib/captive_release/config_file.rb
 - lib/captive_release/config_loader.rb
 - lib/captive_release/config_writer.rb
+- lib/captive_release/direct_commits.rb
 - lib/captive_release/exclusion_input.rb
 - lib/captive_release/framework_detector.rb
 - lib/captive_release/gemfile_lock_refresh.rb
@@ -55,8 +56,10 @@ files:
 - lib/captive_release/messages.rb
 - lib/captive_release/options.rb
 - lib/captive_release/prerelease_guard.rb
+- lib/captive_release/prerelease_iteration.rb
 - lib/captive_release/release_command.rb
 - lib/captive_release/release_confirmation.rb
+- lib/captive_release/release_notes.rb
 - lib/captive_release/release_overview.rb
 - lib/captive_release/release_preconditions.rb
 - lib/captive_release/release_publication.rb
@@ -65,6 +68,7 @@ files:
 - lib/captive_release/semver.rb
 - lib/captive_release/shell.rb
 - lib/captive_release/terminal.rb
+- lib/captive_release/update_check.rb
 - lib/captive_release/version.rb
 - lib/captive_release/version_bumper.rb
 - lib/captive_release/version_choice.rb
@@ -94,7 +98,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.16
+rubygems_version: 4.0.20
 specification_version: 4
 summary: CLI de release semver pour projets Captive
 test_files: []