git integration

[defji]

git integration

[PHLAK]

Can you elaborate on how you would like this to work?

[jordanbrauer]

@defji The way I've integrated programatic semver handling to Git repository management, is like so – using command line automation tools (such as Robo):

/**
 * Tag the current state of the repository.
 *
 * @param string $version The name of the tag.
 * @param boolean $commitTag (optional) Commit the tag or not.
 * @return void
 */
public function tagRelease(string $version, bool $commitTag = true)
{
    if ($commitTag) {
        $this->taskGitStack()
            ->stopOnFail()
            ->tag('v'.ltrim($version, 'v'), 'Tag release for v'.$version)
            ->run();
    }
}

This is within a Robofile.php (using the Robo task runner) libraries' built-in Git support. It would then be used on the command line, like so:

php robo.phar tag:release v1.2.3

---

Even further – you can also automate entire releases using the tagRelease method (modified for your needs, of course) within another method.

/**
 * Release the next stable version of the package.
 *
 * @param string $version A valid semver version scheme string to set as the next version and tag.
 * @param bool $commit Should the changes be commited and tagged?
 * @return void
 */
public function releaseStable(string $version, bool $commit = true): void
{
    $this->checkoutMaster($commit);
    $this->tagRelease($version, $commit);
    $this->pushAll($version, $commit);
    $this->upgradeDocumentation($version, $commit);
    $this->upgradeChangelog($version, $commit);
    $this->removeTag($version, $commit);
    $this->tagRelease($version, $commit);
    $this->pushAll($version, $commit);
    echo PHP_EOL;
    $this->say("Successfully bumped version to <fg=blue>v</><fg=cyan>{$version}</>");
}

Used on the command line, like so:

php robo.phar release:stable v1.2.3

It's worked pretty good for my own needs. YMMV though. 🙂