Hi all.
I've pushed a new plugin I've been working on for a while that gives you
@edit-like functionality for remote files over SFTP (FTP over SSH).
Here's the docstring:
'''@edit-like functionality for remote files over SFTP
By Jacob M. Peck
@sftp nodes
===========
This plugin requires the python module 'paramiko' to be installed.
This plugin operates on @sftp nodes, which are defined as nodes
with headlines that start with `@sftp` and follow one of the following
patterns::
@sftp username@host!port:path/to/remote.file
@sftp username@host:path/to/remote.file
@sftp host!port:path/to/remote.file
@sftp host:path/to/remote.file
This headline tells the sftp plugin almost all it needs to know to
connect to the remote server
and edit the file. If the username is omitted, it defaults to your
LeoID. If the port is omitted,
it defaults to 22, the standard sftp port.
General usage
=============
Generally, you'll create an empty node with a proper @sftp headline, and
then run the minibuffer command `sftp-pull`. When you're satisfied with
your edits, you can then run the command `sftp-push` to push your
changes back to the server.
On passwords and host keys
==========================
This plugin checks host-keys before communicating with the remote
server. The first time you connect
to a remote server per Leo session, you'll need to agree to let the
host-key into your trusted hosts
list. This is a Leo-centric list, and does not use your operating
system's known_hosts file, in order
to keep it platform independent.
Similarly, this plugin does not (yet) use SSH key-based authentication.
It will instead prompt you for
your password the first time you connect to a server per Leo session.
Future attempts will be cached,
in order to cut down on typing. You can use the `@bool
sftp-cache-credentials` setting to prevent password caching.
Configuration Settings
======================
This plugin is configured with the following @settings:
@bool sftp-cache-credentials = True
-----------------------------------
Set this to False to make sftp.py prompt you for a password on each
connection.
Commands
========
This plugin provides the following commands:
sftp-push
---------
Overwrites the file on the remote server with the contents of the body
of the currently selected @sftp node.
sftp-push-all
-------------
Runs an `sftp-push` on all @sftp nodes in the current outline.
sftp-pull
---------
Replaces the body of the currently selected @sftp node with the contents
of the file on the remote server.
sftp-pull-all
-------------
Runs an `sftp-pull` on all @sftp nodes in the current outline.
sftp-forget-credentials
-----------------------
Makes sftp.py forget your entered passwords. Only available if `@bool
sftp-cache-credentials = True`.
'''
-->Jake
--
You received this message because you are subscribed to the Google Groups
"leo-editor" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/leo-editor.
For more options, visit https://groups.google.com/groups/opt_out.
