kodedphp / stdlib

semver.php

<?php declare(strict_types=1);

const INVALID_VERSION_ARRAY = ['0.0.0', '0', '0'];
const SEMVER_REGEX = '/^([0-9]+\.[0-9]+\.[0-9]+)(?:\-([a-z0-9-]+(?:\.[a-z0-9-]+)*))?(?:\+([a-z0-9-]+(?:\.[a-z0-9-]+)*))?$/i';

/**
 * Returns the Koded version number from VERSION file.
 *
 * @param array $version
 * @return string SemVer-compliant version
 * @see http://semver.org/
 */
function get_version(array $version = []): string
{
    $v = get_complete_version($version);
    // Most common format (X.Y.Z)
    if (empty($v[1]) && empty($v[2])) {
        return $v[0];
    }
    // Special case when pre-release is ALPHA and build is empty
    if ('alpha' === strtolower($v[1]) && empty($v[2])) {
        $v[2] = get_git_changeset();
        return sprintf('%s-%s+%s', ...$v);
    }
    if (empty($v[2])) {
        return sprintf('%s-%s', ...$v);
    }
    if (empty($v[1])) {
        $v[1] = $v[2];
        return sprintf('%s+%s', ...$v);
    }
    return sprintf('%s-%s+%s', ...$v);
}

/**
 * @internal
 *
 * Returns the version parts in array.
 *
 * @param string $version
 * @return array If version is not parsed by the semver rules, returns 0-filled array
 */
function get_version_array(string $version): array
{
    if (!preg_match(SEMVER_REGEX, trim($version), $match)) {
        return INVALID_VERSION_ARRAY;
    }
    array_shift($match);
    $match = array_replace(INVALID_VERSION_ARRAY, $match);
    return array_map(fn($v) => empty($v) ? '0' : $v, $match);
}

/**
 * @internal
 *
 * Returns the array version from the VERSION file.
 * Checks the correctness of the provided version array.
 *
 * @param array $version
 * @return array Segmented version as array
 */
function get_complete_version(array $version): array
{
    if (empty($version)) {
        $version = match (true) {
            defined('VERSION') && is_array(VERSION) => get_version_array(join('-', array_filter(VERSION))),

The constant VERSION was not found. Maybe you did not declare it correctly or list all dependencies?

            is_file($version = __DIR__ . '/../../../VERSION'), // project dir relative to /vendor
            is_file($version = getcwd() . '/VERSION') => get_version_array(@file_get_contents($version)),

It seems like @file_get_contents($version) can also be of type false; however, parameter $version of get_version_array() does only seem to accept string, maybe add an additional type check?

            // @codeCoverageIgnoreStart
            default => INVALID_VERSION_ARRAY
            // @codeCoverageIgnoreEnd
        };
    }
    assert(3 === count($version), 'version array should have exactly 3 parts');

It seems like $version can also be of type string; however, parameter $value of count() does only seem to accept Countable|array, maybe add an additional type check?

    assert('' !== $version[1], 'pre-release is empty, should be zero or valid identifier');
    assert('' !== $version[2], 'build-metadata is empty, should be zero or valid identifier');
    return $version;

The expression return $version could return the type string which is incompatible with the type-hinted return array. Consider adding an additional type-check to rule them out.

}

/**
 * @internal
 *
 * Returns the the major version from VERSION file.
 *
 * @param array $version
 * @return int The major version
 */
function get_major_version(array $version): int
{
    return (int)get_complete_version($version)[0];
}

/**
 * @internal
 *
 * The result is the UTC timestamp of the changeset in "YmDHis" format.
 * This value is not guaranteed to be unique, but it is sufficient
 * for generating the development version numbers.
 *
 * @return string Returns the numeric identifier of the latest GIT changeset,
 * or root directory modification time on failure
 */
function get_git_changeset(): string
{
    $cwd = getcwd() . '/.';
    $format = 'YmdHis';
    $gitlog = proc_open('git log --pretty=format:%ct --quiet -l HEAD', [
        ['pipe', 'r'],
        ['pipe', 'w'],
        ['pipe', 'w'],
    ], $pipes, $cwd);
    if (false === is_resource($gitlog)) {
        return date($format, filemtime($cwd));
    }
    stream_set_blocking($pipes[2], false);
    $timestamp = stream_get_contents($pipes[1]);
    $timestamp = explode(PHP_EOL, $timestamp)[0] ?? '';
    // cleanup; avoid a deadlock
    fclose($pipes[0]);
    fclose($pipes[1]);
    fclose($pipes[2]);
    proc_close($gitlog);
    if (empty($timestamp)) {
        return date($format, filemtime($cwd));
    }
    // UNIX timestamps are stored in UTC
    return date_create_immutable('@' . $timestamp)->format($format);
}