falkorlib 0.4.8 → 0.4.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 24f2e16454b28d1ca83d3df97e64a245b1b0c01e
-  data.tar.gz: 2a4c42fc9214770ad2cf683adc8251f2ff8e4cbd
+  metadata.gz: 547ac0a671298d19987ffa23c3fac3d6172a94f9
+  data.tar.gz: 711e6f847ac8df89ccb2991978bcdb03852de130
 SHA512:
-  metadata.gz: 0d4ddf35ca1812050bdfa24c526adf855d32fe27dd2132ea9db044004a1a5463fa2726df6c18580c5d23715b6e8ca2f8ae993f18bd2cdf67cb98ab1b720a0357
-  data.tar.gz: dbe16737008ea26ac775fa79dc8100400dca0a659d4431808c60cce0b43705bb09e48b5d8ba9b82fb802431c2a133a70124f1c71772b2819734b509fd384593a
+  metadata.gz: 9bcc4f2c3d71e273642155008f898266606e32630b3a8d2c98eb15eba1b8c1f3f859ad18bfe6eae768bce777968f9034437e215c99d89e6a2c72daec16437f4d
+  data.tar.gz: c8043d01e52d548282c8266ad8adc8cf949bb60d11582f7283ec52b84e6cb8bd211355b5d1e5316c463ea09746fd68e4ac8c93154e91652df5e098485b220a34

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    falkorlib (0.4.8)
+    falkorlib (0.4.9)
       artii (>= 2.1)
       awesome_print (~> 1.2)
       configatron (~> 3.2)

data/lib/falkorlib/puppet/modules.rb

@@ -1,6 +1,6 @@
 # -*- encoding: utf-8 -*-
 ################################################################################
-# Time-stamp: <Fri 2015-05-08 11:21 svarrette>
+# Time-stamp: <Fri 2015-05-08 16:19 svarrette>
 ################################################################################
 # Interface for the main Puppet Module operations
 #
@@ -126,8 +126,8 @@ module FalkorLib  #:nodoc:
                 # Supported platforms
                 config[:platforms] = [ 'debian' ]
                 config[:dependencies] = [{
-                                             "name"          => "puppetlabs-stdlib",
-                                             "version_range" => ">= 1.0.0"
+                                             "name"                => "puppetlabs-stdlib",
+                                             "version_requirement" => ">=4.2.2 <5.0.0"
                                          }]
                 config[:params] = [ 'ensure', 'protocol', 'port', 'packagename' ]
                 #ap config
@@ -164,11 +164,11 @@ module FalkorLib  #:nodoc:
                 if FalkorLib::Git.init?(moduledir)
                     if FalkorLib::GitFlow.init?(moduledir)
                         info "=> preparing git-flow feature for the newly created module '#{config[:name]}'"
-                        FalkorLib::GitFlow.start('feature', "bootstraping", moduledir)
+                        FalkorLib::GitFlow.start('feature', "bootstrapping", moduledir)
                     end
                     [ 'metadata.json',
-                      'doc/', 'LICENSE', '.gitignore',
-                      'Gemfile', '.vagrant_init.rb', 'Rakefile', 'Vagrantfile' ].each do |f|
+                     'doc/', 'LICENSE', '.gitignore', '.ruby-version', '.ruby-gemset',
+                     'Gemfile', '.vagrant_init.rb', 'Rakefile', 'Vagrantfile' ].each do |f|
                         FalkorLib::Git.add(File.join(moduledir, f))
                     end
                 end
@@ -301,6 +301,7 @@ module FalkorLib  #:nodoc:
                     ans = options[:no_interaction] ? 'Yes' : ask(cyan("==> procceed? (Y|n)"), 'Yes')
                     next if ans =~ /n.*/i
                     if update_from_erb.include?(f)
+                        ap "=> updating #{f}.erb"
                         i += write_from_erb_template(File.join(templatedir, "#{f}.erb"),
                                                      File.join(moduledir,  f),
                                                      metadata,

data/lib/falkorlib/tasks/puppet_modules.rake

@@ -1,7 +1,7 @@
 # -*- encoding: utf-8 -*-
 ################################################################################
 # puppet_modules.rake - Special tasks for the management of Puppet modules
-# Time-stamp: <Thu 2015-05-07 18:51 svarrette>
+# Time-stamp: <Fri 2015-05-08 15:33 svarrette>
 #
 # Copyright (c) 2014 Sebastien Varrette <Sebastien.Varrette@uni.lu>
 #               http://varrette.gforge.uni.lu
@@ -130,10 +130,11 @@ namespace :templates do
 
 		[ 'readme', 'rake', 'vagrant' ].each do |t|
 			###########   templates:upgrade:{readme,rake,vagrant}   ###########
+            desc "Upgrade (overwrite) #{t.capitalize} using the current FalkorLib template"
 			task t.to_sym do
 				list = case t
 				       when 'readme'
-					       [ 'README.md', 'doc/contributing.md' ]
+					       [ 'README.md', 'doc/contributing.md', 'doc/vagrant.md' ]
 				       when 'rake' 
 					       [ 'Gemfile', 'Rakefile' ]
 				       when 'vagrant'
@@ -169,7 +170,7 @@ exclude_tests_paths = ['pkg/**/*','spec/**/*']
 #
 require 'puppet-lint/tasks/puppet-lint'
 
-PuppetLint.configuration.send('disable_autoloader_layout')
+#PuppetLint.configuration.send('disable_autoloader_layout')
 PuppetLint.configuration.send('disable_class_inherits_from_params_class')
 PuppetLint.configuration.send('disable_80chars')
 PuppetLint.configuration.ignore_paths = exclude_tests_paths

data/lib/falkorlib/version.rb

@@ -19,7 +19,7 @@ module FalkorLib #:nodoc:
         # MAJOR: Defines the major version
         # MINOR: Defines the minor version
         # PATCH: Defines the patch version
-	    MAJOR, MINOR, PATCH = 0, 4, 8  
+	    MAJOR, MINOR, PATCH = 0, 4, 9  
 	    
 	    module_function
 	    

data/spec/falkorlib/puppet_modules_spec.rb

@@ -2,7 +2,7 @@
 #########################################
 # puppet_modules_spec.rb
 # @author Sebastien Varrette <Sebastien.Varrette@uni.lu>
-# Time-stamp: <Fri 2015-05-08 11:23 svarrette>
+# Time-stamp: <Fri 2015-05-08 16:21 svarrette>
 #
 # @description Check the Puppet Modules operations
 #
@@ -71,8 +71,8 @@ describe FalkorLib::Puppet::Modules do
                     "toto::params",
                     "toto",
                     "toto::common",
-                    "toto::debian",
-                    "toto::redhat"
+                    "toto::common::debian",
+                    "toto::common::redhat"
                    ]
             c.size.should == ref.size
             c.each { |e| ref.should include(e) }
@@ -110,10 +110,10 @@ describe FalkorLib::Puppet::Modules do
                             'definitions',
                             'toto',
                             'toto::common',
-                            'toto::debian',
+                            'toto::common::debian',
+                            'toto::common::redhat',
                             'toto::mydef',
                             'toto::params',
-                            'toto::redhat',
                            ]
         end
 
@@ -147,12 +147,12 @@ describe FalkorLib::Puppet::Modules do
 			               ]
 		end
 
-		upgraded_files_default = 1
+		upgraded_files_default = 2
 		it "#upgrade" do
 			d = FalkorLib::Puppet::Modules.upgrade(moduledir, {
 				                                       :no_interaction => true
 			                                       })
-			d.should == upgraded_files_default
+            d.should == upgraded_files_default
 		end
 
 		it "#upgrade -- with only a subset of files" do
@@ -168,7 +168,8 @@ describe FalkorLib::Puppet::Modules do
 				                                       :no_interaction => true, 
 				                                       :exclude => [ 'README.md']
 			                                       })
-			d.should == (upgraded_files_default - 1)
+            d.should == 0
+			#d.should == (upgraded_files_default - 1)
 		end
 
 		it "#upgrade -- both include and exclude files" do

data/spec/falkorlib/versioning_puppet_module_spec.rb

@@ -2,7 +2,7 @@
 #########################################
 # versioning_puppet_module_spec.rb
 # @author Sebastien Varrette <Sebastien.Varrette@uni.lu>
-# Time-stamp: <Ven 2014-09-05 10:53 svarrette>
+# Time-stamp: <Fri 2015-05-08 16:28 svarrette>
 #
 # @description Check the versioning operations on Gems
 #
@@ -51,14 +51,14 @@ describe FalkorLib::Versioning::Puppet do
         ###################################################################
         context 'Test Puppet Module versioning operations within temporary directory' do
 
-
+            ap default_version
             it "#get_version -- get default version #{default_version} after initialization" do
                 Array.new(16).each { |e|  STDIN.should_receive(:gets).and_return('') }
                 FalkorLib::Puppet::Modules.init(moduledir)
                 v = FalkorLib::Versioning.get_version(moduledir)
                 v.should == default_version
                 if command?('git-flow')
-                    a = FalkorLib::GitFlow.finish('feature', 'bootstraping', moduledir)
+                    a = FalkorLib::GitFlow.finish('feature', 'bootstrapping', moduledir)
                     a.should == 0
                 end
             end

data/templates/puppet/modules/.gitignore

