ColorizeSwift 1.2.0

ColorizeSwift 1.2.0

×

测试已测试✗
语言语言 SwiftSwift
许可 MIT
发布上次发布2017年9月
SwiftSwift版本3.0
SPM支持SPM✓

由Michał Tynior维护。

ColorizeSwift 1.2.0

ColorizeSwift

Swift的终端字符串样式。

要求

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

集成

Swift Package Managers (SPM)

您可以通过将ColorizeSwift添加到Package.swift文件来使用Swift Package Manager来安装ColorizeSwift

import PackageDescription

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

手动

您还可以手动将ColorizeSwift添加到您的项目中

  1. 下载ColorizeSwift.swift文件，
  2. 将ColorizeSwift.swift拖放到项目树上。

示例

您可以运行示例应用程序

  1. 在终端中，转到Example文件夹。
  2. 运行./build.sh脚本来构建示例应用程序。
  3. 运行./example pacman来启动示例。

可用样本

  1. styles - 打印可用样式

    Example - Styles

  2. f1 - 打印Formula 1赛车

    Example - F1

  3. pacman - 打印吃豆达人

    Example - Pacman

  4. mario - 打印马里奥

    Example - 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() (不支持广泛)
  • underline()
  • reverse()
  • hidden()
  • strikethrough() (不支持广泛)
  • 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()

256色模式

您还可以使用256色，但请注意，并非所有终端客户端都支持它们。

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

可用颜色

您可以使用枚举访问256色。

256 Colors

转义码

有时您只需要访问修改器的开放代码。您可以使用枚举来访问它们

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

对于256色使用

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

禁用着色

着色可以在全局范围内禁用

String.isColorizationEnabled = false // Default: true

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

贡献者

许可证

ColorizeSwift在MIT许可证下发布。有关详细信息，请参阅LICENSE。