All Versions
29
Latest Version
Avg Release Cycle
39 days
Latest Release
1266 days ago

Changelog History
Page 1

  • v2.3.2 Changes

    December 09, 2020

    ๐Ÿ›  Fixes

    • ๐Ÿ‘ Client output implementation Python 2 support.
  • v2.3.1 Changes

    December 06, 2020

    ๐Ÿ”„ Changes

    • SSHClient.read_output and read_stderr now take buffer to read from as argument instead of channel.
    • SSHClient.wait_finished now takes HostOutput argument instead of channel.

    ๐Ÿ›  Fixes

    • Output for multiple commands on one host run at the same time would be lost.
  • v2.3.0 Changes

    December 04, 2020

    ๐Ÿ”„ Changes

    • SSHClient now starts buffering output from remote host, both standard output and standard error, when a command is run.
    • SSHClient.read_output, SSHClient.read_stderr and iterating on stdout/stderr from HostOutput now read from the internal buffer rather than the SSH channel directly.
    • ParallelSSHClient.join no longer requires consume_output to be set in order to get exit codes without first reading output.
    • 0๏ธโƒฃ ParallelSSHClient.join with timeout no longer consumes output by default. It is now possible to use join with a timeout and capture output after join completes.
    • ParallelSSHClient.reset_output_generators is now a no-op and no longer required to be called after timeouts.
    • HostOutput.stdout and stderr are now dynamic properties.
    • ๐Ÿ‘€ Added HostOutput.read_timeout attribute. Can be used to see what read timeout was when run_command was called and to change timeout when next reading from HostOutput.stdout and stderr.
    • โž• Added HostOutput.encoding attribute for encoding used when run_command was called. Encoding can now be changed for when next reading output.
    • โฑ ParallelSSHClient.join with timeout no longer affects stdout or stderr read timeout set when run_command was called.
    • LibSSH clients under pssh.clients.ssh now allow output to be read as it becomes available without waiting for remote command to finish first.
    • Reading from output behaviour is now consistent across all client types - parallel and single clients under both pssh.clients.native and pssh.clients.ssh.
    • 0๏ธโƒฃ ParallelSSHClient.join can now be called without arguments and defaults to last ran commands.
    • 0๏ธโƒฃ ParallelSSHClient.finished can now be called without arguments and defaults to last ran commands.

    This is now possible:

       output = client.run_command(<..>)
       client.join(output)
       assert output[0].exit_code is not None
    

    As is this:

       client.run_command(<..>, timeout=1)
       client.join(output, timeout=1)
       for line in output[0].stdout:
           print(line)
    

    โฑ Output can be read after and has separate timeout from join.

    ๐Ÿ“š See documentation for more examples on use of timeouts.

  • v2.2.0 Changes

    December 01, 2020

    ๐Ÿ”„ Changes

    • ๐Ÿ†• New single host tunneling, SSH proxy, implementation for increased performance.
    • Native SSHClient now accepts proxy_host, proxy_port and associated parameters - see API documentation
    • ๐Ÿ”ง Proxy configuration can now be provided via HostConfig.
    • โž• Added ParallelSSHClient.connect_auth function for connecting and authenticating to hosts in parallel.
  • v2.1.0 Changes

    October 25, 2020

    ๐Ÿ”„ Changes

    • โž• Added certificate authentication support for the pssh.clients.ssh clients.
  • v2.1.0.post1

    October 25, 2020
  • v2.0.0 Changes

    October 06, 2020

    ๐Ÿ”„ Changes

    โฌ†๏ธ See Upgrading to API 2.0 for examples of code that will need updating.

    • โœ‚ Removed paramiko clients and dependency.
    • ParallelSSHClient.run_command now always returns a list of HostOutput - return_list argument is a no-op and will be removed in future releases.
    • ParallelSSHClient.get_last_output now always returns a list of HostOutput.
    • SSHClient.run_command now returns HostOutput.
    • โœ‚ Removed deprecated since 1.0.0 HostOutput dictionary attributes.
    • โœ‚ Removed deprecated since 1.0.0 imports and modules.
    • Removed paramiko based load_private_key and read_openssh_config functions from pssh.utils.
    • โœ‚ Removed paramiko based pssh.tunnel.
    • โœ‚ Removed paramiko based pssh.agent.
    • โœ‚ Removed deprecated ParallelSSHClient.get_output function.
    • Removed deprecated ParallelSSHClient.get_exit_code and get_exit_codes functions.
    • โœ‚ Removed deprecated ParallelSSHClient host_config dictionary implementation - now list of HostConfig.
    • โœ‚ Removed HostOutput.cmd attribute.
    • โœ‚ Removed ParallelSSHClient.host_clients attribute.
    • โฑ Made ParallelSSHClient(timeout=<seconds>) a global timeout setting for all operations.
    • Removed run_command(greenlet_timeout=<..>) argument - now uses global timeout setting.
    • โฑ Renamed run_command timeout to read_timeout=<seconds>) for setting output read timeout individually - defaults to global timeout setting.
    • โœ‚ Removed pssh.native package and native code.
    • ๐Ÿ‘ ParallelSSHClient.scp_send now supports copy_args keyword argument for providing per-host file name arguments like rest of scp_* and copy_* functionality.
    • ๐Ÿ”„ Changed exception names to end in Error from Exception - backwards compatible.
    • UnknownHostException, AuthenticationException, ConnectionErrorException, SSHException no longer available as imports from pssh - use from pssh.exceptions.

    ๐Ÿ›  Fixes

    • โœ‚ Removed now unnecessary locking around SSHClient initialisation so it can be parallelised - #219.
    • ParallelSSHClient.join with encoding would not pass on encoding when reading from output buffers - #214.
    • โฑ Clients could raise Timeout early when timeout settings were used with many hosts.

    Packaging

    • ๐Ÿ“ฆ Package architecture has changed to none-any.
  • v2.0.0.rc1 Changes

    October 03, 2020

    ๐Ÿ”„ Changes

    โšก๏ธ See Upgrading to API 2.0 <upgrade-link>_ for examples of code that will need updating.

    • โœ‚ Removed paramiko clients and dependency.
    • ParallelSSHClient.run_command now always returns a list of HostOutput - return_list argument is a no-op and may be removed.
    • ParallelSSHClient.get_last_output now always returns a list of HostOutput.
    • SSHClient.run_command now returns HostOutput.
    • โœ‚ Removed deprecated since 1.0.0 HostOutput dictionary attributes.
    • โœ‚ Removed deprecated since 1.0.0 imports and modules.
    • Removed paramiko based load_private_key and read_openssh_config functions from pssh.utils.
    • โœ‚ Removed paramiko based pssh.tunnel.
    • โœ‚ Removed paramiko based pssh.agent.
    • โœ‚ Removed deprecated ParallelSSHClient.get_output function.
    • Removed deprecated ParallelSSHClient.get_exit_code and get_exit_codes functions.
    • โœ‚ Removed deprecated ParallelSSHClient host_config dictionary implementation - now list of HostConfig.
    • โœ‚ Removed HostOutput.cmd attribute.
    • โœ‚ Removed ParallelSSHClient.host_clients attribute.
    • โฑ Made ParallelSSHClient(timeout=<seconds>) a global timeout setting for all operations.
    • Removed run_command(greenlet_timeout=<..>) argument - now uses global timeout setting.
    • โฑ Renamed run_command timeout to read_timeout=<seconds>) for setting output read timeout individually - defaults to global timeout setting.
    • โœ‚ Removed pssh.native package and native code.
    • ๐Ÿ“ฆ No native code means package architecture has changed to none-any.

    ๐Ÿ›  Fixes

    • โœ‚ Removed now unnecessary locking around SSHClient initialisation so it can be parallelised - #219.
    • ParallelSSHClient.join with encoding would not pass on encoding when reading from output buffers - #214.
    • โฑ Clients could raise Timeout early when timeout settings were used with many hosts.
  • v2.0.0.b3

    September 18, 2020
  • v2.0.0.b2

    September 18, 2020