python3 version produced by 2to3 - not fully tested

todo: ansible style inventory support

feature request for variable names in RHS of .defines

update todos

new features list

WHATSNEW For 'tsshbatch' 1.317 (Sat Oct 15 16:14:26 CDT 2016)

version bump to 1.317 - document .local variable definition and behavior

implement .local directive

WHATSNEW For 'tsshbatch' 1.316 (Fri Oct 14 14:44:55 CDT 2016)

version bump to 1.316 - fix how git id gets embedded by makefile

WHATSNEW For 'tsshbatch' 1.315 (Fri Oct 14 14:31:30 CDT 2016)

version bump to 1.315 - fix minor help formatting issue

WHATSNEW For 'tsshbatch' 1.314 (Fri Oct 14 12:09:22 CDT 2016)

slight tuning of notification format

fix embedded version numbers

version bump to 3.14 - cleanup notification formatting

WHATSNEW For 'tsshbatch' 1.313 (Wed Oct 12 16:37:36 CDT 2016)

cleanup documentation

version bump to 1.313 - suppress .notify output in silent mode

cleanup documentation

post release cleanup

WHATSNEW For 'tsshbatch' 1.312 (Tue Oct 11 17:39:20 CDT 2016)

update version information

protect path search -for -LFV from nonexistent paths, version bump to 1.312

implement .notify directive

enable .include targets to use variable references

add -r option to suppress reporting of start/stop statistics

new TODO for execution time message print

further cleanup notes

note to self in TODO

improve online help for -F and -V

implemented -F and -V matching options

factor out the path walker function from the -L option for reuse

add -W option, fix regression causing hosts to be procesed twice

fix file transfers to honor -s flag

add -L option to display all host- and command files on their respective search paths

version bump to 1.311

WHATSNEW For 'tsshbatch' 1.310 (Wed Sep 28 18:57:08 CDT 2016)

push after release to ensure that the WHATSNEW.txt file gets preserved

fix Id string in master rst file when releasing

finish -i documentation, reorg release tarball to separate docs, fix copyright date everywhere

implement -i option to allow multiple hostlist files to be used at once

bump version in actual code

allow multiple instances of -H on the command line

version bump to 1.310

fix the version target in makefile

replace remaining cvs operations with git equivalents

further conversion to git version management

further work moving away from CVSID

changed reference from CVSID to GITID

*** empty log message ***

*** empty log message ***

*** empty log message ***

*** empty log message ***

*** empty log message ***

WHATSNEW For 'tsshbatch' 1.228 (Mon Jan 18 18:11:54 CST 2016)

Summary: Cosmetics

WHATSNEW For 'tsshbatch' 1.228 (Mon Jan 18 18:09:40 CST 2016)

Summary: Cosmetics

*** empty log message ***

*** empty log message ***

WHATSNEW For 'tsshbatch' 1.228 (Mon Jan 18 18:04:34 CST 2016)

Summary: Cosmetics

WHATSNEW For 'tsshbatch' 1.228 (Mon Jan 18 17:55:10 CST 2016)

Summary: Cosmetics

WHATSNEW For 'tsshbatch' 1.228 (Mon Jan 18 17:44:06 CST 2016)

Summary: Cosmetics

Summary: Added description of config file processing and updated explanation of elapased time banner output.

Summary: Added default information to help screen where relevant. Added ability to override default configuration file location on command line with -C option.

Summary: Added logic to make to handle the absence of HostName and/or IdentityFile in a configuration entry.

Summary: First working version honoring configuration files.

Summary: Completed parsing phase of SSH configuration files.

*** empty log message ***

Summary: Fixed start time reporting to work for both normal error cases. ...

Now does not include prompt response time.

Summary: Basic scaffolding for SSH configuration file processing in place.

Summary: Cosmetics

Summary: Factored out ssh connection logic for use by both host command and file transfer processing.

Summary: Don't start timing until after user interactive input complete.

*** empty log message ***

