Skip to content

mxcl/Chalk

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Chalk

Terminal colors using Swift 5’s string interpolation extensions.

import Chalk  // @mxcl ~> 0.3

let colorString = "blue"
print("Here’s \(colorString, color: .blue)!")

Styles, Backgrounds, Extended Colors etc.

// color, background & style can be specified all together or individually:
print("Foo \(string, color: .blue) bar")
print("Foo \(string, color: .blue, background: .yellow) bar")
print("Foo \(string, color: .blue, background: .yellow, style: .underline) bar")

// styles are an `OptionSet`:
print("Foo \(string, style: .underline) bar")
print("Foo \(string, style: [.underline, .bold]) bar")

// 256 color mode is supported:
print("Foo \(string, color: .extended(78) bar")

Name

Chalk by @sindresorhus is an extremely famous Node package for the same purpose. Open source is facilitated by naming connections, we picked the same name to enable those mental connections.

This package is called Chalk, or mxcl/Chalk or Chalk for Swift when disambiguating.

Support mxcl

Hey there, I’m Max Howell, a prolific producer of open source and probably you already use some of it (I created brew). I work full-time on open source and it’s hard; currently I earn less than minimum wage. Please help me continue my work, I appreciate it 🙏🏻

Other ways to say thanks.

Demo

If you have swift-sh:

$ swift sh <<EOF
import Foundation
import Chalk  // @mxcl ~> 0.3

for x in 0..<256 {
    let cell = " \(x)".padding(toLength: 5, withPad: " ", startingAt: 0)
    let terminator = (x + 3).isMultiple(of: 6) ? "\n" : ""
    print("\(cell, color: .extended(15), background: .extended(UInt8(x)))", terminator: terminator)
}
EOF

Will give you:

Installation

SwiftPM:

package.append(.package(url: "https://github.com/mxcl/Chalk.git", from: "0.1.0"))

Carthage:

Waiting on: @Carthage#1945.

About

Terminal colors using Swift 5’s string interpolation extensions.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages