puppet-composer

This module installs Composer, a dependency manager for PHP.

Installation

Using the Puppet Module Tool, install the willdurand/composer by running the following command:

puppet module install willdurand/composer

Otherwise, clone this repository and make sure to install the proper dependencies (puppet-wget):

git clone git://github.com/willdurand/puppet-composer.git modules/composer

Important: the right puppet-wget module is maestrodev/puppet-wget. You should not use any other puppet-wget module. Example42's module won't work for instance. So, please, run the following command:

git clone git://github.com/maestrodev/puppet-wget.git modules/wget

Usage

Include the composer class:

include composer

You can specify the command name you want to get, and the target directory (aka where to install Composer):

class { 'composer':
  command_name => 'composer',
  target_dir   => '/usr/local/bin'
}

You can also auto update composer by using the auto_update parameter. This will update Composer only when you will run Puppet.

class { 'composer':
  auto_update => true
}

You can specify a particular user that will be the owner of the Composer executable:

class { 'composer':
  user => 'foo',
}

It is also possible to specify a custom composer version:

class { 'composer':
  version => '1.0.0-alpha11',
}

Handle dependency order

Handle the PHP dependency with custom stages. Make composer wait for PHP.

class { 'composer':
  command_name => 'composer',
  target_dir   => '/usr/local/bin', 
  auto_update => true, 
  stage => last,
}
stage { 'last': }
Stage['main'] -> Stage['last']

Custom stages reference: http://docs.puppetlabs.com/puppet/3/reference/lang_run_stages.html

Running the tests

Install the dependencies using Bundler:

BUNDLE_GEMFILE=.gemfile bundle install

Run the following command:

BUNDLE_GEMFILE=.gemfile bundle exec rake spec

License

puppet-composer is released under the MIT License. See the bundled LICENSE file for details.