Summary: Added elapsed time to banner output.

WHATSNEW For 'tsshbatch' 1.218 (Sun Jan 10 14:43:56 CST 2016)

Summary: Cosmetics.

Summary: More on -b.

Summary: Documented -B and -b options.

*** empty log message ***

Summary: Formatting.

Summary: Added -B switch for start/stop banners.

Summary: Implemented -b option to continue after a bad sudo attempt.

Summary: Changed auth logic to always computer a username even for keyexchange-based auth.

Summary: Update copyright date.

*** empty log message ***

Summary: Fixed bug that failed to provide username with key auth.

*** empty log message ***

*** empty log message ***

*** empty log message ***

*** empty log message ***

*** empty log message ***

WHATSNEW For 'tsshbatch' 1.212 (Wed Dec 10 09:42:24 CST 2014)

Summary: Moved note about filenames with spaces into the File Transfer section of the document.

WHATSNEW For 'tsshbatch' 1.212 (Wed Dec 10 09:32:34 CST 2014)

Minor edits. Noted that file transfer cannot handle filenames with spaces.

Removed quote stripping from cmdfile transfer logic.

Minor edits.

Implemented the .getfile and .putfile directives.

WHATSNEW For 'tsshbatch' 1.210 (Tue Dec 9 12:21:43 CST 2014)

Fixed bug that prevented continuation after failed file transfer even ...

when -a was specified.

*** empty log message ***

Documented other, similar products.

Made file transfer data structures ordered dictionaries so that transfer order matches specification order.

Documented __LOGINNAME__. ...

Documented file transfer specifications in cmdfiles.

Implemented file transfer specifications within cmdfiles.

Added __LOGINNAME__ builtin.

*** empty log message ***

*** empty log message ***

Documented various noise levels and the new -s option.

*** empty log message ***

Ensured that silent mode does not suppress error reporting.

Implemented -s, "Silent" mode.

*** empty log message ***

*** empty log message ***

Minor edit.

Summary: Added document production information.

*** empty log message ***

*** empty log message ***

WHATSNEW For 'tsshbatch' 1.204 (Thu Dec 4 18:33:17 CST 2014)

Minor Edit.

WHATSNEW For 'tsshbatch' 1.204 (Thu Dec 4 17:51:58 CST 2014)

Changed note on file permissions.

*** empty log message ***

File transfers now preserve mode.

*** empty log message ***

*** empty log message ***

Fixed bug that prevented variable substitution in hostnames.

Minor edit.

Documented use of -q for multiline commands.

Minor edit.

Added -q, quiet mode support.

*** empty log message ***

Documented -q.

Minor cleanup.

Removed newline stripping from execution variable results.

Note on multi-line results from execution variables.

Wrote section on execution variables.

Added code to strip newlines out of execution variable results.

*** empty log message ***

Wrote Builtin Variable section.

Extensive reorganization and formatting updates. ...

Wrote intro sections on variables.

Updated html and latex generation with latest options.

Minor updates and formatting changes.

*** empty log message ***

*** empty log message ***

*** empty log message ***

*** empty log message ***

Summary: Implemented variable dereferencing in test mode.

*** empty log message ***

Summary: Implemented execution variables.

*** empty log message ***

*** empty log message ***

*** empty log message ***

*** empty log message ***

Added __DATETIME__

*** empty log message ***

Added __DATE__ and __TIME__.

*** empty log message ***

Structured code to have builtin variables handled like any other user-defined variable.

*** empty log message ***

*** empty log message ***

Fixed typos.

*** empty log message ***

*** empty log message ***

Documented .define overrides for HOSTNAME, HOSTSHORT builtins.

*** empty log message ***

Fixed HOSTNAME substitutions in file transfer specifications. ...

Added .define substitution in file transfer specifications.

*** empty log message ***

Changed delimiters on HOSTNAME from <> to __.

*** empty log message ***

Changed HOSTNAME and HOSTSHORT delimiters from '<>' to '__'.

Documented -l, the use of the '-' separator in -G operations, and further notes on sudo operations.

*** empty log message ***

Added smarter detection for sudo invocations via new KeyInString() function.

*** empty log message ***

Summary: Fixed bug that missed sudo invocation if it wasn't the first statement on a compound line.

WHATSNEW For 'tsshbatch' 1.189 (Tue Nov 25 18:03:09 CST 2014)

*** empty log message ***

*** empty log message ***

Summary: Added support for logging via -l argument.

*** empty log message ***

*** empty log message ***

Summary: Suppress use of ssh-agent and search for keys when password authentication is in effect.

Fixed help screen syntax bug.

Cleaned up help display.

*** empty log message ***

Summary: Changed HOSTSEP from ':' to '-' for better compatibility with file naming standards across Linux and NTFS.

*** empty log message ***

*** empty log message ***

Fixed noisy operation in experimental code.

Added experimental version (x.py) to work on advanced sudoers mode.

Added -E option to redirect stderr -> stdout and documented it.

*** empty log message ***

*** empty log message ***

*** empty log message ***

Added -a option to allow continuation after file transfer error.

Minor typo.

*** empty log message ***

Documented -T and -a.

*** empty log message ***

Went back to allowing file transfers to continue after an error on one host. ...

Made error messages more consistent and clear.

Added hostname to file transfer error report.

Went back to aborting program if any file transfer failed. ...

It makes no sense to keep going on the chance that subsequent commands expect the file there.

*** empty log message ***

Reintroduced .close() commands in file transfer except stanza, protected by a try this time. ...

Changed semantics so a failed connection attempt on one host does not abort program but goes on to next host.

*** empty log message ***

Cleaned up error reporting. ...

Removed explicit .close() calls in file transfer except stanza.
Added -T option to set connecton timeout period.

*** empty log message ***

WHATSNEW For 'tsshbatch' 1.177 (Thu Mar 27 19:09:10 CDT 2014)

*** empty log message ***

WHATSNEW For 'tsshbatch' 1.177 (Thu Mar 27 18:41:16 CDT 2014)

Added -K to synopsis.

WHATSNEW For 'tsshbatch' 1.177 (Thu Mar 27 18:38:24 CDT 2014)

WHATSNEW For 'tsshbatch' 1.177 (Thu Mar 27 18:37:58 CDT 2014)

WHATSNEW For 'tsshbatch' 1.177 (Thu Mar 27 18:37:48 CDT 2014)

Minor cleanup.

WHATSNEW For 'tsshbatch' 1.177 (Thu Mar 27 18:36:33 CDT 2014)

*** empty log message ***

Updated copyright.

Documented -K, HOSTNAME, and HOSTSHORT. Updated copyright.

Added -K option to force prompting for password.

Updated copyright.

Implemented HOSTNAME and HOSTSHORT as separate hostname substitution mechanisms.

Implemented <HOSTNAME> substitution for commands and file transfers.

Update

Documented the fact that test mode is now the default.

*** empty log message ***

Updated copyright.

Made testmode the default.

*** empty log message ***

*** empty log message ***

WHATSNEW For 'tsshbatch' 1.171 (Fri Nov 1 12:08:38 CDT 2013)

Added warning about permissions of transferred files.

WHATSNEW For 'tsshbatch' 1.171 (Tue Oct 29 12:35:15 CDT 2013)

General edits and cleanup.

WHATSNEW For 'tsshbatch' 1.171 (Tue Oct 29 10:28:22 CDT 2013)

Added note about -N canceling -k.

Fixed -N so that it cancels any keychange auth option.

WHATSNEW For 'tsshbatch' 1.170 (Tue Oct 29 10:06:14 CDT 2013)

More variable substitution bug fixes.

Factored variable substitution into VarSub() and fixed bug that failed to do ...

substitution on host names passed with -H.

WHATSNEW For 'tsshbatch' 1.168 (Tue Oct 29 09:16:13 CDT 2013)

