puppet-masterless 0.2.2 → 0.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: efe72dcfd1e767ad585ab7877714c2d5ce25560f524a4a754575c5cb484078d1
-  data.tar.gz: f7db589d57432b964c237e7b9f913e0d7fb3a361eb5064fc47ea5b992b1e9dcc
+  metadata.gz: c92e1a6b43a5b98773af8b769d752ec38ab36b6703df0fcb3f5021729b9dbd38
+  data.tar.gz: ec90a19bb036bd8166a54cdfba7137370560d313e54748926e92c3408125432f
 SHA512:
-  metadata.gz: 0a2985ea7c98b601e58476caaf773974a99e1e346c2fa07e51cd5fa4be0f26957b544af9f85a4a3afc56adf1f08374e4c0876c19bffa04e13ea5c942c7f0b4ae
-  data.tar.gz: c79f6b79db153787060c2fbdd46dc5913341ccd64c947ddd8bcef4179f7391aae59703944571875a5d7ea8eddddbb53addaa99ccfe305dad92d1abe6f606e7a2
+  metadata.gz: 371ad6220621c70420885ea853a6cc541489b31257faee85f38d02cab607d6f748c561b0f920232027dc60fde345346f8fad80c5986a6517f2c6eb16a061b58d
+  data.tar.gz: 752186acfd8d467161ed42845036b14d22bf54690e31d9fa48939783025fdbacdf76738a78a8271224c3aa4893b056776df070cb34cfc8e966477daf86bd772d

data/README.md

@@ -30,8 +30,8 @@ the man page.
     install -m 755 src/puppet-masterless /usr/local/bin/puppet-masterless
     install -m 644 man/puppet-masterless.1 /usr/local/share/man/man1/puppet-masterless.1
 
-You can also bundle the man page with the executable and install just
-that one file:
+You can also bundle the man page with the executable and install both as
+a single file:
 
     rake build:prepare
     install -m 755 bin/puppet-masterless /usr/local/bin/puppet-masterless
@@ -61,8 +61,8 @@ about how this directory should be organised.
 The program accepts arguments according to a very simple command line
 grammar. To see a summary of the available options and what they
 control, run `puppet-masterless` without any arguments. For full
-documentation, refer to its man page[^2] or help text (accessed via
-`puppet-masterless help`).
+documentation, refer to its [man page][manual][^2] or help text
+(accessed via `puppet-masterless help`).
 
 [^2]: You can view a Gem's man page by installing the [gem-man][]
   extension and running `gem man <gem>`.
@@ -111,10 +111,20 @@ path under your project's `confdir`:
     :yaml:
       :datadir: "%{settings::confdir}/data"
 
+## Resources
+
+ - [Man page][manual]
+ - [Source repository][repo]
+ - [Issue tracker][issues]
+
+[manual]: https://catalyst-it.gitlab.io/devtools/puppet-masterless/
+[repo]: https://gitlab.com/catalyst-it/devtools/puppet-masterless/
+[issues]: https://gitlab.com/catalyst-it/devtools/puppet-masterless/issues
+
 ## Contributing
 
- 1. Fork it from <https://gitlab.com/catalyst-it/puppet-masterless>
+ 1. Fork it from <https://gitlab.com/catalyst-it/devtools/puppet-masterless>
  2. Create a feature branch (`git checkout -b my-new-feature`)
  3. Commit your changes (`git commit -am 'Add some feature'`)
  4. Push to the branch (`git push origin my-new-feature`)
- 5. Create a Merge Request at <https://gitlab.com/catalyst-it/puppet-masterless/merge_requests>
+ 5. Create a Merge Request at <https://gitlab.com/catalyst-it/devtools/puppet-masterless/merge_requests>

data/bin/puppet-masterless

@@ -56,6 +56,7 @@ module PuppetMasterless
   DEFAULT_SUDO = 'sudo'
   REMOTE_USER = 'root'
   REMOTE_WORKDIR = '/tmp'
+  VERSION = %{0.2.3}
 
   class Main
     def initialize
@@ -74,6 +75,11 @@ module PuppetMasterless
       exit(n)
     end
 
