Metadata-Version: 1.0
Name: zc.buildoutsftp
Version: 0.2.1
Summary: Specialized zc.buildout plugin to add sftp support.
Home-page: http://www.python.org/pypi/zc.buildoutsftp
Author: Jim Fulton
Author-email: jim@zope.com
License: ZPL 2.1
Description: ===========================================
        Secure FTP (SFTP) Extension for zc.buildout
        ===========================================
        
        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.1
        -----
        
        Fixed a bug in handling multiple user keys.
        
        0.2
        ---
        
        Added missing entry point.
        
        Adjusted content-type information to work with setuptools.
        
        0.1
        ---
        
        Initial release
        
Keywords: buildout
Platform: UNKNOWN
Classifier: Framework :: Buildout
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Zope Public License
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Software Development :: Libraries :: Python Modules