Documented variable substitution on the command line hosts and command arguments.

Added variable substitution to the command passed on the command line.

WHATSNEW For 'tsshbatch' 1.167 (Mon Oct 28 21:59:13 CDT 2013)

Minor edit in the Environment section.

WHATSNEW For 'tsshbatch' 1.167 (Mon Oct 28 21:55:50 CDT 2013)

Formattting fix.

WHATSNEW For 'tsshbatch' 1.167 (Mon Oct 28 21:53:09 CDT 2013)

Fixed typos and general editing.

WHATSNEW For 'tsshbatch' 1.167 (Mon Oct 28 20:17:11 CDT 2013)

Minor formatting cleanup.

Fixed bug that was causing *all* "=" signs to be removed from the RHS of a .define statement. Now it properly only uses the leftmost as a delimiter between LHS and RHS and leaves the rest, if any, alone.

Documented -t, -x. variable definitions, search paths, and did general doc improvement.

*** empty log message ***

Renamed tsearchpath() to SearchPath() and had it return first matching ...

filepath as a string, not a list.  Adjusted ReadFile() accordingly.
Added explicit check to make sure a FQ filename passed on the command line
was not actually the name of a directory.

Minor cosmetic change.

First full implementation of path searching for command files and host list files. ...

Implemented -x option to override -t.

*** empty log message ***

*** empty log message ***

Sorted symbol table test output.

Slight change in test mode report output order.

Implemented -t option and test mode.

*** empty log message ***

*** empty log message ***

*** empty log message ***

First implementation of variable definitions.

*** empty log message ***

WHATSNEW For 'tsshbatch' 1.159 (Thu Oct 24 14:09:02 CDT 2013)

Cleaned up formatting.

WHATSNEW For 'tsshbatch' 1.159 (Thu Oct 24 14:03:03 CDT 2013)

Fixed typo.

Documented -y option.

Documented -y command.

Added -y option to produce noisy reporting.

*** empty log message ***

WHATSNEW For 'tsshbatch' 1.158 (Wed Oct 23 22:19:44 CDT 2013)

Documented the .include directive. ...

General typo fixes and cleanup.

Minor cosmetic changes to usage output.

Added support for the .include directive when reading files.

Factored reading of external files into a single ReadFile() routine so ...

that line conditioning, comment handling, and metacommand processing
can be done in one place.

*** empty log message ***

Typos and edits.

Replace stdin redirection with -f option and documented it.

Minor typo fix.

Updated auth precedence section.

Cleaned up user name prompting and precedence.

Changed -s option to -S for consistency with -N.

Document sudo and password prompting behavior.

Fixed sudo failure code to abort on error instead of continuing.

*** empty log message ***

Added -s option and corrected sudo password prompting algorithm.

*** empty log message ***

Minor change to sudo pw hint.

Cleaned up logic to permit separate login and sudo passwords, with defaulting ...

to login password when present.

Cleaned up sudo handling and reporting.

Cleaned up reporting output.

Added description of command processing and stdin redirection. ...

Added note about sudo password prompting with -k option.

Modified to only trigger sudo behavior (passwords, etc.) when the ...

command string begins with "sudo " instead of just "sudo".  This
inhibits sudo behavior for commands like 'sudoedit' and 'sudoreplay' that,
if used at all, should themselves be run under 'sudo' privilege promotion.

Added ability read commands from stdin.

Documented -G and -P

Changed the host separator on GETs from "-" to ":".

*** empty log message ***

Bi-directional file transfer implemented.

Notes on documenation to be written.

More scaffolding for file transfers.

Updated documentation to reflect new comment handling capability.

Changed references of RCSID to CVSID.

Added scaffolding for file transfer. ...

Added support for freeform comments in host lists.

Default behavior is now to use $USER as the login name and prompt only for password. ...

Added -N option for force username prompting, with $USER as the default value.
Updated documentation and copyright information.

Added TODOs.

Update copyright.

Added TODO list to project.

WHATSNEW For 'tsshbatch' 1.137 (Fri Feb 22 15:32:00 CST 2013)

Further bug cleanup to make error messages more relevant.

Changed failure reporting so that all relevant information appears on a single line.

WHATSNEW For 'tsshbatch' 1.135 (Fri Feb 22 12:25:48 CST 2013)

Improved error message detail when problem is something other than auth ...

credentials.

WHATSNEW For 'tsshbatch' 1.134 (Fri Jun 8 22:08:19 CDT 2012)

WHATSNEW For 'tsshbatch' 1.134 (Fri Jun 8 22:07:29 CDT 2012)

Removed 'setup.py' from release build. It is not needed.

Migrated to CVS and updated makefile to latest template.

WHATSNEW For 'tsshbatch' 1.134 comment (Fri Jun 8 21:15:05 CDT 2012)

WHATSNEW For 'tsshbatch' 1.134 comment (Fri Jun 8 21:13:27 CDT 2012)

WHATSNEW For 'tsshbatch' 1.134 (Tue Jan 17 09:00:17 CST 2012)

Cleaned up some typos and added some comments in the OTHER section.

WHATSNEW For 'tsshbatch' 1.134 (Thu Jan 5 13:14:26 CST 2012)

Got rid of compilation.

Added TOC.

Formatting and typo cleanup.

Added note about hangs when sudo doesn't properly report bad passwords.

WHATSNEW For 'tsshbatch' 1.134 (Thu Jan 5 12:42:06 CST 2012)

Cleaned up help screen.

Added comment at top about licensing details.

Fixed typo in sudo noise handling.

Fixed bug where sudo parameters were being substituted for every occurence of 'sudo' in the command rather than just the leftmost. ...

Fixed bug that caused a syntax error when there was no sudo noise.

Minor cosmetic cleanup.

Added logic to properly handle bad sudo passwords and bogus sudo command lines.

WHATSNEW For 'tsshbatch' 1.128 (Fri Dec 30 17:50:44 CST 2011)

Fixed acknowledgment.

Added acknowledgement for Noller article.

Cleaned up help message for -e.

Changed reporting to explicity note stdout and stderr outputs.

Changed auth and connection-related error report to got to stderr instead of stdout.

Separated stdout/stderr output and implemented the -e option to suppress stderr reporting.

Changed logic to prompt for password during sudo rather than error out.

Minor formatting cleanup.

Added section on sudo use.

Added section on passing authentication credentials on the command line.

Added section on ways to pass host lists.

Inital population of manual.

WHATSNEW For 'tsshbatch' 1.121 (Wed Dec 28 18:14:50 CST 2011)

Got rid of fee for use.

Minor comment cleanup.

Added -h and -v options. ...

Reorganized help display and added version info and copyright to it.
Cleaned up check for minumum command line argument length.

Top comment header added and general tidying up of the code.

Fixed so that sudo operations do not require a pty but work from stdin.

First implementation of sudo support.

Implemented key exchange-based authentication via -k option.

Update Usage output.

Added -h option to pass host lists on the commnand line.

Fixed RCSID string.

Implemented support for passing name and password on command line. ...

Implemented framework for requesting key exchanged-based auth.
Updated Usage reporting output.

Initial Version

Fixed usage output.

Restructured exception handling in HostCommand() to deal with all transport/connection problems and not blow out of the program.

First freestanding version. ...

Suppressed DeprecationWarnings until paramiko catches up with Python.
Added stderr results to output report on successful runs.

Cleaned up output reporting for consistency and clarity.

Cleaned up reporting of multiple exception types. ...

Fixed problem with reporting successful results.

Made error reporting more descriptive.

Further report formatting cleanup.

Added logic to properly handle multi-word commands. ...

Fixed formatting problem with multi-line results.

Added code to provide formatted results reporting.

First complete version.

Initial version - NOT TESTED.