Changelog¶
Versions follow Semantic Versioning (<major>.<minor>.<patch>
).
Backward incompatible (breaking) changes will only be introduced in major
versions with advance notice in the Deprecations section of releases.
v1.1.1rc1.dev48+g57e2802 [UNRELEASED DRAFT] (2024-02-07)¶
Bug fixes¶
ansible-pylibssh no longer crashes when received EOF or when channel is not explicitly closed – by @pbrezina.
Previously, ansible-pylibssh crashed if
channel.recv
was called andlibssh
returnedSSH_EOF
error. It also crashed on some special occasions where channel was not explicitly closed and the session object was garbage-collected first.Related issues and pull requests on GitHub: #576.
Features¶
Started exposing the
SSH_OPTIONS_PUBLICKEY_ACCEPTED_TYPES
andSSH_OPTIONS_HOSTKEYS
options publicly – by @Qalthos.Related issues and pull requests on GitHub: #527.
The
request_exec()
method was added to theChannel
class. It exposes an interface for calling the respective low-level C-API of the underlyinglibssh
library – by @pbrezina.Additionally, the following calls to
libssh
are now available in the same class:request_exec()
,send_eof()
,request_send_signal()
andis_eof
which is exposed as aproperty
.Related issues and pull requests on GitHub: #576.
Improved documentation¶
Fixed spelling of “Connect” in the
Session.connect()
docstring – by @donnerhacke.Related issues and pull requests on GitHub: #474.
Added a tip to the installation guide on how to set compiler flags when installing from source – @webknjaz.
Related issues and pull requests on GitHub: #499.
Fixed the example of invoking remote commands by using
Channel.exec_command()
in snippets – by @pbrezina.Its previously showcased version wasn’t functional.
Related issues and pull requests on GitHub: #576.
Packaging updates and notes for downstreams¶
From now on, the published distribution package artifacts for the new releases are signed via Sigstore – by @webknjaz.
This is happening as a part of the GitHub Actions CI/CD workflow automation and the signatures are uploaded to the corresponding GitHub Release pages.
Related commits on GitHub: 986988a.
The platform-specific macOS wheels are now built using the Python interpreter from https://python.org. They are tagged with
macosx_10_9
– by @webknjaz.Related issues and pull requests on GitHub: #333.
The
toml
build time dependency has been replaced withtomli
– by @webknjaz.The
tomli
distribution is only pulled in under Python versions below 3.11. On 3.11 and higher, the standard library moduletomllib
is now used instead.Related issues and pull requests on GitHub: #501.
Started using the built-in
setuptools-scm
Git archive support under Python 3.7 and higher – @webknjaz.Related issues and pull requests on GitHub: #502.
Added support for Python 3.12 – by @Qalthos.
It is now both tested in the CI and is advertised through the Trove classifiers.
Related issues and pull requests on GitHub: #532.
The
Cython
build time dependency now has the minimum version of 3.0 under Python 3.12 and higher – by @webknjaz.The previous versions of
Cython
are still able to build the project under older Python versions.Related issues and pull requests on GitHub: #540.
PEP 660 is now enabled – @webknjaz.
Previously, due to restrictive PEP 517 hook reimports, our in-tree build backend was losing non-PEP 517 hooks implemented in newer versions of
setuptools
but not the earlier ones. This is now addressed by reexporting everything thatsetuptools
exposes with a wildcard.Related issues and pull requests on GitHub: #541.
Contributor-facing changes¶
The Changelog page for the tagged release builds on Read The Docs does not attempt showing the draft section anymore – by @webknjaz.
Related commits on GitHub: 852d259.
Adjusted the publishing workflow automation to pre-configure Git before attempting to create a tag when building a source distribution – by @webknjaz.
Related commits on GitHub: f07296f.
The CI configuration for building the macOS platform-specific wheels switched to using
cibuildwheel
– by @webknjaz.Related issues and pull requests on GitHub: #333.
The OS-level tox package was upgraded to v3.28.0 in the UBI9 CI runtime – by @Qalthos.
Fixed spelling of “Connect” in the
Session.connect()
docstring – by @donnerhacke.Related issues and pull requests on GitHub: #474.
The Packit CI access to the internet has been restored – by @Qalthos.
Related issues and pull requests on GitHub: #507.
Started building
manylinux_2_28
base images for testing and packaging in the CI/CD infrastructure – by @Qalthos.Related issues and pull requests on GitHub: #533.
Switched back to using Cython’s native plugin for measuring code coverage – by @webknjaz.
Related issues and pull requests on GitHub: #538.
Added separate changelog fragment types for contributor- and downstream-facing patches – by @webknjaz.
Their corresponding identifiers are
contrib
andpackaging
respectively. They are meant to be used for more accurate classification, where one would resort to usingmisc
otherwise.Related issues and pull requests on GitHub: #539.
PEP 660 is now enabled – @webknjaz.
This effectively means that the ecosystem-native editable install mode started working properly.
Related issues and pull requests on GitHub: #541.
The duplicated jobs matrices for building manylinux wheels now reside in a single GitHub Actions CI/CD reusable workflow definition.
Related issues and pull requests on GitHub: #559.
The duplicated jobs matrices of the text jobs now reside in a single GitHub Actions CI/CD reusable workflow definition.
Related issues and pull requests on GitHub: #560.
Fixed the location of release workflow in the Release Guide document – by @Qalthos.
Related issues and pull requests on GitHub: #565.
Released versions¶
v1.1.0 (2022-12-05)¶
Deprecations (removal in next major release)¶
Documentation¶
Added a Release Guide for making new releases – by @webknjaz (#413)
Miscellaneous¶
Started testing RPM packaging spec with Packit service – by @webknjaz and @TomasTomecek (#227, #246)
Removed the remains of Python 2 compatiblity code from the in-tree PEP 517 build backend – by @webknjaz (#377)
Fixed removing
expandvars
frompyproject.toml
in an RPM spec – by @webknjazBefore this patch, the
sed
invocation removed entirebuild-system.requires
entry from there, in rare cases but this won’t be happening anymore. (#378)Declared official support of CPython 3.11 – by @Qalthos (#396)
Started shipping sdists built with Cython v0.29.32 – by @webknjaz (#399)
Started building RPMs with Cython v0.29.32 – by @webknjaz (#402)
Added an SSH connection re-try helper to tests – by @webknjaz (#405)
v1.0.0 (2022-09-14)¶
Features¶
Added
password_prompt
argument toconnect()
to override the default prompt of “password:” when using keyboard-interactive authentication – by @Qalthos (#331)Added support for
:fd:
socket option – by @sabedevops (#343)
v0.4.0 (2022-04-26)¶
Bugfixes¶
Improved
channel.exec_command
to always use a newly createdssh_channel
to avoid segfaults on repeated calls – by @Qalthos (#280)Fixed password prompt match in
pylibsshext.session.Session.authenticate_interactive()
to strip whitespace, check that the prompt only ends withpassword:
, and added a little extra logging – by @dalrrard (#311)
v0.3.0 (2021-11-03)¶
Bugfixes¶
Features¶
Miscellaneous¶
Started building AARCH64 base images with Buildah+Podman in GitHub Actions CI/CD – @webknjaz (#181)
Restructured the in-tree PEP 517 build backend into multiple submodules moving the entry-point to
pep517_backend.hooks
that also facilitates extraction of user-definedconfig_settings
passed by the end-user (packager) via thebuild
CLI command – @webknjaz (#200)Updated manylinux build script to build libssh with GSSAPI enabled – @Qalthos (#203)
Added an initial RPM spec continuously tested in the CI – @webknjaz (#205)
Added additional details when SFTP write errors are raised – by @Qalthos (#216)
Made
auditwheel
only keep one platform tag in the produced wheel names – @webknjaz (#224)Improved manylinux build scripts to expect dual-aliased manylinux tags produced for versions 1/2010/2014 along with their PEP 600 counterparts after
auditwheel repair
– @webknjaz (#226)Enabled self-test checks in the RPM spec for Fedora – @webknjaz (#228)
Enabled self-test checks in the RPM spec for CentOS – @webknjaz (#235)
Enabled self-test checks in the RPM spec for RHEL – @webknjaz (#236)
Added
NAME = "VALUE"
to flake8-eradicate whitelist to work around test false positive introduced in flake8-eradicate 1.1.0 – by @Qalthos (#258)Stopped testing
pylibssh
binary wheels under Ubuntu 16.04 in GitHub Actions CI/CD because it is EOL now – @webknjaz (#260)Fixed failing fast on problems with
rpmbuild
in GitHub Actions CI/CD under Fedora – @webknjaz (#261)Declare
python3-pip
a build dependency under Fedora fixing the RPM creation job in GitHub Actions CI/CD under Fedora – @webknjaz (#262)Replaced git protocols in pre-commit config with https now that GitHub has turned off git protocol access – @Qalthos (#266)
v0.1.0 (2020-08-12)¶
Bugfixes¶
Enhanced sftp error handling code to match with libssh error messages – by @ganeshrn (#27)
Fixed session timeout issue, the data type of timeout is expected by
ssh_options_set
is of typelong int
– by @ganeshrn (#46)Fixed sftp file get issue. On py2 The file
write()
method returnsNone
on py2 if bytes are written to file successfully, whereas on py3 it returns total number of bytes written to file. Added a fix to check for the number of bytes written only in the case whenwrite()
does not returnNone
– by @ganeshrn (#58)Fixed double close issue, added logic to free the channel allocated memory within __dealloc__() – by @ganeshrn (#113)
Features¶
Added cython extension for libssh client API’s initial commit – by @ganeshrn (#1)
Added proxycommand support for session and update session exeception to
LibsshSessionException
– by @ganeshrn (#10)Added support for host key checking with authentication – by @ganeshrn (#15)
Changed pylibssh dir to pylibsshext to avoid ns collision – by @ganeshrn (#25)
Added sftp get functionality to fetch file from remote host – by @amolkahat (#26)
Added support to receive bulk response for remote shell – by @ganeshrn (#40)
Added the support for keyboard-authentication method – by @Qalthos (#105)
Backward incompatible changes¶
Documentation¶
Miscellaneous¶
Updated requirements file to replace
requirements.txt
withrequirements-build.in
– by @akasurde (#14)Made tox’s main env pick up the in-tree PEP 517 build backend – by @webknjaz (#72)
Refactored sphinx RST parsing in towncrier extension – by @ewjoachim (#119)
Hotfixed the directive in the in-tree sphinx extension to always trigger the changelog document rebuilds so that it’d pick up any changelog fragments from disk – by @webknjaz (#120)
Turned the Townrier fragments README doc title into subtitle – by @webknjaz
The effect is that it doesn’t show up in the side bar as an individual item anymore. (#125)
Integrated Markdown support into docs via the MyST parser – by @webknjaz (#126)
Switched the builder on Read the Docs to dirhtml so it now generates a dir-based URL layout for the website – by @webknjaz (#127)
Enabled sphinx.ext.autosectionlabel Sphinx extension to automatically generate reference targets for document sections that can be linked against using
:ref:
– by @webknjaz (#128)