+    def version(n = 0)
+      STDERR.puts("puppet-masterless #{VERSION}")
+      exit(n)
+    end
+
     def collect(args)
       while word = args.shift
         case word
@@ -236,6 +242,8 @@ begin
     main.apply
   when 'help'
     main.help
+  when 'version', '--version'
+    main.version(0)
   when '-h', '--help', nil
     main.usage(0)
   else
@@ -246,7 +254,7 @@ rescue => e
   exit(1)
 end
 
-#1 .Dd January 28, 2019
+#1 .Dd October 10, 2019
 #1 .Dt PUPPET-MASTERLESS 1
 #1 .Os
 #1 .Sh NAME
@@ -262,110 +270,134 @@ end
 #1 .Sh DESCRIPTION
 #1 The
 #1 .Nm
-#1 .No program packages a Puppet project as a self-contained shell script
-#1 .No and optionally executes it on a remote machine via SSH.
+#1 program packages a Puppet project as a self-contained shell script and
+#1 optionally executes it on a remote machine via SSH.
 #1 .Pp
-#1 .No Some simple conventions are used to decide what files to include
-#1 .No in the package. For a list of files that will be automatically
-#1 .No included, refer to Sx FILES .
+#1 Some simple conventions are used to decide what files to include in the
+#1 package. For a list of files that will be automatically included, refer
+#1 to
+#1 .Sx FILES .
 #1 .Sh COMMANDS
-#1 .Bl -tag -width "        "
+#1 .Bl -tag -width Ds
 #1 .It Cm package
-#1 .No Package a project as a self-contained shell script.
+#1 Package a project as a self-contained shell script.
 #1 .It Cm apply
-#1 .No Apply a project to a remote host, or to the local machine if no
-#1 .No hostname is specified with the
-#1 .Cm to No argument.
+#1 Apply a project to a remote host, or to the local machine if no hostname
+#1 is specified with the
+#1 .Cm to
+#1 argument.
+#1 .El
 #1 .Sh ARGUMENTS
-#1 .Bl -tag -width "        "
+#1 .Bl -tag -width Ds
 #1 .It Cm confdir Aq pathname
-#1 .No Set the root directory of the Puppet project. This value is passed to
+#1 Set the root directory of the Puppet project. This value is passed to
 #1 .Fl -confdir
-#1 .No when running
+#1 when running
 #1 .Xr puppet-apply 8 .
 #1 .Pp
-#1 .No This argument is required.
+#1 This argument is required.
 #1 .It Cm manifest Aq filename
-#1 .No Specify the main Puppet manifest to apply. This may be a file or
-#1 .No directory.
+#1 Specify the main Puppet manifest to apply. This may be a file or
+#1 directory.
 #1 .Pp
-#1 .No Defaults to
+#1 Defaults to
 #1 .Dq Ao confdir Ac Ns /manifests
-#1 .No (if that file is present).
+#1 (if that file is present).
 #1 .It Cm hiera_config Aq filename
-#1 .No Specify the Hiera configuration file to use. This value is passed to
+#1 Specify the Hiera configuration file to use. This value is passed to
 #1 .Fl -hiera_config
-#1 .No when running
+#1 when running
 #1 .Xr puppet-apply 8 .
 #1 .Pp
-#1 .No Defaults to
+#1 Defaults to
 #1 .Dq Ao confdir Ac Ns /hiera.yaml
-#1 .No (if that file is present).
+#1 (if that file is present).
 #1 .It Cm modulepath Aq pathname
-#1 .No Set the Puppet modules directory. This value is passed to
-#1 .No Fl -modulepath No when running Xr puppet-apply 8 .
+#1 Set the Puppet modules directory. This value is passed to
+#1 .Fl -modulepath
+#1 when running
+#1 .Xr puppet-apply 8 .
 #1 .Pp
-#1 .No Defaults to
+#1 Defaults to
 #1 .Dq Ao confdir Ac Ns /modules
-#1 .No (if that file is present).
+#1 (if that file is present).
 #1 .It Cm file Aq filename
