sycersion 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 296451fb7d60ad509421f5bfdfa718e726a06f7377f063a4f27a5176fc3f8a8c
+  data.tar.gz: 8291b661655aed0ccce7f24e085e26185e8f6a43d7bca101c4dfcc77a34911a7
+SHA512:
+  metadata.gz: a21a9851fb8b5961565423189306c44ee6189d18c101e5f0c690d97977c11418eb5bd09c04e3ca4b5b80a7a42a05264e1867bba1a4a28eb9c428cb2c5e138f98
+  data.tar.gz: 94bcfc3960cc42798e5620f7bb391a10f6d945021e734ae1099bb2f88b333d71faf304aef964d16c324acd606ebe2533eff702be7f7164cffc18e46fab996a3b

data/.gitignore

@@ -0,0 +1,11 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.ruby-version

@@ -0,0 +1 @@
+3.2.6

data/.sycersion/environment.yml

@@ -0,0 +1,3 @@
+---
+- ".sycersion/version"
+- 0.1.0

data/.travis.yml

@@ -0,0 +1,7 @@
+---
+sudo: false
+language: ruby
+cache: bundler
+rvm:
+  - 2.5.7
+before_install: gem install bundler -v 1.17.3

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,74 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of experience,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at pierre@sugaryourcoffee.de. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

data/Gemfile

