Popularity
3.5
Declining
Activity
3.5
-
14
3
0

Programming language: Crystal
License: MIT License
Tags: Cli Utils    
Latest version: v0.2.0

climate alternatives and similar shards

Based on the "CLI Utils" category.
Alternatively, view climate alternatives based on common mentions on social networks and blogs.

Do you think we are missing an alternative of climate or a related project?

Add another 'CLI Utils' Shard

README

climate.cr Build Status Releases License

Small helper utility to make your CLI program output ๐ŸŒˆ coloured by means of configurable markup styles. Think of it as your CLI-mate :)

Installation

  1. Add the dependency to your shard.yml:
   dependencies:
     climate:
       github: Sija/climate.cr
  1. Run shards install

Usage

require "climate"

message = "Usage: {#{PROGRAM_NAME}} <required-arg> [optional-arg]"

# you can call `Climate.parse` method directly
puts Climate.parse(message)

# or use a `String#climatize` extension
puts message.climatize

Defaults

Default styles are:

  • <> colored in green (keeping delimiters)
  • [] colored in yellow (keeping delimiters)
  • {} colored in blue (hiding delimiters)
  • !ยก colored in red (hiding delimiters)

Configuration

You can change the global settings with a #configure block:

Climate.configure do |settings|
  # use defaults
  settings.use_defaults!

  # and/or configure your own styles
  settings.styles << Climate::Style.new(
    delimiters: {'?', 'ยฟ'},
    keep_delimiters: false,
    colors: {
      fore: :magenta,
      back: :default,
    },
    decoration: :bold
  )
end

For the colors and decoration reference values see documentation for the Colorize module (which Climate uses under the hood).

Contributing

  1. Fork it (https://github.com/Sija/climate.cr/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

Contributors


*Note that all licence references and agreements mentioned in the climate README section above are relevant to that project's source code only.