Motor

Swift cli spinner. Simple and fully customizable.

Table of Contents

• Demo
• Installation
• Customization
  • Pattern
  • Delay
  • Message
• Contribute

Demo

import Foundation
import Motor
/// Initialize spinner.
letspinner=Spinner(pattern:Patterns.dots)
/// Start spinner.
spinner.start(message:"Motor initiated...")
/// Do your job.
sleep(2)
/// Print message.
spinner.display("Do something...")
/// Do another job.
sleep(3)
/// Stop spinner with message.
spinner.stop(message:"✓".color(.green)+" Done!")

On terminal

Installation

Add Motor to Package.swift.

dependencies:[.package(url:"https://github.com/flintbox/Motor", from:"0.1.1")]

Customization

Pattern

publicstructPattern{publicletframes:[String]publicletfps:UInt32}

Spinner pattern. frames for frames of the animation. fps(frames per second) for frame rate.

Delay

openclassAnimator:Operation{publicinit(pattern:Pattern, delay:UInt32){
spinner =Animation(pattern: pattern)self.delay = delay
super.init()}}

Delay before starting animation. Useful when duration of the job could be short and don't want to flash spinner.

Message

openclassSpinner{openfunc start(message:String=""){}openfunc display(_ message:String){}openfunc stop(message:String?=nil){}}

On start, during or termination of the animation. Show message beside spinner. Please, keep in mind that the spinner and message should be in one line to be correctly animated.

Contribute

If you have good idea or suggestion? Please, don't hesitate to open a pull request or send me an email.

Hope you enjoy building command line tool with Motor!