colsole 0.8.0 → 0.8.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2fd26345db2525e6804965d0686301be91d7c27d9fe3894550a781e73e1c2f72
-  data.tar.gz: f44de99c02442edeae3723d405be87fe29d845c130460ee16a23bf0aab254901
+  metadata.gz: 277f45ee7c12e0c6090bd41752a275feef3357c38a1d3cbca522f9089ce68d49
+  data.tar.gz: f21a9866ce164222627f314c4ffe0c16046d705f5d544783b1d5f3598a54cf18
 SHA512:
-  metadata.gz: ff6fb2074275bf9479ab0ba400bec991aa1d5972488c0c21c143ab012851733452aca15549278d770f8427c05ff5bcfad077f53c2649860ceb063934ebe0cba0
-  data.tar.gz: 8bd0e29dc5216b94ade0bec78636122bf015bbe502061655312cf52aaecd4c3462bac97310bf4e5f35d7ad0a51ad9fe5f4093d806b36968b4597f9df3789574a
+  metadata.gz: c74ab05a5fea57685109cbcf2bdc033e0b0ba7f191a5ea491e4d31a1bcee335718d7e74481a031b19e99203e14dd34646542985199a001d15c2dbfc0dd52a8da
+  data.tar.gz: af3bcd3c64f66cc5dd5a89c96f4e92946160082ea08e017e68c3eda311525c6de5688759bdfe858d084231dae835d4c091ed9ca6af225f640ef2803a61b0e4d9

data/README.md

@@ -9,10 +9,10 @@
 Utility functions for colorful console applications.
 
 > **Upgrade Note**
->
+> 
 > This README is for the latest version of colsole (0.8.x), which is compatible
 > with older versions. Version 1.x will NOT be compatible.
->
+> 
 > See [Uprading](#upgrading) below.
 
 ## Install
@@ -20,7 +20,22 @@ Utility functions for colorful console applications.
 Add to your Gemfile:
 
 ```
-$ gem 'colsole', '>= 0.6.0', '< 2.0'
+$ gem 'colsole', '>= 0.8.1', '< 2.0'
+```
+
+## Usage
+
+```ruby
+require 'colsole'
+include Colsole
+say 'b`Blue` Man Group'
+```
+
+All the methods described below can also be called directly on the `Colsole` module. This is useful when you want to use it at the top level of your project, without namespace contamination:
+
+```ruby
+require 'colsole'
+Colsole.say 'b`Blue` Man Group'
 ```
 
 ## Examples
@@ -60,7 +75,6 @@ say "downloading data... "
 say "download complete.", replace: true
 ```
 
-
 ### `word_wrap "   string" [, length]`
 
 Wrap long lines while keeping words intact, and keeping indentation based on the
@@ -111,7 +125,6 @@ fallback if it is unable to detect.
 Returns only the terminal width or height. This is a shortcut to 
 `terminal_size[0]` / terminal_size[1].
 
-
 ## Colors
 
 Strings that are surrounded by backticks, and preceded by a color code and
@@ -123,24 +136,24 @@ say "this is b`blue` and ru`this is red underlined`"
 
 The one letter color code is required, followed by up to 3 style code.
 
-| Color Code | Color
-|------------|-------
-| `n`        | no color
-| `k`        | black
-| `r`        | red
-| `g`        | green
-| `y`        | yellow
-| `b`        | blue
-| `m`        | magenta
-| `c`        | cyan
-| `w`        | white
-
-| Style Code | Style
-|------------|-------
-| `b`        | bold
-| `u`        | underlined
-| `i`        | inverted
-| `z`        | terminate
+| Color Code | Color    |
+| ---------- | -------- |
+| `n`        | no color |
+| `k`        | black    |
+| `r`        | red      |
+| `g`        | green    |
+| `y`        | yellow   |
+| `b`        | blue     |
+| `m`        | magenta  |
+| `c`        | cyan     |
+| `w`        | white    |
+
+| Style Code | Style      |
+| ---------- | ---------- |
+| `b`        | bold       |
+| `u`        | underlined |
+| `i`        | inverted   |
+| `z`        | terminate  |
 
 ## Upgrading
 
@@ -150,12 +163,11 @@ markers. For easy transition, it is compatible with older versions.
 Follow these steps to upgrade:
 
 ```ruby
-
 # => Require a more flexible version
 # change this
 gem 'colsole'
-# to this (to avoid conflicts with other gems that require 0.x)
-gem 'colsole', '>= 0.6.0', '< 2.0'
+# to this
+gem 'colsole', '>= 0.8.1', '< 2.0'
 
 # => Remove 'say_status'
 # It will no longer be supported in 1.0.0

data/lib/colsole/compat.rb

@@ -2,6 +2,12 @@
 # for compatibility with older versions of colsole.
 # Do not use these methods directly.
 module Colsole
+module_function
+
+  def detect_terminal_size(*args)
+    terminal_size(*args)
+  end
+
   def old_colorize(text)
     reset = colors['txtrst']
     reset_called_last = true

data/lib/colsole/version.rb

@@ -1,3 +1,3 @@
 module Colsole
-  VERSION = '0.8.0'
+  VERSION = '0.8.2'
 end

data/lib/colsole.rb

@@ -22,6 +22,8 @@ module Colsole
     'z' => "\e[0m", # terminate
   }
 
+module_function
+
   # Output a string with optional color markers to stdout.
   # If text is ended with a white space, you can call again with replace: true
   # to replace that line
@@ -119,8 +121,6 @@ module Colsole
     process_color_markers(compat_string) { |_color, _styles, text| text }
   end
 
-private
-
   def process_color_markers(string)
     string.gsub(/([rgybmcn])([ubi]{0,3})`([^`]*)`/) do
       color = ANSI_COLORS[$1]
@@ -143,8 +143,12 @@ private
   end
 
   def safe_get_tty_size(default = [80, 30])
-    $stdout.winsize.reverse
-  rescue Errno::ENOTTY
-    default
+    return default unless IO.console
+
+    begin
+      IO.console.winsize.reverse
+    rescue Errno::ENOTTY
+      default
+    end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: colsole
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.8.2
 platform: ruby
 authors:
 - Danny Ben Shitrit
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-01-20 00:00:00.000000000 Z
+date: 2023-01-25 00:00:00.000000000 Z
 dependencies: []
 description: Utility functions for making colorful console applications
 email: db@dannyben.com
@@ -40,7 +40,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.3
+rubygems_version: 3.4.5
 signing_key: 
 specification_version: 4
 summary: Colorful Console Applications