-#1 .No Add an arbitrary file or directory to the generated package. This
-#1 .No can be used to include files in non-standard locations.
+#1 Add an arbitrary file or directory to the generated package. This can be
+#1 used to include files in non-standard locations.
 #1 .Pp
-#1 .No Directories are added recursively, and this option can be repeated
-#1 .No to include multiple files.
+#1 Directories are added recursively, and this option can be repeated to
+#1 include multiple files.
 #1 .It Cm puppet Aq executable
-#1 .No Specify the location of the Xr puppet 8 executable on the remote host.
-#1 .No This is useful when the puppet binary is installed in a directory
-#1 .No that is not on the active user's Ev PATH (for example under
+#1 .Pp
+#1 Specify the location of the
+#1 .Xr puppet 8
+#1 executable on the remote host. This is useful when the puppet binary is
+#1 installed in a directory that is not on the active user's
+#1 .Ev PATH
+#1 (for example under
 #1 .Pa /opt/puppetlabs/bin Ns ).
 #1 .Pp
-#1 .No Defaults to
+#1 Defaults to
 #1 .Dq puppet .
 #1 .It Cm output file Aq filename
-#1 .No Set the output filename. If not given, a randomly-generated filename in
-#1 .No the current directory is used.
+#1 Set the output filename. If not given, a randomly-generated filename in
+#1 the current directory is used.
 #1 .Pp
-#1 .No Applies only to the Cm package No command.
+#1 Applies only to the
+#1 .Cm package
+#1 command.
 #1 .It Cm sudo Aq executable
-#1 .No Specify the location of the Xr sudo 1 executable on the remote host.
-#1 .No This can also be used to specify an alternative command for
-#1 .No privilege elevation, for example Xr doas 1 .
+#1 Specify the location of the
+#1 .Xr sudo 1
+#1 executable on the remote host. This can also be used to specify an
+#1 alternative command for privilege elevation, for example
+#1 .Xr doas 1 .
 #1 .Pp
-#1 .No Applies only to the Cm apply No command.
+#1 Applies only to the
+#1 .Cm apply
+#1 command.
 #1 .Pp
-#1 .No Defaults to
+#1 Defaults to
 #1 .Dq sudo .
 #1 .It Cm as Aq username
-#1 .No Set the name of the user that will run
-#1 .Xr puppet-apply 8 on the remote host.
-#1 .Xr sudo 1 is used to become this user before execution.
+#1 Set the name of the user that will run
+#1 .Xr puppet-apply 8
+#1 on the remote host.
+#1 .Xr sudo 1
+#1 is used to become this user before execution.
 #1 .Pp
-#1 .No Applies only to the Cm apply No command.
+#1 Applies only to the
+#1 .Cm apply
+#1 command.
 #1 .Pp
-#1 .No Defaults to
+#1 Defaults to
 #1 .Dq root .
 #1 .It Cm to Aq hostname
-#1 .No Specify the remote host to provision. If not given, the project will
-#1 .No be applied directly to the local machine (without packaging or SSH).
+#1 Specify the remote host to provision. If not given, the project will be
+#1 applied directly to the local machine (without packaging or SSH).
 #1 .Pp
-#1 .No Applies only to the Cm apply No command.
-#1 .It Cm and , with
-#1 .No These words are ignored. They can be used to make an invocation of
-#1 .No the program read sensibly (or insensibly, as desired).
+#1 Applies only to the
+#1 .Cm apply
+#1 command.
+#1 .It Cm and, with
+#1 These words are ignored. They can be used to make an invocation of the
+#1 program read sensibly (or insensibly, as desired).
 #1 .It Cm -- [ Ar argument ... ]
-#1 .No Two dashes indicate the end of program arguments. Any remaining
-#1 .No arguments are passed to
-#1 .Xr puppet-apply 8 verbatim.
-#1 .El
+#1 Two dashes indicate the end of program arguments. Any remaining
+#1 arguments are passed to
+#1 .Xr puppet-apply 8
+#1 verbatim.
+#1 .\" empty par for -T html spacing
 #1 .Pp
-#1 .No For more information about the
+#1 \&
+#1 .El
+#1 For more information about the
 #1 .Cm confdir ,
 #1 .Cm hiera_config ,
 #1 .Cm manifest , No and
 #1 .Cm modulepath No settings, refer to the following Puppet documentation:
 #1 .Pp
