A long-lived project that still receives updates
Terminal color capabilities detection
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
 Dependencies

Development

>= 0
>= 3.0
 Project Readme
TTY Toolkit logo

TTY::Color Gitter

Gem Version Actions CI Build status Code Climate Coverage Status Inline docs

Terminal color capabilities detection.

TTY::Color provides independent color support detection component for TTY toolkit.

Installation

Add this line to your application's Gemfile:

gem "tty-color"

And then execute:

$ bundle

Or install it yourself as:

$ gem install tty-color

Usage

TTY::Color allows you to check if terminal supports color:

TTY::Color.color?    # => true
TTY::Color.support?  # => true

You can also get the number of colors supported by the terminal using mode method:

TTY::Color.mode # => 64

To detect if color support has been disabled with NO_COLOR environment variable, use disabled?:

TTY::Color.disabled? # => false

TTY::Color is just a module hence you can include it into your scripts directly:

#!/usr/bin/env ruby

include TTY::Color

puts color?

Command line tool

tty-color-cli is a command line tool for the TTY::Color.

To check if terminal supports colors use -s|--support:

tty-color -s
tty-color --support
# => true

And to check color mode use -m|--mode option:

tty-color -m
tty-color --mode
# => 256

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/piotrmurach/tty-color. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

  1. Fork it ( https://github.com/piotrmurach/tty-color/fork )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

Code of Conduct

Everyone interacting in the TTY::Color project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.

Copyright

Copyright (c) 2016 Piotr Murach. See LICENSE for further details.