bolt 0.19.1 → 0.20.0

data/vendored/puppet/lib/puppet/face/module.rb

@@ -1,19 +0,0 @@
-require 'puppet/face'
-require 'puppet/module_tool'
-require 'puppet/util/colors'
-
-Puppet::Face.define(:module, '1.0.0') do
-  extend Puppet::Util::Colors
-
-  copyright "Puppet Inc.", 2012
-  license   _("Apache 2 license; see COPYING")
-
-  summary _("Creates, installs and searches for modules on the Puppet Forge.")
-  description <<-EOT
-    This subcommand can find, install, and manage modules from the Puppet Forge,
-    a repository of user-contributed Puppet code. It can also generate empty
-    modules, and prepare locally developed modules for release on the Forge.
-  EOT
-
-  display_global_options "environment", "modulepath"
-end

data/vendored/puppet/lib/puppet/face/module/build.rb

@@ -1,64 +0,0 @@
-Puppet::Face.define(:module, '1.0.0') do
-  action(:build) do
-    summary _("Build a module release package.")
-    description <<-EOT
-      Prepares a local module for release on the Puppet Forge by building a
-      ready-to-upload archive file.
-      Note: Module build uses MD5 checksums, which are prohibited on FIPS enabled systems.
-
-      This action uses the metadata.json file in the module directory to set metadata
-      used by the Forge. See <https://docs.puppetlabs.com/puppet/latest/reference/modules_publishing.html> for more
-      about writing metadata.json files.
-
-      After being built, the release archive file can be found in the module's
-      `pkg` directory.
-    EOT
-
-    returns _("Pathname object representing the path to the release archive.")
-
-    examples <<-EOT
-      Build a module release:
-
-      $ puppet module build puppetlabs-apache
-      notice: Building /Users/kelseyhightower/puppetlabs-apache for release
-      Module built: /Users/kelseyhightower/puppetlabs-apache/pkg/puppetlabs-apache-0.0.1.tar.gz
-
-      Build the module in the current working directory:
-
-      $ cd /Users/kelseyhightower/puppetlabs-apache
-      $ puppet module build
-      notice: Building /Users/kelseyhightower/puppetlabs-apache for release
-      Module built: /Users/kelseyhightower/puppetlabs-apache/pkg/puppetlabs-apache-0.0.1.tar.gz
-    EOT
-
-    arguments _("[<path>]")
-
-    when_invoked do |*args|
-      options = args.pop
-      if options.nil? or args.length > 1 then
-        raise ArgumentError, _("puppet module build only accepts 0 or 1 arguments")
-      end
-
-      module_path = args.first
-      if module_path.nil?
-        pwd = Dir.pwd
-        module_path = Puppet::ModuleTool.find_module_root(pwd)
-        if module_path.nil?
-          raise _("Unable to find metadata.json in module root %{pwd} or parent directories. See <https://docs.puppetlabs.com/puppet/latest/reference/modules_publishing.html> for required file format.") % { pwd: pwd }
-        end
-      else
-        unless Puppet::ModuleTool.is_module_root?(module_path)
-          raise _("Unable to find metadata.json in module root %{module_path} or parent directories. See <https://docs.puppetlabs.com/puppet/latest/reference/modules_publishing.html> for required file format.") % { module_path: module_path }
-        end
-      end
-
-      Puppet::ModuleTool.set_option_defaults options
-      Puppet::ModuleTool::Applications::Builder.run(module_path, options)
-    end
-
-    when_rendering :console do |return_value|
-      # Get the string representation of the Pathname object.
-      _("Module built: %{path}") % { path: return_value.expand_path.to_s }
-    end
-  end
-end

data/vendored/puppet/lib/puppet/face/module/changes.rb

