Update

1Overview

Temma's source code evolves over time, and it's important to get the latest versions, whether to benefit from bug fixes or to take advantage of new features.

The update method depends on whether you installed Temma using Composer, or using the installation script or by hand.

2With Composer

As with all Composer-managed dependency updates, simply type the following command:

$ composer update

The composer.json file contains the following directive:

"require": {
    "digicreon/temma-lib": "^2.X.0"
}

With X the current minor version number at the time you installed your project. In this way, you'll be able to retrieve all minor versions of Temma version 2 (which must not contain any non-backward-compatible modifications).

3Without Composer

Updating is done on the command line, using the comma tool:

$ bin/comma '\Temma\Cli\Temma' update

The command is run from the project root.

This command can take several options, in order to choose the version deployed and the update behavior.

3.1version

The version option can take several possible values:

• stable: (default value) Updates with files from the latest released version of Temma.
• latest : Updates with Temma's latest commited sources. This allows you to retrieve the latest developments, but takes a risk as these files may not have been thoroughly tested.
• A version number in the form X.Y.Z: Allows you to specify the precise version to be retrieved.

Examples:

$ bin/comma '\Temma\Cli\Temma' update --version=stable

$ bin/comma '\Temma\Cli\Temma' update --version=latest

$ bin/comma '\Temma\Cli\Temma' update --version=2.10.0

2.2force

The update is performed in a way that respects your use of Temma. By default, certain files or directories are not updated if they are not present in your file tree.

With the force option, you can request a more aggressive update, which may go as far as deleting files and replacing them with Temma files (in the requested version).

Three identical examples:

$ bin/comma '\Temma\Cli\Temma' update --force

$ bin/comma '\Temma\Cli\Temma' update --force=true

$ bin/comma '\Temma\Cli\Temma' update --force=yes

3Current version number

To find out the current version number of Temma, simply run the following command:

$ bin/comma '\Temma\Cli\Temma' info

You'll get the Temma version, as well as the Smarty version (if Smarty is installed):

Temma version:  2.8.0
Smarty version: 5.4.1