string_dot_gradient 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 888e756d71707ea2545d43cf8a3fdc38ac9a390570fe7b9e52271c89e7af3d7d
-  data.tar.gz: fc1bf3010fca21e26c7ee07504ad2e76dd66affe2eff5acd6b316ebf2805a243
+  metadata.gz: d6fa81c2c57dbe1b9712438b587127627a24f23e7583b1892328412ebc14031a
+  data.tar.gz: 2960add227d5e2c678f693da5a6c84269045b286b1d3c37f8426eb66f776f6e0
 SHA512:
-  metadata.gz: c9fce9010dba35978ef9b93e5336911f534b6d37c8635817240414a86411317f32626a6a50c0a52ef8bab7f27f12a7912fbaec572fa200a7b2011c858d8c5c0d
-  data.tar.gz: 9cbf19d2ef2361f1d2bd6cd2ec39ea3e96264617bf5ba0a216c542bc4c401da58a72927095b360a204c0040c6e84d2688328002b0601e628b4eca5e6d9cd2157
+  metadata.gz: 63ffc5173183586621b0b98550651b4049875464aa39aa97f5b926e479cfad1b72ca4f63fb4c959a051a7d9552b1f8bfd5b94454318709986784e1b406ed7e33
+  data.tar.gz: 443780070aabb205c759966136b725cd3d7d2ca4e7f1cf2208407d1553db7e95ce6712fbddba594d5e12b218f8dbd10f48c9a5f1a10481d83e97b2bd7f820aad

data/lib/string_dot_gradient/gradient.rb

@@ -183,6 +183,76 @@ class String
 		block_given ? nil : temp
 	end
 
+	##
+	# = multi_gradient(*n_arg_colours, bg: false, exclude_spaces: true, bold: false, blink: false)    # => string or nil
+	#
+	# Accepts n number of colours. Example:
+	#    'Hello world this is multi_gradient()'.multi_gradient('3eb', '55f', 'f55', 'fa0')
+	#
+	# In this example, multi_gradient() paints the string with 4 colours in one line.
+	#
+	# It Splits up a string with the Calls String#gradient() with the given number of colours
+	# So each call to multi_gradient() involves many calls to String#gradient().
+	# Hence it's slower than String#gradient()
+	def multi_gradient(*colours,
+		exclude_spaces: true,
+		bg: false,
+		bold: false,
+		italic: false,
+		underline: false,
+		blink: false,
+		strikethrough: false,
+		double_underline: false,
+		overline: false
+		)
+
+		len = colours.length
+		raise ArgumentError, "Minimum two colours are required, given #{len}" if len < 2
+
+		div = len - 1
+		div_1 = div - 1
+		ret = ''
+
+		params = {
+			exclude_spaces: exclude_spaces,
+			bg: bg,
+			bold: bold,
+			italic: italic,
+			underline: underline,
+			blink: blink,
+			strikethrough: strikethrough,
+			double_underline: double_underline,
+			overline: overline
+		}
+
+		each_line { |l|
+			_len = l.length
+
+			len, c = _len.fdiv(div).round, colours.dup
+			counter, i, j = -1, -1, 0
+			ch = ''
+
+			while x = l[i += 1] do
+				counter += 1
+
+				# colour % len == 0 is very slow approach
+				if counter == len && j < div_1
+					counter, j = 0, j + 1
+					ret << ch.gradient(c[0], c[1], **params)
+
+					c.rotate!
+					ch.clear
+				end
+
+				ch << x
+			end
+
+			ret << ch.gradient(c[0], c[1], **params)
+		}
+
+		ret
+	end
+
 	private
 	def hex_to_rgb(hex)
 		# Duplicate colour, even if colour is nil
@@ -201,8 +271,7 @@ class String
 				oor.include?(x) ? "\e[1;31m#{x}\e[0m" : x
 			}.join
 
-			puts "Hex Colour ##{invalids} is Out of Range"
-			raise ArgumentError
+			raise ArgumentError, "\e[0mHex Colour \e[1m##{invalids} is Out of Range\e[0m"
 		end
 
 		clen = colour.length

data/lib/string_dot_gradient/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module StringDotGradient
-	VERSION = "0.2.0"
+	VERSION = "0.3.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: string_dot_gradient
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Sourav Goswami
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-01-15 00:00:00.000000000 Z
+date: 2021-04-01 00:00:00.000000000 Z
 dependencies: []
 description: An itty-bitty extension that adds "gradient" method to String class that
   supports any hex colour, for Linux terminals
@@ -40,7 +40,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.4
+rubygems_version: 3.2.13
 signing_key:
 specification_version: 4
 summary: An itty-bitty extension that adds "gradient" method to String class that