dvla-herodotus 2.2.0 → 2.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2eb770ebff3f1d698f1498ae9d09f6ce70735fe4a0b4e8fb48047db6fffa9497
-  data.tar.gz: 3b32cbac5261b3f04831b455f0bdc1e12d7579ba3006b32fedf7a0214b6c1219
+  metadata.gz: 52b672b4b047bc03d1b603eb57ce54e8710d2f349531b0ed7ff586dfc74ec006
+  data.tar.gz: 8fd5c49734e7293aa0f0331860843fd032d2728ca25b1d24747514e584b6a6b8
 SHA512:
-  metadata.gz: e79ed58e9d0b3bbce41cc04c61ba6ffac86faee95ef257bc1be5f38c14cd9c2606c3452b13fb4f2aae5411137827aa29e70e4a2b038b8f8bf18f74dcc4f95793
-  data.tar.gz: 9fceaf98cfc77253cf2f772367698486a250ca3659d4b5d0399ab7d18b4b95274951c1e7cda5820e3f8019e8941f34f1554208bbc5d0fdda85bd3a5ffa085547
+  metadata.gz: e6a86fb9b81c961a73495e68068a7ea6b4b6c8aefd9c5e0b44855430b2738ddf829df971affc1a01b11a66a346b10648f62e4b538682c13efb8b8fa83ed080ac
+  data.tar.gz: d409d7a8f18584ac281f780c9ed94b603ed3de3af4e3a81ea15fffcfa72a95944691fd28b7642acf669f3faf1f196aabbaf7fed6742b2add922a59415fd0d290

data/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+All notable changes to this project will be documented in this file.
+
+## [2.2.1] - 2025-09-15
+- Fixed issue with ANSI exit codes breaking on string interpolation
+- Added strip_colour method to String which we now call when sending logs to file
+- Added colours/styles: yellow, bg_yellow, bg_white, bg_bright_red, bg_bright_green, bg_bright_blue, bg_bright_magenta, bg_bright_cyan, dim
+- Removed colours/styles: bright_black (that's just gray), bright_yellow (that's just yellow), blink (inconsistent/unsupported)
+- Added a changelog
+
+
+## [2.2.0] - 2025-09-08
+- Added colourise method to handle colour exist codes
+- Added alias for colour/color
+- Added alias for brown/yellow

data/README.md

@@ -29,7 +29,9 @@ You can get a logger by calling the following once Herodotus is installed:
 logger = DVLA::Herodotus.logger('<system-name>')
 ```
 
-You can also log out to a file. If you want all the logs in a single file, provide a string of the path to that output file and it will be logged to simultaneously with standard console logger
+You can also log out to a file. If you want all the logs in a single file, provide a string of the path to that output file and it will be logged to simultaneously with standard console logger.
+
+**Note:** Log messages are stripped of colour codes before being saved to file.
 
 ```ruby
 logger = DVLA::Herodotus.logger('<system-name>', output_path: 'logs.txt')
@@ -82,45 +84,34 @@ logger.new_scenario('Scenario Id')
 
 ### Strings
 
-Also included is a series of additional methods on `String` that allow you to modify the colour and style of logs. As these exist on `String`, you can call them on any string such as:
+Also included is a series of additional methods on `String` that allow you to modify the colour and style of logs.
+You can stack multiple method calls to add additional styling and use string interpolation to style different parts of the string
+
 
 ```ruby
-example_string = 'Multicoloured String'.blue.bg_red.bold
+  example_string = "#{'H'.red}#{'E'.bright_red}#{'R'.yellow}#{'O'.green}#{'D'.blue}#{'O'.bright_blue}#{'T'.magenta}#{'U'.bright_magenta}#{'S'.cyan}".bold.reverse_colour
 ```
 
