leaseweb/version-information-bundle

Adds output of SVN and Git 'status' commands to the Web Debug Toolbar

Installs: 11 841

Dependents: 0

Stars: 26

Watchers: 13

Forks: 6

Open Issues: 2

Language: PHP

v1.0.6 2015-02-10 13:43 UTC

README

screenshot

screenshot

How do the testers know what revision of our application they are testing and what branch or tag they are testing? This is especially a problem with acceptance testing where interactions between various systems are tested. Because the testers do not have command line access on the Linux machines that run the acceptance environment they cannot simply issue the "svn info" and "svn status" (or "git log -1" and "git status") commands like developers can.

Read the LeaseWebLabs blog about LswVersionInformationBundle

To solve this problem we wrote a Symfony bundle called LswVersionInformationBundle. It shows the output of the "svn info" and "svn status" (or "git log -1" and "git status") commands in a tab in the Symfony2 debug toolbar. This bundle is actually a rewrite of the Symfony1 "lwTestingInformationPlugin" we wrote a year ago that can be found on the link below.

Read the LeaseWebLabs blog about the Symfony1 version

Installation

To install LswVersionInformationBundle with Composer just add the following to your 'composer.json' file:

{
    require: {
        "leaseweb/version-information-bundle": "*",
        ...
    }
}

The next thing you should do is install the bundle by executing the following command:

php composer.phar update leaseweb/version-information-bundle

Finally, add the bundle to the registerBundles function of the AppKernel class in the 'app/AppKernel.php' file:

<?php
// app/AppKernel.php

public function registerBundles()
{
    ...

    if (in_array($this->getEnvironment(), array('dev', 'test'))) {
        ...
        $bundles[] = new Lsw\VersionInformationBundle\LswVersionInformationBundle();
    }

}

Now the Subversion (or Git) information should show up with a little 'svn' (or 'Git') icon in your debug toolbar.

Configuration

If you are using a custom folder structure in your Symfony2 application you have to modify your root_dir parameter. Otherwise collector won't be able to locate your vcs folder.

In your config.yml (if you have enabled the bundle only for dev environment use config_dev.yml instead)

# LSW Version Information configuration
lsw_version_information:
    root_dir: path/to/your/root