Awesome
SwiftSH
This is a fork of the original SwiftSH module with a handful of bug fixes and changes that I wanted for my SwiftTerm emulator. The upstream package does not seem active.
While Carthage, Pods and other platforms were originally supported, I have not attempted to update those, I have now moved to SwiftPM for it, which solved various issues for me.
Additionally, this add a callback-based authentication system, that you can now use for authenticating using the secure enclave.
Original Readme
A Swift SSH framework that wraps libssh2.
Features:
- Thread-safety
- SSH shell
- SSH command
- SCP
- SFTP
- Tests
- Documentation
:package: Installation
CocoaPods
CocoaPods is the dependency manager for Swift and Objective-C Cocoa projects. It has over ten thousand libraries and can help you scale your projects elegantly.
Add this to your Podfile:
use_frameworks!
pod 'SwiftSH'
Carthage
Carthage builds your dependencies and provides you with binary frameworks, but you retain full control over your project structure and setup.
Add this to your Cartfile:
github "Frugghi/SwiftSH"
:book: Documentation
The API documentation is available here.
:computer: Usage
Import the framework:
import SwiftSH
Execute a SSH command:
let command = Command(host: "localhost", port: 22)
// ...
command.connect()
.authenticate(.byPassword(username: "username", password: "password"))
.execute(command) { (command, result: String?, error) in
if let result = result {
print("\(result)")
} else {
print("ERROR: \(error)")
}
}
Open a SSH shell:
let shell = Shell(host: "localhost", port: 22)
// ...
shell.withCallback { (string: String?, error: String?) in
print("\(string ?? error!)")
}
.connect()
.authenticate(.byPassword(username: "username", password: "password"))
.open { (error) in
if let error = error {
print("\(error)")
}
}
// ...
shell.write("ls -lA") { (error) in
if let error = error {
print("\(error)")
}
}
// ...
shell.disconnect()
:warning: OpenSSL and Libssh2 binaries
SwiftSH includes precompiled binaries of Libssh2 and OpenSSL generated with this script. For security reasons, you are strongly encouraged to recompile the libraries and replace the binaries.
:page_facing_up: License ![LICENSE](https://img.shields.io/cocoapods/l/SwiftSH.svg)
SwiftSH is released under the MIT license. See LICENSE for details.