Swiftpack.co - Package - tuist/shell

๐Ÿงช Shell

Shell is a ยต-library written Swift to run shell tasks.

CircleCI Swift Package Manager Release Code Coverage Slack License

Install ๐Ÿ› 

Swift Package Manager

Add the dependency in your Package.swift file:

let package = Package(
    name: "myproject",
    dependencies: [
        .package(url: "https://github.com/tuist/shell.git", .upToNextMajor(from: "2.1.2")),
    targets: [
            name: "myproject",
            dependencies: ["Shell"]),


Add the following line to your project Podfile:

pod "Shell", "2.1.2"
pod "ShellTesting", "2.1.2"
pod "RxShell", "2.1.2"


Add the following line to your project Cartfile:

github "tuist/shell" "2.1.2"


If you want to use Shell in a Marathon script, either add it to your Marathonfile (see the Marathon repo for instructions on how to do that), or point Marathon to Shell using the inline dependency syntax:

import Shell // https://github.com/tuist/shell.git

Usage ๐Ÿš€

To run commands in the system, you need to create an instance of Shell:

let shell = Shell()

Shell exposes methods for running the commands synchronously, asynchronously, and capturing the output:

// Synchronous running
let result = shell.sync(["xcodebuild", "-project", "Shell", "-scheme", "Shell"])

// Asynchronous running
shell.async(["xcodebuild", "-project", "Shell", "-scheme", "Shell"]) { result in
  // Process the result

// Capturing output
let result = shell.capture(["xcode-select", "-p"])

Testing โœ…

We understand how inconvenient testing might be in Swift and thus, we designed Shell's API to facilitate testing by avoiding many syntactic sugar and static interfaces. The library comes with a library, ShellTesting that you can import in your tests target to mock the Shell interface and stub the result of running commands:

import ShellTesting

let mock = Shell.mock()
let xcodebuild = XcodeBuild(shell: mock)

shell.succeed(["xcodebuild", "-project", "Shell.xcodeproj", "-scheme", "Shell"])

XCTAssertNoThrow(try xcodebuild.build(project: "Shell.xcodeproj", scheme: "Shell"))

RxShell ๐Ÿ’ƒ

Shell comes with a package, RxShell that adds a reactive extension using RxSwift to the interface of Shell.

subject.run(["xcodebuild", "-project", "Shell", "-scheme", "Shell"]).subscribe {
  print("Compilation completed")

Setup for development ๐Ÿ‘ฉโ€๐Ÿ’ป

  1. Git clone: git@github.com:tuist/shell.git
  2. Generate Xcode project with swift package generate-xcodeproj.
  3. Open Shell.xcodeproj.
  4. Have fun ๐Ÿค–

Open source

Tuist is a proud supporter of the Software Freedom Conservacy

Become a Conservancy Supporter!


Stars: 21
Help us keep the lights on


2.1.2 - May 30, 2019


  • Make stdout and stderr public.

2.1.1 - May 30, 2019


  • Make collect() method public.

2.1.0 - May 30, 2019


  • RxSwift package by @pepibumur.

2.0.3 - Apr 6, 2019


  • Carthage dependency to PathKit by @pepibumur.

2.0.2 - Apr 5, 2019


  • Remove residual print by @pepibumur.