puppet 6.29.0 → 7.0.0

data/lib/puppet/vendor/pathspec/lib/pathspec/gitignorespec.rb

@@ -1,275 +0,0 @@
-# encoding: utf-8
-
-require 'pathspec/regexspec'
-
-class GitIgnoreSpec < RegexSpec
-  attr_reader :regex
-
-  def initialize(pattern)
-    pattern = pattern.strip unless pattern.nil?
-
-    # A pattern starting with a hash ('#') serves as a comment
-    # (neither includes nor excludes files). Escape the hash with a
-    # back-slash to match a literal hash (i.e., '\#').
-    if pattern.start_with?('#')
-      @regex = nil
-      @inclusive = nil
-
-    # A blank pattern is a null-operation (neither includes nor
-    # excludes files).
-    elsif pattern.empty?
-      @regex = nil
-      @inclusive = nil
-
-    # Patterns containing three or more consecutive stars are invalid and
-    # will be ignored.
-    elsif pattern =~ /\*\*\*+/
-      @regex = nil
-      @inclusive = nil
-
-    # We have a valid pattern!
-    else
-      # A pattern starting with an exclamation mark ('!') negates the
-      # pattern (exclude instead of include). Escape the exclamation
-      # mark with a back-slash to match a literal exclamation mark
-      # (i.e., '\!').
-      if pattern.start_with?('!')
-        @inclusive = false
-        # Remove leading exclamation mark.
-        pattern = pattern[1..-1]
-      else
-        @inclusive = true
-      end
-
-      # Remove leading back-slash escape for escaped hash ('#') or
-      # exclamation mark ('!').
-      if pattern.start_with?('\\')
-        pattern = pattern[1..-1]
-      end
-
-      # Split pattern into segments. -1 to allow trailing slashes.
-      pattern_segs = pattern.split('/', -1)
-
-      # Normalize pattern to make processing easier.
-
-      # A pattern beginning with a slash ('/') will only match paths
-      # directly on the root directory instead of any descendant
-      # paths. So, remove empty first segment to make pattern relative
-      # to root.
-      if pattern_segs[0].empty?
-        pattern_segs.shift
-      else
-        # A pattern without a beginning slash ('/') will match any
-        # descendant path. This is equivalent to "**/{pattern}". So,
-        # prepend with double-asterisks to make pattern relative to
-        # root.
-        if pattern_segs.length == 1 && pattern_segs[0] != '**'
-          pattern_segs.insert(0, '**')
-        end
-      end
-
-      # A pattern ending with a slash ('/') will match all descendant
-      # paths of if it is a directory but not if it is a regular file.
-      # This is equivalent to "{pattern}/**". So, set last segment to
-      # double asterisks to include all descendants.
-      if pattern_segs[-1].empty?
-        pattern_segs[-1] = '**'
-      end
-
-      # Handle platforms with backslash separated paths
-      if File::SEPARATOR == '\\'
-        path_sep = '\\\\'
-      else
-        path_sep = '/'
-      end
-
-
-      # Build regular expression from pattern.
-      regex = '^'
-      need_slash = false
-      regex_end = pattern_segs.size - 1
-      pattern_segs.each_index do |i|
-        seg = pattern_segs[i]
-
-        if seg == '**'
-          # A pattern consisting solely of double-asterisks ('**')
-          # will match every path.
-          if i == 0 && i == regex_end
-            regex.concat('.+')
-
-          # A normalized pattern beginning with double-asterisks
-          # ('**') will match any leading path segments.
-          elsif i == 0
-            regex.concat("(?:.+#{path_sep})?")
-            need_slash = false
-
-          # A normalized pattern ending with double-asterisks ('**')
-          # will match any trailing path segments.
-          elsif i == regex_end
-            regex.concat("#{path_sep}.*")
-
-          # A pattern with inner double-asterisks ('**') will match
-          # multiple (or zero) inner path segments.
-          else
-            regex.concat("(?:#{path_sep}.+)?")
-            need_slash = true
-          end
-
-        # Match single path segment.
-        elsif seg == '*'
-          if need_slash
-            regex.concat(path_sep)
-          end
-
-          regex.concat("[^#{path_sep}]+")
-          need_slash = true
-
-        else
-          # Match segment glob pattern.
-          if need_slash
-            regex.concat(path_sep)
-          end
-
-          regex.concat(translate_segment_glob(seg))
-          need_slash = true
-        end
-      end
-
-      regex.concat('$')
-      super(regex)
-    end
-  end
-
-  def match(path)
-    super(path)
-  end
-
-  def translate_segment_glob(pattern)
-    """
-    Translates the glob pattern to a regular expression. This is used in
-    the constructor to translate a path segment glob pattern to its
-    corresponding regular expression.
-
-    *pattern* (``str``) is the glob pattern.
-
-    Returns the regular expression (``str``).
-    """
-    # NOTE: This is derived from `fnmatch.translate()` and is similar to
-    # the POSIX function `fnmatch()` with the `FNM_PATHNAME` flag set.
-
-    escape = false
-    regex = ''
-    i = 0
-
-    while i < pattern.size
-      # Get next character.
-      char = pattern[i].chr
-      i += 1
-
-      # Escape the character.
-      if escape
-        escape = false
-        regex += Regexp.escape(char)
-
-      # Escape character, escape next character.
-      elsif char == '\\'
-        escape = true
-
-      # Multi-character wildcard. Match any string (except slashes),
-      # including an empty string.
-      elsif char == '*'
-        regex += '[^/]*'
-
-      # Single-character wildcard. Match any single character (except
-      # a slash).
-      elsif char == '?'
-        regex += '[^/]'
-
-      # Bracket expression wildcard. Except for the beginning
-      # exclamation mark, the whole bracket expression can be used
-      # directly as regex but we have to find where the expression
-      # ends.
-      # - "[][!]" matches ']', '[' and '!'.
-      # - "[]-]" matches ']' and '-'.
-      # - "[!]a-]" matches any character except ']', 'a' and '-'.
-      elsif char == '['
-        j = i
-        # Pass brack expression negation.
-        if j < pattern.size && pattern[j].chr == '!'
-          j += 1
-        end
-
-        # Pass first closing bracket if it is at the beginning of the
-        # expression.
-        if j < pattern.size && pattern[j].chr == ']'
-          j += 1
-        end
-
-        # Find closing bracket. Stop once we reach the end or find it.
-        while j < pattern.size && pattern[j].chr != ']'
-          j += 1
-        end
-
-
-        if j < pattern.size
-          expr = '['
-
-          # Bracket expression needs to be negated.
-          if pattern[i].chr == '!'
-            expr += '^'
-            i += 1
-
-          # POSIX declares that the regex bracket expression negation
-          # "[^...]" is undefined in a glob pattern. Python's
-          # `fnmatch.translate()` escapes the caret ('^') as a
-          # literal. To maintain consistency with undefined behavior,
-          # I am escaping the '^' as well.
-          elsif pattern[i].chr == '^'
-            expr += '\\^'
-            i += 1
-          end
-
-          # Escape brackets contained within pattern
-          if pattern[i].chr == ']' && i != j
-            expr += '\]'
-            i += 1
-          end
-
-
-          # Build regex bracket expression. Escape slashes so they are
-          # treated as literal slashes by regex as defined by POSIX.
-          expr += pattern[i..j].sub('\\', '\\\\')
-
-          # Add regex bracket expression to regex result.
-          regex += expr
-
-          # Found end of bracket expression. Increment j to be one past
-          # the closing bracket:
-          #
-          #  [...]
-          #   ^   ^
-          #   i   j
-          #
-          j += 1
-          # Set i to one past the closing bracket.
-          i = j
-
-        # Failed to find closing bracket, treat opening bracket as a
-        # bracket literal instead of as an expression.
-        else
-          regex += '\['
-        end
-
-      # Regular character, escape it for regex.
-      else
-        regex << Regexp.escape(char)
-      end
-    end
-
-    regex
-  end
-
-  def inclusive?
-    @inclusive
-  end
-end

