puppet_module_packaging 0.0.1

data/test/end_to_end/pkg_test.rb

@@ -0,0 +1,33 @@
+require 'test_helper'
+
+describe 'deb task' do
+  around do |t|
+    do_into_tmp_module('testmod', t)
+  end
+
+  describe 'by default' do
+    let(:pkg) { 'pkg/puppet-mod-testdev-testmod_0.0.1_all.deb' }
+
+    it 'build a package into the `pkg` folder' do
+      `rake deb`
+
+      assert file?(pkg), "expected package #{pkg} to exist"
+    end
+  end
+end
+
+describe 'rpm task' do
+  around do |t|
+    do_into_tmp_module('testmod', only_if_rpmbuild_found(t))
+  end
+
+  describe 'by default' do
+    let(:pkg) { 'pkg/puppet-mod-testdev-testmod-0.0.1.noarch.rpm' }
+
+    it 'build a package into the `pkg` folder' do
+      `rake rpm`
+
+      assert file?(pkg), "expected package #{pkg} to exist"
+    end
+  end
+end

data/test/end_to_end/tasks_test.rb

@@ -0,0 +1,16 @@
+require 'test_helper'
+
+describe 'using PuppetModule::Pkg::Tasks in a Rakefile' do
+  around do |t|
+    do_into_tmp_module('testmod', t)
+  end
+
+  let(:fixture_module) { File.join(fixture_dir, 'testmod') }
+  let(:task_list) { `rake -T` }
+
+  [:install, :clean, :deb, :rpm].each do |task|
+    it "defines a `#{task}` task" do
+      task_list.must_match /^rake #{task}/
+    end
+  end
+end

data/test/fixture/testmod/Modulefile

@@ -0,0 +1,13 @@
+name    'testdev/testmod'
+version '0.0.1'
+source 'https://example.com/git/testmod'
+author 'Test Developer <test@example.com>'
+license 'Apache License, Version 2.0'
+summary 'A silly module, only useful for testing'
+description 'A long description of this silly module'
+project_page 'https://example.com/testmod/home'
+
+## Add dependencies, if any:
+# dependency 'username/name', '>= 1.2.0'
+
+unsupported_field 'I don`t know what I am for'

data/test/fixture/testmod/Modulefile.no_name_or_author

@@ -0,0 +1,2 @@
+name    'missing_name_or_author'
+version '0.0.1'

data/test/fixture/testmod/Modulefile.no_version

@@ -0,0 +1 @@
+name    'testdev/testmod'

data/test/fixture/testmod/Rakefile

@@ -0,0 +1,3 @@
+require 'puppet_module/pkg/tasks'
+
+PuppetModule::Pkg::Tasks.new

data/test/integration/modulefile_test.rb

@@ -0,0 +1,50 @@
+require 'test_helper'
+
+describe PuppetModule::Pkg::Tasks::Modulefile do
+  # TODO: dependency management
+  #
+  # TODO: Modulefile not present => Errno::ENOENT, Errno::EISDIR => requires
+  # specification of shell output format
+  #
+  # TODO: incorrect format (maybe)
+  #
+  # TODO: allow for single-dash commented line to be parsed (maybe,
+  # particularly for non-forge dependencies)
+
+  around do |t|
+    do_into_tmp_module('testmod', t)
+  end
+
+  let(:parser) { PuppetModule::Pkg::Tasks::Modulefile }
+
+  it 'reads a Modulefile and maps its fields to an object value' do
+    metadata = parser.parse 'Modulefile'
+
+    metadata.name.must_equal 'testmod'
+    metadata.author.must_equal 'testdev'
+    metadata.version.must_equal '0.0.1'
+    metadata.source.must_equal 'https://example.com/git/testmod'
+    metadata.author_full.must_equal 'Test Developer <test@example.com>'
+    metadata.license.must_equal 'Apache License, Version 2.0'
+    metadata.summary.must_equal 'A silly module, only useful for testing'
+    metadata.description.must_equal 'A long description of this silly module'
+    metadata.project_page.must_equal 'https://example.com/testmod/home'
+  end
+
+  it 'raises an error if the Modulefile doesn`t contain required fields' do
+    # We need at least module name, developer name and version in order to
+    # build a package
+    proc {
+      parser.parse 'Modulefile.no_name_or_author'
+    }.must_raise ArgumentError
+
+    proc {
+      parser.parse 'Modulefile.no_version'
+    }.must_raise ArgumentError
+  end
+
+  it 'doesn`t complain if it finds an unsupported/unrecognized field' do
+    metadata = parser.parse 'Modulefile'
+    metadata.unsupported_field.must_be_nil
+  end
+end

