npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

ssh2-sftp-client-mkdir-patch

v2.4.4

Published

ssh2 sftp client for node. With mkdir recursive patch

Downloads

82

Readme

SSH2 SFTP Client

a SFTP client for node.js, a wrapper for ssh2

Additional documentation on the methods and available options can be found in the ssh2 and ssh2-streams documentation.

Installation

npm install ssh2-sftp-client

Usage

let Client = require('ssh2-sftp-client');
let sftp = new Client();
sftp.connect({
    host: '127.0.0.1',
    port: '8080',
    username: 'username',
    password: '******'
}).then(() => {
    return sftp.list('/pathname');
}).then((data) => {
    console.log(data, 'the data info');
}).catch((err) => {
    console.log(err, 'catch error');
});

Breaking Changes

Due to some incompatibilities with stream handling which breaks this module when used with Node 10.x, some changes have been implemented that should enhance the interface, but which also break compatibility with previous versions.

Option Changes

  • The default encoding is null not utf8 as it was previously. This is consistent with the defaults for the underlying SSH2 module.
  • The usedCompressed option has been removed. None of the shh2-steams methods actually support this option. The 'compress' option can be set as part of the connection options. See ssh2 client event.
  • The separate explicit option arguments for encoding and useCompression for some methods have been replaced with a single 'options' argument, which is an object that can have the following properties (defaults shown). See the ssh2-streams documentation for an explination of the opt8ons.
    const defaults = {
    highWaterMark: 32 * 1024,
    debug: undefined,
    concurrency: 64,
    chunkSize: 32768,
    step: undefined,
    mode: 0o666,
    autoClose: true,
    encoding: null
  };

Method Changes

get(srcPath, dst, options)

Used to retrieve a file from a remote SFTP server.

  • srcPath: path to the file on the remote server
  • dst: Either a string, which will be used as the path to store the file on the local system or a writable stream, which will be used as the destination for a stream pipe. If undefined, the remote file will be read into a Buffer and the buffer returned.
  • options: Options for the get operation e.g. encoding.

Documentation

the connection to server config pls see ssh2 client event.

list of methods: all the methods will return a Promise;

List

Retrieves a directory listing.

sftp.list(remoteFilePath)

directory info:

type: // file type(-, d, l)
name: // file name
size: // file size
modifyTime: // file timestamp of modified time
accessTime: // file timestamp of access time
rights: {
    user:
    group:
    other:
},
owner: // user ID
group: // group ID

AuxList

Retrieves a directory list that matches a pattern. The default pattern is "*", to list all of the files inside a directory.

Pattern examples:
    *.txt -- matches any file name that ends with .txt
    test* -- matches any file name that begins with test
    *bar* -- matches any file name that has the sequence "bar" in any position
sftp.list(remoteFilePath, pattern)

directory info:

type: // file type(-, d, l)
name: // file name
size: // file size
modifyTime: // file timestamp of modified time
accessTime: // file timestamp of access time
rights: {
    user:
    group:
    other:
},
owner: // user ID
group: // group ID

Get

Get a ReadableStream from remotePath. The encoding is passed to Node Stream (https://nodejs.org/api/stream.html) and it controls how the content is encoded. For example, when downloading binary data, 'null' should be passed (check node stream documentation). Default to 'null'.

sftp.get(remoteFilePath, [options]);

FastGet

Downloads a file at remotePath to localPath using parallel reads for faster throughput. options properties you can find fastGet method here.

sftp.fastGet(remotePath, localPath, [options]);

Put

upload a file from localPath or Buffer, Stream data to remoteFilePath.The encoding is passed to Node Stream to control how the content is encoded. Default to 'utf8'. Be sure to include the file name in remoteFilePath!

sftp.put(localFilePath, remoteFilePath, [optons]);
sftp.put(Buffer, remoteFilePath, [options]);
sftp.put(Stream, remoteFilePath, [options]);

FastPut

Uploads a file from localPath to remotePath using parallel reads for faster throughput. options properties you can find fastPut method here.

sftp.fastPut(localPath, remotePath, [options]);

Mkdir

create a new directory.

// recursive default is false, if true, it will create directory recursive
sftp.mkdir(remoteFilePath, recursive);

Rmdir

remove the directory or file.

// recursive default is false, if true, it will remove directory recursive even if is not empty
sftp.rmdir(localPath, recursive);

Delete

delete file.

sftp.delete(remoteFilePath);

Rename

rename remoteSourcePath to remoteDestPath (removes remoteSourcePath).

sftp.rename(remoteSourcePath, remoteDestPath);

Chmod

modify rights to remoteDestPath file

sftp.chmod(remoteDestPath, mode);

Connect

connection config you will see here

End

close the sftp connection. when you need it, you can call it in then() or catch().

sftp.end();

Event

add client event handle. you can find more here

close

The socket was closed. hadError is set to true if this was due to error.

sftp.on('close', callbackFn)

end

The socket was disconnected.

sftp.on('end', callbackFn)

error

An error occurred. A 'level' property indicates 'client-socket' for socket-level errors and 'client-ssh' for SSH disconnection messages. In the case of 'client-ssh' messages, there may be a 'description' property that provides more detail.

sftp.on('error', callbackFn)

FAQ

Log

V2.4.3

- merge #108, #110
  - fix connect promise if connection ends

V2.4.2

- merge #105
  - fix windows path

V2.4.1

- merge pr #99, #100
  - bug fix

V2.4.0

Requires node.js v7.5.0 or above.

- merge pr #97, thanks for @theophilusx
    - Remove emmitter.maxListener warnings
    - Upgraded ssh2 dependency from 0.5.5 to 0.6.1
    - Enhanced error messages to provide more context and to be more consistent
    - re-factored test
    - Added new 'exists' method and re-factored mkdir/rmdir

V2.3.0

- add: `stat` method
- add `fastGet` and `fastPut` method.
- fix: `mkdir` file exists decision logic

V3.0.0 -- deprecate this version

- change: `sftp.get` will return chunk not stream anymore
- fix: get readable not emitting data events in node 10.0.0

V2.1.1

- add: event listener. [doc](https://github.com/jyu213/ssh2-sftp-client#Event)
- add: `get` or `put` method add extra options [pr#52](https://github.com/jyu213/ssh2-sftp-client/pull/52)

V2.0.1

- add: `chmod` method [pr#33](https://github.com/jyu213/ssh2-sftp-client/pull/33)
- update: upgrade ssh2 to V0.5.0 [pr#30](https://github.com/jyu213/ssh2-sftp-client/pull/30)
- fix: get method stream error reject unwork [#22](https://github.com/jyu213/ssh2-sftp-client/issues/22)
- fix: return Error object on promise rejection [pr#20](https://github.com/jyu213/ssh2-sftp-client/pull/20)

V1.1.0

- fix: add encoding control support for binary stream

V1.0.5:

- fix: multi image upload
- change: remove `this.client.sftp` to `connect` function