@@ -1,42 +0,0 @@
-Puppet::Face.define(:module, '1.0.0') do
-  action(:changes) do
-    summary _("Show modified files of an installed module.")
-    description <<-EOT
-      Shows any files in a module that have been modified since it was
-      installed. This action compares the files on disk to the md5 checksums
-      included in the module's checksums.json or, if that is missing, in
-      metadata.json.
-    EOT
-
-    returns _("Array of strings representing paths of modified files.")
-
-    examples <<-EOT
-      Show modified files of an installed module:
-
-      $ puppet module changes /etc/puppetlabs/code/modules/vcsrepo/
-      warning: 1 files modified
-      lib/puppet/provider/vcsrepo.rb
-    EOT
-
-    arguments _("<path>")
-
-    when_invoked do |path, options|
-      Puppet::ModuleTool.set_option_defaults options
-      unless root_path = Puppet::ModuleTool.find_module_root(path)
-        raise ArgumentError, _("Could not find a valid module at %{path}") % { path: path.inspect }
-      end
-      Puppet::ModuleTool::Applications::Checksummer.run(root_path, options)
-    end
-
-    when_rendering :console do |return_value|
-      if return_value.empty?
-        Puppet.notice _("No modified files")
-      else
-        Puppet.warning _("%{count} files modified") % { count: return_value.size }
-      end
-      return_value.map do |changed_file|
-        "#{changed_file}"
-      end.join("\n")
-    end
-  end
-end

data/vendored/puppet/lib/puppet/face/module/generate.rb