data/test/integration/system_test.rb

@@ -0,0 +1,59 @@
+require 'test_helper'
+require 'tmpdir'
+
+describe PuppetModule::Pkg::Tasks::System do
+  let(:fs) { PuppetModule::Pkg::Tasks::System.new }
+
+  around do |t|
+    do_into_tmpdir(t)
+  end
+
+  describe 'mkdir' do
+    it 'creates a whole directory subtree' do
+      fs.mkdir('a/b/c/d')
+
+      walk_path('a'..'d').each do |dir|
+        assert directory?(dir), "expected directory #{dir} to exist"
+      end
+    end
+
+    it 'doesn`t complain if some of the directories already exist' do
+      fs.mkdir('a/b/c/d')
+      fs.mkdir('a/b/c/d')
+    end
+  end
+
+  describe 'cp' do
+    it 'recursively copies a list of directories into a destination' do
+      mkdir 'out'
+      ('a'..'d').to_a.each do |dir|
+        mkdir dir
+        touch join dir, "test_#{dir}"
+      end
+
+      fs.cp('a'..'d', 'out')
+
+      ('a'..'d').to_a.each do |dir|
+        assert directory?(join 'out', dir), "expected directory #{dir} to exist"
+        assert file?(join 'out', dir, "test_#{dir}"), "expected file out/#{dir}/test_#{dir} to exist"
+      end
+    end
+  end
+
+  describe 'rm' do
+    it 'removes the whole subtree under given directory' do
+      mkdir 'a/b/c/d'
+
+      fs.rm 'a'
+      refute directory?('a'), "expected directory 'a' to have been wiped"
+    end
+  end
+
+  describe 'exec' do
+    it 'executes given command in system`s shell' do
+      fs.sh 'touch test_file'
+
+      assert file?('test_file'), "expected file test_file to have been created, but it was not"
+    end
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,85 @@
+require 'minitest/autorun'
+require 'minitest/spec'
+require 'minitest/filesystem'
+require 'minitest/around/spec'
+require 'mocha/setup'
+
+require 'tmpdir'
+
+require 'puppet_module/pkg/tasks'
+
+# Directory that contains test fixtures
+def fixture_dir
+  File.join File.dirname(__FILE__), 'fixture'
+end
+
+# Path of the test module named `name`
+def fixture_module(name)
+  File.join(fixture_dir, name)
+end
+
+# Creates an array of all increasing paths from dirs.first to dirs.last
+#
+# Ex: walk_path(['a','b','c']) # => ['a', 'a/b', 'a/b/c']
+def walk_path(dirs)
+  (1..dirs.to_a.length).map do |k|
+    File.join(*dirs.to_a.take(k))
+  end
+end
+
+# Exec proc inside specified directory
+def do_into_dir(dir, t)
+  Dir.chdir dir do
+    t.call
+  end
+end
+
+# Exec proc inside a temp dir
+def do_into_tmpdir(t)
+  Dir.mktmpdir do |dir|
+    do_into_dir(dir, t)
+  end
+end
+
+# Exec proc inside a temp copy of fixture module `mod_name`
+def do_into_tmp_module(mod_name, t)
+  do_into_tmpdir(proc {
+    FileUtils.cp_r fixture_module(mod_name), mod_name
+    do_into_dir(mod_name, t)
+  })
+end
+
+# FPM requires rpmbuild to be present in order to produce a RPM package.
+# If we can't find it, do not run given test
+def only_if_rpmbuild_found(t)
+  if rpmbuild_found?
+    return t
+  else
+    return Proc.new {}
+  end
+end
+
+def rpmbuild_found?
+  `which rpmbuild`
+  return $? == 0
+end
+
+def directory?(d)
+  File.directory? d
+end
+
+def file?(f)
+  File.file? f
+end
+
+def mkdir(d)
+  FileUtils.mkdir_p d
+end
+
+def touch(f)
+  FileUtils.touch f
+end
+
+def join(*args)
+  File.join(*args)
+end

