LswVersionInformationBundle

KO | EN

gitlite — search

#python #hacktoberfest #typescript #golang #rust #deep-learning #linux #docker #java #nodejs #vue #security #ios #openai

LswVersionInformationBundle

(★ 25)

Symfony2 bundle that adds output of SVN and Git "status" commands to the Web Debug Toolbar.

LswVersionInformationBundle Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

LswVersionInformationBundle
===========================

![screenshot](http://www.leaseweblabs.com/wp-content/uploads/2013/02/git_info.png)

![screenshot](http://www.leaseweblabs.com/wp-content/uploads/2013/02/svn_info.png)

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](http://www.leaseweblabs.com/2013/02/git-version-information-in-symfony2-wdt/)

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](http://www.leaseweblabs.com/2011/12/subversion-revision-information-in-the-symfony-debug-toolbar/)

### 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
<?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
```

All options available with default values:

```
# LSW Version Information configuration
lsw_version_information:
    root_dir: %kernel.root_dir%/../
    settings:
        show_icon: true
        show_current_branch: true
        show_latest_revision: false
        show_dirty_files: true
    collectors:
        hg: Lsw\VersionInformationBundle\DataCollector\HgRevisionInformationCollector
        git: Acme\DemoBundle\DataCollector\MyOwnGitCollectorImplementation # This is how to override the default git implementation
```

### Registering additional collectors
Additional collectors can be registered through the `collectors` configuration (see above).
A collector must implement the class `Lsw\VersionInformationBundle\RevisionInformation\RevisionInformationCollectorInterface`.

Equally, you can override the default `git` and `svn` collectors by specifying the collector key as `git` or `svn` respectively.

LswVersionInformationBundle

LswVersionInformationBundle Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

LswVersionInformationBundle

LswVersionInformationBundle Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README