Enhancement: Allow bumping Version

[localheinz]

This pull request

• allows bumping a Version

Fixes #7.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Comparison is base (8dcfba2) 98.48% compared to head (728af47) 98.64%.

Additional details and impacted files

@@             Coverage Diff              @@
##               main      #13      +/-   ##
============================================
+ Coverage     98.48%   98.64%   +0.16%     
- Complexity       68       71       +3     
============================================
  Files            13       13              
  Lines           198      222      +24     
============================================
+ Hits            195      219      +24     
  Misses            3        3              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[localheinz]

Not entirely sure whether this makes sense, see https://semver.org/#spec-item-11.

[dsentker]

@localheinz Oops, you were faster than me. I think your solution is more elegant.

My idea was to provide an update() method to overwrite specific parts of the version string.

Let's keep your implementation :-)

private function update(
        ?Major $major = null,
        ?Minor $minor = null,
        ?Patch $patch = null,
        ?PreRelease $preRelease = null,
        ?BuildMetaData $buildMetaData = null,
    ): self {
        $newMajor = $major ?? $this->major;
        $newMinor = $minor ?? $this->minor;
        $newPatch = $patch ?? $this->patch;
        $newPreRelease = $preRelease ?? $this->preRelease;
        $newBuildMetaData = $buildMetaData ?? $this->buildMetaData;

        $newVersionString = \sprintf(
            '%d.%d.%d-%s+%s',
            $newMajor->toInt(),
            $newMinor->toInt(),
            $newPatch->toInt(),
            $newPreRelease->toString(),
            $newBuildMetaData->toString(),
        );

        $newVersionString = \rtrim($newVersionString, '+'); // Strip build metadata character if empty
        $newVersionString = \rtrim($newVersionString, '-'); // Strip prerelease character if empty

        return self::fromString($newVersionString);
    }