GitHub - ansible/pylibssh: Python bindings specific to Ansible use case for libssh https://www.libssh.org/ (original) (raw)

pylibssh: Python bindings to client functionality of libssh specific to Ansible use case

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.9+

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.