captive-stack-detector 0.10.0 → 0.12.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5275b5b8c6fc70aec72f1ab4de5c4301c93e8e269908d93fc8db6d7735f99540
-  data.tar.gz: e8ba22932d1a222f38f5b6d569c32d772af28930ccfc8c9967c916db9ac14152
+  metadata.gz: e5c9cf6e0559903b9b472715ed1d425903be96cdf7ca09c4689a66f63df7b19f
+  data.tar.gz: 7146a542cf6d2887063172c47a0d8f85251d3e7e02062969c8ee04882c321398
 SHA512:
-  metadata.gz: 18fd7d008bb7eba3e0f9b6a1efc3baead566d0cb3b676b49126776ec6112692a43334bdc199bb59c883d28aac67abf5e54515077bc79f4a9c265b7d36b57989f
-  data.tar.gz: be421c440ddee1fecdeeacec913e83cbdf2cdd23094ce1fbae24f9450bf02507a4d701746c389b912ed31b95ba7fc4483170e9eb4c586a0ce1db8b6167385500
+  metadata.gz: d2162dfa8b2aa58308fb3523677fba79ffba3cd7abb7fa980bd2466408bc8347519845ec93bb83b8d751b308e504488c4f2edc56a2147132634ef288de5e78b1
+  data.tar.gz: 65b1daea44aa2172b74e215d3d6fd55b87e94ae6dc5115657605dee8ee880dbc5e4f0b2f04db139348cab9c34883a33d07a131e32fe5377db6256368531de625

data/docs/stacks.md

@@ -112,7 +112,7 @@ Ces variables sont lues **au build** : après en avoir changé une, redéployez.
 
 ### Site statique sans build
 
-Condition : ni `Gemfile` ni `package.json` à la racine, mais un `public/index.html` ou un `index.html` à la racine. Rien n'est installé ni buildé : vos fichiers sont servis tels quels.
+Condition : pas de `Gemfile` à la racine, mais un `public/index.html` ou un `index.html` à la racine. Un `package.json` est accepté s'il ne sert qu'à l'outillage (Supabase CLI, prettier…) : sans dépendance `expo` ni script `start` ou `build`. Rien n'est installé ni buildé : vos fichiers sont servis tels quels.
 
 - Si `public/` existe, seul ce dossier est servi.
 - Sinon la racine est servie, limitée aux fichiers web (HTML, JavaScript, CSS, JSON, images, polices, manifeste, texte). Les dossiers cachés (`.git/`, `.github/`), `supabase/`, vos scripts SQL ou votre documentation ne sont jamais publiés.