-#1 .Bl -dash -compact -width Ns
+#1 .Bl -dash -compact
 #1 .It
 #1 .Lk https://puppet.com/docs/puppet/5.5/dirs_confdir.html confdir
 #1 .It
@@ -376,9 +408,12 @@ end
 #1 .Lk https://puppet.com/docs/puppet/5.5/dirs_modulepath.html modulepath
 #1 .El
 #1 .Sh FILES
-#1 .No The following files are automatically included in the package, when
-#1 .No present:
-#1 .Bl -column "                 "
+#1 The following files are automatically included in the package, when
+#1 present:
+#1 .\" empty par for -T html spacing
+#1 .Pp
+#1 \&
+#1 .Bl -column "                  "
 #1 .It Ao confdir Ac Ns /puppet.conf Ta - Default Puppet configuration file.
 #1 .It Ao confdir Ac Ns /hiera.yaml  Ta - Default hiera configuration file.
 #1 .It Ao confdir Ac Ns /data        Ta - Default hiera data directory.
@@ -386,7 +421,7 @@ end
 #1 .It Ao confdir Ac Ns /modules     Ta - Default module path.
 #1 .El
 #1 .Pp
-#1 .No Directories are included recursively.
+#1 Directories are included recursively.
 #1 .Sh EXIT STATUS
 #1 .Ex -std
 #1 .Sh EXAMPLES
@@ -397,11 +432,11 @@ end
 #1 puppet-masterless apply confdir puppet
 #1 .Ed
 #1 .Pp
-#1 .No Apply the
+#1 Apply the
 #1 .Pa site.pp
-#1 .No manifest from the project in
+#1 manifest from the project in
 #1 .Pa ./config
-#1 .No to host 10.0.8.1 as user
+#1 to host 10.0.8.1 as user
 #1 .Dq charlize :
 #1 .Bd -literal -offset indent
 #1 puppet-masterless apply confdir config \\
@@ -409,48 +444,50 @@ end
 #1   to 10.0.8.1 as charlize
 #1 .Ed
 #1 .Pp
-#1 .No Bundle the
+#1 Bundle the
 #1 .Pa test
-#1 .No project as a shell script, including a non-standard Hiera configuration
-#1 .No file location and data directory:
+#1 project as a shell script, including a non-standard Hiera configuration
+#1 file location and data directory:
 #1 .Bd -literal -offset indent
 #1 puppet-masterless package confdir test \\
 #1   with file hiera and hiera_config hiera/test.yaml
 #1 .Ed
+#1 .Pp
 #1 .Sh CAVEATS
-#1 .No For this program to be useful, Puppet must be installed on the remote host.
+#1 For this program to be useful, Puppet must be installed on the remote
+#1 host.
 #1 .Pp
-#1 .No All file paths must be relative to the current working directory. An error
-#1 .No is signaled whenever an absolute path is specified.
+#1 All file paths must be relative to the current working directory. An
+#1 error is signaled whenever an absolute path is specified.
 #1 .Pp
-#1 .No This program is only intended to work with Puppet 4.10 and 5.5. \&It
-#1 .No may work with other versions of Puppet, or it may not.
+#1 This program is only intended to work with Puppet 4.10 and 5.5. It may
+#1 work with other versions of Puppet, or it may not.
 #1 .Pp
-#1 .No The SSH functionality of this program is intentionally simplistic.
-#1 .No If you need more complex behaviour when connecting to remote machines,
-#1 .No use the
+#1 The SSH functionality of this program is intentionally simplistic. If
+#1 you need more complex behaviour when connecting to remote machines, use
+#1 the
 #1 .Cm package
-#1 .No command in combination with a tool like
+#1 command in combination with a tool like
 #1 .Xr ansible 1 ,
 #1 .Xr cap 1 or
 #1 .Xr fab 1 .
 #1 .Pp
-#1 .No Very little information is displayed when an error occurs.
+#1 Very little information is displayed when an error occurs.
 #1 .Sh SECURITY CONSIDERATIONS
