Security News
The Unpaid Backbone of Open Source: Solo Maintainers Face Increasing Security Demands
Solo open source maintainers face burnout and security challenges, with 60% unpaid and 60% considering quitting.
sftp-client-promise
Advanced tools
a SFTP client for node.js, a wrapper for ssh2
npm install sftp-client-promise
let Client = require('sftp-client-promise');
let conn = new Client();
conn.connect({
host: '127.0.0.1',
port: '8080',
username: 'username',
password: '******'
}).then(() => {
return conn.sftp('readdir', {path: '/pathname'});
}).then((data) => {
console.log(data, 'the data info');
}).catch((err) => {
console.log(err, 'catch error');
conn.end();
});
the connection to server config pls see ssh2 client event.
list of methods: all the methods will return a Promise;
read a directory
conn.sftp('readdir', {path: 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
return true if the path(file or directory) exists, false otherwise.
conn.sftp('exists', {path: remotePath})
download file from remote server
conn.sftp('createReadStream', {
path: remoteFilePath,
stream: localWriteStream,
option: option
})
for example:
conn.sftp('createReadStream', {
path: '/home/temp.gz',
stream: fs.createWriteStream('./local/temp.gz')
})
upload file from local, data(stream | buffer | string)
conn.sftp('createWriteStream', {
path: remoteFilePath,
data: stream | buffer | string,
option: option
})
for example:
conn.sftp('createWriteStream', {
path: '/home/temp.gz',
data: fs.createReadStream('./local/temp.gz')
//data: fs.readFileSync('./local/temp.gz')
//data: 'some local data'
})
download file from remote server
conn.sftp('fastGet', {remotePath: remotePath, localPath: localPath})
upload local file to remote serer
conn.sftp('fastPut', {localPath: localPath, remotePath: remotePath})
download remote server file
conn.sftp('readFile', {path: remoteFilePath, option: option})
upload file to remote server
conn.sftp('writeFile', {path: remoteFilePath, data: localFilePath, option: option})
append local data to remote server file
conn.sftp('appendFile', {path: remoteFilePath, data: localData, option: option})
create a new directory.
conn.sftp('mkdir', {path: remoteFilePath});
remove the directory.
conn.sftp('rmdir', {path: localPath});
delete file.
conn.sftp('delete', {path: remoteFilePath});
rename remoteSourcePath to remoteDestPath (removes remoteSourcePath).
conn.sftp('rename', {oldPath: remoteSourcePath, newPath: remoteDestPath});
modify rights to remoteDestPath file
conn.sftp('chmod', {path: remoteDestPath, mode: mode});
####connect
connection config you will see here
close the sftp connection. when you need it, you can call it in then()
or catch()
.
conn.end();
FAQs
a SFTP client for node.js
The npm package sftp-client-promise receives a total of 25 weekly downloads. As such, sftp-client-promise popularity was classified as not popular.
We found that sftp-client-promise demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Solo open source maintainers face burnout and security challenges, with 60% unpaid and 60% considering quitting.
Security News
License exceptions modify the terms of open source licenses, impacting how software can be used, modified, and distributed. Developers should be aware of the legal implications of these exceptions.
Security News
A developer is accusing Tencent of violating the GPL by modifying a Python utility and changing its license to BSD, highlighting the importance of copyleft compliance.