raketeer 0.2.3 → 0.2.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5c38d651b22554d93b5986c5d12461efc2d3323f7d3b19aadfd7e361e611dd7a
-  data.tar.gz: 612dc5ab931a7e794c36a4f01925e008923c4894680edb6ea2e9a38f828d28ad
+  metadata.gz: 3e6ed3bd0408cc6af232b21a069ea2515d63ea1db1fc40b6d0a1c2e29fa61838
+  data.tar.gz: 46809d4b3d4d65b62a3f4f72fc136b2393727ca871aa0321fefc64cf8cfa62c6
 SHA512:
-  metadata.gz: '0316239d48a10b37f972ae845813cd2bd50375d766cdeefe2227f419ed315f44da826e058d9a61c2dfae1a40eaa9847d45b7177fdffa16d845a6ed53e438c909'
-  data.tar.gz: c44703d264b50f802e7c7efc2d62f62269b5e83e430d5277304da246cf3ca0f46d527ce133eee7f81ec46545af1f778ab910a2e64fa48067a8409c0766f94252
+  metadata.gz: ffdf10d2f65ca8e0e6d9b8866c1a807749da9aa151c92d44b9f0588478f30b94008f9b100ce709b10f6ef07c1a3fbba43bc74178f0ebcf1c3d46ff8cd157e038
+  data.tar.gz: 4052757cc76e4826759e0f1fc09b664d02ea44b63d00856f9f914ba099c97d5be1eb497e2101ebcb054d71452e31975ed36ef6f4c089b3b640c0cb62ee89ca5b

data/CHANGELOG.md

@@ -2,22 +2,36 @@
 
 Format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
-## [[Unreleased]](https://github.com/esotericpig/raketeer/compare/v0.2.3...master)
+## [[Unreleased]](https://github.com/esotericpig/raketeer/compare/v0.2.4...master)
+
+## [v0.2.4] - 2019-08-02
+### Added
+- BumpTask & 'raketeer/bump'
+- FilesBumper (lib/raketeer/files_bumper.rb)
+- SemVer (lib/raketeer/sem_ver.rb)
+- BumpVer (lib/raketeer/bump_ver.rb)
+- To Util:
+    - to_bool() & TRUE_BOOLS (from my yard_ghurt project)
+- To version.rb:
+    - DEP_VERSIONS & try_require_dev() (for future use)
+
+### Changed
+- Util.find_main_executable() to not search for 'bin/*.rb' since almost no project uses an extension in the bin directory
 
 ## [v0.2.3] - 2019-07-30
 ### Fixed
 - Fixed 'yield' typo in some tasks
 
 ## [v0.2.2] - 2019-07-29
-### Changed
-- Refactored some code (minor)
-- Changed some documentation (minor)
-
 ### Added
 - RunTask & 'raketeer/run'
 - Util
 - bin/raketeer (for testing purposes only, not included in the Gem package)
 
+### Changed
+- Refactored some code (minor)
+- Changed some documentation (minor)
+
 ## [v0.2.1] - 2019-07-24
 ### Changed
 - Fixed minor/cosmetic typo

data/Rakefile

@@ -22,6 +22,8 @@
 
 require 'bundler/gem_tasks'
 
+require 'raketeer'
+
 require 'rake/clean'
 
 task default: []

data/lib/raketeer.rb

@@ -21,9 +21,14 @@
 #++
 
 
+require 'raketeer/bump_task'
+require 'raketeer/bump_ver'
+require 'raketeer/files_bumper'
 require 'raketeer/irb_task'
 require 'raketeer/nokogiri_install_tasks'
 require 'raketeer/run_task'
+require 'raketeer/sem_ver'
+require 'raketeer/util'
 require 'raketeer/version'
 
 ###

data/lib/raketeer/all.rb

@@ -21,6 +21,7 @@
 #++
 
 
+require 'raketeer/bump' # @since 0.2.4
 require 'raketeer/irb' # @since 0.2.0
 require 'raketeer/nokogiri_installs' # @since 0.1.0
 require 'raketeer/run' # @since 0.2.2