-#1 .No The
+#1 The
 #1 .Cm apply
-#1 .No command uses
+#1 command uses
 #1 .Xr sudo 1
-#1 .No to assume a given user's identity on the remote host, with all of the
-#1 .No security issues that implies.
+#1 to assume a given user's identity on the remote host, with all of the
+#1 security issues that implies.
 #1 .Pp
-#1 .No When applying manifests to a remote machine, any secrets included in the
-#1 .No project will be present on the filesystem for as long as it takes to run
+#1 When applying manifests to a remote machine, any secrets included in the
+#1 project will be present on the filesystem for as long as it takes to run
 #1 .Xr puppet-apply 8 .
 #1 .Sh IMPLEMENTATION NOTES
 #1 .Nm
-#1 .No is a single Ruby script with no Gem dependencies. \&It should be
-#1 .No possible to copy and run it on any machine with Ruby 1.9 or newer.
+#1 is a single Ruby script with no Gem dependencies. It should be possible
+#1 to copy and run on any machine with Ruby 1.9 or newer.
 #1 .Sh SEE ALSO
 #1 .Xr puppet 8 ,
 #1 .Xr puppet-apply 8 ,

data/man/puppet-masterless.1

@@ -1,4 +1,4 @@
-.Dd January 28, 2019
+.Dd October 10, 2019
 .Dt PUPPET-MASTERLESS 1
 .Os
 .Sh NAME
@@ -14,110 +14,134 @@
 .Sh DESCRIPTION
 The
 .Nm
-.No program packages a Puppet project as a self-contained shell script
-.No and optionally executes it on a remote machine via SSH.
+program packages a Puppet project as a self-contained shell script and
+optionally executes it on a remote machine via SSH.
 .Pp
-.No Some simple conventions are used to decide what files to include
-.No in the package. For a list of files that will be automatically
-.No included, refer to Sx FILES .
+Some simple conventions are used to decide what files to include in the
+package. For a list of files that will be automatically included, refer
+to
+.Sx FILES .
 .Sh COMMANDS
-.Bl -tag -width "        "
+.Bl -tag -width Ds
 .It Cm package
-.No Package a project as a self-contained shell script.
+Package a project as a self-contained shell script.
 .It Cm apply
-.No Apply a project to a remote host, or to the local machine if no
-.No hostname is specified with the
-.Cm to No argument.
+Apply a project to a remote host, or to the local machine if no hostname
+is specified with the
+.Cm to
+argument.
+.El
 .Sh ARGUMENTS
-.Bl -tag -width "        "
+.Bl -tag -width Ds
 .It Cm confdir Aq pathname
-.No Set the root directory of the Puppet project. This value is passed to
+Set the root directory of the Puppet project. This value is passed to
 .Fl -confdir
-.No when running
+when running
 .Xr puppet-apply 8 .
 .Pp
-.No This argument is required.
+This argument is required.
 .It Cm manifest Aq filename
-.No Specify the main Puppet manifest to apply. This may be a file or
-.No directory.
+Specify the main Puppet manifest to apply. This may be a file or
+directory.
 .Pp
-.No Defaults to
+Defaults to
 .Dq Ao confdir Ac Ns /manifests
-.No (if that file is present).
+(if that file is present).
 .It Cm hiera_config Aq filename
-.No Specify the Hiera configuration file to use. This value is passed to
+Specify the Hiera configuration file to use. This value is passed to
 .Fl -hiera_config
-.No when running
+when running
 .Xr puppet-apply 8 .
 .Pp
-.No Defaults to
+Defaults to
 .Dq Ao confdir Ac Ns /hiera.yaml
-.No (if that file is present).
+(if that file is present).
 .It Cm modulepath Aq pathname
-.No Set the Puppet modules directory. This value is passed to
-.No Fl -modulepath No when running Xr puppet-apply 8 .
+Set the Puppet modules directory. This value is passed to
+.Fl -modulepath
+when running
+.Xr puppet-apply 8 .
 .Pp
-.No Defaults to
+Defaults to
 .Dq Ao confdir Ac Ns /modules
-.No (if that file is present).
+(if that file is present).
 .It Cm file Aq filename