-| Method        | Function                                         |
-|---------------|--------------------------------------------------|
-| blue          | Sets the string's colour to blue                 |
-| red           | Sets the string's colour to red                  |
-| green         | Sets the string's colour to green                |
-| brown         | Sets the string's colour to brown                |
-| blue          | Sets the string's colour to blue                 |
-| magenta       | Sets the string's colour to magenta              |
-| cyan          | Sets the string's colour to cyan                 |
-| gray          | Sets the string's colour to gray                 |
-| grey          | Sets the string's colour to grey (alias of gray) |
-| bright_blue   | Sets the string's colour to bright blue          |
-| bright_red    | Sets the string's colour to bright red           |
-| bright_green  | Sets the string's colour to bright green         |
-| bright_yellow | Sets the string's colour to bright yellow        |
-| bright_blue   | Sets the string's colour to bright blue          |
-| bright_magenta| Sets the string's colour to bright magenta       |
-| bright_cyan   | Sets the string's colour to bright cyan          |
-| white         | Sets the string's colour to white                |
-| bg_blue       | Sets the string's background colour to blue      |
-| bg_red        | Sets the string's background colour to red       |
-| bg_green      | Sets the string's background colour to green     |
-| bg_brown      | Sets the string's background colour to brown     |
-| bg_blue       | Sets the string's background colour to blue      |
-| bg_magenta    | Sets the string's background colour to magenta   |
-| bg_cyan       | Sets the string's background colour to cyan      |
-| bg_gray       | Sets the string's background colour to gray      |
-| bold          | Sets the string to be bold                       |
-| italic        | Sets the string to be italic                     |
-| underline     | Sets the string to be underline                  |
-| blink         | Sets the string to blink                         |
-| reverse_color | Reverses the colour of the string                |
+#### Available String Methods
+
+| Type | Examples |
+|------|----------|
+| Text Styles | **bold** <span style="opacity:0.6">dim</span> *italic* <u>underline</u> |
+| Colors | <span style="color:black">black</span> <span style="color:red">red</span> <span style="color:green">green</span> <span style="color:#B8860B">brown</span> <span style="color:#ffff00">yellow</span> <span style="color:blue">blue</span> <span style="color:magenta">magenta</span> <span style="color:cyan">cyan</span> <span style="color:grey">gray</span> <span style="color:white">white</span> |
+| Bright Colors | <span style="color:#ff5555">bright_red</span> <span style="color:#55ff55">bright_green</span> <span style="color:#5555ff">bright_blue</span> <span style="color:#ff55ff">bright_magenta</span> <span style="color:#55ffff">bright_cyan</span> |
+| Background Colors | <span style="background:black;color:white">bg_black</span> <span style="background:red;color:white">bg_red</span> <span style="background:green;color:white">bg_green</span> <span style="background:#B8860B;color:white">bg_brown</span> <span style="background:#ffff00;color:black">bg_yellow</span> <span style="background:blue;color:white">bg_blue</span> <span style="background:magenta;color:white">bg_magenta</span> <span style="background:cyan;color:black">bg_cyan</span> <span style="background:grey;color:white">bg_gray</span> <span style="background:white;color:black">bg_white</span> |
+| Bright Background Colors | <span style="background:#ff5555;color:white">bg_bright_red</span> <span style="background:#55ff55;color:black">bg_bright_green</span> <span style="background:#5555ff;color:white">bg_bright_blue</span> <span style="background:#ff55ff;color:white">bg_bright_magenta</span> <span style="background:#55ffff;color:black">bg_bright_cyan</span> |
+| Utility | strip_colour reverse_colour |
+
+#### To handle differences in spelling the following methods have been given aliases:
+| Alias         | Original       |
+|---------------|----------------|
+| bg_grey       | bg_gray        |
+| colorize      | colourise      |
+| grey          | gray           |
+| reverse_color | reverse_colour |
+| strip_color   | strip_colour   |
 
 ## Development
 
-Herodotus is very lightweight. Currently all code to generate a new logger can be found in `herodotus.rb` and the code for the logger is in `herodotus_logger.rb` so that is the best place to start with any modifications
+Herodotus is very lightweight. Currently, all code to generate a new logger can be found in `herodotus.rb` and the code for the logger is in `herodotus_logger.rb` so that is the best place to start with any modifications