data/test/test_vm.pp

@@ -0,0 +1,23 @@
+$deps = [
+  'libxml2',
+  'libxml2-dev',
+  'libxslt1.1',
+  'libxslt1-dev',
+  'rpm',
+  'git',
+]
+
+package { $deps:
+  ensure  => installed,
+  require => Exec['apt-get update'],
+}
+
+package { 'bundler':
+  ensure   => installed,
+  require  => Package[$deps],
+  provider => 'gem',
+}
+
+exec { 'apt-get update':
+  path => '/usr/bin',
+}

data/test/unit/build_test.rb

@@ -0,0 +1,81 @@
+require 'test_helper'
+
+describe 'packaging tasks' do
+  let(:deb_task)    { PuppetModule::Pkg::Tasks::Deb }
+  let(:rpm_task)    { PuppetModule::Pkg::Tasks::RPM }
+  let(:sys)         { stub_everything }
+  let(:minimal_mod) { OpenStruct.new(
+    :name    => 'my_mod',
+    :author  => 'a_dev',
+    :version => 'some_version')
+  }
+
+  let(:mod) { OpenStruct.new(
+    :name    => 'my_mod',
+    :author  => 'a_dev',
+    :version => 'some_version',
+    :author_full => 'a_dev <a@dev.com>',
+    :project_page => 'http://a.b.c/my_mod',
+    :summary => 'nothing fancy',
+    :license => 'whatever')
+  }
+  let(:opts) { OpenStruct.new(
+    :pkg_dir     => 'pkg',
+    :install_dir => 'some/where')
+  }
+
+  it 'creates the output folder' do
+    sys.expects(:mkdir).with(regexp_matches(/#{opts.pkg_dir}/))
+
+    deb_task.new(sys).invoke(mod, opts)
+  end
+
+  it 'builds a package using all available module info' do
+    sys.expects(:sh).with(all_of(
+      regexp_matches(/^fpm/),
+      regexp_matches(/-s dir/),
+      regexp_matches(/-a all/),
+      regexp_matches(/-n puppet-mod-#{mod.author}-#{mod.name}/),
+      regexp_matches(/-v #{mod.version}/),
+      regexp_matches(/-m '#{mod.author_full}'/),
+      regexp_matches(/--url '#{mod.project_page}'/),
+      regexp_matches(/--description '#{mod.summary}'/),
+      regexp_matches(/--license '#{mod.license}'/),
+      regexp_matches(/-C #{opts.install_dir}/),
+      regexp_matches(/\.$/)))
+
+    deb_task.new(sys).invoke(mod, opts)
+  end
+
+  it 'doesn`t complain if optional module info are missing' do
+    sys.expects(:sh).with(Not(any_of(
+      regexp_matches(/-m /),
+      regexp_matches(/--url /),
+      regexp_matches(/--description /),
+      regexp_matches(/--license /)
+    )))
+
+    deb_task.new(sys).invoke(minimal_mod, opts)
+  end
+
+  describe 'deb task' do
+    it 'builds a deb package, using Debian conventions' do
+      sys.expects(:sh).with(all_of(
+        regexp_matches(/-t deb/),
+        regexp_matches(/-p #{opts.pkg_dir}\/puppet-mod-#{mod.author}-#{mod.name}_VERSION_ARCH.deb/)))
+  
+      deb_task.new(sys).invoke(mod, opts)
+    end
+  end
+
+  describe 'rpm task' do
+    it 'builds a rpm package, using RPM conventions' do
+      sys.expects(:sh).with(all_of(
+        regexp_matches(/-t rpm/),
+        regexp_matches(/-p #{opts.pkg_dir}\/puppet-mod-#{mod.author}-#{mod.name}-VERSION.ARCH.rpm/)))
+  
+      rpm_task.new(sys).invoke(mod, opts)
+    end
+  end
+end
+

data/test/unit/clean_test.rb

@@ -0,0 +1,13 @@
+require 'test_helper'
+
+describe PuppetModule::Pkg::Tasks::Clean do
+  let(:clean_task) { PuppetModule::Pkg::Tasks::Clean }
+  let(:sys)        { stub_everything }
+  let(:opts)       { OpenStruct.new(:install_dir => 'clean_test')}
+
+  it 'removes the installation directory' do
+    sys.expects(:rm).with(regexp_matches(/#{opts.install_dir}/))
+
+    clean_task.new(sys).invoke(nil, opts)
+  end
+end

data/test/unit/install_test.rb

@@ -0,0 +1,34 @@
+require 'test_helper'
+
+describe PuppetModule::Pkg::Tasks::Install do
+  let(:install_task) { PuppetModule::Pkg::Tasks::Install }
+  let(:sys)          { stub_everything }
+  let(:mod)          { OpenStruct.new(:name => 'my_mod')}
+  let(:opts)         { OpenStruct.new(:install_dir => 'build')}
+  let(:dest_path)    { "usr/share/puppet/modules/#{mod.name}" }
+  let(:install_path) { join(opts.install_dir, dest_path) }
+
+  it 'creates the output folder' do
+    sys.expects(:mkdir).with(regexp_matches(/#{opts.install_dir}/))
+
+    install_task.new(sys).invoke(mod, opts)
+  end
+
+  it 'creates the destination path into the output folder' do
+    sys.expects(:mkdir).with(regexp_matches(/#{dest_path}/))
+
+    install_task.new(sys).invoke(mod, opts)
+  end
+
+  it 'installs all the relevant directories into the output folder' do
+    sys.expects(:cp).with(
+      includes(
+        'manifests',
+        'templates',
+        'files',
+        'lib'),
+      install_path)
+
+    install_task.new(sys).invoke(mod, opts)
+  end
+end

metadata

@@ -0,0 +1,242 @@
+--- !ruby/object:Gem::Specification
+name: puppet_module_packaging
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Stefano Zanella
+autorequire: 
+bindir: bin
+cert_chain:
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIDQDCCAiigAwIBAgIBADANBgkqhkiG9w0BAQUFADBGMRgwFgYDVQQDDA96YW5l
+  bGxhLnN0ZWZhbm8xFTATBgoJkiaJk/IsZAEZFgVnbWFpbDETMBEGCgmSJomT8ixk
+  ARkWA2NvbTAeFw0xMzA4MDcxOTA2MDZaFw0xNDA4MDcxOTA2MDZaMEYxGDAWBgNV
+  BAMMD3phbmVsbGEuc3RlZmFubzEVMBMGCgmSJomT8ixkARkWBWdtYWlsMRMwEQYK
+  CZImiZPyLGQBGRYDY29tMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA
+  2JCnJCnjjs62MR/Tw/4WgSG42ruiCEqXV1ECMsXymHPE8xyHkYAwLXvBRzOkZ/IA
+  puJ1XhScduMRcUuE0ZPA5N2HBZI0WsmyyNTYBjOob8m0SNInoRZfIMloj3D8QzB7
+  /6G5HLMWNx60JEpIDgfXvIuSRKNKQ0/0+/G/H4COgj72pd3F4dYltvx+mSwPRq7Q
+  MdZsK3T5Q3d4eLBY1VSlJpq0wkwdEWTXAhR0Mfmbn1D8m9IhJfubgXuXVBY4OPO8
+  KAF/wWqTkzA6guVQlSKdZR4vwms7OpeFkotnivBKa6JwUQSXO8AZEyy53V8cSYDu
+  dbaFi53YbEwOWSMQnW8/kQIDAQABozkwNzAdBgNVHQ4EFgQUcBKkmJAvSTKfDf7z
+  LEu1wE+Rk+swCQYDVR0TBAIwADALBgNVHQ8EBAMCBLAwDQYJKoZIhvcNAQEFBQAD
+  ggEBAMeqfk1l4Y0iZ8jNiu0afcQ60DVqBkRtrT/rsZEqGsdOw11bntOE4yWpo4Kd
+  Y0C/kYrVQ/mIN7IGKbCSjES3aYdQftV9SRW77FA25m2KXRbnEYtJDUX35gAqSdRY
+  9IiYivsMq2dr70eKPNFrFOwWvmwhcGyEG8EDvYoXWllke7RGz1Dn/AZx6jPnShO+
+  0ru4OXsM9++md3sGXIugEFNygvo2/1yQoTe6+XiBocS+pWsJd6JZBfkxPRT4Dz4H
+  RigBD0E3/t/ABjCXkmqwp5gnAZmP8JiVUkn8rp5E0FXvC8T7nsPs2TW/TAmUV6rN
+  hK25FX8YWgT9fD9y3PpWjiYcrCo=
+  -----END CERTIFICATE-----
+date: 2013-11-13 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: fpm
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.4'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubygems-tasks
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: minitest-filesystem
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: minitest-around
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: mocha
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: |2
+      puppet_module_packaging provides some Rake tasks to ease wrapping Puppet
+      modules into proper system packages like deb and rpm.
+email:
+- zanella.stefano@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .ruby-version
+- .travis.yml
+- Changelog.md
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- Vagrantfile
+- lib/puppet_module/pkg/tasks.rb
+- lib/puppet_module/pkg/tasks/build.rb
+- lib/puppet_module/pkg/tasks/clean.rb
+- lib/puppet_module/pkg/tasks/deb.rb
+- lib/puppet_module/pkg/tasks/install.rb
+- lib/puppet_module/pkg/tasks/modulefile.rb
+- lib/puppet_module/pkg/tasks/rake_tasks.rb
+- lib/puppet_module/pkg/tasks/rpm.rb
+- lib/puppet_module/pkg/tasks/system.rb
+- lib/puppet_module/pkg/version.rb
+- puppet_module_packaging.gemspec
+- rubygems-stefanozanella.crt
+- test/end_to_end/.gitkeep
+- test/end_to_end/clean_test.rb
+- test/end_to_end/install_test.rb
+- test/end_to_end/pkg_test.rb
+- test/end_to_end/tasks_test.rb
+- test/fixture/testmod/Modulefile
+- test/fixture/testmod/Modulefile.no_name_or_author
+- test/fixture/testmod/Modulefile.no_version
+- test/fixture/testmod/Rakefile
+- test/fixture/testmod/files/example.dat
+- test/fixture/testmod/lib/utils.rb
+- test/fixture/testmod/manifests/init.pp
+- test/fixture/testmod/templates/config.erb
+- test/integration/modulefile_test.rb
+- test/integration/system_test.rb
+- test/test_helper.rb
+- test/test_vm.pp
+- test/unit/.gitkeep
+- test/unit/build_test.rb
+- test/unit/clean_test.rb
+- test/unit/install_test.rb
+homepage: https://github.com/stefanozanella/puppet_module_packaging
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.7
+signing_key: 
+specification_version: 4
+summary: Rake tasks for packaging Puppet modules
+test_files:
+- test/end_to_end/.gitkeep
+- test/end_to_end/clean_test.rb
+- test/end_to_end/install_test.rb
+- test/end_to_end/pkg_test.rb
+- test/end_to_end/tasks_test.rb
+- test/fixture/testmod/Modulefile
+- test/fixture/testmod/Modulefile.no_name_or_author
+- test/fixture/testmod/Modulefile.no_version
+- test/fixture/testmod/Rakefile
+- test/fixture/testmod/files/example.dat
+- test/fixture/testmod/lib/utils.rb
+- test/fixture/testmod/manifests/init.pp
+- test/fixture/testmod/templates/config.erb
+- test/integration/modulefile_test.rb
+- test/integration/system_test.rb
+- test/test_helper.rb
+- test/test_vm.pp
+- test/unit/.gitkeep
+- test/unit/build_test.rb
+- test/unit/clean_test.rb
+- test/unit/install_test.rb

metadata.gz.sig

@@ -0,0 +1,2 @@
+#�El�l��4�;�6�_����hQ�H����7*�2$��E$ߌ�׭�p4C2�O,c*DVQ���a檞f�h�y�?/=���(�`�;_82-�2������$G<�������E���͡���^_J�jٴ��,�q �\�jOvH��B�J�h��%k5A�==�7��~ؗD��2�[����Z�ؒ�
+Z��s�@0�h����F�����h@>.��T�-�?���t���N�?q̢�����i�q!ݙ