@@ -1,256 +0,0 @@
-Puppet::Face.define(:module, '1.0.0') do
-  action(:generate) do
-    summary _("Generate boilerplate for a new module.")
-    description <<-EOT
-      Generates boilerplate for a new module by creating the directory
-      structure and files recommended for the Puppet community's best practices.
-
-      A module may need additional directories beyond this boilerplate
-      if it provides plugins, files, or templates.
-    EOT
-
-    returns _("Array of Pathname objects representing paths of generated files.")
-
-    examples <<-EOT
-      Generate a new module in the current directory:
-
-      $ puppet module generate puppetlabs-ssh
-      We need to create a metadata.json file for this module.  Please answer the
-      following questions; if the question is not applicable to this module, feel free
-      to leave it blank.
-
-      Puppet uses Semantic Versioning (semver.org) to version modules.
-      What version is this module?  [0.1.0]
-      -->
-
-      Who wrote this module?  [puppetlabs]
-      -->
-
-      What license does this module code fall under?  [Apache-2.0]
-      -->
-
-      How would you describe this module in a single sentence?
-      -->
-
-      Where is this module's source code repository?
-      -->
-
-      Where can others go to learn more about this module?
-      -->
-
-      Where can others go to file issues about this module?
-      -->
-
-      ----------------------------------------
-      {
-        "name": "puppetlabs-ssh",
-        "version": "0.1.0",
-        "author": "puppetlabs",
-        "summary": null,
-        "license": "Apache-2.0",
-        "source": "",
-        "project_page": null,
-        "issues_url": null,
-        "dependencies": [
-          {
-            "name": "puppetlabs-stdlib",
-            "version_requirement": ">= 1.0.0"
-          }
-        ]
-      }
-      ----------------------------------------
-
-      About to generate this metadata; continue? [n/Y]
-      -->
-
-      Notice: Generating module at /Users/username/Projects/puppet/puppetlabs-ssh...
-      Notice: Populating ERB templates...
-      Finished; module generated in puppetlabs-ssh.
-      puppetlabs-ssh/manifests
-      puppetlabs-ssh/manifests/init.pp
-      puppetlabs-ssh/metadata.json
-      puppetlabs-ssh/README.md
-      puppetlabs-ssh/spec
-      puppetlabs-ssh/spec/spec_helper.rb
-      puppetlabs-ssh/tests
-      puppetlabs-ssh/tests/init.pp
-    EOT
-
-    option "--skip-interview" do
-      summary _("Bypass the interactive metadata interview")
-      description <<-EOT
-        Do not attempt to perform a metadata interview.  Primarily useful for automatic
-        execution of `puppet module generate`.
-      EOT
-    end
-
-    arguments _("<name>")
-
-    when_invoked do |name, options|
-      # Since we only want to interview if it's being rendered to the console
-      # (i.e. when invoked with `puppet module generate`), we can't do any work
-      # here in the when_invoked block. The result of this block is then
-      # passed to each renderer, which will handle it appropriately; by
-      # returning a simple message like this, every renderer will simply output
-      # the string.
-      # Our `when_rendering :console` handler will ignore this value and
-      # actually generate the module.
-      #
-      # All this is necessary because it is not possible at this point in time
-      # to know what the destination of the output is.
-      _("This format is not supported by this action.")
-    end
-
-    when_rendering :console do |_, name, options|
-      Puppet::ModuleTool.set_option_defaults options
-
-      begin
-        # A default dependency for all newly generated modules is being
-        # introduced as a substitute for the comments we used to include in the
-        # previous module data specifications. While introducing a default
-        # dependency is less than perfectly desirable, the cost is low, and the
-        # syntax is obtuse enough to justify its inclusion.
-        metadata = Puppet::ModuleTool::Metadata.new.update(
-          'name' => name,
-          'version' => '0.1.0',
-          'dependencies' => [
-            { 'name' => 'puppetlabs-stdlib', 'version_requirement' => '>= 1.0.0' }
-          ]
-        )
-      rescue ArgumentError
-        msg = _("Could not generate directory %{name}, you must specify a dash-separated username and module name.") % { name: name.inspect }
-        raise ArgumentError, msg, $!.backtrace
-      end
-
-      dest = Puppet::ModuleTool::Generate.destination(metadata)
-      result = Puppet::ModuleTool::Generate.generate(metadata, options[:skip_interview])
-
-      path = dest.relative_path_from(Pathname.pwd)
-      puts _("Finished; module generated in %{path}.") % { path: path }
-      result.join("\n")
-    end
-
-    deprecate
-  end
-end
-
-module Puppet::ModuleTool::Generate
-  module_function
-
-  def generate(metadata, skip_interview = false)
-    #TRANSLATORS 'puppet module generate' is the name of the puppet command and 'Puppet Development Kit' is the name of the software package replacing this action and should not be translated. 
-    Puppet.deprecation_warning _("`puppet module generate` is deprecated and will be removed in a future release. This action has been replaced by Puppet Development Kit. For more information visit https://puppet.com/docs/pdk/latest/pdk.html.")
-
-    interview(metadata) unless skip_interview
-    destination = duplicate_skeleton(metadata)
-    all_files = destination.basename + '**/*'
-
-    return Dir[all_files.to_s]
-  end
-
-  def interview(metadata)
-    puts _("We need to create a metadata.json file for this module.  Please answer the
-    following questions; if the question is not applicable to this module, feel free
-    to leave it blank.")
-
-    begin
-      puts
-      puts _("Puppet uses Semantic Versioning (semver.org) to version modules.")
-      puts _("What version is this module?  [%{version}]") % { version: metadata.version }
-      metadata.update 'version' => user_input(metadata.version)
-    rescue
-      Puppet.err _("We're sorry, we could not parse that as a Semantic Version.")
-      retry
-    end
-
-    puts
-    puts _("Who wrote this module?  [%{author}]") % { author: metadata.author }
-    metadata.update 'author' => user_input(metadata.author)
-
-    puts
-    puts _("What license does this module code fall under?  [%{license}]") % { license: metadata.license }
-    metadata.update 'license' => user_input(metadata.license)
-
-    puts
-    puts _("How would you describe this module in a single sentence?")
-    metadata.update 'summary' => user_input(metadata.summary)
-
-    puts
-    puts _("Where is this module's source code repository?")
-    metadata.update 'source' => user_input(metadata.source)
-
-    puts
-    puts _("Where can others go to learn more about this module?%{project_page}") % { project_page: metadata.project_page && "  [#{metadata.project_page}]" }
-    metadata.update 'project_page' => user_input(metadata.project_page)
-
-    puts
-    puts _("Where can others go to file issues about this module?%{issues}") % { issues: metadata.issues_url && "  [#{metadata.issues_url}]" }
-    metadata.update 'issues_url' => user_input(metadata.issues_url)
-
-    puts
-    puts '-' * 40
-    puts metadata.to_json
-    puts '-' * 40
-    puts
-    puts _("About to generate this metadata; continue? [n/Y]")
-
-    if user_input('Y') !~ /^y(es)?$/i
-      puts _("Aborting...")
-      exit 0
-    end
-  end
-
-  def user_input(default=nil)
-    print '--> '
-    input = STDIN.gets.chomp.strip
-    input = default if input == ''
-    return input
-  end
-
-  def destination(metadata)
-    return @dest if defined? @dest
-    @dest = Pathname.pwd + metadata.name
-    raise ArgumentError, _("%{destination} already exists.") % { destination: @dest } if @dest.exist?
-    return @dest
-  end
-
-  def duplicate_skeleton(metadata)
-    dest = destination(metadata)
-
-    puts
-    Puppet.notice _("Generating module at %{dest}...") % { dest: dest }
-    FileUtils.cp_r skeleton_path, dest
-
-    populate_templates(metadata, dest)
-    return dest
-  end
-
-  def populate_templates(metadata, destination)
-    Puppet.notice _("Populating templates...")
-
-    formatters = {
-      :erb      => proc { |data, ctx| ERB.new(data).result(ctx) },
-      :template => proc { |data, _| data },
-    }
-
-    formatters.each do |type, block|
-      templates = destination + "**/*.#{type}"
-
-      Dir.glob(templates.to_s, File::FNM_DOTMATCH).each do |erb|
-        path = Pathname.new(erb)
-        content = block[path.read, binding]
-
-        target = path.parent + path.basename(".#{type}")
-        target.open('w:UTF-8') { |f| f.write(content) }
-        path.unlink
-      end
-    end
-  end
-
-  def skeleton_path
-    return @path if defined? @path
-    path = Pathname(Puppet.settings[:module_skeleton_dir])
-    path = Pathname(__FILE__).dirname + '../../module_tool/skeleton/templates/generator' unless path.directory?
-    @path = path
-  end
-end

data/vendored/puppet/lib/puppet/face/module/install.rb

@@ -1,150 +0,0 @@
-# encoding: UTF-8
-require 'puppet/forge'
-require 'puppet/module_tool/install_directory'
-require 'pathname'
-
-Puppet::Face.define(:module, '1.0.0') do
-  action(:install) do
-    summary _("Install a module from the Puppet Forge or a release archive.")
-    description <<-EOT
-      Installs a module from the Puppet Forge or from a release archive file.
-      Note: Module install uses MD5 checksums, which are prohibited on FIPS enabled systems.
-
-      The specified module will be installed into the directory
-      specified with the `--target-dir` option, which defaults to the first
-      directory in the modulepath.
-    EOT
-
-    returns _("Pathname object representing the path to the installed module.")
-
-    examples <<-'EOT'
-      Install a module:
-
-      $ puppet module install puppetlabs-vcsrepo
-      Preparing to install into /etc/puppetlabs/code/modules ...
-      Downloading from https://forgeapi.puppet.com ...
-      Installing -- do not interrupt ...
-      /etc/puppetlabs/code/modules
-      └── puppetlabs-vcsrepo (v0.0.4)
-
-      Install a module to a specific environment:
-
-      $ puppet module install puppetlabs-vcsrepo --environment development
-      Preparing to install into /etc/puppetlabs/code/environments/development/modules ...
-      Downloading from https://forgeapi.puppet.com ...
-      Installing -- do not interrupt ...
-      /etc/puppetlabs/code/environments/development/modules
-      └── puppetlabs-vcsrepo (v0.0.4)
-
-      Install a specific module version:
-
-      $ puppet module install puppetlabs-vcsrepo -v 0.0.4
-      Preparing to install into /etc/puppetlabs/modules ...
-      Downloading from https://forgeapi.puppet.com ...
-      Installing -- do not interrupt ...
-      /etc/puppetlabs/code/modules
-      └── puppetlabs-vcsrepo (v0.0.4)
-
-      Install a module into a specific directory:
-
-      $ puppet module install puppetlabs-vcsrepo --target-dir=/opt/puppetlabs/puppet/modules
-      Preparing to install into /opt/puppetlabs/puppet/modules ...
-      Downloading from https://forgeapi.puppet.com ...
-      Installing -- do not interrupt ...
-      /opt/puppetlabs/puppet/modules
-      └── puppetlabs-vcsrepo (v0.0.4)
-
-      Install a module into a specific directory and check for dependencies in other directories:
-
-      $ puppet module install puppetlabs-vcsrepo --target-dir=/opt/puppetlabs/puppet/modules --modulepath /etc/puppetlabs/code/modules
-      Preparing to install into /opt/puppetlabs/puppet/modules ...
-      Downloading from https://forgeapi.puppet.com ...
-      Installing -- do not interrupt ...
-      /opt/puppetlabs/puppet/modules
-      └── puppetlabs-vcsrepo (v0.0.4)
-
-      Install a module from a release archive:
-
-      $ puppet module install puppetlabs-vcsrepo-0.0.4.tar.gz
-      Preparing to install into /etc/puppetlabs/code/modules ...
-      Downloading from https://forgeapi.puppet.com ...
-      Installing -- do not interrupt ...
-      /etc/puppetlabs/code/modules
-      └── puppetlabs-vcsrepo (v0.0.4)
-
-      Install a module from a release archive and ignore dependencies:
-
-      $ puppet module install puppetlabs-vcsrepo-0.0.4.tar.gz --ignore-dependencies
-      Preparing to install into /etc/puppetlabs/code/modules ...
-      Installing -- do not interrupt ...
-      /etc/puppetlabs/code/modules
-      └── puppetlabs-vcsrepo (v0.0.4)
-
-    EOT
-
-    arguments _("<name>")
-
-    option "--force", "-f" do
-      summary _("Force overwrite of existing module, if any. (Implies --ignore-dependencies.)")
-      description <<-EOT
-        Force overwrite of existing module, if any.
-        Implies --ignore-dependencies.
-      EOT
-    end
-
-    option "--target-dir DIR", "-i DIR" do
-      summary _("The directory into which modules are installed.")
-      description <<-EOT
-        The directory into which modules are installed; defaults to the first
-        directory in the modulepath.
-
-        Specifying this option will change the installation directory, and
-        will use the existing modulepath when checking for dependencies. If
-        you wish to check a different set of directories for dependencies, you
-        must also use the `--environment` or `--modulepath` options.
-      EOT
-    end
-
-    option "--ignore-dependencies" do
-      summary _("Do not attempt to install dependencies. (Implied by --force.)")
-      description <<-EOT
-        Do not attempt to install dependencies. Implied by --force.
-      EOT
-    end
-
-    option "--version VER", "-v VER" do
-      summary _("Module version to install.")
-      description <<-EOT
-        Module version to install; can be an exact version or a requirement string,
-        eg '>= 1.0.3'. Defaults to latest version.
-      EOT
-    end
-
-    option '--strict-semver' do
-      summary _('Whether version ranges should exclude pre-release versions')
-    end
-
-    when_invoked do |name, options|
-      Puppet::ModuleTool.set_option_defaults options
-      Puppet.notice _("Preparing to install into %{dir} ...") % { dir: options[:target_dir] }
-
-      install_dir = Puppet::ModuleTool::InstallDirectory.new(Pathname.new(options[:target_dir]))
-      Puppet::ModuleTool::Applications::Installer.run(name, install_dir, options)
-    end
-
-    when_rendering :console do |return_value, name, options|
-      if return_value[:result] == :noop
-        Puppet.notice _("Module %{name} %{version} is already installed.") % { name: name, version: return_value[:version] }
-        exit 0
-      elsif return_value[:result] == :failure
-        Puppet.err(return_value[:error][:multiline])
-        exit 1
-      else
-        tree = Puppet::ModuleTool.build_tree(return_value[:graph], return_value[:install_dir])
-
-        "#{return_value[:install_dir]}\n" +
-        Puppet::ModuleTool.format_tree(tree)
-      end
-    end
-  end
-end