2017 © Pedro Peláez
 

library version

Library that helps with managing the version number of Git-hosted PHP projects

image

sebastian/version

Library that helps with managing the version number of Git-hosted PHP projects

  • PHP
  • 87 Dependents
  • 0 Suggesters
  • 18 Forks
  • 0 Open issues
  • 10 Versions
  • 8 % Grown

The README.md

Version

Version is a library that helps with managing the version number of Git-hosted PHP projects., (*1)

Installation

You can add this library as a local, per-project dependency to your project using Composer:, (*2)

composer require sebastian/version

If you only need this library during development, for instance to run your project's test suite, then you should add it as a development-time dependency:, (*3)

composer require --dev sebastian/version

Usage

The constructor of the SebastianBergmann\Version class expects two parameters:, (*4)

  • $release is the version number of the latest release (X.Y.Z, for instance) or the name of the release series (X.Y) when no release has been made from that branch / for that release series yet.
  • $path is the path to the directory (or a subdirectory thereof) where the sourcecode of the project can be found. Simply passing __DIR__ here usually suffices.

Apart from the constructor, the SebastianBergmann\Version class has a single public method: getVersion()., (*5)

Here is a contrived example that shows the basic usage:, (*6)

<?php
$version = new SebastianBergmann\Version(
  '3.7.10', '/usr/local/src/phpunit'
);

var_dump($version->getVersion());
?>

string(18) "3.7.10-17-g00f3408"

When a new release is prepared, the string that is passed to the constructor as the first argument needs to be updated., (*7)

How SebastianBergmann\Version::getVersion() works

  • If $path is not (part of) a Git repository and $release is in X.Y.Z format then $release is returned as-is.
  • If $path is not (part of) a Git repository and $release is in X.Y format then $release is returned suffixed with -dev.
  • If $path is (part of) a Git repository and $release is in X.Y.Z format then the output of git describe --tags is returned as-is.
  • If $path is (part of) a Git repository and $release is in X.Y format then a string is returned that begins with X.Y and ends with information from git describe --tags.

The Versions

15/05 2018

dev-master

9999999-dev https://github.com/sebastianbergmann/version

Library that helps with managing the version number of Git-hosted PHP projects

  Sources   Download

BSD-3-Clause

The Requires

  • php ^7.1

 

03/10 2016

2.0.1

2.0.1.0 https://github.com/sebastianbergmann/version

Library that helps with managing the version number of Git-hosted PHP projects

  Sources   Download

BSD-3-Clause

The Requires

  • php >=5.6

 

04/02 2016

2.0.0

2.0.0.0 https://github.com/sebastianbergmann/version

Library that helps with managing the version number of Git-hosted PHP projects

  Sources   Download

BSD-3-Clause

The Requires

  • php >=5.6

 

21/06 2015

1.0.6

1.0.6.0 https://github.com/sebastianbergmann/version

Library that helps with managing the version number of Git-hosted PHP projects

  Sources   Download

BSD-3-Clause

24/02 2015

1.0.5

1.0.5.0 https://github.com/sebastianbergmann/version

Library that helps with managing the version number of Git-hosted PHP projects

  Sources   Download

BSD-3-Clause

15/12 2014

1.0.4

1.0.4.0 https://github.com/sebastianbergmann/version

Library that helps with managing the version number of Git-hosted PHP projects

  Sources   Download

BSD-3-Clause

07/03 2014

1.0.3

1.0.3.0 https://github.com/sebastianbergmann/version

Library that helps with managing the version number of Git-hosted PHP projects

  Sources   Download

BSD-3-Clause

12/02 2014

1.0.2

1.0.2.0 https://github.com/sebastianbergmann/version

Library that helps with managing the version number of Git-hosted PHP projects

  Sources   Download

BSD-3-Clause

29/05 2013

1.0.1

1.0.1.0 https://github.com/sebastianbergmann/version

Library that helps with managing the version number of Git-hosted PHP projects

  Sources   Download

BSD-3-Clause

05/01 2013

1.0.0

1.0.0.0 https://github.com/sebastianbergmann/version

Library that helps with managing the version number of Git-hosted PHP projects

  Sources   Download

BSD-3-Clause