puppet-module 0.3.0

data/spec/spec.opts

@@ -0,0 +1 @@
+--color

data/spec/spec_helper.rb

@@ -0,0 +1,15 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+
+require 'spec'
+require 'spec/autorun'
+
+require 'puppet/module/tool'
+
+Dir[File.join(File.dirname(__FILE__), 'support', '*.rb')].each do |support_file|
+  require support_file
+end
+
+Spec::Runner.configure do |config|
+  config.mock_with :mocha
+end

data/spec/support/output_support.rb

@@ -0,0 +1,19 @@
+# Return string containing the STDIN and STDOUT output emitted within
+# the +block+.
+def output_for(&block)
+  output = StringIO.new
+
+  stdout_old = $stdout
+  stderr_old = $stderr
+
+  $stdout = output
+  $stderr = output
+
+  block.call
+  
+  output.rewind
+  return output.read
+ensure
+  $stdout = stdout_old
+  $stderr = stderr_old
+end

data/spec/support/stub_http_support.rb

@@ -0,0 +1,14 @@
+def stub_repository_read(code, body)
+  kind = Net::HTTPResponse.send(:response_class, code.to_s)
+  response = kind.new('1.0', code.to_s, 'HTTP MESSAGE')
+  response.stubs(:read_body).returns(body)
+  Puppet::Module::Tool::Repository.any_instance.stubs(:read_contact).returns(response)
+end
+
+def stub_installer_read(body)
+  Puppet::Module::Tool::Applications::Installer.any_instance.stubs(:read_match).returns(body)
+end
+
+def stub_cache_read(body)
+  Puppet::Module::Tool::Cache.any_instance.stubs(:read_retrieve).returns(body)
+end

data/spec/support/testdir_support.rb

@@ -0,0 +1,26 @@
+  require 'fileutils'
+
+  # Return path to temparory directory for testing.
+  def testdir
+    return @testdir ||= File.expand_path(File.join(File.dirname(__FILE__), '..', '..', 'tmp', 'spec'))
+  end
+
+  # Create a temporary testing directory, change into it, and execute the
+  # +block+. When the block exists, remove the test directory and change back
+  # to the previous directory.
+  def mktestdircd(&block)
+    previousdir = Dir.pwd
+    rmtestdir
+    FileUtils.mkdir_p(testdir)
+    Dir.chdir(testdir)
+    block.call
+  ensure
+    rmtestdir
+    Dir.chdir previousdir
+  end
+
+  # Remove the temporary test directory.
+  def rmtestdir
+    FileUtils.rm_rf(testdir) if File.directory?(testdir)
+  end
+

data/spec/unit/application_spec.rb

@@ -0,0 +1,25 @@
+require File.join(File.dirname(__FILE__), '..', 'spec_helper')
+
+describe Puppet::Module::Tool::Applications::Application do
+
+  describe 'inherited classes' do
+
+    before do
+      @app = Class.new(described_class).new
+      Puppet::Module::Tool.stubs(:prepare_settings)
+      Puppet.stubs(:settings => {:puppet_module_repository => 'http://fake.modules.site.com'})
+    end
+
+    describe '#repository' do
+      before do
+        @url = 'http://fake.com'
+        Puppet.settings.expects(:[]).with(:puppet_module_repository).returns(@url)
+      end
+      it "should use the :puppet_module_repository setting" do
+        @app.repository.uri.should == URI.parse(@url)
+      end
+    end
+
+  end
+
+end

data/spec/unit/repository_spec.rb

@@ -0,0 +1,51 @@
+require File.join(File.dirname(__FILE__), '..', 'spec_helper')
+
+describe Puppet::Module::Tool::Repository do
+  describe 'instances' do
+    before do
+      @repository = described_class.new('http://fake.com')
+    end
+
+    describe '#contact' do
+      before do
+        Net::HTTP.expects(:start)
+      end
+      context "when not given an :authenticate option" do
+        it "should authenticate" do
+          @repository.expects(:authenticate).never
+          @repository.contact(nil)
+        end        
+      end
+      context "when given an :authenticate option" do
+        it "should authenticate" do
+          @repository.expects(:authenticate)
+          @repository.contact(nil, :authenticate => true)
+        end
+      end
+    end
+
+    describe '#authenticate' do
+      before do
+        @request = stub
+        @repository.expects(:header)
+        @repository.expects(:prompt).twice        
+      end
+
+      it "should set basic auth on the request" do
+        @request.expects(:basic_auth)
+        @repository.authenticate(@request)
+      end      
+    end
+
+    describe '#retrieve' do
+      before do
+        @uri = URI.parse('http://some.url.com')
+        @repository.cache.expects(:retrieve).with(@uri)
+      end
+      it "should access the cache" do
+        @repository.retrieve(@uri)
+      end
+    end
+    
+  end
+end

