Skip to main content

Specialized zc.buildout plugin to add sftp support.

Project description

The zc.buildoutsftp package provides a zc.buildout extension that provides support for SFTP. To use it, simply provide the option:

extension = zc.buildoutsftp

in your buildout section. Then you can use sftp URLs for fine-links or index URLs. (Note that zc.buildout >=1.0.0b5 is needed for this to work properly.)

An SFTP URL is similar to an FTP URL and is of the form:

sftp://user:password@hostname:port/path

where the user name, password, and port are optional. Here are some examples:

The following URL accesses the path /distribution on download.zope.org:

sftp://download.zope.org/distribution

The following URL accesses the path /distribution on download.zope.org using the user id jim:

sftp://jim@download.zope.org/distribution

The following URL accesses the path /distribution on download.zope.org using the user id jim and password 123:

sftp://jim:123@download.zope.org/distribution

The following url accesses the path /distribution on download.zope.org using an ssh server running on port 1022:

sftp://download.zope.org:1022/distribution

The buildout extension actually installs a urllib2 handler for the “sftp” protocol. This handler is actually setuptools specific because it generates HTML directory listings, needed by setuptools and makes no effort to make directory listings useful for anything else. It is possible that, in the future, setuptools will provide it’s own extension mechanism for handling alternate protocols, in which case, we might bypass the urllib2 extension mechanism.

SSH Compatibility

The extension works with Open SSH on unix-based systems and PuTTY on Windows. Unless a password is given in the URL, private keys are ontained from ssh agent (pagent on Windows).

Status and Change History

This package is experimental. It seems to work based on manual testing. I’m still trying to figure out how to write automated tests for this.

0.2

Added missing entry point.

Adjusted content-type information to work with setuptools.

0.1

Initial release

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

zc.buildoutsftp-0.2-py2.4.egg (11.6 kB view hashes)

Uploaded Source

zc.buildoutsftp-0.2-py2.3.egg (24.6 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page