semantic versioning.php

Rayne semântica

Uma pequena biblioteca independente para analisar e comparar versões semânticas, que é compatível com a versão semântica 2.0.

Dependências

Produção

• Php 5.6 ou melhor

Desenvolvimento

• Compositor
• Git
• Phpunit

Configurar

Faça o download do compositor e instale rayne/semantic-versioning .

 composer require rayne/semantic-versioning

Testes

1. Clone o repositório

    git clone https://github.com/rayne/semantic-versioning.php.git
   

2. Instale as dependências de desenvolvimento

    composer install --dev
   

3. Execute os testes

    ./vendor/bin/phpunit
   

Exemplos

A biblioteca contém as seguintes classes:

• InvalidVersionException : Jogado pela SemanticVersion na entrada inválida

• SemanticComparator : O Comparador de Versão Semântica para comparar objetos SemanticVersion

• SemanticVersion : O analisador de versântico que lança uma RuntimeException de versões inválidas

Os exemplos fazem parte do conjunto de testes. Dê uma olhada no diretório tests para obter mais informações.

Interpretar versões semânticas

 use Rayne  SemanticVersioning  SemanticVersion ;

$ version = new SemanticVersion ( ' 1.0.0-beta+exp.sha.5114f85 ' );

assert ( ' 1.0.0-beta+exp.sha.5114f85 ' === ( string ) $ version );
assert ( 1                           === $ version -> getMajor ());
assert (   0                         === $ version -> getMinor ());
assert (     0                       === $ version -> getPatch ());
assert (      ' beta '                 === $ version -> getPre ());
assert (           ' exp.sha.5114f85 ' === $ version -> getMeta ());
assert ( ' 1.0.0-beta+exp.sha.5114f85 ' === $ version -> getVersion ());

assert ( true  === $ version -> isMajorRelease ());
assert ( false === $ version -> isMinorRelease ());
assert ( false === $ version -> isPatchRelease ());
assert ( true  === $ version -> isPreRelease ());

Compare versões semânticas

 use Rayne  SemanticVersioning  SemanticComparator ;
use Rayne  SemanticVersioning  SemanticVersion ;

$ comparator     = new SemanticComparator ;

$ alpha          = new SemanticVersion ( ' 1.0.0-alpha ' );
$ candidate      = new SemanticVersion ( ' 1.0.0-rc.1 ' );
$ candidate_meta = new SemanticVersion ( ' 1.0.0-rc.1+ci ' );
$ release        = new SemanticVersion ( ' 1.0.0 ' );

// $alpha < $candidate
assert ( $ comparator ( $ alpha , $ candidate ) < 0 );
assert ( $ comparator -> compare ( $ alpha , $ candidate ) < 0 );

// $candidate == $candidate_meta
assert ( $ comparator ( $ candidate , $ candidate_meta ) == 0 );
assert ( $ comparator -> compare ( $ candidate , $ candidate_meta ) == 0 );

// $release > $candidate
assert ( $ comparator ( $ release , $ candidate ) > 0 );
assert ( $ comparator -> compare ( $ release , $ candidate ) > 0 );

Classificar versões semânticas

 use Rayne  SemanticVersioning  SemanticComparator ;
use Rayne  SemanticVersioning  SemanticVersion ;

$ versions = [
	$ candidate = new SemanticVersion ( ' 1.0.0-rc.1 ' ),
	$ release   = new SemanticVersion ( ' 1.0.0 ' ),
	$ alpha     = new SemanticVersion ( ' 1.0.0-alpha ' ),
];

// Sort by semantic precedence.
usort ( $ versions , new SemanticComparator );

assert ( $ versions [ 0 ] === $ alpha );
assert ( $ versions [ 1 ] === $ candidate );
assert ( $ versions [ 2 ] === $ release );