data/lib/raketeer/bump.rb

@@ -0,0 +1,35 @@
+#!/usr/bin/env ruby
+# encoding: UTF-8
+# frozen_string_literal: true
+
+#--
+# This file is part of Raketeer.
+# Copyright (c) 2019 Jonathan Bradley Whited (@esotericpig)
+# 
+# Raketeer is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+# 
+# Raketeer is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Lesser General Public License for more details.
+# 
+# You should have received a copy of the GNU Lesser General Public License
+# along with Raketeer.  If not, see <https://www.gnu.org/licenses/>.
+#++
+
+
+require 'raketeer/bump_task'
+
+module Raketeer
+  ###
+  # @author Jonathan Bradley Whited (@esotericpig)
+  # @since  0.2.4
+  ###
+  module Bump
+  end
+end
+
+Raketeer::BumpTask.new() # @since 0.2.4

data/lib/raketeer/bump_task.rb

@@ -0,0 +1,333 @@
+#!/usr/bin/env ruby
+# encoding: UTF-8
+# frozen_string_literal: true
+
+#--
+# This file is part of Raketeer.
+# Copyright (c) 2019 Jonathan Bradley Whited (@esotericpig)
+# 
+# Raketeer is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+# 
+# Raketeer is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Lesser General Public License for more details.
+# 
+# You should have received a copy of the GNU Lesser General Public License
+# along with Raketeer.  If not, see <https://www.gnu.org/licenses/>.
+#++
+
+
+require 'date'
+require 'rake'
+
+require 'rake/tasklib'
+
+require 'raketeer/bump_ver'
+require 'raketeer/files_bumper'
+require 'raketeer/sem_ver'
+require 'raketeer/util'
+
+module Raketeer
+  ###
+  # @author Jonathan Bradley Whited (@esotericpig)
+  # @since  0.2.4
+  ###
+  class BumpTask < Rake::TaskLib
+    attr_accessor :bump_bundle
+    attr_accessor :bump_files # Looks for a version number
+    attr_accessor :bundle_cmd
+    attr_accessor :changelogs # Looks for 'Unreleased' & a Markdown header
+    attr_accessor :dry_run
+    attr_accessor :git_msg
+    attr_accessor :name
+    attr_accessor :ruby_files # Looks for {ruby_var}
+    attr_accessor :ruby_var
+    
+    alias_method :bump_bundle?,:bump_bundle
+    alias_method :dry_run?,:dry_run
+    
+    def initialize(name=:bump)
+      super()
+      
+      @bump_bundle = false
+      @bump_files = Rake::FileList[]
+      @bundle_cmd = 'bundle'
+      @changelogs = Rake::FileList['CHANGELOG.md']
+      @dry_run = false
+      @git_msg = %q(git commit -m 'Bump version to v%{version}')
+      @name = name
+      @ruby_files = Rake::FileList[File.join('lib','**','version.rb')]
+      @ruby_var = 'VERSION'
+      
+      yield self if block_given?()
+      define()
+    end
+    
+    def define()
+      desc 'Show/Set/Bump the version'
+      task @name,[:version] do |task,args|
+        check_env()
+        bump_all(BumpVer.new(
+          version: args.version,
+          major: ENV['major'],
+          minor: ENV['minor'],
+          patch: ENV['patch'],
+          prerelease: ENV['pre'],
+          build_meta: ENV['build']
+        ))
+      end
+      
+      namespace @name do
+        desc 'Bump/Set the major version'
+        task :major,[:major] do |task,args|
+          bump_ver = BumpVer.new(major: args.major)
+          
+          # You can't erase the major version (required)
+          bump_ver.major = '+1' if bump_ver.major.nil?() || bump_ver.major.empty?()
+          
+          check_env()
+          bump_all(bump_ver)
+        end
+        
+        desc 'Bump/Set the minor version'
+        task :minor,[:minor] do |task,args|
+          bump_ver = BumpVer.new(minor: args.minor)
+          bump_ver.minor = '+1' if bump_ver.minor.nil?()
+          
+          check_env()
+          bump_all(bump_ver)
+        end
+        
+        desc 'Bump/Set the patch version'
+        task :patch,[:patch] do |task,args|
+          bump_ver = BumpVer.new(patch: args.patch)
+          bump_ver.patch = '+1' if bump_ver.patch.nil?()
+          
+          check_env()
+          bump_all(bump_ver)
+        end
+        
+        desc 'Set/Erase the pre-release version'
+        task :pre,[:pre] do |task,args|
+          bump_ver = BumpVer.new(prerelease: args.pre)
+          bump_ver.prerelease = '' if bump_ver.prerelease.nil?()
+          
+          check_env()
+          bump_all(bump_ver)
+        end
+        
+        desc 'Set/Erase the build metadata'
+        task :build,[:build] do |task,args|
+          bump_ver = BumpVer.new(build_meta: args.build)
+          bump_ver.build_meta = '' if bump_ver.build_meta.nil?()
+          
+          check_env()
+          bump_all(bump_ver)
+        end
+        
+        desc 'Bump the Gemfile.lock version'
+        task :bundle do
+          check_env()
+          bump_bundle_file()
+        end
+        
+        desc "Show the help/usage for #{name} tasks"
+        task :help do
+          print_help()
+        end
+      end
+    end
+    
+    def bump_all(bump_ver)
+      sem_vers = []
+      
+      # Order matters for outputting the most accurate version
+      sem_vers << bump_ruby_files(bump_ver)
+      sem_vers << bump_bump_files(bump_ver)
+      sem_vers << bump_changelogs(bump_ver)
+      
+      sem_vers.compact!()
+      
+      if @bump_bundle && !bump_ver.empty?() && !sem_vers.empty?()
+        bump_bundle_file()
+      end
+      
+      # Always output it, in case the user just wants to see what the git message
+      # should be without making changes.
+      if !@git_msg.nil?() && !sem_vers.empty?()
+        puts '[Git]:'
+        puts '= ' + (@git_msg % {version: sem_vers[0].to_s()})
+      end
+    end
+    
+    def bump_bump_files(bump_ver)
+      bumper = FilesBumper.new(@bump_files,bump_ver,@dry_run)
+      
+      bumper.bump_files() do
+        next if bumper.changes > 0 || bumper.line !~ SemVer::REGEX
+        
+        break if bumper.bump_line!() && bumper.bump_ver_empty?()
+      end
+      
+      return bumper.version
+    end
+    
+    def bump_bundle_file()
+      sh_cmd = [@bundle_cmd,'list']
+      
+      puts "[#{sh_cmd.join(' ')}]:"
+      
+      if @dry_run
+        puts '= Nothing written (dry run)'
+        
+        return
+      end
+      
+      sh(*sh_cmd,{:verbose => false})
+    end
+    
+    # @see https://keepachangelog.com/en/1.0.0/
+    def bump_changelogs(bump_ver)
+      bumper = FilesBumper.new(@changelogs,bump_ver,@dry_run) do
+        @header_bumped = false
+        @unreleased_bumped = false
+      end
+      
+      header_regex = /\A(\s*##\s*\[+\D*)(#{SemVer::REGEX.to_s()})(.*)\z/m
+      unreleased_regex = /\A.*Unreleased.*http.*\.{3}/
+      
+      bumper.bump_files() do
+        if @header_bumped && @unreleased_bumped
+          if bumper.bump_ver_empty?()
+            break
+          else
+            next
+          end
+        end
+        
+        if bumper.line =~ unreleased_regex
+          next if @unreleased_bumped
+          
+          # Match from the end, in case the URL has a number (like '%20')
+          match = bumper.line.match(/(#{SemVer::REGEX.to_s()})(\.{3}.*)\z/m)
+          
+          next if match.nil?() || match.length < 3 || (i = match.begin(0)) < 1
+          
+          match = [bumper.line[0..i - 1],match[1],match[-1]]
+          
+          next if match.any?() {|m| m.nil?() || m.strip().empty?()}
+          
+          orig_line = bumper.line.dup()
+          bumper.line = match[1]
+          
+          if bumper.bump_line!(add_change: false)
+            bumper.line = match[0] << bumper.line << match[2]
+            
+            bumper.add_change(bumper.line,push: false)
+            
+            @unreleased_bumped = true
+          else
+            bumper.line = orig_line
+          end
+        elsif !(match = bumper.line.match(header_regex)).nil?()
+          next if @header_bumped || match.length < 4
+          
+          match = [match[1],match[2],match[-1]]
+          
+          next if match.any?() {|m| m.nil?() || m.strip().empty?()}
+          
+          orig_line = bumper.line.dup()
+          bumper.line = match[1]
+          
+          if bumper.bump_line!(add_change: false)
+            bumper.line = match[0] << bumper.line
+            
+            # Replace the date with today's date for the new Markdown header, if it exists
+            match[2].sub!(/\d+\s*\-\s*\d+\s*\-\s*\d+(.*)\z/m,"#{Date.today().strftime('%F')}\\1")
+            bumper.line << match[2]
+            
+            bumper.add_change(bumper.line,push: true)
+            bumper.line << "\n" # Don't print this newline to the console
+            
+            @header_bumped = true
+          end
+          
+          # We are adding a new Markdown header, so always set the line back to its original value
+          bumper.line = orig_line
+        end
+      end
+      
+      return bumper.version
+    end
+    
+    def bump_ruby_files(bump_ver)
+      bumper = FilesBumper.new(@ruby_files,bump_ver,@dry_run)
+      version_var_regex = /\A(\s*#{Regexp.quote(@ruby_var)}\s*=\D*)(#{SemVer::REGEX.to_s()})(.*)\z/m
+      
+      bumper.bump_files() do
+        next if bumper.changes > 0
+        next if (match = bumper.line.match(version_var_regex)).nil?()
+        next if match.length < 4
+        next if match[1..2].any?() {|m| m.nil?() || m.strip().empty?()}
+        
+        orig_line = bumper.line.dup()
+        bumper.line = match[2]
+        
+        if bumper.bump_line!(add_change: false)
+          bumper.line = match[1] << bumper.line
+          bumper.line << match[-1] unless match[-1].nil?()
+          
+          bumper.add_change(bumper.line,push: false)
+          
+          break if bumper.bump_ver_empty?()
+        else
+          bumper.line = orig_line
+        end
+      end
+      
+      return bumper.version
+    end
+    
+    def check_env()
+      env_dryrun = ENV['dryrun']
+      
+      if !env_dryrun.nil?() && !(env_dryrun = env_dryrun.to_s().strip()).empty?()
+        @dry_run = Util.to_bool(env_dryrun)
+      end
+    end
+    
+    def print_help()
+      puts <<-EOH
+rake #{@name}  # Print the current version
+
+# You can run a dry run for any task (will not write to files)
+rake #{@name} dryrun=true
+
+rake #{@name}[1.2.3-alpha.4-beta.5]       # Set the version manually
+rake #{@name} major=1 minor=2 patch=3     # Set the version numbers
+rake #{@name} pre=alpha.4 build=beta.5    # Set the version extensions
+rake #{@name} major=+1 minor=+1 patch=+1  # Bump the version numbers by 1
+rake #{@name} major=+2 minor=+3 patch=+4  # Bump the version numbers by X
+
+rake #{@name}:major          # Bump the major version by 1
+rake #{@name}:major[1]       # Set the major version
+rake #{@name}:major[+2]      # Bump the major version by 2
+rake #{@name}:minor          # Bump the minor version by 1
+rake #{@name}:minor[2]       # Set the minor version
+rake #{@name}:minor[+3]      # Bump the minor version by 3
+rake #{@name}:patch          # Bump the patch version by 1
+rake #{@name}:patch[3]       # Set the patch version
+rake #{@name}:patch[+4]      # Bump the patch version by 4
+rake #{@name}:pre            # Erase the pre-release version
+rake #{@name}:pre[alpha.4]   # Set the pre-release version
+rake #{@name}:build          # Erase the build metadata
+rake #{@name}:build[beta.5]  # Set the build metadata
+rake #{@name}:bundle         # Bump the Gemfile.lock version
+      EOH
+    end
+  end
+end

data/lib/raketeer/bump_ver.rb

@@ -0,0 +1,144 @@
+#!/usr/bin/env ruby
+# encoding: UTF-8
+# frozen_string_literal: true
+
+#--
+# This file is part of Raketeer.
+# Copyright (c) 2019 Jonathan Bradley Whited (@esotericpig)
+# 
+# Raketeer is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+# 
+# Raketeer is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Lesser General Public License for more details.
+# 
+# You should have received a copy of the GNU Lesser General Public License
+# along with Raketeer.  If not, see <https://www.gnu.org/licenses/>.
+#++
+
+
+require 'raketeer/sem_ver'
+
+module Raketeer
+  ###
+  # Bump Version
+  # 
+  # @author Jonathan Bradley Whited (@esotericpig)
+  # @since  0.2.4
+  ###
+  class BumpVer < SemVer
+    def initialize(version: nil,major: nil,minor: nil,patch: nil,prerelease: nil,build_meta: nil)
+      self.build_meta = build_meta
+      self.major = major
+      self.minor = minor
+      self.patch = patch
+      self.prerelease = prerelease
+      self.version = version
+    end
+    
+    def init_int_or_str(obj)
+      return nil if obj.nil?()
+      return obj if obj.is_a?(Integer)
+      
+      obj = obj.to_s().strip()
+      
+      return obj if obj.empty?() || obj[0] == '+'
+      return obj.to_i()
+    end
+    
+    def init_str(obj)
+      return obj.nil?() ? nil : obj.to_s().strip()
+    end
+    
+    def bump!(sem_ver)
+      if !@version.nil?()
+        sem_ver.version = @version
+      else
+        if !@major.nil?()
+          if @major.is_a?(Integer)
+            sem_ver.major = @major
+          elsif @major.empty?()
+            sem_ver.major = 0 # There must always be a major version
+          else
+            sem_ver.major = 0 if sem_ver.major.nil?()
+            sem_ver.major += @major.to_i()
+          end
+        end
+        
+        if !@minor.nil?()
+          if @minor.is_a?(Integer)
+            sem_ver.minor = @minor
+          elsif @minor.empty?()
+            sem_ver.minor = nil
+          else
+            sem_ver.minor = 0 if sem_ver.minor.nil?()
+            sem_ver.minor += @minor.to_i()
+          end
+        end
+        
+        if !@patch.nil?()
+          if @patch.is_a?(Integer)
+            sem_ver.patch = @patch
+          elsif @patch.empty?()
+            sem_ver.patch = nil
+          else
+            sem_ver.patch = 0 if sem_ver.patch.nil?()
+            sem_ver.patch += @patch.to_i()
+          end
+        end
+        
+        if !@prerelease.nil?()
+          if @prerelease.empty?()
+            sem_ver.prerelease = nil
+          else
+            sem_ver.prerelease = @prerelease
+          end
+        end
+        
+        if !@build_meta.nil?()
+          if @build_meta.empty?()
+            sem_ver.build_meta = nil
+          else
+            sem_ver.build_meta = @build_meta
+          end
+        end
+      end
+      
+      return sem_ver
+    end
+    
+    def bump_line!(line,sem_ver)
+      line.sub!(REGEX,bump!(sem_ver).to_s())
+      
+      return line
+    end
+    
+    def build_meta=(build_meta)
+      super(init_str(build_meta))
+    end
+    
+    def major=(major)
+      super(init_int_or_str(major))
+    end
+    
+    def minor=(minor)
+      super(init_int_or_str(minor))
+    end
+    
+    def patch=(patch)
+      super(init_int_or_str(patch))
+    end
+    
+    def prerelease=(prerelease)
+      super(init_str(prerelease))
+    end
+    
+    def version=(version)
+      super(init_str(version))
+    end
+  end
+end

data/lib/raketeer/files_bumper.rb

@@ -0,0 +1,141 @@
+#!/usr/bin/env ruby
+# encoding: UTF-8
+# frozen_string_literal: true
+
+#--
+# This file is part of Raketeer.
+# Copyright (c) 2019 Jonathan Bradley Whited (@esotericpig)
+# 
+# Raketeer is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+# 
+# Raketeer is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Lesser General Public License for more details.
+# 
+# You should have received a copy of the GNU Lesser General Public License
+# along with Raketeer.  If not, see <https://www.gnu.org/licenses/>.
+#++
+
+
+require 'raketeer/bump_ver'
+require 'raketeer/sem_ver'
+
+module Raketeer
+  ###
+  # @author Jonathan Bradley Whited (@esotericpig)
+  # @since  0.2.4
+  ###
+  class FilesBumper
+    attr_reader :bump_ver
+    attr_reader :bump_ver_empty
+    attr_accessor :changes
+    attr_reader :dry_run
+    attr_reader :files
+    attr_accessor :init_per_file
+    attr_accessor :line
+    attr_accessor :lines
+    attr_accessor :sem_ver
+    attr_accessor :version
+    attr_accessor :version_bumped # Was the version actually bumped?
+    
+    alias_method :bump_ver_empty?,:bump_ver_empty
+    alias_method :dry_run?,:dry_run
+    alias_method :version_bumped?,:version_bumped
+    
+    def initialize(files,bump_ver,dry_run,&init_per_file)
+      @bump_ver = bump_ver
+      @bump_ver_empty = bump_ver.empty?()
+      @dry_run = dry_run
+      @files = files.to_a()
+      @init_per_file = init_per_file
+      @sem_ver = nil
+      @version = nil
+      @version_bumped = false
+    end
+    
+    def add_change(line,push: true)
+      puts "+ #{line}"
+      
+      @changes += 1
+      @lines << line if push
+    end
+    
+    def bump_files(&block)
+      @files.each do |filename|
+        puts "[#{filename}]:"
+        
+        if !File.exist?(filename)
+          puts '! File does not exist'
+          
+          next
+        end
+        
+        @changes = 0 # For possible future use
+        @lines = []
+        @sem_ver = nil
+        
+        @init_per_file.call(self) unless @init_per_file.nil?()
+        
+        File.foreach(filename) do |line|
+          @line = line
+          
+          block.call(self) if !@line.strip().empty?()
+          
+          @lines << @line
+        end
+        
+        next if bump_ver_empty?()
+        
+        print '= '
+        
+        if @changes > 0
+          if dry_run?()
+            puts "Nothing written (dry run): #{@sem_ver}"
+          else
+            File.open(filename,'w') do |file|
+              file.puts @lines
+            end
+            
+            puts "#{@changes} change#{@changes == 1 ? '' : 's'} written"
+          end
+        else
+          puts "Nothing written (up-to-date): #{@sem_ver}"
+        end
+      end
+    end
+    
+    def bump_line!(add_change: true)
+      @sem_ver = SemVer.parse_line(@line)
+      
+      return false if @sem_ver.nil?()
+      
+      @version = @sem_ver if @version.nil?()
+      
+      if bump_ver_empty?()
+        puts "= #{@sem_ver}"
+        
+        return true
+      else
+        orig_line = @line.dup()
+        @bump_ver.bump_line!(@line,@sem_ver)
+        
+        if @line != orig_line
+          if !@version_bumped
+            @version = @sem_ver
+            @version_bumped = true
+          end
+          
+          self.add_change(@line,push: false) if add_change
+          
+          return true
+        end
+      end
+      
+      return false
+    end
+  end
+end

data/lib/raketeer/sem_ver.rb

@@ -0,0 +1,130 @@
+#!/usr/bin/env ruby
+# encoding: UTF-8
+# frozen_string_literal: true
+
+#--
+# This file is part of Raketeer.
+# Copyright (c) 2019 Jonathan Bradley Whited (@esotericpig)
+# 
+# Raketeer is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+# 
+# Raketeer is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Lesser General Public License for more details.
+# 
+# You should have received a copy of the GNU Lesser General Public License
+# along with Raketeer.  If not, see <https://www.gnu.org/licenses/>.
+#++
+
+
+module Raketeer
+  ###
+  # Semantic Version
+  # 
+  # This is a non-strict version of Semantic Versioning v2.0.0.
+  # 
+  # @author Jonathan Bradley Whited (@esotericpig)
+  # @since  0.2.4
+  # @see    https://semver.org
+  ###
+  class SemVer
+    REGEX = /\d+(\.\d+)?(\.\d+)?(\-[0-9A-Za-z\-\.]+)?(\+[0-9A-Za-z\-\.]+)?/
+    
+    attr_accessor :build_meta
+    attr_accessor :major
+    attr_accessor :minor
+    attr_accessor :patch
+    attr_accessor :prerelease
+    attr_accessor :version # If not +nil+, {to_s} will only return this.
+    
+    def initialize(major: nil,minor: nil,patch: nil,prerelease: nil,build_meta: nil)
+      @build_meta = build_meta
+      @major = major
+      @minor = minor
+      @patch = patch
+      @prerelease = prerelease
+      @version = nil
+    end
+    
+    def initialize_copy(orig)
+      super(orig)
+      
+      is_clone = caller[0].include?('clone')
+      
+      @build_meta = is_clone ? orig.build_meta.clone() : orig.build_meta.dup()
+      @major = is_clone ? orig.major.clone() : orig.major.dup()
+      @minor = is_clone ? orig.minor.clone() : orig.minor.dup()
+      @patch = is_clone ? orig.patch.clone() : orig.patch.dup()
+      @prerelease = is_clone ? orig.prerelease.clone() : orig.prerelease.dup()
+      @version = is_clone ? orig.version.clone() : orig.version.dup()
+    end
+    
+    def self.parse(str)
+      # Parsing backwards makes the logic easier
+      build_meta = str.split('+',2)
+      prerelease = build_meta[0].split('-',2)
+      numbers = prerelease[0].split('.',3)
+      
+      sem_ver = SemVer.new()
+      sem_ver.major = numbers[0].to_i() # There must always be a major version
+      
+      if numbers.length >= 2
+        minor = numbers[1].strip()
+        sem_ver.minor = minor.to_i() unless minor.empty?()
+        
+        if numbers.length == 3
+          patch = numbers[2].strip()
+          sem_ver.patch = patch.to_i() unless patch.empty?()
+        end
+      end
+      
+      if prerelease.length == 2
+        prerelease = prerelease[1].strip()
+        sem_ver.prerelease = prerelease unless prerelease.empty?()
+      end
+      
+      if build_meta.length == 2
+        build_meta = build_meta[1].strip()
+        sem_ver.build_meta = build_meta unless build_meta.empty?()
+      end
+      
+      return sem_ver
+    end
+    
+    def self.parse_line(line)
+      str = line[REGEX]
+      
+      return nil if str.nil?() || (str = str.strip()).empty?()
+      return parse(str)
+    end
+    
+    def empty?()
+      return @build_meta.nil?() &&
+             @major.nil?() &&
+             @minor.nil?() &&
+             @patch.nil?() &&
+             @prerelease.nil?() &&
+             @version.nil?()
+    end
+    
+    def to_s()
+      s = ''.dup()
+      
+      if !@version.nil?()
+        s << @version.to_s()
+      elsif !@major.nil?()
+        s << @major.to_s()
+        s << ".#{@minor.to_s()}" unless @minor.nil?()
+        s << ".#{@patch.to_s()}" unless @patch.nil?()
+        s << "-#{@prerelease.to_s()}" unless @prerelease.nil?()
+        s << "+#{@build_meta.to_s()}" unless @build_meta.nil?()
+      end
+      
+      return s
+    end
+  end
+end

data/lib/raketeer/util.rb

@@ -27,17 +27,15 @@ module Raketeer
   # @since  0.2.2
   ###
   module Util
+    # @since 0.2.4
+    TRUE_BOOLS = ['1','on','t','true','y','yes'].freeze()
+    
     def self.find_main_executable(bin_dir)
-      # Try any file
+      # Try the bin/ dir
       main_exe = Dir.glob(File.join(bin_dir,'*'))
       
       return File.basename(main_exe[0]) if main_exe.length == 1
       
-      # Try only .rb files
-      main_exe = Dir.glob(File.join(bin_dir,'*.rb'))
-      
-      return File.basename(main_exe[0]) if main_exe.length == 1
-      
       # Try using the main module
       main_mod = find_main_module()
       
@@ -63,5 +61,10 @@ module Raketeer
       
       return nil
     end
+    
+    # @since 0.2.4
+    def self.to_bool(obj)
+      return TRUE_BOOLS.include?(obj.to_s().downcase())
+    end
   end
 end

data/lib/raketeer/version.rb

@@ -22,5 +22,19 @@
 
 
 module Raketeer
-  VERSION = '0.2.3'
+  VERSION = '0.2.4'
+  
+  # @since 0.2.4
+  DEP_VERSIONS = {
+    'irb' => '~> 1.0'
+  }
+  
+  # @since 0.2.4
+  def self.try_require_dev(gem_name)
+    begin
+      require gem_name
+    rescue LoadError => e
+      raise e.exception("Add development dependency: '#{gem_name}','#{DEP_VERSIONS[gem_name]}'")
+    end
+  end
 end

data/raketeer.gemspec

@@ -52,8 +52,9 @@ Gem::Specification.new() do |spec|
   spec.required_ruby_version = '>= 2.1.10'
   
   # TODO: also add the below comment to the README & reword for user
+  # 
   # If it is a dependency specific to a task, then it should probably be added
-  # as a dev dependency (not a runtime dependency) so that a bunch of
+  # as a development dependency (not a runtime dependency) so that a bunch of
   # non-essential dependencies (to the user) are not added.
   # 
   # For example, if the user only uses the Nokogiri tasks, then they don't need
@@ -63,9 +64,11 @@ Gem::Specification.new() do |spec|
   # If the user uses the IRB task, then they will have to add 'irb' as a
   # development dependency in their own project's Gemspec.
   
+  dv = Raketeer::DEP_VERSIONS
+  
   spec.add_runtime_dependency 'rake' #,'~> 12.3'
   
   spec.add_development_dependency 'bundler','~> 1.17'
-  spec.add_development_dependency 'irb'    ,'~> 1.0'  # For IRBTask
-  spec.add_development_dependency 'yard'   ,'~> 0.9'  # For doc
+  spec.add_development_dependency 'irb'    ,dv['irb'] # For IRBTask
+  spec.add_development_dependency 'yard'   ,'~> 0.9'  # For documentation
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: raketeer
 version: !ruby/object:Gem::Version
-  version: 0.2.3
+  version: 0.2.4
 platform: ruby
 authors:
 - Jonathan Bradley Whited (@esotericpig)
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-07-30 00:00:00.000000000 Z
+date: 2019-08-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -80,12 +80,17 @@ files:
 - Rakefile
 - lib/raketeer.rb
 - lib/raketeer/all.rb
+- lib/raketeer/bump.rb
+- lib/raketeer/bump_task.rb
+- lib/raketeer/bump_ver.rb
+- lib/raketeer/files_bumper.rb
 - lib/raketeer/irb.rb
 - lib/raketeer/irb_task.rb
 - lib/raketeer/nokogiri_install_tasks.rb
 - lib/raketeer/nokogiri_installs.rb
 - lib/raketeer/run.rb
 - lib/raketeer/run_task.rb
+- lib/raketeer/sem_ver.rb
 - lib/raketeer/util.rb
 - lib/raketeer/version.rb
 - raketeer.gemspec