data/lib/dvla/herodotus/multi_writer.rb

@@ -8,7 +8,14 @@ module DVLA
       end
 
       def write(*args)
-        @targets.each { |t| t.write(*args) }
+        @targets.each do |target|
+          # If we're writing to a file we remove the colour
+          if target != $stdout && args[0].respond_to?(:strip_colour)
+            target.write(args[0].strip_colour, *args[1..])
+          else
+            target.write(*args)
+          end
+        end
       end
 
       def close

data/lib/dvla/herodotus/string.rb

@@ -1,43 +1,91 @@
 class String
   def colourise(code, reset_code = 39)
-    "\e[#{code}m#{self}\e[#{reset_code}m"
+    # Making sure we align the correct reset codes
+    if self.include?("\e[#{reset_code}m")
+      result = self.gsub("\e[#{reset_code}m", "\e[#{reset_code}m\e[#{code}m")
+      "\e[#{code}m#{result}\e[#{reset_code}m"
+    else
+      "\e[#{code}m#{self}\e[#{reset_code}m"
+    end
   end
-  alias colorize colourise
+
+  def white = colourise(97)
 
   def black = colourise(30)
+
   def red = colourise(31)
+
   def green = colourise(32)
+
   def brown = colourise(33)
-  alias yellow brown
+
+  def yellow = colourise(93)
 
   def blue = colourise(34)
+
   def magenta = colourise(35)
+
   def cyan = colourise(36)
+
   def gray = colourise(37)
-  alias grey gray
 
-  def bright_black = colourise(90)
   def bright_red = colourise(91)
+
   def bright_green = colourise(92)
-  def bright_yellow = colourise(93)
+
   def bright_blue = colourise(94)
+
   def bright_magenta = colourise(95)
+
   def bright_cyan = colourise(96)
-  def white = colourise(97)
 
   def bg_black = colourise(40, 49)
+
   def bg_red = colourise(41, 49)
+
   def bg_green = colourise(42, 49)
+
   def bg_brown = colourise(43, 49)
+
+  def bg_yellow = colourise(103, 49)
+
   def bg_blue = colourise(44, 49)
+
   def bg_magenta = colourise(45, 49)
+
   def bg_cyan = colourise(46, 49)
+
   def bg_gray = colourise(47, 49)
 
+  def bg_white = colourise(107, 49)
+
+  def bg_bright_red = colourise(101, 49)
+
+  def bg_bright_green = colourise(102, 49)
+
+  def bg_bright_blue = colourise(104, 49)
+
+  def bg_bright_magenta = colourise(105, 49)
+
+  def bg_bright_cyan = colourise(106, 49)
+
   def bold = colourise(1, 22)
+
+  def dim = colourise(2, 22)
+
   def italic = colourise(3, 23)
+
   def underline = colourise(4, 24)
-  def blink = colourise(5, 25)
-  def reverse_color = colourise(7, 27)
-  alias reverse_colour reverse_color
+
+  def reverse_colour = colourise(7, 27)
+
+  def strip_colour
+    gsub(/\e\[[0-9;]*m/, '')
+  end
+
+  alias bg_grey bg_gray
+  alias colorize colourise
+  alias grey gray
+  alias reverse_color reverse_colour
+  alias strip_color strip_colour
 end

data/lib/dvla/herodotus/version.rb

@@ -1,5 +1,5 @@
 module DVLA
   module Herodotus
-    VERSION = '2.2.0'.freeze
+    VERSION = '2.2.1'.freeze
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: dvla-herodotus
 version: !ruby/object:Gem::Version
-  version: 2.2.0
+  version: 2.2.1
 platform: ruby
 authors:
 - Driver and Vehicle Licensing Agency (DVLA)
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-09-08 00:00:00.000000000 Z
+date: 2025-09-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dvla-lint
@@ -52,6 +52,7 @@ files:
 - ".gitignore"
 - ".rubocop.yml"
 - ".ruby-version"
+- CHANGELOG.md
 - Gemfile
 - LICENSE
 - README.md