metasploit-version 0.1.2 → 0.1.3

data/features/metasploit-version/install/steps/gemspec_steps.rb

@@ -0,0 +1,19 @@
+Then(/^metasploit\-version should be development dependency with semantic version restriction in "(.*?)"$/) do |gemspec_path|
+  version_requirement = if defined? Metasploit::Version::Version::PRERELEASE
+    # require exactly this pre-release in case there are multiple prereleases for the same
+    # version number due to parallel branches.
+    "= #{Metasploit::Version::GEM_VERSION}"
+  elsif Metasploit::Version::Version::MAJOR < 1
+    # can only allow the PATCH to wiggle pre-1.0.0
+    "~> #{Metasploit::Version::Version::MAJOR}.#{Metasploit::Version::Version::MINOR}.#{Metasploit::Version::Version::PATCH}"
+  else
+    # can allow the MINOR to wiggle 1.0.0+
+    "~> #{Metasploit::Version::Version::MAJOR}.#{Metasploit::Version::Version::MINOR}"
+  end
+
+  check_file_content(
+      gemspec_path,
+      %r{spec\.add_development_dependency\s*(?<quote>'|")metasploit-version\k<quote>,\s*\k<quote>#{version_requirement}\k<quote>},
+      true
+  )
+end

data/features/metasploit-version/install/upgrading.feature

@@ -0,0 +1,19 @@
+Feature: metasploit-version install should add UPGRADING.md
+
+  `metasploit-version install` should generate UPGRADING.md which includes any information needed by downstream
+  consumers of the gem when upgrading to handle Deprecations or Incompatible Changes.
+
+  Scenario:
+    Given I successfully run `bundle gem upgraded`
+    And I cd to "upgraded"
+    And my git identity is configured
+    And I successfully run `git commit --message "bundle gem upgraded"`
+    And I unset the environment variable "TRAVIS_BRANCH"
+    And I set the environment variables to:
+      | variable            | value |
+      | TRAVIS_PULL_REQUEST | false |
+    When I successfully run `metasploit-version install --force --no-bundle-install`
+    Then the file "UPGRADING.md" should contain:
+      """
+      No Deprecations or Incompatible Changes have been introduced at this time
+      """

data/features/metasploit-version/install/version.feature

@@ -0,0 +1,11 @@
+Feature: metasploit-version install adds 'version.rb' to replace default 'version.rb'
+
+  The version.rb file from metasploit-version will follow semver.org and define `MAJOR`, `MINOR`, and `PATCH`.  If on
+  a branch, the `PRERELEASE` will also be defined.  Default implementations for `Version.full` and `Version.gem` will
+  be provided and `VERSION` and `GEM_VERSION` will be set to the respective method.
+
+  Scenario: No gemspec
+    Given a file matching %r<.*\.gemspec> should not exist
+    When I run `metasploit-version install`
+    Then the output should contain "No gemspec found"
+    And the exit status should not be 0

data/features/metasploit-version/install/version/namespace.feature

@@ -0,0 +1,157 @@
+Feature: metasploit-version install's 'version.rb' generate proper namespace nesting
+
+  The version.rb file from metasploit-version will generate the appropriately indented nesting for single and multiple
+  namespaces with proper conversion of underscored and dashes in the gem name to camel case and separate modules,
+  respectively
+
+  Scenario Outline: Top-level namespace
+    Given I successfully run `bundle gem <gem_name>`
+    And I cd to "<gem_name>"
+    And my git identity is configured
+    And I successfully run `git commit --message "bundle gem <gem_name>"`
+    And I unset the environment variable "TRAVIS_BRANCH"
+    And I set the environment variables to:
+      | variable            | value |
+      | TRAVIS_PULL_REQUEST | false |
+    When I successfully run `metasploit-version install --force --no-bundle-install`
+    Then the file "<version_rb_path>" should contain exactly:
+      """
+      module <namespace_name>
+        # Holds components of {VERSION} as defined by {http://semver.org/spec/v2.0.0.html semantic versioning v2.0.0}.
+        module Version
+          #
+          # CONSTANTS
+          #
+
+          # The major version number.
+          MAJOR = 0
+          # The minor version number, scoped to the {MAJOR} version number.
+          MINOR = 0
+          # The patch version number, scoped to the {MAJOR} and {MINOR} version numbers.
+          PATCH = 1
+
+          #
+          # Module Methods
+          #
+
+          # The full version string, including the {<namespace_name>::Version::MAJOR},
+          # {<namespace_name>::Version::MINOR}, {<namespace_name>::Version::PATCH}, and optionally, the
+          # `<namespace_name>::Version::PRERELEASE` in the
+          # {http://semver.org/spec/v2.0.0.html semantic versioning v2.0.0} format.
+          #
+          # @return [String] '{<namespace_name>::Version::MAJOR}.{<namespace_name>::Version::MINOR}.{<namespace_name>::Version::PATCH}' on master.
+          #   '{<namespace_name>::Version::MAJOR}.{<namespace_name>::Version::MINOR}.{<namespace_name>::Version::PATCH}-PRERELEASE'
+          #   on any branch other than master.
+          def self.full
+            version = "#{MAJOR}.#{MINOR}.#{PATCH}"
+
+            if defined? PRERELEASE
+              version = "#{version}-#{PRERELEASE}"
+            end
+
+            version
+          end
+
+          # The full gem version string, including the {<namespace_name>::Version::MAJOR},
+          # {<namespace_name>::Version::MINOR}, {<namespace_name>::Version::PATCH}, and optionally, the
+          # `<namespace_name>::Version::PRERELEASE` in the
+          # {http://guides.rubygems.org/specification-reference/#version RubyGems versioning} format.
+          #
+          # @return [String] '{<namespace_name>::Version::MAJOR}.{<namespace_name>::Version::MINOR}.{<namespace_name>::Version::PATCH}'
+          #   on master.  '{<namespace_name>::Version::MAJOR}.{<namespace_name>::Version::MINOR}.{<namespace_name>::Version::PATCH}.PRERELEASE'
+          #   on any branch other than master.
+          def self.gem
+            full.gsub('-', '.pre.')
+          end
+        end
+
+        # (see Version.gem)
+        GEM_VERSION = Version.gem
+
+        # (see Version.full)
+        VERSION = Version.full
+      end
+
+      """
+
+    Examples:
+      | gem_name  | version_rb_path          | namespace_name |
+      | single    | lib/single/version.rb    | Single         |
+      | two_words | lib/two_words/version.rb | TwoWords       |
+
+  Scenario Outline: Two-level namespace
+    Given I successfully run `bundle gem <gem_name>`
+    And I cd to "<gem_name>"
+    And my git identity is configured
+    And I successfully run `git commit --message "bundle gem <gem_name>"`
+    And I unset the environment variable "TRAVIS_BRANCH"
+    And I set the environment variables to:
+      | variable            | value |
+      | TRAVIS_PULL_REQUEST | false |
+    When I successfully run `metasploit-version install --force --no-bundle-install`
+    Then the file "<version_rb_path>" should contain exactly:
+      """
+      module <parent_module_name>
+        module <child_module_name>
+          # Holds components of {VERSION} as defined by {http://semver.org/spec/v2.0.0.html semantic versioning v2.0.0}.
+          module Version
+            #
+            # CONSTANTS
+            #
+
+            # The major version number.
+            MAJOR = 0
+            # The minor version number, scoped to the {MAJOR} version number.
+            MINOR = 0
+            # The patch version number, scoped to the {MAJOR} and {MINOR} version numbers.
+            PATCH = 1
+
+            #
+            # Module Methods
+            #
+
+            # The full version string, including the {<parent_module_name>::<child_module_name>::Version::MAJOR},
+            # {<parent_module_name>::<child_module_name>::Version::MINOR}, {<parent_module_name>::<child_module_name>::Version::PATCH}, and optionally, the
+            # `<parent_module_name>::<child_module_name>::Version::PRERELEASE` in the
+            # {http://semver.org/spec/v2.0.0.html semantic versioning v2.0.0} format.
+            #
+            # @return [String] '{<parent_module_name>::<child_module_name>::Version::MAJOR}.{<parent_module_name>::<child_module_name>::Version::MINOR}.{<parent_module_name>::<child_module_name>::Version::PATCH}' on master.
+            #   '{<parent_module_name>::<child_module_name>::Version::MAJOR}.{<parent_module_name>::<child_module_name>::Version::MINOR}.{<parent_module_name>::<child_module_name>::Version::PATCH}-PRERELEASE'
+            #   on any branch other than master.
+            def self.full
+              version = "#{MAJOR}.#{MINOR}.#{PATCH}"
+
+              if defined? PRERELEASE
+                version = "#{version}-#{PRERELEASE}"
+              end
+
+              version
+            end
+
+            # The full gem version string, including the {<parent_module_name>::<child_module_name>::Version::MAJOR},
+            # {<parent_module_name>::<child_module_name>::Version::MINOR}, {<parent_module_name>::<child_module_name>::Version::PATCH}, and optionally, the
+            # `<parent_module_name>::<child_module_name>::Version::PRERELEASE` in the
+            # {http://guides.rubygems.org/specification-reference/#version RubyGems versioning} format.
+            #
+            # @return [String] '{<parent_module_name>::<child_module_name>::Version::MAJOR}.{<parent_module_name>::<child_module_name>::Version::MINOR}.{<parent_module_name>::<child_module_name>::Version::PATCH}'
+            #   on master.  '{<parent_module_name>::<child_module_name>::Version::MAJOR}.{<parent_module_name>::<child_module_name>::Version::MINOR}.{<parent_module_name>::<child_module_name>::Version::PATCH}.PRERELEASE'
+            #   on any branch other than master.
+            def self.gem
+              full.gsub('-', '.pre.')
+            end
+          end
+
+          # (see Version.gem)
+          GEM_VERSION = Version.gem
+
+          # (see Version.full)
+          VERSION = Version.full
+        end
+      end
+
+      """
+
+    Examples:
+      | gem_name         | version_rb_path                 | parent_module_name | child_module_name |
+      | parent-single    | lib/parent/single/version.rb    | Parent             | Single            |
+      | parent-two_words | lib/parent/two_words/version.rb | Parent             | TwoWords          |

data/features/metasploit-version/install/version/prerelease.feature

@@ -0,0 +1,154 @@
+Feature: metasploit-version install conditionally defines PRERELEASE in version.rb
+
+  The version.rb file will define PRERELEASE to the branch's prerelease name when `metasploit-version install` is run on
+  a branch, while it will not define PRERELEASE on master.
+
+  Scenario: No PRERELEASE on master
+    Given I successfully run `bundle gem master`
+    And I cd to "master"
+    And I unset the environment variable "TRAVIS_BRANCH"
+    And I set the environment variables to:
+      | variable            | value |
+      | TRAVIS_PULL_REQUEST | false |
+    And my git identity is configured
+    And I successfully run `git commit --message "bundle gem master"`
+    When I successfully run `metasploit-version install --force --no-bundle-install`
+    Then the file "lib/master/version.rb" should contain exactly:
+      """
+      module Master
+        # Holds components of {VERSION} as defined by {http://semver.org/spec/v2.0.0.html semantic versioning v2.0.0}.
+        module Version
+          #
+          # CONSTANTS
+          #
+
+          # The major version number.
+          MAJOR = 0
+          # The minor version number, scoped to the {MAJOR} version number.
+          MINOR = 0
+          # The patch version number, scoped to the {MAJOR} and {MINOR} version numbers.
+          PATCH = 1
+
+          #
+          # Module Methods
+          #
+
+          # The full version string, including the {Master::Version::MAJOR},
+          # {Master::Version::MINOR}, {Master::Version::PATCH}, and optionally, the
+          # `Master::Version::PRERELEASE` in the
+          # {http://semver.org/spec/v2.0.0.html semantic versioning v2.0.0} format.
+          #
+          # @return [String] '{Master::Version::MAJOR}.{Master::Version::MINOR}.{Master::Version::PATCH}' on master.
+          #   '{Master::Version::MAJOR}.{Master::Version::MINOR}.{Master::Version::PATCH}-PRERELEASE'
+          #   on any branch other than master.
+          def self.full
+            version = "#{MAJOR}.#{MINOR}.#{PATCH}"
+
+            if defined? PRERELEASE
+              version = "#{version}-#{PRERELEASE}"
+            end
+
+            version
+          end
+
+          # The full gem version string, including the {Master::Version::MAJOR},
+          # {Master::Version::MINOR}, {Master::Version::PATCH}, and optionally, the
+          # `Master::Version::PRERELEASE` in the
+          # {http://guides.rubygems.org/specification-reference/#version RubyGems versioning} format.
+          #
+          # @return [String] '{Master::Version::MAJOR}.{Master::Version::MINOR}.{Master::Version::PATCH}'
+          #   on master.  '{Master::Version::MAJOR}.{Master::Version::MINOR}.{Master::Version::PATCH}.PRERELEASE'
+          #   on any branch other than master.
+          def self.gem
+            full.gsub('-', '.pre.')
+          end
+        end
+
+        # (see Version.gem)
+        GEM_VERSION = Version.gem
+
+        # (see Version.full)
+        VERSION = Version.full
+      end
+
+      """
+
+  Scenario Outline: PRERELEASE on branch
+    Given I successfully run `bundle gem branch`
+    And I cd to "branch"
+    And I unset the environment variable "TRAVIS_BRANCH"
+    And I set the environment variables to:
+      | variable            | value |
+      | TRAVIS_PULL_REQUEST | false |
+    And my git identity is configured
+    And I successfully run `git commit --message "bundle gem branch"`
+    And I successfully run `git checkout -b <branch>`
+    When I successfully run `metasploit-version install --force --no-bundle-install`
+    Then the file "lib/branch/version.rb" should contain exactly:
+      """
+      module Branch
+        # Holds components of {VERSION} as defined by {http://semver.org/spec/v2.0.0.html semantic versioning v2.0.0}.
+        module Version
+          #
+          # CONSTANTS
+          #
+
+          # The major version number.
+          MAJOR = 0
+          # The minor version number, scoped to the {MAJOR} version number.
+          MINOR = 0
+          # The patch version number, scoped to the {MAJOR} and {MINOR} version numbers.
+          PATCH = 1
+          # The prerelease version, scoped to the {MAJOR}, {MINOR}, and {PATCH} version numbers.
+          PRERELEASE = '<prerelease>'
+
+          #
+          # Module Methods
+          #
+
+          # The full version string, including the {Branch::Version::MAJOR},
+          # {Branch::Version::MINOR}, {Branch::Version::PATCH}, and optionally, the
+          # `Branch::Version::PRERELEASE` in the
+          # {http://semver.org/spec/v2.0.0.html semantic versioning v2.0.0} format.
+          #
+          # @return [String] '{Branch::Version::MAJOR}.{Branch::Version::MINOR}.{Branch::Version::PATCH}' on master.
+          #   '{Branch::Version::MAJOR}.{Branch::Version::MINOR}.{Branch::Version::PATCH}-PRERELEASE'
+          #   on any branch other than master.
+          def self.full
+            version = "#{MAJOR}.#{MINOR}.#{PATCH}"
+
+            if defined? PRERELEASE
+              version = "#{version}-#{PRERELEASE}"
+            end
+
+            version
+          end
+
+          # The full gem version string, including the {Branch::Version::MAJOR},
+          # {Branch::Version::MINOR}, {Branch::Version::PATCH}, and optionally, the
+          # `Branch::Version::PRERELEASE` in the
+          # {http://guides.rubygems.org/specification-reference/#version RubyGems versioning} format.
+          #
+          # @return [String] '{Branch::Version::MAJOR}.{Branch::Version::MINOR}.{Branch::Version::PATCH}'
+          #   on master.  '{Branch::Version::MAJOR}.{Branch::Version::MINOR}.{Branch::Version::PATCH}.PRERELEASE'
+          #   on any branch other than master.
+          def self.gem
+            full.gsub('-', '.pre.')
+          end
+        end
+
+        # (see Version.gem)
+        GEM_VERSION = Version.gem
+
+        # (see Version.full)
+        VERSION = Version.full
+      end
+
+      """
+
+    Examples:
+      | branch                      | prerelease    |
+      | staging/flood-release       | flood-release |
+      | bug/MSP-666/nasty           | nasty         |
+      | chore/MSP-1234/recurring    | recurring     |
+      | feature/MSP-1337/super-cool | super-cool    |

data/features/metasploit-version/install/version_spec/namespace.feature

@@ -0,0 +1,32 @@
+Feature: metasploit-version install's 'version_spec.rb' generates proper namespace from gem name
+
+  The version_spec.rb file from metasploit-version will use the fully-qualified name for the Version module under
+  the gem's namespace with proper conversion of underscored and dashes in the gem name to camel case and separate
+  modules, respectively
+
+  Scenario Outline:
+    Given I successfully run `bundle gem <gem_name>`
+    And I cd to "<gem_name>"
+    And my git identity is configured
+    And I successfully run `git commit --message "bundle gem <gem_name>"`
+    And I unset the environment variable "TRAVIS_BRANCH"
+    And I set the environment variables to:
+      | variable            | value |
+      | TRAVIS_PULL_REQUEST | false |
+    When I successfully run `metasploit-version install --force --no-bundle-install`
+    Then the file "<version_spec_rb_path>" should contain exactly:
+      """
+      RSpec.describe <fully_qualified_version_module> do
+        it_should_behave_like 'Metasploit::Version Version Module'
+      end
+
+      """
+
+    Examples:
+      | gem_name             | version_spec_rb_path                          | fully_qualified_version_module |
+      | single               | spec/lib/single/version_spec.rb               | Single::Version                |
+      | two_words            | spec/lib/two_words/version_spec.rb            | TwoWords::Version              |
+      | parent-child         | spec/lib/parent/child/version_spec.rb         | Parent::Child::Version         |
+      | two_words-child      | spec/lib/two_words/child/version_spec.rb      | TwoWords::Child::Version       |
+      | parent-two_words     | spec/lib/parent/two_words/version_spec.rb     | Parent::TwoWords::Version      |
+      | two_words-more_words | spec/lib/two_words/more_words/version_spec.rb | TwoWords::MoreWords::Version   |

data/features/metasploit-version/install/version_spec/testing/branch_from_master.feature

@@ -0,0 +1,40 @@
+Feature: metasploit-version install's 'version_spec.rb' catches when PRERELEASE is missing when branching from master
+
+  The version_spec.rb fiel from metasploit-version will catch errors if the user fails to add the PRERELEASE constant in
+  version.rb when branching from master.
+
+  Background:
+    Given I successfully run `bundle gem versioned`
+    And I cd to "versioned"
+    And my git identity is configured
+    And I successfully run `git commit --message "bundle gem versioned"`
+    And I unset the environment variable "TRAVIS_BRANCH"
+    And I set the environment variables to:
+      | variable            | value |
+      | TRAVIS_PULL_REQUEST | false |
+
+  Scenario: Installing metasploit-version on feature branch
+    Given I successfully run `git checkout -b feature/MSP-1234/metasploit-version`
+    And I successfully run `metasploit-version install --force --no-bundle-install`
+    Then I successfully run `rake spec`
+
+  Scenario: Branching from master without adding PRERELEASE
+    And I successfully run `metasploit-version install --force --no-bundle-install`
+    And I successfully run `rake spec`
+    And I successfully run `git add *`
+    And I successfully run `git commit --all --message "metasploit-version install"`
+    And I successfully run `git checkout -b feature/MSP-1337/super-cool`
+    Then the file "lib/versioned/version.rb" should not contain "    PRERELEASE ="
+    When I run `rake spec`
+    Then the exit status should not be 0
+    And the output should contain:
+      """
+             expected Versioned::Version::PRERELEASE to be defined.
+             Add the following to Versioned::Version:
+      """
+    And the output should contain:
+      """
+                 # The prerelease version, scoped to the {PATCH} version number.
+                 PRERELEASE = super-cool
+      """
+    And the output should contain " 1 failure"

data/features/metasploit-version/install/version_spec/testing/branching_from_branch.feature

@@ -0,0 +1,161 @@
+Feature: metasploit-version install's version_spec.rb catches errors with PRERELEASE when branching from another branch
+
+  The version_spec.rb file from metasploit-version will catch errors if the user fails to update the PRERELEASE
+  constant in version.rb to when going from one branch to another.
+
+  Background:
+    Given I successfully run `bundle gem double_branched`
+    And I cd to "double_branched"
+    And my git identity is configured
+    And I successfully run `git commit --message "bundle gem double_branched"`
+    And I unset the environment variable "TRAVIS_BRANCH"
+    And I set the environment variables to:
+      | variable            | value |
+      | TRAVIS_PULL_REQUEST | false |
+    And I successfully run `metasploit-version install --force --no-bundle-install`
+    And I successfully run `rake spec`
+    And I successfully run `git add *`
+    And I successfully run `git commit --all --message "metasploit-version install"`
+    And I successfully run `git checkout -b feature/MSP-1337/super-cool`
+    And I overwrite "lib/double_branched/version.rb" with:
+      """
+      module DoubleBranched
+        # Holds components of {VERSION} as defined by {http://semver.org/spec/v2.0.0.html semantic versioning v2.0.0}.
+        module Version
+          #
+          # CONSTANTS
+          #
+
+          # The major version number.
+          MAJOR = 0
+          # The minor version number, scoped to the {MAJOR} version number.
+          MINOR = 0
+          # The patch version number, scoped to the {MAJOR} and {MINOR} version numbers.
+          PATCH = 1
+          # The prerelease version, scoped to the {MAJOR}, {MINOR}, and {PATCH} version numbers.
+          PRERELEASE = 'super-cool'
+
+          #
+          # Module Methods
+          #
+
+          # The full version string, including the {DoubleBranched::Version::MAJOR},
+          # {DoubleBranched::Version::MINOR}, {DoubleBranched::Version::PATCH}, and optionally, the
+          # `DoubleBranched::Version::PRERELEASE` in the
+          # {http://semver.org/spec/v2.0.0.html semantic versioning v2.0.0} format.
+          #
+          # @return [String] '{DoubleBranched::Version::MAJOR}.{DoubleBranched::Version::MINOR}.{DoubleBranched::Version::PATCH}' on master.
+          #   '{DoubleBranched::Version::MAJOR}.{DoubleBranched::Version::MINOR}.{DoubleBranched::Version::PATCH}-PRERELEASE'
+          #   on any branch other than master.
+          def self.full
+            version = "#{MAJOR}.#{MINOR}.#{PATCH}"
+
+            if defined? PRERELEASE
+              version = "#{version}-#{PRERELEASE}"
+            end
+
+            version
+          end
+
+          # The full gem version string, including the {DoubleBranched::Version::MAJOR},
+          # {DoubleBranched::Version::MINOR}, {DoubleBranched::Version::PATCH}, and optionally, the
+          # `DoubleBranched::Version::PRERELEASE` in the
+          # {http://guides.rubygems.org/specification-reference/#version RubyGems versioning} format.
+          #
+          # @return [String] '{DoubleBranched::Version::MAJOR}.{DoubleBranched::Version::MINOR}.{DoubleBranched::Version::PATCH}'
+          #   on master.  '{DoubleBranched::Version::MAJOR}.{DoubleBranched::Version::MINOR}.{DoubleBranched::Version::PATCH}.PRERELEASE'
+          #   on any branch other than master.
+          def self.gem
+            full.gsub('-', '.pre.')
+          end
+        end
+
+        # (see Version.gem)
+        GEM_VERSION = Version.gem
+
+        # (see Version.full)
+        VERSION = Version.full
+      end
+
+      """
+    And I successfully run `rake spec`
+    And I successfully run `git checkout -b bug/MSP-666/needed-for-super-cool`
+
+  Scenario: With changing PRERELEASE
+    Given I overwrite "lib/double_branched/version.rb" with:
+      """
+      module DoubleBranched
+        # Holds components of {VERSION} as defined by {http://semver.org/spec/v2.0.0.html semantic versioning v2.0.0}.
+        module Version
+          #
+          # CONSTANTS
+          #
+
+          # The major version number.
+          MAJOR = 0
+          # The minor version number, scoped to the {MAJOR} version number.
+          MINOR = 0
+          # The patch version number, scoped to the {MAJOR} and {MINOR} version numbers.
+          PATCH = 1
+          # The prerelease version, scoped to the {MAJOR}, {MINOR}, and {PATCH} version numbers.
+          PRERELEASE = 'needed-for-super-cool'
+
+          #
+          # Module Methods
+          #
+
+          # The full version string, including the {DoubleBranched::Version::MAJOR},
+          # {DoubleBranched::Version::MINOR}, {DoubleBranched::Version::PATCH}, and optionally, the
+          # `DoubleBranched::Version::PRERELEASE` in the
+          # {http://semver.org/spec/v2.0.0.html semantic versioning v2.0.0} format.
+          #
+          # @return [String] '{DoubleBranched::Version::MAJOR}.{DoubleBranched::Version::MINOR}.{DoubleBranched::Version::PATCH}' on master.
+          #   '{DoubleBranched::Version::MAJOR}.{DoubleBranched::Version::MINOR}.{DoubleBranched::Version::PATCH}-PRERELEASE'
+          #   on any branch other than master.
+          def self.full
+            version = "#{MAJOR}.#{MINOR}.#{PATCH}"
+
+            if defined? PRERELEASE
+              version = "#{version}-#{PRERELEASE}"
+            end
+
+            version
+          end
+
+          # The full gem version string, including the {DoubleBranched::Version::MAJOR},
+          # {DoubleBranched::Version::MINOR}, {DoubleBranched::Version::PATCH}, and optionally, the
+          # `DoubleBranched::Version::PRERELEASE` in the
+          # {http://guides.rubygems.org/specification-reference/#version RubyGems versioning} format.
+          #
+          # @return [String] '{DoubleBranched::Version::MAJOR}.{DoubleBranched::Version::MINOR}.{DoubleBranched::Version::PATCH}'
+          #   on master.  '{DoubleBranched::Version::MAJOR}.{DoubleBranched::Version::MINOR}.{DoubleBranched::Version::PATCH}.PRERELEASE'
+          #   on any branch other than master.
+          def self.gem
+            full.gsub('-', '.pre.')
+          end
+        end
+
+        # (see Version.gem)
+        GEM_VERSION = Version.gem
+
+        # (see Version.full)
+        VERSION = Version.full
+      end
+
+      """
+    Then I successfully run `rake spec`
+
+  Scenario: Without changing PRERELEASE
+    Given the file "lib/double_branched/version.rb" should contain:
+      """
+          # The prerelease version, scoped to the {MAJOR}, {MINOR}, and {PATCH} version numbers.
+          PRERELEASE = 'super-cool'
+      """
+    When I run `rake spec`
+    Then the exit status should not be 0
+    And the output should contain:
+      """
+             expected: "needed-for-super-cool"
+                  got: "super-cool"
+      """
+    And the output should contain " 1 failure"