@@ -0,0 +1,6 @@
+source "https://rubygems.org"
+
+git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
+
+# Specify your gem's dependencies in sycersion.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,121 @@
+PATH
+  remote: .
+  specs:
+    sycersion (0.1.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activesupport (8.0.1)
+      base64
+      benchmark (>= 0.3)
+      bigdecimal
+      concurrent-ruby (~> 1.0, >= 1.3.1)
+      connection_pool (>= 2.2.5)
+      drb
+      i18n (>= 1.6, < 2)
+      logger (>= 1.4.2)
+      minitest (>= 5.1)
+      securerandom (>= 0.3)
+      tzinfo (~> 2.0, >= 2.0.5)
+      uri (>= 0.13.1)
+    aruba (1.1.2)
+      bundler (>= 1.17, < 3.0)
+      childprocess (>= 2.0, < 5.0)
+      contracts (>= 0.16.0, < 0.18.0)
+      cucumber (>= 2.4, < 7.0)
+      rspec-expectations (~> 3.4)
+      thor (~> 1.0)
+    base64 (0.2.0)
+    benchmark (0.4.0)
+    bigdecimal (3.1.9)
+    builder (3.3.0)
+    childprocess (4.1.0)
+    concurrent-ruby (1.3.5)
+    connection_pool (2.5.0)
+    contracts (0.17.2)
+    cucumber (6.1.0)
+      builder (~> 3.2, >= 3.2.4)
+      cucumber-core (~> 9.0, >= 9.0.1)
+      cucumber-create-meta (~> 4.0, >= 4.0.0)
+      cucumber-cucumber-expressions (~> 12.1, >= 12.1.1)
+      cucumber-gherkin (~> 18.1, >= 18.1.0)
+      cucumber-html-formatter (~> 13.0, >= 13.0.0)
+      cucumber-messages (~> 15.0, >= 15.0.0)
+      cucumber-wire (~> 5.0, >= 5.0.1)
+      diff-lcs (~> 1.4, >= 1.4.4)
+      mime-types (~> 3.3, >= 3.3.1)
+      multi_test (~> 0.1, >= 0.1.2)
+      sys-uname (~> 1.2, >= 1.2.2)
+    cucumber-core (9.0.1)
+      cucumber-gherkin (~> 18.1, >= 18.1.0)
+      cucumber-messages (~> 15.0, >= 15.0.0)
+      cucumber-tag-expressions (~> 3.0, >= 3.0.1)
+    cucumber-create-meta (4.0.0)
+      cucumber-messages (~> 15.0, >= 15.0.0)
+      sys-uname (~> 1.2, >= 1.2.2)
+    cucumber-cucumber-expressions (12.1.3)
+    cucumber-gherkin (18.1.1)
+      cucumber-messages (~> 15.0, >= 15.0.0)
+    cucumber-html-formatter (13.0.0)
+      cucumber-messages (~> 15.0, >= 15.0.0)
+    cucumber-messages (15.0.0)
+      protobuf-cucumber (~> 3.10, >= 3.10.8)
+    cucumber-tag-expressions (3.0.1)
+    cucumber-wire (5.0.1)
+      cucumber-core (~> 9.0, >= 9.0.1)
+      cucumber-cucumber-expressions (~> 12.1, >= 12.1.1)
+      cucumber-messages (~> 15.0, >= 15.0.0)
+    diff-lcs (1.5.1)
+    drb (2.2.1)
+    ffi (1.17.1)
+    i18n (1.14.7)
+      concurrent-ruby (~> 1.0)
+    logger (1.6.5)
+    middleware (0.1.0)
+    mime-types (3.6.0)
+      logger
+      mime-types-data (~> 3.2015)
+    mime-types-data (3.2025.0107)
+    minitest (5.25.4)
+    multi_test (0.1.2)
+    protobuf-cucumber (3.10.8)
+      activesupport (>= 3.2)
+      middleware
+      thor
+      thread_safe
+    rake (10.5.0)
+    rspec (3.13.0)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.2)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.3)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.2)
+    securerandom (0.4.1)
+    sys-uname (1.3.1)
+      ffi (~> 1.1)
+    thor (1.3.2)
+    thread_safe (0.3.6)
+    tzinfo (2.0.6)
+      concurrent-ruby (~> 1.0)
+    uri (1.0.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  aruba (~> 1.0)
+  bundler (~> 2.0)
+  rake (~> 10.0)
+  rspec (~> 3.0)
+  sycersion!
+
+BUNDLED WITH
+   2.2.26

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2020 Pierre Sugar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,133 @@
+# Sycersion
+
+**sycersion** is a command-line tool to manage application versions following
+the guiding principles of _semantic versioning_ found at
+[semver.org](https://semver.org).
+
+**sycersion** has a default start version of 0.1.0. This can be activitated with
+the initalization running `sycersion --init`. During this intialization another
+version can be chosen. The version is saved to the _version-file_ and also the
+_configuration-directory_ is created. While initialization **sycersion**
+additionally searches for files that contain a version according to semantic
+versioning and the user can select out of the list of files which version out of
+that files to intially start with.
+
+The _version-file_ and _configuration-directory_ are also created if the user is
+setting an initial version with `sycersion --set 0.1.1`. 
+
+If the version is updated the version is written into the _version-file_. Within
+the application the version can be read from the file and displayed somewhere in
+the application's UI.
+
+**sycersion** evaluates version numbers provided that they comply to semantic
+versioning.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'sycersion'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install sycersion
+
+## Usage
+
+* `--init`
+  Initializes the **sycersion** environment with _version_ and _version-file_
+* `-i`, `--info VERSION|SUMMARY`
+  Shows the current _version_ (default) or additionally information about the
+  _version-file_, the _configuration-directory_ and _code_ how to read the
+  version within an application.
+* `--inc MAJOR|MINOR|PATCH` 
+  increments the major, minor, patch part of the version.
+* `--set MAJOR.MINOR.PATCH[+BUILD|-PRE_RELEASE[+BUILD]]` 
+  sets the version where all three version parts need to be provided,
+  major.minor.patch with optionally adding a pre-release part and/or a build
+  part.
+* `--pre PRE-RELEASE`
+  Set the pre-release part in the version
+* `--build BUILD`
+  Set the build part in the version
+* `-c`, `--compare VERSION`
+  Compares the current version with the version provided following the semver
+  precedence guidline 
+* `--help`
+  Prints the command line help
+
+## Examples
+
+Initialize **sycersion**
+
+    $ sycersion --init
+
+Set the version with a pre-release
+
+    $ sycersion --set 0.1.1-beta.1.0
+
+Set the version with a build
+
+    $ sycersion --set 0.1.1+build-a.1
+
+Set the version with a pre-release and a build
+
+    $ sycersion --set 0.1.1-beta.1.0+build-a.1
+
+Show the current version
+
+    $ sycersion -i
+    0.1.1-beta.1.0+build-a.1
+    
+Increment minor part of the version 0.1.1, which will lead to 0.2.0
+
+    $ sycersion --inc minor
+    $ sycersion -i
+    0.2.0
+
+When increasing one of major, minor or patch, the subsequent numbers are eather
+reset to 0 or pre-release and build are removed.
+
+Compare the assumed current version 0.1.1 to the provided version
+
+    $ sycersion -c 0.1.1-alpha
+    0.1.1 > 0.1.1-alpha
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run
+`rake features` to run the tests. You can also run `bin/console` for an
+interactive prompt that will allow you to experiment. Running **sycersion** with
+`SYC_DEBUG=true sycersion [options]` will print debug information to the
+console.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To
+release a new version, update the version number with `sycersion --set X.Y.Z`
+while the version is accessible in `version.rb`, and then run `bundle exec rake
+release`, which will create a git tag for the version, push git commits and
+tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at
+https://github.com/sugaryourcoffee/sycersion. This project is intended to be a
+safe, welcoming space for collaboration, and contributors are expected to adhere
+to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+
+## License
+
+The gem is available as open source under the terms of the [MIT
+License](https://opensource.org/licenses/MIT).
+
+## Code of Conduct
+
+Everyone interacting in the Sycersion project’s codebases, issue trackers, chat
+rooms and mailing lists is expected to follow the [code of
+conduct](https://github.com/[USERNAME]/sycersion/blob/master/CODE_OF_CONDUCT.md).
+

data/Rakefile

@@ -0,0 +1,13 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+require "cucumber"
+require "cucumber/rake/task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec
+
+Cucumber::Rake::Task.new(:features) do |task|
+  task.cucumber_opts = "features --format pretty -x"
+  task.fork = false
+end

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "sycersion"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/bin/sycersion

@@ -0,0 +1,9 @@
+#!/usr/bin/env ruby
+
+require_relative '../lib/sycersion'
+
+# Kicking off the application by reading the arguments from commandline and
+# forwarding it to the `Runner` which is operating on the ARGV that is holding
+# the command line arguments
+runner = Sycersion::Runner.new(ARGV)
+runner.run

data/lib/sycersion/options.rb

@@ -0,0 +1,96 @@
+# frozen_string_literal: true
+
+require 'optparse'
+
+# Creating and managing version following semver. Part commangline parsing
+module Sycersion
+  # Parses the commandline arguments provided by the user and provides them to
+  # the calling class
+  class Options
+    attr_reader :options
+
+    #    SEMVER_REGEX = /^(\d+\.\d+\.\d+)-?(beta|staging|\w*)?$/
+
+    def initialize(argv)
+      @options = {}
+      parse(argv)
+    end
+
+    def parse(_argv)
+      parser = OptionParser.new do |opts|
+        opts.banner = banner
+
+        opts.on('--init',
+                'Setup the sycersion environment:',
+                '* file where the app version is stored',
+                '* initial version will be stored in version file',
+                '* code that provides the version to the application') do |opt|
+          @options[:init] = opt
+        end
+
+        opts.on('-i', '--info [VERSION|SUMMARY]', %i[version summary],
+                'Print information about the application version and environment:',
+                '* current version of the application (default)',
+                '* file where the app version is stored',
+                '* file where the version is read into the application') do |opt|
+          @options[:info] = opt || :version
+        end
+
+        opts.on('--inc [MAJOR|MINOR|PATCH]', %i[major minor patch],
+                'Increment the provided verion element (major, minor, patch)') do |opt|
+          @options[:inc] = opt
+        end
+
+        opts.on('--set MAJOR.MINOR.PATCH[+BUILD|-PRE_RELEASE+BUILD]',
+                Sycersion::SEMVER_REGEX,
+                'Set the application version according to semver:',
+                '* major.minor.patch optionally add a pre-release and/or build',
+                '* major.minor.patch-prerelease+build or',
+                '* major.minor.patch+build') do |opt|
+          @options[:set] = opt
+        end
+
+        opts.on('-p', '--pre PRE_RELEASE', Sycersion::SEMVER_PRE_RELEASE_REGEX,
+                'Set a pre-release suffix') do |opt|
+          @options[:pre_release] = opt
+        end
+
+        opts.on('-b', '--build BUILD', Sycersion::SEMVER_BUILD_REGEX,
+                'Set a build suffix') do |opt|
+          @options[:build] = opt
+        end
+
+        opts.on('-c', '--compare VERSION', Sycersion::SEMVER_REGEX,
+                'Compare current version with VERSION regarding precedence') do |opt|
+          @options[:compare] = opt
+        end
+
+        opts.on('-h', '--help', 'Show this help') do
+          puts opts
+          exit(0)
+        end
+      end
+
+      begin
+        puts "Run `#{File.basename($PROGRAM_NAME)} --help` for usage information" if ARGV.empty?
+        parser.parse!
+      rescue OptionParser::ParseError => e
+        warn e.message, "\n", options
+        parser.opts if ENV['SYC_DEBUG']
+        parser.parse(%w[--help])
+        exit(1)
+      end
+    end
+
+    def banner
+      program_name = File.basename($PROGRAM_NAME)
+      <<-CL_BANNER
+        Usage: #{program_name} [options]
+
+        #{program_name} supports applications to manage semantic versioning. Details
+        can be found at https://semver.org
+
+      CL_BANNER
+    end
+  end
+end

data/lib/sycersion/semver.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module Sycersion
+  SEMVER_REGEX = /
+    ^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)
+    (?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)
+    (?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?
+    (?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$
+  /x.freeze
+
+  SEMVER_LAX_REGEX = /
+    (0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)
+    (?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)
+    (?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?
+    (?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?
+  /x.freeze
+
+  SEMVER_PRE_RELEASE_REGEX = /
+    ^((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)
+    (?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*)?$
+  /x.freeze
+
+  SEMVER_BUILD_REGEX = /
+    ^([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*)$
+  /x.freeze
+
+  # Semver contains methods to support semver operations
+  class Semver
+    # semver_array is of the form ["major", "minor", "patch", "pre-release",
+    # "build"]. version creates a version string in the form
+    # major.minor.patch-per-release+build. If only a build is given it creates
+    # major.minor.patch+build.
+    def self.version(semver_array)
+      semver = "#{semver_array[0]}.#{semver_array[1]}.#{semver_array[2]}"
+      semver += "-#{semver_array[3]}" unless semver_array[3].to_s.empty?
+      semver += "+#{semver_array[4]}" unless semver_array[4].to_s.empty?
+      semver
+    end
+  end
+end

data/lib/sycersion/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Sycersion
+  VERSION = File.exist?('.sycersion/version') ? File.read('.sycersion/version') : '0.1.0'
+end

data/lib/sycersion/version_compare.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+module Sycersion
+  # Comparisson of two versions regarding semver guiding principles
+  class VersionCompare
+    COMPARATORS = ['=', '>', '<'].freeze
+    SUFFIX_REGEX = /([A-Za-z\-|\d]+)/.freeze
+    NUMBER_REGEX = /\A\d+\z/.freeze
+
+    def initialize
+      @current_version = Sycersion::VersionEnvironment.new
+                                                      .version
+                                                      .scan(Sycersion::SEMVER_REGEX)
+                                                      .flatten
+    end
+
+    # Compares two semantic versions. The expected representation of the versions is:
+    # ["major", "minor", "patch", "pre-release", "build"]
+    def compare(comparer, current = @current_version)
+      result = compare_core(current[0..2], comparer[0..2])
+      result = compare_pre_release(current[3], comparer[3]) if result.zero?
+      result_string(current, COMPARATORS[result], comparer)
+    end
+
+    def compare_core(core1, core2)
+      3.times do |_i|
+        result = core1.shift.to_i <=> core2.shift.to_i
+        return result unless result.zero?
+      end
+      0
+    end
+
+    def compare_pre_release(version1, version2)
+      result = compare_on_nil(version1, version2)
+      return result unless result.zero? && !(version1.nil? && version2.nil?)
+
+      parts1 = version1.scan(SUFFIX_REGEX).flatten
+      parts2 = version2.scan(SUFFIX_REGEX).flatten
+
+      result = compare_parts(parts1, parts2)
+      return result unless result.zero?
+
+      compare_pre_release_field_size(parts1, parts2)
+    end
+
+    def compare_parts(parts1, parts2)
+      [parts1.size, parts2.size].min.times do |_i|
+        value1 = parts1.shift
+        value2 = parts2.shift
+
+        result = compare_numerically(value1, value2)
+        return result unless result.zero?
+
+        result = compare_lexically(value1, value2)
+        return result unless result.zero?
+      end
+      0
+    end
+
+    def compare_pre_release_field_size(value1, value2)
+      value1.size <=> value2.size
+    end
+
+    def compare_lexically(value1, value2)
+      value1 <=> value2
+    end
+
+    def compare_numerically(value1, value2)
+      v1_is_number = value1.match(NUMBER_REGEX)
+      v2_is_number = value2.match(NUMBER_REGEX)
+      result = value1.to_i <=> value2.to_i if v1_is_number && v2_is_number
+      return result unless result.nil? || result.zero?
+      return 1 if v2_is_number
+      return -1 if v1_is_number
+
+      0
+    end
+
+    def compare_on_nil(value1, value2)
+      return 1 if value1.nil? && !value2.nil?
+      return -1 if !value1.nil? && value2.nil?
+
+      0
+    end
+
+    def result_string(value1, comparator, value2)
+      "#{Sycersion::Semver.version(value1)} #{comparator} #{Sycersion::Semver.version(value2)}"
+    end
+  end
+end