run_tasks 4.0.0 → 4.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 18567c31d63e5cacb71de0cf93a2a988a36161add471ba464e0c76fc80e1a5ae
-  data.tar.gz: 5e1a9ca0f82fe57c4ebab2bafe9487f588fa436f0c2a14b4e2555bace0874000
+  metadata.gz: 89b89a1b7418844bef966d37027b641a162cbcd4023a2e932a1848ccf3df69bc
+  data.tar.gz: d691b13bf7a3eab7ebc5bbbb9f5155c88686696667c8a305aa4ca9ce6cbd2c79
 SHA512:
-  metadata.gz: b70d57d950528c6182766218104938627b2b9469baccebd1e4472f3ef8ec1363283dd2432d898b4d89bc8173e3a249acfdc02b7fa7eeed99e5598323599cd5eb
-  data.tar.gz: 8ba35fe28b3ef9346ff031041b342d641975503d068f9e817df178a429a663a11af423b1f3e1f1c03622043013513603b5b98b57cf10cfbbc5cbf759d9fefd2f
+  metadata.gz: 780a926350e17a09469794beb7e0fb8959df42ee893dd209436f1b85aefe2aca749a235060dc16764da502f0007b415421fadfa2294c8e66cc855b7eaf1f2a4d
+  data.tar.gz: 1ee1f1e74ae13f7962184f1e7134621fefb298068c89121af734bc7f74788b243c20f2554732491366635aea67e73d573f6f2c8ce96f572964d6d682a6aa1868

data/README.md

@@ -34,6 +34,16 @@ run help
 
 > Note that the command `run` displays the help screen by default when no task is specified.
 
+## Runfile version
+
+The first line of a Runfile declares the major version of Run it is written for:
+
+```rb
+version 4
+```
+
+When a Runfile declares another major version, Run hands over to the matching version if it is installed, so projects written for Run 3 and Run 4 can live side by side. A Runfile without this line is a version 2 one.
+
 ## Writing tasks
 
 ```rb

data/src/run/core.rb

@@ -7,6 +7,7 @@ module Run
     NAME_PATTERN = /[a-zA-Z_]\w*(?:-\w+)*/
     OPTION_PATTERN = /\A([+-])(#{NAME_PATTERN})\z/
     NAMED_PARAMETER_PATTERN = /\A(#{NAME_PATTERN})=(.*)\z/m
+    RUNFILE_VERSION_PATTERN = /^\s*version\s*\(?\s*(\d+)/
     @@tasks = []
     @@runfile_version = nil
 
@@ -18,6 +19,7 @@ module Run
 
     # @return [void]
     def self.run_run
+      delegate_to_runfile_version! if File.file?(RUNFILE_FILENAME)
       if ARGV.size == 1 && ARGV[0] == "--completions"
         require File.expand_path(RUNFILE_FILENAME) if File.exist?(RUNFILE_FILENAME)
         puts completions.join("\n")
@@ -72,8 +74,31 @@ module Run
       }
     end
 
+    # @param contents [String]
+    # @return [Integer]
+    def self.declared_runfile_version(contents)
+      contents[RUNFILE_VERSION_PATTERN, 1]&.to_i || 2
+    end
+
+    # @param major [Integer]
+    # @return [Gem::Version, nil]
+    def self.installed_version_for(major)
+      Gem::Specification.find_all_by_name("run_tasks", "~> #{major}.0").map(&:version).max
+    end
+
     private
 
+    # @return [void]
+    def self.delegate_to_runfile_version!
+      major = declared_runfile_version(File.read(RUNFILE_FILENAME))
+      return if major == VERSION.split(".").first.to_i
+
+      version = installed_version_for(major)
+      raise Run::Error::RunfileVersionMismatch.new(major) if !version
+
+      exec Gem.ruby, File.join(Gem.bindir, "run"), "_#{version}_", *ARGV
+    end
+
     # @return [void]
     def self.check_runfile_version!
       if (@@runfile_version || 2) != VERSION.split(".").first.to_i

data/src/run/error/runfile_version_mismatch.rb

@@ -3,8 +3,13 @@
 module Run
   module Error
     class RunfileVersionMismatch < StandardError
-      def initialize
-        super "Runfile version mismatches Run version"
+      # @param major [Integer, nil]
+      def initialize(major = nil)
+        if major
+          super "Runfile declares version #{major}, which needs Run #{major}: gem install run_tasks -v '~> #{major}.0'"
+        else
+          super "Runfile version mismatches Run version"
+        end
       end
     end
   end

data/src/run/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Run
-  VERSION = "4.0.0"
+  VERSION = "4.0.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: run_tasks
 version: !ruby/object:Gem::Version
-  version: 4.0.0
+  version: 4.0.1
 platform: ruby
 authors:
 - Aurélien Delogu