-.No Add an arbitrary file or directory to the generated package. This
-.No can be used to include files in non-standard locations.
+Add an arbitrary file or directory to the generated package. This can be
+used to include files in non-standard locations.
 .Pp
-.No Directories are added recursively, and this option can be repeated
-.No to include multiple files.
+Directories are added recursively, and this option can be repeated to
+include multiple files.
 .It Cm puppet Aq executable
-.No Specify the location of the Xr puppet 8 executable on the remote host.
-.No This is useful when the puppet binary is installed in a directory
-.No that is not on the active user's Ev PATH (for example under
+.Pp
+Specify the location of the
+.Xr puppet 8
+executable on the remote host. This is useful when the puppet binary is
+installed in a directory that is not on the active user's
+.Ev PATH
+(for example under
 .Pa /opt/puppetlabs/bin Ns ).
 .Pp
-.No Defaults to
+Defaults to
 .Dq puppet .
 .It Cm output file Aq filename
-.No Set the output filename. If not given, a randomly-generated filename in
-.No the current directory is used.
+Set the output filename. If not given, a randomly-generated filename in
+the current directory is used.
 .Pp
-.No Applies only to the Cm package No command.
+Applies only to the
+.Cm package
+command.
 .It Cm sudo Aq executable
-.No Specify the location of the Xr sudo 1 executable on the remote host.
-.No This can also be used to specify an alternative command for
-.No privilege elevation, for example Xr doas 1 .
+Specify the location of the
+.Xr sudo 1
+executable on the remote host. This can also be used to specify an
+alternative command for privilege elevation, for example
+.Xr doas 1 .
 .Pp
-.No Applies only to the Cm apply No command.
+Applies only to the
+.Cm apply
+command.
 .Pp
-.No Defaults to
+Defaults to
 .Dq sudo .
 .It Cm as Aq username
-.No Set the name of the user that will run
-.Xr puppet-apply 8 on the remote host.
-.Xr sudo 1 is used to become this user before execution.
+Set the name of the user that will run
+.Xr puppet-apply 8
+on the remote host.
+.Xr sudo 1
+is used to become this user before execution.
 .Pp
-.No Applies only to the Cm apply No command.
+Applies only to the
+.Cm apply
+command.
 .Pp
-.No Defaults to
+Defaults to
 .Dq root .
 .It Cm to Aq hostname
-.No Specify the remote host to provision. If not given, the project will
-.No be applied directly to the local machine (without packaging or SSH).
+Specify the remote host to provision. If not given, the project will be
+applied directly to the local machine (without packaging or SSH).
 .Pp
-.No Applies only to the Cm apply No command.
-.It Cm and , with
-.No These words are ignored. They can be used to make an invocation of
-.No the program read sensibly (or insensibly, as desired).
+Applies only to the
+.Cm apply
+command.
+.It Cm and, with
+These words are ignored. They can be used to make an invocation of the
+program read sensibly (or insensibly, as desired).
 .It Cm -- [ Ar argument ... ]
-.No Two dashes indicate the end of program arguments. Any remaining
-.No arguments are passed to
-.Xr puppet-apply 8 verbatim.
-.El
+Two dashes indicate the end of program arguments. Any remaining
+arguments are passed to
+.Xr puppet-apply 8
+verbatim.
+.\" empty par for -T html spacing
 .Pp
-.No For more information about the
+\&
+.El
+For more information about the
 .Cm confdir ,
 .Cm hiera_config ,
 .Cm manifest , No and
 .Cm modulepath No settings, refer to the following Puppet documentation:
 .Pp
-.Bl -dash -compact -width Ns
+.Bl -dash -compact
 .It
 .Lk https://puppet.com/docs/puppet/5.5/dirs_confdir.html confdir
 .It
@@ -128,9 +152,12 @@ The
 .Lk https://puppet.com/docs/puppet/5.5/dirs_modulepath.html modulepath
 .El
 .Sh FILES
