Terminal string styling for Swift.

• iOS 9.0+ / Mac OS X 10.10+ / tvOS 9.0+ / watchOS 2.0+
• Xcode 8.0+

You can use CocoaPods to install ColorizeSwift by adding it to your Podfile:

platform :ios, '9.0'
use_frameworks!

target 'MyApp' do
	pod 'ColorizeSwift'
end

Run pods install to intagrate pods with your project.

You can use Carthage to install ColorizeSwift by adding it to your Cartfile:

github "mtynior/ColorizeSwift"

Run carthage update to build the framework and drag the built ColorizeSwift.framework into your Xcode project.

You can use The Swift Package Manager to install ColorizeSwift by adding it to your Package.swift file:

import PackageDescription

let package = Package(
    name: "MyApp",
    targets: [],
    dependencies: [
        .Package(url: "https://github.com/mtynior/ColorizeSwift.git", majorVersion: 1)
    ]
)

You can also manually add ColorizeSwift to you project:

1. Download ColorizeSwift.swift file,
2. Drag ColorizeSwift.swift into you project's tree.

You can run sample application:

1. Open Terminal and go to Example folder.
2. Run ./build.sh script to build sample application.
3. Run ./example pacman to launch sample.

Available samples:

1. styles - prints available styles

   

2. f1 - prints F1 cars

   

3. pacman - prints Pacman

   

4. mario - prints mario

   

print("Normal")
print("Bold".bold())
print("Dim".dim())
print("Italic".italic())
print("Underline".underline())
print("Blink".blink())
print("Reverse".reverse())
print("hidden".hidden())
print("strikethrough".strikethrough())
print("Red".red())
print("On yellow".onYellow())
print("256 foreground".foregroundColor(.orange1))
print("226 background".backgroundColor(.orange1))
print("Awful combination".colorize(.yellow, background: .red))
    
let nested = "with a blue substring".blue().underline()
print("A bold, green line \(nested) that becomes bold and green again".green().bold())

• bold()
• dim()
• italic() (not widely supported)
• underline()
• reverse()
• hidden()
• strikethrough() (not widely supported)
• reset()

• black()
• red()
• green()
• yellow()
• blue()
• magenta()
• cyan()
• lightGray()
• darkGray()
• lightRed()
• lightGreen()
• lightYellow()
• lightBlue()
• lightMagenta()
• lightCyan()
• white()

• onBlack()
• onRed()
• onGreen()
• onYellow()
• onBlue()
• onMagenta()
• onCyan()
• onLightGray()
• onDarkGray()
• onLightRed()
• onLightGreen()
• onLightYellow()
• onLightBlue()
• onLightMagenta()
• onLightCyan()
• onWhite()

You can also use 256 colors, but keep in mind that not all Terminal clients support them.

• foregroundColor(color: TerminalColor)
• backgroundColor(color: TerminalColor)
• colorize(foreground: TerminalColor, background: TerminalColor)

You can access 256 colors using TerminalColor enumeration.

Sometimes you only need the open code for a modifier. You can access them using TerminalStyle enum:

TerminalStyle.bold.open // "\u{001B}[1m"
TerminalStyle.bold.close  // "\u{001B}[22m"

For 256 colors use:

TerminalColor.red.foregroundStyleCode().open \\"\u{001B}[38;5;9m"
TerminalColor.red.backgroundStyleCode().open \\"\u{001B}[48;5;9m"

Colorization can be disabled globally:

String.isColorizationEnabled = false // Default: true

// For example, you can support a command line option (./example --no-color)
String.isColorizationEnabled = !CommandLine.arguments.contains("--no-color")

• Mike Smiley
• Theo Lubert
• Noah Bass

ColorizeSwift is released under the MIT license. See LICENSE for details.