@@ -150,6 +150,6 @@ Condition : un `package.json` à la racine avec la dépendance `expo` (dans `dep
 | --- | --- | --- |
 | Aucun Gemfile ni package.json à la racine du dépôt. | Pas de fichier de dépendances ni d'`index.html` à la racine. | Vérifiez que l'application est bien à la racine du dépôt, pas dans un sous-dossier (`app/`, `frontend/`…). Les monorepos ne sont pas pris en charge. |
 | Gemfile trouvé, mais sans la gem rails. | Application Ruby non Rails (Sinatra, Hanami…), ou `Gemfile` d'outillage dans un projet JavaScript. | Seul Rails est pris en charge côté Ruby. Si le `Gemfile` ne sert qu'à de l'outillage, retirez-le du dépôt. |
-| package.json trouvé, mais sans dépendance expo ni script start ou build. | Captive ne sait pas comment construire l'application. | Ajoutez un script `build` (application web) ou `start` (serveur), comme dans les exemples ci-dessus. |
+| package.json trouvé, mais sans dépendance expo ni script start ou build. | Captive ne sait pas comment construire l'application, et aucun `index.html` ne permet de la servir telle quelle. | Ajoutez un script `build` (application web) ou `start` (serveur), comme dans les exemples ci-dessus, ou un `index.html` pour un site statique. |
 
 Si votre stack n'est pas listée ici, contactez l'équipe Captive.

data/lib/captive_stack_detector/github_api_client.rb

@@ -5,9 +5,14 @@ require "uri"
 require "base64"
 require "json"
 require_relative "github_tree"
+require_relative "types"
+require_relative "github_response"
 
 module CaptiveStackDetector
   class GithubApiClient
+    # Un corps illisible (JSON invalide ou sans le champ attendu) vaut une absence.
+    UNREADABLE = [ JSON::ParserError, NoMethodError, TypeError ].freeze
+
     def initialize(token, repo)
       @token = token
       @repo  = repo
@@ -18,7 +23,7 @@ module CaptiveStackDetector
       return nil unless body
 
       Base64.decode64(JSON.parse(body)["content"]).force_encoding("utf-8")
-    rescue StandardError
+    rescue *UNREADABLE
       nil
     end
 
@@ -27,7 +32,7 @@ module CaptiveStackDetector
       return [] unless body
 
       GithubTree.new(body).files_in(dir)
-    rescue StandardError
+    rescue *UNREADABLE
       []
     end
 
@@ -35,9 +40,10 @@ module CaptiveStackDetector
 
     def get(path)
       uri = URI("https://api.github.com/repos/#{@repo}/#{path}")
-      req = Net::HTTP::Get.new(uri, "Authorization" => "Bearer #{@token}", "Accept" => "application/vnd.github+json")
-      res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
-      res.body if res.is_a?(Net::HTTPSuccess)
+      GithubResponse.body(Net::HTTP.get_response(uri, "Authorization" => "Bearer #{@token}",
+                                                      "Accept" => "application/vnd.github+json"))
+    rescue SystemCallError, IOError, SocketError, Timeout::Error, OpenSSL::SSL::SSLError => e
+      raise SourceUnavailable.new(:network, detail: e.message)
     end
   end
 end

data/lib/captive_stack_detector/github_response.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require "net/http"
+require_relative "types"
+
+module CaptiveStackDetector
+  # Ce que veut dire une réponse de l'API GitHub : un corps, une absence, ou un refus nommé.
+  # Change avec la façon dont GitHub signale ses erreurs, pas avec ce que l'on y lit.
+  module GithubResponse
+    # 404 : fichier absent ; 409 : dépôt vide. Tout autre échec vient de GitHub, pas du dépôt.
+    ABSENT = [ "404", "409" ].freeze
+    REFUSALS = { "401" => :unauthorized, "429" => :rate_limited }.freeze
+
+    def self.body(res)
+      return res.body if res.is_a?(Net::HTTPSuccess)
+      return nil if ABSENT.include?(res.code)
+
+      raise SourceUnavailable.new(refusal_kind(res), status: res.code.to_i)
+    end
+
+    # GitHub signale un quota épuisé par un 403 ou un 429, avec x-ratelimit-remaining à 0.
+    def self.refusal_kind(res)
+      return :rate_limited if res["x-ratelimit-remaining"] == "0"
+
+      REFUSALS.fetch(res.code) { res.is_a?(Net::HTTPServerError) ? :server_error : :forbidden }
+    end
+  end
+end

data/lib/captive_stack_detector/js_stack_detector.rb

@@ -11,6 +11,8 @@ module CaptiveStackDetector
       @analyzer = PackageJsonAnalyzer.new(package_json)
     end
 
+    def entry? = !@analyzer.type.nil?
+
     def detect
       type = @analyzer.type
       raise UnsupportedStack, :no_node_entry unless type

data/lib/captive_stack_detector/rails_stack_detector.rb

@@ -20,7 +20,7 @@ module CaptiveStackDetector
         subtype:         @analyzer.subtype,
         services:        Services.new(database: @analyzer.database, queue: @analyzer.queue, backend: nil),
         worker:          build_worker,
-        runtime:         Runtime.new(ruby: @reader.ruby_version, node: nil),
+        runtime:         Runtime.new(ruby: @reader.ruby_version, node: @reader.node_version),
         env_vars:        @reader.env_vars,
         system_packages: system_packages,
       )

data/lib/captive_stack_detector/stack_router.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require_relative "types"
+require_relative "gemfile_analyzer"
+require_relative "rails_stack_detector"
+require_relative "js_stack_detector"
+require_relative "static_site_detector"
+
+module CaptiveStackDetector
+  # Aiguille un dépôt vers le détecteur de sa stack, d'après ses manifestes à la racine.
+  class StackRouter
+    def initialize(reader)
+      @reader = reader
+    end
+
+    def detect
+      gemfile      = @reader.read("Gemfile")
+      package_json = @reader.read("package.json")
+
+      return RailsStackDetector.new(@reader, GemfileAnalyzer.new(gemfile)).detect if gemfile
+
+      static_site = StaticSiteDetector.new(@reader)
+      # Un package.json sans point d'entrée (Supabase CLI, prettier…) n'est que de l'outillage :
+      # un index.html présent reste servi tel quel au lieu d'un refus no_node_entry.
+      js = package_json && JsStackDetector.new(@reader, package_json)
+      return js.detect if js && (js.entry? || !static_site.site?)
+      raise UnsupportedStack, :no_manifest unless static_site.site?
+
+      static_site.detect
+    end
+  end
+end

data/lib/captive_stack_detector/types.rb

@@ -26,4 +26,17 @@ module CaptiveStackDetector
       super(reason&.to_s || "unsupported stack")
     end
   end
+
+  # GitHub n'a pas laissé lire le dépôt, ce qui ne dit rien de sa stack. `kind` dit pourquoi,
+  # pour que l'appelant l'explique : :unauthorized (jeton refusé), :rate_limited (quota épuisé),
+  # :forbidden (accès refusé), :server_error (panne GitHub), :network (pas de réponse).
+  class SourceUnavailable < StandardError
+    attr_reader :kind, :status
+
+    def initialize(kind = :network, status: nil, detail: nil)
+      @kind   = kind
+      @status = status
+      super(detail || "GitHub illisible : #{kind}#{" (#{status})" if status}")
+    end
+  end
 end

data/lib/captive_stack_detector/version.rb

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

data/lib/captive_stack_detector.rb

@@ -3,10 +3,7 @@
 require "json"
 require_relative "captive_stack_detector/types"
 require_relative "captive_stack_detector/file_reader"
-require_relative "captive_stack_detector/gemfile_analyzer"
-require_relative "captive_stack_detector/rails_stack_detector"
-require_relative "captive_stack_detector/js_stack_detector"
-require_relative "captive_stack_detector/static_site_detector"
+require_relative "captive_stack_detector/stack_router"
 require_relative "captive_stack_detector/addon_recommender"
 
 # Déduit d'un dépôt sa stack, ses services et les options d'add-on à recommander.
@@ -20,21 +17,7 @@ module CaptiveStackDetector
   end
 
   def self.detect_from(reader)
-    AddonRecommender.new(reader).apply(detect_stack(reader))
+    AddonRecommender.new(reader).apply(StackRouter.new(reader).detect)
   end
   private_class_method :detect_from
-
-  def self.detect_stack(reader)
-    gemfile      = reader.read("Gemfile")
-    package_json = reader.read("package.json")
-
-    return RailsStackDetector.new(reader, GemfileAnalyzer.new(gemfile)).detect if gemfile
-    return JsStackDetector.new(reader, package_json).detect                    if package_json
-
-    static_site = StaticSiteDetector.new(reader)
-    raise UnsupportedStack, :no_manifest unless static_site.site?
-
-    static_site.detect
-  end
-  private_class_method :detect_stack
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: captive-stack-detector
 version: !ruby/object:Gem::Version
-  version: 0.10.0
+  version: 0.12.5
 platform: ruby
 authors:
 - Captive Studio
@@ -29,6 +29,7 @@ files:
 - lib/captive_stack_detector/gem_package_map.rb
 - lib/captive_stack_detector/gemfile_analyzer.rb
 - lib/captive_stack_detector/github_api_client.rb
+- lib/captive_stack_detector/github_response.rb
 - lib/captive_stack_detector/github_tree.rb
 - lib/captive_stack_detector/js_env_detector.rb
 - lib/captive_stack_detector/js_env_files.rb
@@ -46,6 +47,7 @@ files:
 - lib/captive_stack_detector/solid_queue_usage.rb
 - lib/captive_stack_detector/solid_queue_worker.rb
 - lib/captive_stack_detector/ssr_framework_detector.rb
+- lib/captive_stack_detector/stack_router.rb
 - lib/captive_stack_detector/static_site_detector.rb
 - lib/captive_stack_detector/system_package_detector.rb
 - lib/captive_stack_detector/types.rb