Welcome to ansible-pylibssh’s documentation!¶
Nightlies @ Dumb PyPI @ GitHub Pages¶
We publish nightlies on tags and pushes to devel. They are hosted on a GitHub Pages based index generated by dumb-pypi.
The web view is @ https://ansible.github.io/pylibssh/.
$ pip install \
--extra-index-url=https://ansible.github.io/pylibssh/simple/ \
--pre \
ansible-pylibssh
Requirements¶
You need Python 3.8+
pylibssh requires libssh to be installed in particular:
libssh version 0.9.0 and later.
To install libssh refer to its Downloads page.
Building the module¶
In the local env, assumes there’s a libssh shared library on the system, build toolchain is present and env vars are set properly:
$ git clone https://github.com/ansible/pylibssh.git
$ cd pylibssh
$ pip install tox
$ tox -e build-dists
manylinux
-compatible wheels:
$ git clone https://github.com/ansible/pylibssh.git
$ cd pylibssh
$ pip install tox
$ tox -e build-dists-manylinux1-x86_64 # with Docker
# or with Podman
$ DOCKER_EXECUTABLE=podman tox -e build-dists-manylinux1-x86_64
# to enable shell script debug mode use
$ tox -e build-dists-manylinux1-x86_64 -- -e DEBUG=1
Communication¶
Join the Ansible forum:
Get Help: get help or help others. Please add the appropriate tags if you start new discussions, for example the
pylibssh
tag.Posts tagged with ‘pylibssh’: subscribe to participate in project-related conversations.
News & Announcements: track project-wide announcements including social events and the Bullhorn newsletter.
Social Spaces: gather and interact with fellow enthusiasts.
For more information about getting in touch with us, see the Ansible communication guide.
License¶
This library is distributed under the terms of LGPL 2 or higher,
see file LICENSE.rst
in this repository.