data/templates/generator/Modulefile.erb

@@ -0,0 +1,5 @@
+name    '<%= metadata.full_name %>'
+version '0.0.1'
+
+## Add dependencies, if any:
+# dependency 'username/name', '>= 1.2.0'

data/templates/generator/README.erb

@@ -0,0 +1,3 @@
+<%= metadata.name %>
+
+This is the <%= metadata.name %> module.

data/templates/generator/files/README.markdown

@@ -0,0 +1,22 @@
+Files
+=====
+
+Puppet comes with both a client and server for copying files around. The file
+serving function is provided as part of the central Puppet daemon,
+puppetmasterd, and the client function is used through the source attribute of
+file objects. Learn more at
+http://projects.puppetlabs.com/projects/puppet/wiki/File_Serving_Configuration
+
+You can use managed files like this:
+
+    class myclass {
+      package { mypackage: ensure => latest }
+      service { myservice: ensure => running }
+      file { "/etc/myfile":
+        source => "puppet://$servername/modules/mymodule/myfile"
+      }
+    }
+
+The files are searched for in:
+
+    $modulepath/mymodule/files/myfile

data/templates/generator/lib/puppet/facter/README.markdown

@@ -0,0 +1,22 @@
+Facter
+======
+
+Define facts in this directory.
+
+Sometimes you need to be able to write conditional expressions based
+on site-specific data that just isn’t available via Facter. The
+solution may be to add a fact to Facter. These additional facts can
+then be distributed to Puppet clients and are available for use in
+manifests. Learn more at
+http://projects.puppetlabs.com/projects/puppet/wiki/Adding_Facts
+
+File paths should match the fact name; for example, a fact
+`hardware_platform`, defined like this:
+
+    Facter.add("hardware_platform") do
+        setcode do
+            %x{/bin/uname -i}.chomp
+        end
+    end
+
+Should be found in `hardware_platform.rb` in this directory.

data/templates/generator/lib/puppet/parser/functions/README.markdown

@@ -0,0 +1,17 @@
+Functions
+=========
+
+Define functions in this directory.
+
+File paths should match the function name; for example, a function
+`myfunction`, defined like this:
+
+    Puppet::Parser::Functions::newfunction(
+        :myfunction,
+        :type => :statement,
+        :doc => "Documentation here."
+    ) do |vals|
+        # ...
+    end
+
+Should be found in `myfunction.rb` in this directory.

data/templates/generator/lib/puppet/provider/README.markdown

@@ -0,0 +1,14 @@
+Providers
+=========
+
+Define providers under this directory.
+
+File paths should match the resource type name and provider name; for
+example, a provider `myprovider` for a resource type `mytype`, defined like this:
+
+    Puppet::Type.type(:mytype).provide(:myprovider) do
+        desc "Documentation here"
+        # ...
+    end
+
+Should be found in `mytype/myprovider.rb` under this directory.

data/templates/generator/lib/puppet/type/README.markdown

@@ -0,0 +1,14 @@
+Resource Types
+==============
+
+Define resource types in this directory.
+
+Filenames should match the resource type name; for example, a resource
+type `mytype`, defined like this:
+
+    Puppet::Type.newtype(:mytype) do
+        @doc = "Documentation here."
+        # ...
+    end
+
+Should be found in `mytype.rb`

data/templates/generator/manifests/README.markdown

@@ -0,0 +1,28 @@
+Manifests
+=========
+
+Module manifest files belong in this directory.
+
+`init.pp` defines how the module will carry out its tasks in this file.
+
+Add additional definitions in this directory. Their file paths should match the
+definition name; for example, a definition `mydefinition`, defined like this:
+
+    # Definition: mydefinition
+    #
+    # This is the mydefinition in the mymodule module.
+    #
+    # Parameters:
+    #
+    # Actions:
+    #
+    # Requires:
+    #
+    # Sample Usage:
+    #
+    # [Remember: No empty lines between comments and class definition]
+    define mydefinition {
+        # ...
+    }
+
+Should be found in `mydefinition.pp` in this directory.

data/templates/generator/manifests/init.pp.erb

@@ -0,0 +1,17 @@
+# Class: <%= metadata.name %>
+#
+# This module manages <%= metadata.name %>
+#
+# Parameters:
+#
+# Actions:
+#
+# Requires:
+#
+# Sample Usage:
+#
+# [Remember: No empty lines between comments and class definition]
+class <%= metadata.name %> {
+
+
+}