data/lib/puppet/vendor/pathspec/lib/pathspec/regexspec.rb

@@ -1,17 +0,0 @@
-require 'pathspec/spec'
-
-class RegexSpec < Spec
-  def initialize(regex)
-    @regex = Regexp.compile regex
-
-    super
-  end
-
-  def inclusive?
-    true
-  end
-
-  def match(path)
-    @regex.match(path) if @regex
-  end
-end

data/lib/puppet/vendor/pathspec/lib/pathspec/spec.rb

@@ -1,14 +0,0 @@
-class Spec
-  attr_reader :regex
-
-  def initialize(*_)
-  end
-
-  def match(files)
-    raise "Unimplemented"
-  end
-
-  def inclusive?
-    true
-  end
-end

data/lib/puppet/vendor/pathspec/lib/pathspec.rb

@@ -1,122 +0,0 @@
-require 'pathspec/gitignorespec'
-require 'pathspec/regexspec'
-require 'find'
-require 'pathname'
-
-class PathSpec
-  attr_reader :specs
-
-  def initialize(lines=nil, type=:git)
-    @specs = []
-
-    if lines
-      add(lines, type)
-    end
-
-    self
-  end
-
-  # Check if a path matches the pathspecs described
-  # Returns true if there are matches and none are excluded
-  # Returns false if there aren't matches or none are included
-  def match(path)
-    matches = specs_matching(path.to_s)
-    !matches.empty? && matches.all? {|m| m.inclusive?}
-  end
-
-  def specs_matching(path)
-    @specs.select do |spec|
-      if spec.match(path)
-        spec
-      end
-    end
-  end
-
-  # Check if any files in a given directory or subdirectories match the specs
-  # Returns matched paths or nil if no paths matched
-  def match_tree(root)
-    rootpath = Pathname.new(root)
-    matching = []
-
-    Find.find(root) do |path|
-      relpath = Pathname.new(path).relative_path_from(rootpath).to_s
-      relpath += '/' if File.directory? path
-      if match(relpath)
-        matching << path
-      end
-    end
-
-    matching
-  end
-
-  def match_path(path, root='/')
-    rootpath = Pathname.new(drive_letter_to_path(root))
-    relpath = Pathname.new(drive_letter_to_path(path)).relative_path_from(rootpath).to_s
-    relpath = relpath + '/' if path[-1].chr == '/'
-
-    match(relpath)
-  end
-
-  def match_paths(paths, root='/')
-    matching = []
-
-    paths.each do |path|
-      if match_path(path, root)
-        matching << path
-      end
-    end
-
-    matching
-  end
-
-  def drive_letter_to_path(path)
-    path.gsub(/^([a-zA-Z]):\//, '/\1/')
-  end
-
-  # Generate specs from a filename, such as a .gitignore
-  def self.from_filename(filename, type=:git)
-    # .gitignore is a UTF-8 file
-    self.from_lines(File.open(filename, 'r', :encoding => Encoding::UTF_8), type)
-  end
-
-  def self.from_lines(lines, type=:git)
-    self.new lines, type
-  end
-
-  # Generate specs from lines of text
-  def add(obj, type=:git)
-    spec_class = spec_type(type)
-
-    if obj.respond_to?(:each_line)
-      obj.each_line do |l|
-        spec = spec_class.new(l.rstrip)
-
-        if !spec.regex.nil? && !spec.inclusive?.nil?
-          @specs << spec
-        end
-      end
-    elsif obj.respond_to?(:each)
-      obj.each do |l|
-        add(l, type)
-      end
-    else
-      raise 'Cannot make Pathspec from non-string/non-enumerable object.'
-    end
-
-    self
-  end
-
-  def empty?
-    @specs.empty?
-  end
-
-  def spec_type(type)
-    if type == :git
-      GitIgnoreSpec
-    elsif type == :regex
-      RegexSpec
-    else
-      raise "Unknown spec type #{type}"
-    end
-  end
-end

data/man/man8/puppet-key.8

@@ -1,126 +0,0 @@
-.\" generated with Ronn/v0.7.3
-.\" http://github.com/rtomayko/ronn/tree/0.7.3
-.
-.TH "PUPPET\-KEY" "8" "January 2023" "Puppet, Inc." "Puppet manual"
-.
-.SH "NAME"
-\fBpuppet\-key\fR \- Create, save, and remove certificate keys\.
-.
-.SH "SYNOPSIS"
-puppet key \fIaction\fR [\-\-terminus _TERMINUS]
-.
-.SH "DESCRIPTION"
-This subcommand manages certificate private keys\. Keys are created automatically by puppet agent and when certificate requests are generated with \'puppet ssl submit_request\'; it should not be necessary to use this subcommand directly\.
-.
-.SH "OPTIONS"
-Note that any setting that\'s valid in the configuration file is also a valid long argument, although it may or may not be relevant to the present action\. For example, \fBserver\fR and \fBrun_mode\fR are valid settings, so you can specify \fB\-\-server <servername>\fR, or \fB\-\-run_mode <runmode>\fR as an argument\.
-.
-.P
-See the configuration file documentation at \fIhttps://puppet\.com/docs/puppet/latest/configuration\.html\fR for the full list of acceptable parameters\. A commented list of all configuration options can also be generated by running puppet with \fB\-\-genconfig\fR\.
-.
-.TP
-\-\-render\-as FORMAT
-The format in which to render output\. The most common formats are \fBjson\fR, \fBs\fR (string), \fByaml\fR, and \fBconsole\fR, but other options such as \fBdot\fR are sometimes available\.
-.
-.TP
-\-\-verbose
-Whether to log verbosely\.
-.
-.TP
-\-\-debug
-Whether to log debug information\.
-.
-.TP
-\-\-extra HASH
-A terminus can take additional arguments to refine the operation, which are passed as an arbitrary hash to the back\-end\. Anything passed as the extra value is just send direct to the back\-end\.
-.
-.TP
-\-\-terminus _TERMINUS
-Indirector faces expose indirected subsystems of Puppet\. These subsystems are each able to retrieve and alter a specific type of data (with the familiar actions of \fBfind\fR, \fBsearch\fR, \fBsave\fR, and \fBdestroy\fR) from an arbitrary number of pluggable backends\. In Puppet parlance, these backends are called terminuses\.
-.
-.IP
-Almost all indirected subsystems have a \fBrest\fR terminus that interacts with the puppet master\'s data\. Most of them have additional terminuses for various local data models, which are in turn used by the indirected subsystem on the puppet master whenever it receives a remote request\.
-.
-.IP
-The terminus for an action is often determined by context, but occasionally needs to be set explicitly\. See the "Notes" section of this face\'s manpage for more details\.
-.
-.SH "ACTIONS"
-.
-.TP
-\fBdestroy\fR \- Delete an object\.
-\fBSYNOPSIS\fR
-.
-.IP
-puppet key destroy [\-\-terminus _TERMINUS] \fIkey\fR
-.
-.IP
-\fBDESCRIPTION\fR
-.
-.IP
-Delete an object\.
-.
-.TP
-\fBfind\fR \- Retrieve an object by name\.
-\fBSYNOPSIS\fR
-.
-.IP
-puppet key find [\-\-terminus _TERMINUS] [\fIkey\fR]
-.
-.IP
-\fBDESCRIPTION\fR
-.
-.IP
-Retrieve an object by name\.
-.
-.TP
-\fBinfo\fR \- Print the default terminus class for this face\.
-\fBSYNOPSIS\fR
-.
-.IP
-puppet key info [\-\-terminus _TERMINUS]
-.
-.IP
-\fBDESCRIPTION\fR
-.
-.IP
-Prints the default terminus class for this subcommand\. Note that different run modes may have different default termini; when in doubt, specify the run mode with the \'\-\-run_mode\' option\.
-.
-.TP
-\fBsave\fR \- API only: create or overwrite an object\.
-\fBSYNOPSIS\fR
-.
-.IP
-puppet key save [\-\-terminus _TERMINUS] \fIkey\fR
-.
-.IP
-\fBDESCRIPTION\fR
-.
-.IP
-API only: create or overwrite an object\. As the Faces framework does not currently accept data from STDIN, save actions cannot currently be invoked from the command line\.
-.
-.TP
-\fBsearch\fR \- Search for an object or retrieve multiple objects\.
-\fBSYNOPSIS\fR
-.
-.IP
-puppet key search [\-\-terminus _TERMINUS] \fIquery\fR
-.
-.IP
-\fBDESCRIPTION\fR
-.
-.IP
-Search for an object or retrieve multiple objects\.
-.
-.SH "NOTES"
-This subcommand is an indirector face, which exposes \fBfind\fR, \fBsearch\fR, \fBsave\fR, and \fBdestroy\fR actions for an indirected subsystem of Puppet\. Valid termini for this face include:
-.
-.IP "\(bu" 4
-\fBfile\fR
-.
-.IP "\(bu" 4
-\fBmemory\fR
-.
-.IP "" 0
-.
-.SH "COPYRIGHT AND LICENSE"
-Copyright 2011 by Puppet Inc\. Apache 2 license; see COPYING

data/man/man8/puppet-man.8

@@ -1,76 +0,0 @@
-.\" generated with Ronn/v0.7.3
-.\" http://github.com/rtomayko/ronn/tree/0.7.3
-.
-.TH "PUPPET\-MAN" "8" "January 2023" "Puppet, Inc." "Puppet manual"
-.
-.SH "NAME"
-\fBpuppet\-man\fR \- Display Puppet manual pages\.
-.
-.SH "SYNOPSIS"
-puppet man \fIaction\fR
-.
-.SH "DESCRIPTION"
-Please use the command \'puppet help \fIsubcommand\fR\' or the system manpage system \'man puppet\-\fIsubcommand\fR\' to display information about Puppet subcommands\. The deprecated man subcommand displays manual pages for all Puppet subcommands\. If the \fBronn\fR gem (\fIhttps://github\.com/rtomayko/ronn/\fR) is installed on your system, puppet man will display fully\-formatted man pages\. If \fBronn\fR is not available, puppet man will display the raw (but human\-readable) source text in a pager\.
-.
-.SH "OPTIONS"
-Note that any setting that\'s valid in the configuration file is also a valid long argument, although it may or may not be relevant to the present action\. For example, \fBserver\fR and \fBrun_mode\fR are valid settings, so you can specify \fB\-\-server <servername>\fR, or \fB\-\-run_mode <runmode>\fR as an argument\.
-.
-.P
-See the configuration file documentation at \fIhttps://puppet\.com/docs/puppet/latest/configuration\.html\fR for the full list of acceptable parameters\. A commented list of all configuration options can also be generated by running puppet with \fB\-\-genconfig\fR\.
-.
-.TP
-\-\-render\-as FORMAT
-The format in which to render output\. The most common formats are \fBjson\fR, \fBs\fR (string), \fByaml\fR, and \fBconsole\fR, but other options such as \fBdot\fR are sometimes available\.
-.
-.TP
-\-\-verbose
-Whether to log verbosely\.
-.
-.TP
-\-\-debug
-Whether to log debug information\.
-.
-.SH "ACTIONS"
-.
-.TP
-\fBman\fR \- Display the manual page for a Puppet subcommand\.
-\fBSYNOPSIS\fR
-.
-.IP
-puppet man \fIsubcommand\fR
-.
-.IP
-\fBDESCRIPTION\fR
-.
-.IP
-Display the manual page for a Puppet subcommand\.
-.
-.IP
-\fBRETURNS\fR
-.
-.IP
-The man data, in Markdown format, suitable for consumption by Ronn\.
-.
-.IP
-RENDERING ISSUES: To skip fancy formatting and output the raw Markdown text (e\.g\. for use in a pipeline), call this action with \'\-\-render\-as s\'\.
-.
-.SH "EXAMPLES"
-\fBman\fR
-.
-.P
-View the installed manual page for the subcommand \'config\':
-.
-.P
-$ man puppet\-config
-.
-.P
-(Deprecated) View the manual page for the subcommand \'config\':
-.
-.P
-$ puppet man config
-.
-.SH "NOTES"
-The pager used for display will be the first found of \fB$MANPAGER\fR, \fB$PAGER\fR, \fBless\fR, \fBmost\fR, or \fBmore\fR\.
-.
-.SH "COPYRIGHT AND LICENSE"
-Copyright 2011 by Puppet Inc\. Apache 2 license; see COPYING