@@ -1,6 +1,5 @@
 .DS_Store
 .vagrant
 /.bundle/*
-.ruby-*
-.falkorlib.yaml
+.falkor*
 /pkg/*

data/templates/puppet/modules/README.md.erb

@@ -1,4 +1,4 @@
--*- mode: markdown; mode: auto-fill; fill-column: 80 -*-
+-*- mode: markdown; mode: visual-line;  -*-
 
 # <%= config[:shortname].capitalize %> Puppet Module 
 
@@ -16,16 +16,29 @@
 
 ## Synopsis
 
-<%= config[:description] %>
+<%= config[:description] %>.
 
 This module implements the following elements: 
 
-* __classes__:     `<%= config[:shortname] %>`
-* __definitions__: 
-  * `<%= config[:shortname] %>::mydef`: 
- 
-The various operations of this repository are piloted from a `Rakefile` which
-assumes that you have [RVM](https://rvm.io/) installed on your system.
+* __Puppet classes__:
+<% unless config[:classes].nil? %>
+<%    config[:classes].each do |cl| %>
+    - `<%= cl %>` 
+<%    end %>
+<% end %>
+
+* __Puppet definitions__: 
+<% unless config[:definitions].nil? %>
+<%    config[:definitions].each do |de| %>
+    - `<%= de %>` 
+<%    end %>
+<% end %>
+
+All these components are configured through a set of variables you will find in
+[`manifests/params.pp`](manifests/params.pp). 
+
+_Note_: the various operations that can be conducted from this repository are piloted from a [`Rakefile`](https://github.com/ruby/rake) and assumes you have a running [Ruby](https://www.ruby-lang.org/en/) installation.
+See [`doc/contributing.md`](doc/contributing.md) for more details on the steps you shall follow to have this `Rakefile` working properly. 
 
 ## Dependencies
 
@@ -35,19 +48,34 @@ See [`metadata.json`](metadata.json). In particular, this module depends on
 * [<%= dep["name"].gsub(/-/,"/") %>](https://forge.puppetlabs.com/<%= dep["name"].gsub(/-/,"/") %>)
 <% end %>
 
-## General Parameters
+## Overview and Usage
 
-See [manifests/params.pp](manifests/params.pp)
+### Class `<%= config[:shortname] %>`
 
-## Overview and Usage
+This is the main class defined in this module.
+It accepts the following parameters: 
 
-### class `<%= config[:shortname] %>`
+* `$ensure`: default to 'present', can be 'absent'
+
+Use is as follows:
 
      include ' <%= config[:shortname] %>'
 
-### definition `<%= config[:shortname] %>::mydef`
+See also [`tests/init.pp`](tests/init.pp)
 
-The definition `<%= config[:shortname] %>::mydef` provides ...
+<% unless config[:classes].nil? %>
+<%    config[:classes].each do |cl| %>
+### Class `<%= cl %>`
+
+See `tests/<%= cl.gsub(/::/, '/') %>.pp`
+<%    end %>
+<% end %>
+
+<% unless config[:definitions].nil? %>
+<%    config[:definitions].each do |de| %>
+### Definition `<%= de %>`
+
+The definition `<%= de %>` provides ...
 This definition accepts the following parameters:
 
 * `$ensure`: default to 'present', can be 'absent'
@@ -56,14 +84,18 @@ This definition accepts the following parameters:
 
 Example:
 
-      <%= config[:shortname] %>::mydef {'entry':
-           content => "entry\n",
-      }
+        <%= de %> { 'toto':
+		      ensure => 'present',
+        }
+
+See also `tests/<%= de.gsub(/::/, '/') %>.pp`
+
+<%    end %>
+<% end %>
 
 ## Librarian-Puppet / R10K Setup
 
-You can of course configure ULHPC-sudo in your `Puppetfile` to make it 
-available with [Librarian puppet](http://librarian-puppet.com/) or
+You can of course configure the <%= config[:shortname] %> module in your `Puppetfile` to make it available with [Librarian puppet](http://librarian-puppet.com/) or
 [r10k](https://github.com/adrienthebo/r10k) by adding the following entry:
 
      # Modules from the Puppet Forge
@@ -77,60 +109,20 @@ or, if you prefer to work on the git version:
 
 ## Issues / Feature request
 
-You can submit bug / issues / feature request using the 
-[<%= config[:name] %> Puppet Module Tracker](<%= config[:issues_url] %>). 
-
+You can submit bug / issues / feature request using the [<%= config[:name] %> Puppet Module Tracker](<%= config[:issues_url] %>). 
 
 ## Developments / Contributing to the code 
 
-If you want to contribute to the code, you shall be aware of the way this module
-is organized.
+If you want to contribute to the code, you shall be aware of the way this module is organized. 
 These elements are detailed on [`doc/contributing.md`](doc/contributing.md)
 
-You are more than welcome to contribute to its development by 
-[sending a pull request](https://help.github.com/articles/using-pull-requests). 
-
-## Tests on Vagrant box
-
-The best way to test this module in a non-intrusive way is to rely on
-[Vagrant](http://www.vagrantup.com/). The `Vagrantfile` at the root of the
-repository pilot the provisioning of the vagrant box and relies on boxes
-generated through my [vagrant-vms](https://github.com/falkor/vagrant-vms)
-repository.  
-Once cloned, run 
-
-      $> rake packer:Debian:init
-      
-To create a template. Select the version matching the once mentioned on the
-`Vagrantfile` (`7.6.0-amd64` for instance)
-Then run 
-
-      $> rake packer:Debian:build
-      
-This shall generate the vagrant box `debian-7.6.0-amd64.box` that you can then
-add to your box lists: 
-
-      $> vagrant box add debian-7.6.0-amd64  packer/debian-7.6.0-amd64/debian-7.6.0-amd64.box
-
-Now you can run `vagrant up` from this repository to boot the VM, provision it
-to be ready to test this module (see the [`.vagrant_init.rb`](.vagrant_init.rb)
-script). For instance, you can test the manifests of the `tests/` directory
-within the VM: 
-
-      $> vagrant ssh 
-      [...]
-      (vagrant)$> sudo puppet apply -t /vagrant/tests/init.pp
-      
-Run `vagrant halt` (or `vagrant destroy`) to stop (or kill) the VM once you've
-finished to play with it. 
+You are more than welcome to contribute to its development by [sending a pull request](https://help.github.com/articles/using-pull-requests). 
 
-## Resources
+## Puppet modules tests within a Vagrant box
 
-### Git 
+The best way to test this module in a non-intrusive way is to rely on [Vagrant](http://www.vagrantup.com/).
+The `Vagrantfile` at the root of the repository pilot the provisioning various vagrant boxes available on [Vagrant cloud](https://atlas.hashicorp.com/boxes/search?utf8=%E2%9C%93&sort=&provider=virtualbox&q=svarrette) you can use to test this module.
 
-You should become familiar (if not yet) with Git. Consider these resources: 
+See [`doc/vagrant.md`](doc/vagrant.md) for more details. 
 
-* [Git book](http://book.git-scm.com/index.html)
-* [Github:help](http://help.github.com/mac-set-up-git/)
-* [Git reference](http://gitref.org/)
 

data/templates/puppet/modules/Vagrantfile

@@ -21,8 +21,8 @@ Vagrant.configure(VAGRANTFILE_API_VERSION) do |config|
         }
     }.each do |name,cfg|
         boxname = name.to_s.downcase.gsub(/_/, '-')
-        config.vm.define boxname do |local|
-            local.vm.primary = true if cfg[:primary]
+        config.vm.define boxname, :primary => cfg[:primary] do |local|
+            #local.vm.primary = true if cfg[:primary]
             local.vm.box = cfg[:box]
             local.vm.host_name = ENV['VAGRANT_HOSTNAME'] || name.to_s.downcase.gsub(/_/, '-').concat(".vagrant.com")
             local.vm.provision "shell", path: ".vagrant_init.rb"

data/templates/puppet/modules/doc/contributing.md.erb

@@ -1,9 +1,8 @@
--*- mode: markdown; mode: auto-fill; fill-column: 80 -*-
+-*- mode: markdown; mode: visual-line; -*-
 
 # <%= config[:shortname].capitalize %> Puppet Module Developments
 
-If you want to contribute to the code, you shall be aware of the way this module
-is organized.   
+If you want to contribute to the code, you shall be aware of the way this module is organized.
 
 ### Directory Layout
 
@@ -15,7 +14,17 @@ is organized.
            `-- manifests/
                 `-- init.pp      # Main manifests file which defines the <%= config[:shortname] %> class 
                 `-- params.pp    # <%= config[:name] %> module variables 
-                `-- mydef.pp     # defines the <%= config[:shortname] %>::mydef  definition   
+<% unless config[:classes].nil? %>
+<%     config[:classes].each do |cl| %>
+<%        next if cl =~ /params/ %>
+                `-- <%= cl.gsub(/::/, '/') %>.pp 
+<%     end %>
+<% end %>
+<% unless config[:definitions].nil? %>
+<%     config[:definitions].each do |de| %>
+                `-- <%= de.gsub(/::/, '/') %>.pp 
+<%     end %>
+<% end %>
            `-- templates/        # Module ERB template files
            `-- tests/            # Contains examples showing how to declare the module’s classes and defined type
            `-- spec/             # Contains rspec tests 
@@ -28,21 +37,13 @@ is organized.
 
 ### Git Branching Model
 
-The Git branching model for this repository follows the guidelines of
-[gitflow](http://nvie.com/posts/a-successful-git-branching-model/).  
-In particular, the central repository holds two main branches with an infinite
-lifetime:  
+The Git branching model for this repository follows the guidelines of [gitflow](http://nvie.com/posts/a-successful-git-branching-model/).
+In particular, the central repository holds two main branches with an infinite lifetime: 
 
-* `<%= FalkorLib.config[:gitflow][:branches][:master] %>`: the branch holding
-  tags of the successive releases of this tutorial 
-* `<%= FalkorLib.config[:gitflow][:branches][:develop] %>`: the main branch
-  where the sources are in a state with the latest delivered development changes 
-  for the next release. This is the *default* branch you get when you clone the
-  repository, and the one on which developments will take places.  
+* `<%= FalkorLib.config[:gitflow][:branches][:master] %>`: the branch holding   tags of the successive releases of this tutorial 
+* `<%= FalkorLib.config[:gitflow][:branches][:develop] %>`: the main branch where the sources are in a state with the latest delivered development changes for the next release. This is the *default* branch you get when you clone the repository, and the one on which developments will take places.
 
-You should therefore install [git-flow](https://github.com/nvie/gitflow), and
-probably also its associated
-[bash completion](https://github.com/bobthecow/git-flow-completion).  
+You should therefore install [git-flow](https://github.com/nvie/gitflow), and probably also its associated [bash completion](https://github.com/bobthecow/git-flow-completion).  
 
 ### Ruby, [RVM](https://rvm.io/) and [Bundler](http://bundler.io/)
 
@@ -59,39 +60,31 @@ The ruby stuff part of this repository corresponds to the following files:
   project as [gemset](https://rvm.io/gemsets) name
 * `Gemfile[.lock]`: used by `[bundle](http://bundler.io/)`
 
-You should now be able to access the list of available tasks by running:
+### Repository Setup
+
+Then, to make your local copy of the repository ready to use the [git-flow](https://github.com/nvie/gitflow) workflow and the local [RVM](https://rvm.io/)  setup, you have to run the following commands once you cloned it for the first time: 
 
-	$> rake -T
+      $> gem install bundler    # assuming it is not yet available
+	  $> bundle install
+	  $> rake -T                # To list the available tasks
+      $> rake setup 
 
 You probably wants to activate the bash-completion for rake tasks.
 I personnaly use the one provided [here](https://github.com/ai/rake-completion)
 
 Also, some of the tasks are hidden. Run `rake -T -A` to list all of them. 
 
-### Repository Setup
-
-Then, to make your local copy of the repository ready to use the
-[git-flow](https://github.com/nvie/gitflow) workflow and the local
-[RVM](https://rvm.io/)  setup, you have to run the following commands once you
-cloned it for the first time: 
-
-      $> rake setup 
-
 ### RSpec tests
 
-A set of unitary tests are defined to validate the different function of my
-library using [Rspec](http://rspec.info/) 
+A set of unitary tests are defined to validate the different function of my library using [Rspec](http://rspec.info/) 
 
 You can run these tests by issuing:
 
 	$> rake rspec  # NOT YET IMPLEMENTED
 	
-By conventions, you will find all the currently implemented tests in the `spec/`
-directory, in files having the `_spec.rb` suffix. This is expected from the
-`rspec` task of the `Rakefile`.    
+By conventions, you will find all the currently implemented tests in the `spec/` directory, in files having the `_spec.rb` suffix. This is expected from the `rspec` task of the `Rakefile`.
 
-**Important** Kindly stick to this convention, and feature tests for all
-  definitions/classes/modules you might want to add. 
+**Important** Kindly stick to this convention, and feature tests for all   definitions/classes/modules you might want to add. 
 
 ### Releasing mechanism
 
@@ -117,15 +110,14 @@ For more information on the version, run:
 
 If a new  version number such be bumped, you simply have to run:
 
-      $> rake version:bump:{major,minor,patch}
+     $> rake version:bump:{major,minor,patch}
 
 This will start the release process for you using `git-flow`.
 Then, to make the release effective, just run:
 
-      $> rake version:release
+     $> rake version:release
 
-This will finalize the release using `git-flow`, create the appropriate tag and
-merge all things the way they should be. 
+This will finalize the release using `git-flow`, create the appropriate tag and merge all things the way they should be. 
 
 # Contributing Notes
 

data/templates/puppet/modules/doc/vagrant.md.erb

@@ -0,0 +1,59 @@
+-*- mode: markdown; mode: visual-line; -*-
+
+# <%= config[:shortname].capitalize %> Puppet Module Tests with Vagrant
+
+The best way to test this module in a non-intrusive way is to rely on [Vagrant](http://www.vagrantup.com/).
+[Vagrant](http://vagrantup.com/) uses [Oracle's VirtualBox](http://www.virtualbox.org/)
+to build configurable, lightweight, and portable virtual machines dynamically. 
+
+* [Reference installation notes](http://docs.vagrantup.com/v2/installation/) -- assuming you have installed [Oracle's VirtualBox](http://www.virtualbox.org/)
+* [installation notes on Mac OS](http://sourabhbajaj.com/mac-setup/Vagrant/README.html) using [Homebrew](http://brew.sh/) and [Cask](http://sourabhbajaj.com/mac-setup/Homebrew/Cask.html)
+
+The `Vagrantfile` at the root of the repository pilot the provisioning of many vagrant boxes generated through the [vagrant-vms](https://github.com/falkor/vagrant-vms) repository and available on [Vagrant cloud](https://atlas.hashicorp.com/boxes/search?utf8=%E2%9C%93&sort=&provider=virtualbox&q=svarrette).
+
+You can list the available vagrant box as follows:
+
+       $> vagrant status 
+	   Current machine states:
+
+       centos-7                  not created (virtualbox)
+	   debian-7                  not created (virtualbox)
+
+       This environment represents multiple VMs. The VMs are all listed
+	   above with their current state. For more information about a specific
+	   VM, run `vagrant status NAME`.
+
+As suggested, you can run a debian 7 machine for instance by issuing: 
+
+      $> vagrant up debian-7
+
+Then you can ssh into the machine afterwards:
+
+      $> vagrant ssh debian-7
+
+When you run `vagrant up <os>` to boot the VM, it is configured to be provisioned with the `.vagrant_init.rb` script.
+This script is responsible for two main tasks:
+
+1. pre-install the puppet modules listed as dependencies in `metadata.json`
+2. make the appropriate symbolic link in the puppet module directory (to `/vagrant`) to ensure you can directly make changes and correct your own module transparently within the box. 
+
+So you can test the manifests of the `tests/` directory within the VM:
+
+      $> vagrant ssh <os>
+      [...]
+      (vagrant)$> sudo puppet apply -t /vagrant/tests/init.pp
+
+From now on, you can test (with --noop) the other manifests. 
+
+Run `vagrant halt` (or `vagrant destroy`) to stop (or kill) the VM once you've finished to play with it.
+
+_Note_: The `Vagrantfile` at the root of this repository might evolve over the time with new boxes. To automatically get the last version available:
+
+1. Upgrade the [`falkorlib`](https://rubygems.org/gems/falkorlib) gem
+
+          $> bundle update falkorlib
+		  $> git commit -s -m "Upgrade falkorlib to the latest version" Gemfile.lock
+
+2. update the `Vagrantfile` to the last version by issuing:
+
+          $> rake templates:upgrade:vagrant

data/templates/puppet/modules/manifests/common/debian.pp.erb

@@ -0,0 +1,10 @@
+# File::      <tt>common/debian.pp</tt>
+# Author::    <%= config[:author] %> (<%= config[:mail] %>)
+# Copyright:: Copyright (c) <%= Time.now.year %> <%= config[:author] %>
+# License::   <%= config[:license].capitalize %>
+#
+# ------------------------------------------------------------------------------
+# = Class: <%= config[:shortname] %>::debian
+#
+# Specialization class for Debian systems
+class <%= config[:shortname] %>::common::debian inherits <%= config[:shortname] %>::common { }

data/templates/puppet/modules/manifests/common/redhat.pp.erb

@@ -0,0 +1,10 @@
+# File::      <tt>common/redhat.pp</tt>
+# Author::    <%= config[:author] %> (<%= config[:mail] %>)
+# Copyright:: Copyright (c) <%= Time.now.year %> <%= config[:author] %>
+# License::   <%= config[:license].capitalize %>
+#
+# ------------------------------------------------------------------------------
+# = Class: <%= config[:shortname] %>::debian
+#
+# Specialization class for Debian systems
+class <%= config[:shortname] %>::common::redhat inherits <%= config[:shortname] %>::common { }

data/templates/puppet/modules/manifests/common.pp.erb

@@ -0,0 +1,127 @@
+# File::      <tt>common.pp</tt>
+# Author::    <%= config[:author] %> (<%= config[:mail] %>)
+# Copyright:: Copyright (c) <%= Time.now.year %> <%= config[:author] %>
+# License::   <%= config[:license].capitalize %>
+#
+# ------------------------------------------------------------------------------
+# = Class: <%= config[:shortname] %>::common
+#
+# Base class to be inherited by the other <%= config[:shortname] %> classes, containing the common code.
+#
+# Note: respect the Naming standard provided here[http://projects.puppetlabs.com/projects/puppet/wiki/Module_Standards]
+
+class <%= config[:shortname] %>::common {
+
+    # Load the variables used in this module. Check the params.pp file
+    require <%= config[:shortname] %>::params
+
+    package { '<%= config[:shortname] %>':
+        name    => "${<%= config[:shortname] %>::params::packagename}",
+        ensure  => "${<%= config[:shortname] %>::ensure}",
+    }
+    # package { $<%= config[:shortname] %>::params::extra_packages:
+    #     ensure => 'present'
+    # }
+
+    if $<%= config[:shortname] %>::ensure == 'present' {
+
+        # Prepare the log directory
+        file { "${<%= config[:shortname] %>::params::logdir}":
+            ensure => 'directory',
+            owner  => "${<%= config[:shortname] %>::params::logdir_owner}",
+            group  => "${<%= config[:shortname] %>::params::logdir_group}",
+            mode   => "${<%= config[:shortname] %>::params::logdir_mode}",
+            require => Package['<%= config[:shortname] %>'],
+        }
+
+        # Configuration file
+        # file { "${<%= config[:shortname] %>::params::configdir}":
+        #     ensure => 'directory',
+        #     owner  => "${<%= config[:shortname] %>::params::configdir_owner}",
+        #     group  => "${<%= config[:shortname] %>::params::configdir_group}",
+        #     mode   => "${<%= config[:shortname] %>::params::configdir_mode}",
+        #     require => Package['<%= config[:shortname] %>'],
+        # }
+        # Regular version using file resource
+        file { '<%= config[:shortname] %>.conf':
+            path    => "${<%= config[:shortname] %>::params::configfile}",
+            owner   => "${<%= config[:shortname] %>::params::configfile_owner}",
+            group   => "${<%= config[:shortname] %>::params::configfile_group}",
+            mode    => "${<%= config[:shortname] %>::params::configfile_mode}",
+            ensure  => "${<%= config[:shortname] %>::ensure}",
+            #content => template("<%= config[:shortname] %>/<%= config[:shortname] %>conf.erb"),
+            #source => "puppet:///modules/<%= config[:shortname] %>/<%= config[:shortname] %>.conf",
+            #notify  => Service['<%= config[:shortname] %>'],
+            require => [
+                        #File["${<%= config[:shortname] %>::params::configdir}"],
+                        Package['<%= config[:shortname] %>']
+                        ],
+        }
+
+        # # Concat version -- see https://forge.puppetlabs.com/puppetlabs/concat
+        # include concat::setup
+        # concat { "${<%= config[:shortname] %>::params::configfile}":
+        #     warn    => false,
+        #     owner   => "${<%= config[:shortname] %>::params::configfile_owner}",
+        #     group   => "${<%= config[:shortname] %>::params::configfile_group}",
+        #     mode    => "${<%= config[:shortname] %>::params::configfile_mode}",
+        #     #notify  => Service['<%= config[:shortname] %>'],
+        #     require => Package['<%= config[:shortname] %>'],
+        # }
+        # # Populate the configuration file
+        # concat::fragment { "${<%= config[:shortname] %>::params::configfile}_header":
+        #     target  => "${<%= config[:shortname] %>::params::configfile}",
+        #     ensure  => "${<%= config[:shortname] %>::ensure}",
+        #     content => template("<%= config[:shortname] %>/<%= config[:shortname] %>_header.conf.erb"),
+        #     #source => "puppet:///modules/<%= config[:shortname] %>/<%= config[:shortname] %>_header.conf",
+        #     order   => '01',
+        # }
+        # concat::fragment { "${<%= config[:shortname] %>::params::configfile}_footer":
+        #     target  => "${<%= config[:shortname] %>::params::configfile}",
+        #     ensure  => "${<%= config[:shortname] %>::ensure}",
+        #     content => template("<%= config[:shortname] %>/<%= config[:shortname] %>_footer.conf.erb"),
+        #     #source => "puppet:///modules/<%= config[:shortname] %>/<%= config[:shortname] %>_footer.conf",
+        #     order   => '99',
+        # }
+
+        # PID file directory
+        # file { "${<%= config[:shortname] %>::params::piddir}":
+        #     ensure  => 'directory',
+        #     owner   => "${<%= config[:shortname] %>::params::piddir_user}",
+        #     group   => "${<%= config[:shortname] %>::params::piddir_group}",
+        #     mode    => "${<%= config[:shortname] %>::params::piddir_mode}",
+        # }
+
+        file { "${<%= config[:shortname] %>::params::configfile_init}":
+            owner   => "${<%= config[:shortname] %>::params::configfile_owner}",
+            group   => "${<%= config[:shortname] %>::params::configfile_group}",
+            mode    => "${<%= config[:shortname] %>::params::configfile_mode}",
+            ensure  => "${<%= config[:shortname] %>::ensure}",
+            #content => template("<%= config[:shortname] %>/default/<%= config[:shortname] %>.erb"),
+            #source => "puppet:///modules/<%= config[:shortname] %>/default/<%= config[:shortname] %>.conf",
+            notify  =>  Service['<%= config[:shortname] %>'],
+            require =>  Package['<%= config[:shortname] %>']
+        }
+
+        service { '<%= config[:shortname] %>':
+            name       => "${<%= config[:shortname] %>::params::servicename}",
+            enable     => true,
+            ensure     => running,
+            hasrestart => "${<%= config[:shortname] %>::params::hasrestart}",
+            pattern    => "${<%= config[:shortname] %>::params::processname}",
+            hasstatus  => "${<%= config[:shortname] %>::params::hasstatus}",
+            require    => [
+                           Package['<%= config[:shortname] %>'],
+                           File["${<%= config[:shortname] %>::params::configfile_init}"]
+                           ],
+            subscribe  => File['<%= config[:shortname] %>.conf'],
+        }
+    }
+    else
+    {
+        # Here $<%= config[:shortname] %>::ensure is 'absent'
+
+    }
+
+}
+

data/templates/puppet/modules/manifests/init.pp.erb

@@ -22,12 +22,12 @@
 #
 # == Sample Usage:
 #
-#     import <%= config[:name] %>
+#     include '<%= config[:shortname] %>'
 #
 # You can then specialize the various aspects of the configuration,
 # for instance:
 #
-#         class { '<%= config[:name] %>':
+#         class { '<%= config[:shortname] %>':
 #             ensure => 'present'
 #         }
 #
@@ -39,159 +39,25 @@
 #
 # [Remember: No empty lines between comments and class definition]
 #
-class <%= config[:name] %>(
-    $ensure = $<%= config[:name] %>::params::ensure
+class <%= config[:shortname] %>(
+    $ensure = $<%= config[:shortname] %>::params::ensure
 )
-inherits <%= config[:name] %>::params
+inherits <%= config[:shortname] %>::params
 {
-    info ("Configuring <%= config[:name] %> (with ensure = ${ensure})")
+    info ("Configuring <%= config[:shortname] %> (with ensure = ${ensure})")
 
     if ! ($ensure in [ 'present', 'absent' ]) {
-        fail("<%= config[:name] %> 'ensure' parameter must be set to either 'absent' or 'present'")
+        fail("<%= config[:shortname] %> 'ensure' parameter must be set to either 'absent' or 'present'")
     }
 
     case $::operatingsystem {
-        debian, ubuntu:         { include <%= config[:name] %>::debian }
-        redhat, fedora, centos: { include <%= config[:name] %>::redhat }
+        debian, ubuntu:         { include <%= config[:shortname] %>::common::debian }
+        redhat, fedora, centos: { include <%= config[:shortname] %>::common::redhat }
         default: {
             fail("Module $module_name is not supported on $operatingsystem")
         }
     }
 }
 
-# ------------------------------------------------------------------------------
-# = Class: <%= config[:name] %>::common
-#
-# Base class to be inherited by the other <%= config[:name] %> classes
-#
-# Note: respect the Naming standard provided here[http://projects.puppetlabs.com/projects/puppet/wiki/Module_Standards]
-class <%= config[:name] %>::common {
-
-    # Load the variables used in this module. Check the <%= config[:name] %>-params.pp file
-    require <%= config[:name] %>::params
-
-    package { '<%= config[:name] %>':
-        name    => "${<%= config[:name] %>::params::packagename}",
-        ensure  => "${<%= config[:name] %>::ensure}",
-    }
-    # package { $<%= config[:name] %>::params::extra_packages:
-    #     ensure => 'present'
-    # }
-
-    if $<%= config[:name] %>::ensure == 'present' {
-
-        # Prepare the log directory
-        file { "${<%= config[:name] %>::params::logdir}":
-            ensure => 'directory',
-            owner  => "${<%= config[:name] %>::params::logdir_owner}",
-            group  => "${<%= config[:name] %>::params::logdir_group}",
-            mode   => "${<%= config[:name] %>::params::logdir_mode}",
-            require => Package['<%= config[:name] %>'],
-        }
-
-        # Configuration file
-        # file { "${<%= config[:name] %>::params::configdir}":
-        #     ensure => 'directory',
-        #     owner  => "${<%= config[:name] %>::params::configdir_owner}",
-        #     group  => "${<%= config[:name] %>::params::configdir_group}",
-        #     mode   => "${<%= config[:name] %>::params::configdir_mode}",
-        #     require => Package['<%= config[:name] %>'],
-        # }
-        # Regular version using file resource
-        file { '<%= config[:name] %>.conf':
-            path    => "${<%= config[:name] %>::params::configfile}",
-            owner   => "${<%= config[:name] %>::params::configfile_owner}",
-            group   => "${<%= config[:name] %>::params::configfile_group}",
-            mode    => "${<%= config[:name] %>::params::configfile_mode}",
-            ensure  => "${<%= config[:name] %>::ensure}",
-            #content => template("<%= config[:name] %>/<%= config[:name] %>conf.erb"),
-            #source => "puppet:///modules/<%= config[:name] %>/<%= config[:name] %>.conf",
-            #notify  => Service['<%= config[:name] %>'],
-            require => [
-                        #File["${<%= config[:name] %>::params::configdir}"],
-                        Package['<%= config[:name] %>']
-                        ],
-        }
-
-        # # Concat version
-        # include concat::setup
-        # concat { "${<%= config[:name] %>::params::configfile}":
-        #     warn    => false,
-        #     owner   => "${<%= config[:name] %>::params::configfile_owner}",
-        #     group   => "${<%= config[:name] %>::params::configfile_group}",
-        #     mode    => "${<%= config[:name] %>::params::configfile_mode}",
-        #     #notify  => Service['<%= config[:name] %>'],
-        #     require => Package['<%= config[:name] %>'],
-        # }
-        # # Populate the configuration file
-        # concat::fragment { "${<%= config[:name] %>::params::configfile}_header":
-        #     target  => "${<%= config[:name] %>::params::configfile}",
-        #     ensure  => "${<%= config[:name] %>::ensure}",
-        #     content => template("<%= config[:name] %>/<%= config[:name] %>_header.conf.erb"),
-        #     #source => "puppet:///modules/<%= config[:name] %>/<%= config[:name] %>_header.conf",
-        #     order   => '01',
-        # }
-        # concat::fragment { "${<%= config[:name] %>::params::configfile}_footer":
-        #     target  => "${<%= config[:name] %>::params::configfile}",
-        #     ensure  => "${<%= config[:name] %>::ensure}",
-        #     content => template("<%= config[:name] %>/<%= config[:name] %>_footer.conf.erb"),
-        #     #source => "puppet:///modules/<%= config[:name] %>/<%= config[:name] %>_footer.conf",
-        #     order   => '99',
-        # }
-
-        # PID file directory
-        # file { "${<%= config[:name] %>::params::piddir}":
-        #     ensure  => 'directory',
-        #     owner   => "${<%= config[:name] %>::params::piddir_user}",
-        #     group   => "${<%= config[:name] %>::params::piddir_group}",
-        #     mode    => "${<%= config[:name] %>::params::piddir_mode}",
-        # }
-
-        file { "${<%= config[:name] %>::params::configfile_init}":
-            owner   => "${<%= config[:name] %>::params::configfile_owner}",
-            group   => "${<%= config[:name] %>::params::configfile_group}",
-            mode    => "${<%= config[:name] %>::params::configfile_mode}",
-            ensure  => "${<%= config[:name] %>::ensure}",
-            #content => template("<%= config[:name] %>/default/<%= config[:name] %>.erb"),
-            #source => "puppet:///modules/<%= config[:name] %>/default/<%= config[:name] %>.conf",
-            notify  =>  Service['<%= config[:name] %>'],
-            require =>  Package['<%= config[:name] %>']
-        }
-
-        service { '<%= config[:name] %>':
-            name       => "${<%= config[:name] %>::params::servicename}",
-            enable     => true,
-            ensure     => running,
-            hasrestart => "${<%= config[:name] %>::params::hasrestart}",
-            pattern    => "${<%= config[:name] %>::params::processname}",
-            hasstatus  => "${<%= config[:name] %>::params::hasstatus}",
-            require    => [
-                           Package['<%= config[:name] %>'],
-                           File["${<%= config[:name] %>::params::configfile_init}"]
-                           ],
-            subscribe  => File['<%= config[:name] %>.conf'],
-        }
-    }
-    else
-    {
-        # Here $<%= config[:name] %>::ensure is 'absent'
-
-    }
-
-}
-
-
-# ------------------------------------------------------------------------------
-# = Class: <%= config[:name] %>::debian
-#
-# Specialization class for Debian systems
-class <%= config[:name] %>::debian inherits <%= config[:name] %>::common { }
-
-# ------------------------------------------------------------------------------
-# = Class: <%= config[:name] %>::redhat
-#
-# Specialization class for Redhat systems
-class <%= config[:name] %>::redhat inherits <%= config[:name] %>::common { }
-
 
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: falkorlib
 version: !ruby/object:Gem::Version
-  version: 0.4.8
+  version: 0.4.9
 platform: ruby
 authors:
 - Sebastien Varrette
@@ -422,7 +422,11 @@ files:
 - templates/puppet/modules/Rakefile
 - templates/puppet/modules/Vagrantfile
 - templates/puppet/modules/doc/contributing.md.erb
+- templates/puppet/modules/doc/vagrant.md.erb
 - templates/puppet/modules/files/README.md.erb
+- templates/puppet/modules/manifests/common.pp.erb
+- templates/puppet/modules/manifests/common/debian.pp.erb
+- templates/puppet/modules/manifests/common/redhat.pp.erb
 - templates/puppet/modules/manifests/init.pp.erb
 - templates/puppet/modules/manifests/mydef.pp.erb
 - templates/puppet/modules/manifests/params.pp.erb