data/templates/generator/metadata.json

@@ -0,0 +1,12 @@
+/*
++-----------------------------------------------------------------------+
+|                                                                       |
+|                    ==> DO NOT EDIT THIS FILE! <==                     |
+|                                                                       |
+|   You should edit the `Modulefile` and run `puppet-module build`      |
+|   to generate the `metadata.json` file for your releases.             |
+|                                                                       |
++-----------------------------------------------------------------------+
+*/
+
+{}

data/templates/generator/spec/README.markdown

@@ -0,0 +1,7 @@
+Specs
+=====
+
+The Puppet project uses RSpec for testing.
+
+For more information on RSpec, see http://rspec.info/
+

data/templates/generator/spec/spec.opts

@@ -0,0 +1,6 @@
+--format
+s
+--colour
+--loadby
+mtime
+--backtrace

data/templates/generator/spec/spec_helper.rb

@@ -0,0 +1,18 @@
+require 'pathname'
+dir = Pathname.new(__FILE__).parent
+$LOAD_PATH.unshift(dir, dir + 'lib', dir + '../lib')
+
+require 'mocha'
+require 'puppet'
+gem 'rspec', '=1.2.9'
+require 'spec/autorun'
+
+Spec::Runner.configure do |config|
+    config.mock_with :mocha
+end
+
+# We need this because the RAL uses 'should' as a method.  This
+# allows us the same behaviour but with a different method name.
+class Object
+    alias :must :should
+end

data/templates/generator/spec/unit/puppet/provider/README.markdown

@@ -0,0 +1,4 @@
+Provider Specs
+==============
+
+Define specs for your providers under this directory.

data/templates/generator/spec/unit/puppet/type/README.markdown

@@ -0,0 +1,4 @@
+Resource Type Specs
+===================
+
+Define specs for your resource types in this directory.

data/templates/generator/templates/README.markdown

@@ -0,0 +1,23 @@
+Templates
+=========
+
+Puppet supports templates and templating via ERB, which is part of the Ruby
+standard library and is used for many other projects including Ruby on Rails.
+Templates allow you to manage the content of template files, for example
+configuration files that cannot yet be managed as a Puppet type. Learn more at
+http://projects.puppetlabs.com/projects/puppet/wiki/Puppet_Templating
+
+You can use templates like this: 
+
+    class myclass {
+      package { mypackage: ensure => latest }
+      service { myservice: ensure => running }
+      file { "/etc/myfile":
+        content => template("mymodule/myfile.erb")
+      }
+    }
+
+The templates are searched for in:
+
+    $templatedir/mymodule/myfile.erb
+    $modulepath/mymodule/templates/myfile.erb

data/templates/generator/tests/init.pp.erb

@@ -0,0 +1 @@
+include <%= metadata.name %>

data/vendor/facets-2.8.2-partial/lib/facets/kernel/returning.rb

@@ -0,0 +1,23 @@
+module Kernel
+
+  # A Ruby-ized realization of the K combinator.
+  #
+  #   returning Book.new do |book|
+  #     book.title = "Imperium"
+  #     book.author = "Ulick Varange"
+  #   end
+  #
+  # Technically, #returning probably should force the return of
+  # the stated object irregardless of any return statements that
+  # might appear within it's block. This might differentiate
+  # #returning from #with, however it also would require
+  # implementation in Ruby itself.
+  #
+  # CREDIT: Mikael Brockman
+
+  def returning(obj=self) #:yield:
+    yield obj
+    obj
+  end
+
+end

data/vendor/facets-2.8.2-partial/lib/facets/kernel/tap.rb

@@ -0,0 +1,39 @@
+module Kernel
+
+  unless method_defined?(:tap)  # 1.8.7+
+
+    # The tap K-Combinator. This yields self -and- returns self.
+    #
+    # Note, Ruby 1.9+ does not appear to support the zero arity
+    # instance_eval option.
+    #
+    def tap(&b)
+      if block_given?
+        b.arity == 1 ? yield(self) : instance_eval(&b)
+      end
+      self
+    end
+
+    # == Future definition?
+    #
+    # This is a consideration for a future #tap using Functor:
+    #
+    #   require 'facets/functor'
+    #
+    #   def tap(&b)
+    #     if block_given?
+    #       b.arity == 1 ? yield(self) : instance_eval(&b)
+    #       self
+    #     else
+    #       Functor.new{ |op, *args| self.send(op, *args); self }
+    #     end
+    #   end
+    #
+    # It would allow a single call, before returning the original.
+    # However there are not very many useful things you can do with
+    # that.
+
+  end
+
+end
+