-.No The following files are automatically included in the package, when
-.No present:
-.Bl -column "                 "
+The following files are automatically included in the package, when
+present:
+.\" empty par for -T html spacing
+.Pp
+\&
+.Bl -column "                  "
 .It Ao confdir Ac Ns /puppet.conf Ta - Default Puppet configuration file.
 .It Ao confdir Ac Ns /hiera.yaml  Ta - Default hiera configuration file.
 .It Ao confdir Ac Ns /data        Ta - Default hiera data directory.
@@ -138,7 +165,7 @@ The
 .It Ao confdir Ac Ns /modules     Ta - Default module path.
 .El
 .Pp
-.No Directories are included recursively.
+Directories are included recursively.
 .Sh EXIT STATUS
 .Ex -std
 .Sh EXAMPLES
@@ -149,11 +176,11 @@ directly to the local machine:
 puppet-masterless apply confdir puppet
 .Ed
 .Pp
-.No Apply the
+Apply the
 .Pa site.pp
-.No manifest from the project in
+manifest from the project in
 .Pa ./config
-.No to host 10.0.8.1 as user
+to host 10.0.8.1 as user
 .Dq charlize :
 .Bd -literal -offset indent
 puppet-masterless apply confdir config \\
@@ -161,48 +188,50 @@ puppet-masterless apply confdir config \\
   to 10.0.8.1 as charlize
 .Ed
 .Pp
-.No Bundle the
+Bundle the
 .Pa test
-.No project as a shell script, including a non-standard Hiera configuration
-.No file location and data directory:
+project as a shell script, including a non-standard Hiera configuration
+file location and data directory:
 .Bd -literal -offset indent
 puppet-masterless package confdir test \\
   with file hiera and hiera_config hiera/test.yaml
 .Ed
+.Pp
 .Sh CAVEATS
-.No For this program to be useful, Puppet must be installed on the remote host.
+For this program to be useful, Puppet must be installed on the remote
+host.
 .Pp
-.No All file paths must be relative to the current working directory. An error
-.No is signaled whenever an absolute path is specified.
+All file paths must be relative to the current working directory. An
+error is signaled whenever an absolute path is specified.
 .Pp
-.No This program is only intended to work with Puppet 4.10 and 5.5. \&It
-.No may work with other versions of Puppet, or it may not.
+This program is only intended to work with Puppet 4.10 and 5.5. It may
+work with other versions of Puppet, or it may not.
 .Pp
-.No The SSH functionality of this program is intentionally simplistic.
-.No If you need more complex behaviour when connecting to remote machines,
-.No use the
+The SSH functionality of this program is intentionally simplistic. If
+you need more complex behaviour when connecting to remote machines, use
+the
 .Cm package
-.No command in combination with a tool like
+command in combination with a tool like
 .Xr ansible 1 ,
 .Xr cap 1 or
 .Xr fab 1 .
 .Pp
-.No Very little information is displayed when an error occurs.
+Very little information is displayed when an error occurs.
 .Sh SECURITY CONSIDERATIONS
-.No The
+The
 .Cm apply
-.No command uses
+command uses
 .Xr sudo 1
-.No to assume a given user's identity on the remote host, with all of the
-.No security issues that implies.
+to assume a given user's identity on the remote host, with all of the
+security issues that implies.
 .Pp
-.No When applying manifests to a remote machine, any secrets included in the
-.No project will be present on the filesystem for as long as it takes to run
+When applying manifests to a remote machine, any secrets included in the
+project will be present on the filesystem for as long as it takes to run
 .Xr puppet-apply 8 .
 .Sh IMPLEMENTATION NOTES
 .Nm
-.No is a single Ruby script with no Gem dependencies. \&It should be
-.No possible to copy and run it on any machine with Ruby 1.9 or newer.
+is a single Ruby script with no Gem dependencies. It should be possible
+to copy and run on any machine with Ruby 1.9 or newer.
 .Sh SEE ALSO
 .Xr puppet 8 ,
 .Xr puppet-apply 8 ,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: puppet-masterless
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.2.3
 platform: ruby
 authors:
 - Evan Hanson
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-10-14 00:00:00.000000000 Z
+date: 2019-10-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -24,6 +24,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '12.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
 description: Packages and applies a Puppet project to a remote host.
 email: evanh@catalyst.net.nz
 executables: