An OS X Framework for command line scripting in Swift. It supports joining together shell commands and Swift functions, like the pipe in shell commands and the pipe forward operator in F#. As Swift itself it supports both object-oriented and functional programming.

Usage

Shell commands return readable streams, which can be read all at once with "read()" or read lazily (as in piece by piece) with "readSome()". The latter is useful for long texts.

#!/usr/bin/env swiftshell

import SwiftShell

let result = run("some shell command").read()

Commands can be piped together.

run("echo piped to the next command") |> run("wc -w") |>> standardoutput

For in-line commands, use $("command").

print( "The time and date is " + $("date -u") )

Read and write files

Files are streams too. They can be read line by line:

for line in open("file1.txt").lines() {
	// Do something with each line
}

Or written to:

let file2 = open(forWriting: tempdirectory / "newfile.txt" )
run("echo line 1") |>> file2
file2.writeln("line 2")

Use standard input

var i = 1
for line in standardinput.lines() {
	print("line \(i++): ")
	println(line)
}

var i = 1
standardinput.lines() |> map {line in "line \(i++): \(line)\n"} |>> standardoutput

Launch with e.g. ls | print_linenumbers.swift

Examples

trash.swift: moves files and folders to the trash.
listallexecutablesinpath.swift: lists all executables currently available in PATH.

Installation

In the Terminal, go to where you want to download SwiftShell.

Run

  git clone https://github.com/kareman/SwiftShell.git 
  cd SwiftShell

Copy/link Div/swiftshell to your bin folder or anywhere in your PATH.
To install the framework itself, either:
- run xcodebuild install from the project's root folder. This will install the SwiftShell framework in ~/Library/Frameworks.
- or run xcodebuild and copy the resulting framework from the build folder to your library folder of choice. If that is not "~/Library/Frameworks", "/Library/Frameworks" or a folder mentioned in the $DYLD_FRAMEWORK_PATH environment variable then you need to add your folder to $DYLD_FRAMEWORK_PATH.

NOTE: Code compiled with optimisations turned on (anything but "SWIFT_OPTIMIZATION_LEVEL = -Onone") crashes when reading from streams. So SwiftShell is compiled with the “Debug” configuration by default.

LICENSE

Released under the MIT License (MIT), http://opensource.org/licenses/MIT

Kåre Morstøl, NotTooBad Software