feat: added NewLettersFromStringWithRGB

bigtext_printer.go

@@ -32,7 +32,7 @@ func NewLettersFromStringWithStyle(text string, style *Style) Letters {
 	return l
 }
 
-// NewLettersFromStringWithRGB creates a Letters object from a string and applies an RGB color to it.
+// NewLettersFromStringWithRGB creates a Letters object from a string and applies an RGB color to it (overwrites style).
 func NewLettersFromStringWithRGB(text string, rgb RGB) Letters {
 	s := strings.Split(text, "")
 	l := Letters{}
@@ -61,7 +61,7 @@ func (l Letter) WithStyle(style *Style) *Letter {
 	return &l
 }
 
-// WithRGB returns a new Letter with a specific RGB color.
+// WithRGB returns a new Letter with a specific RGB color (overwrites style).
 func (l Letter) WithRGB(rgb RGB) *Letter {
 	l.RGB = rgb
 	return &l

bigtext_printer_test.go

@@ -32,6 +32,22 @@ func TestBigTextPrinter_Render(t *testing.T) {
 	pterm.EnableStyling()
 }
 
+func TestBigTextPrinter_RenderRGB(t *testing.T) {
+	printer := pterm.DefaultBigText.WithLetters(pterm.NewLettersFromStringWithRGB("Hello", pterm.NewRGB(255, 0, 0)))
+	content := captureStdout(func(w io.Writer) {
+		printer.Render()
+	})
+	testza.AssertNotZero(t, content)
+	testza.SnapshotCreateOrValidate(t, t.Name(), content)
+	// DisableStyling
+	pterm.DisableStyling()
+	content = captureStdout(func(w io.Writer) {
+		printer.Render()
+	})
+	testza.SnapshotCreateOrValidate(t, t.Name()+"NoStyling", content)
+	pterm.EnableStyling()
+}
+
 func TestBigTextPrinter_RenderRawOutput(t *testing.T) {
 	printer := pterm.DefaultBigText.WithLetters(pterm.NewLettersFromString("Hello"))
 	content := captureStdout(func(w io.Writer) {
@@ -93,6 +109,15 @@ func TestLetter_WithStyle(t *testing.T) {
 	testza.AssertZero(t, p.Style)
 }
 
+func TestLetter_WithRGB(t *testing.T) {
+	p := pterm.Letter{}
+	rgb := pterm.NewRGB(0, 0, 0)
+	p2 := p.WithRGB(rgb)
+
+	testza.AssertEqual(t, rgb, p2.RGB)
+	testza.AssertZero(t, p.RGB)
+}
+
 func TestNewLettersFromText(t *testing.T) {
 	e := pterm.Letters{
 		pterm.Letter{
@@ -125,6 +150,24 @@ func TestNewLettersFromTextWithStyle(t *testing.T) {
 	testza.AssertEqual(t, e, p)
 }
 
+func TestNewLettersFromTextWithRGB(t *testing.T) {
+	e := pterm.Letters{
+		pterm.Letter{
+			String: "a",
+			Style:  pterm.NewStyle(),
+			RGB:    pterm.NewRGB(0, 0, 0),
+		},
+		pterm.Letter{
+			String: "b",
+			Style:  pterm.NewStyle(),
+			RGB:    pterm.NewRGB(0, 0, 0),
+		},
+	}
+	p := pterm.NewLettersFromStringWithRGB("ab", pterm.NewRGB(0, 0, 0))
+
+	testza.AssertEqual(t, e, p)
+}
+
 func TestDefaultLettersMaxHeight(t *testing.T) {
 	maxHeight := 5
 	chars := pterm.DefaultBigText.BigCharacters

testdata/snapshots/TestBigTextPrinter_RenderRGB.testza

@@ -0,0 +1 @@
+(string) (len=886) "\x1b[38;2;255;0;0m██   ██ \x1b[0m\x1b[38;2;255;0;0m███████ \x1b[0m\x1b[38;2;255;0;0m██      \x1b[0m\x1b[38;2;255;0;0m██      \x1b[0m\x1b[38;2;255;0;0m ██████  \x1b[0m\n\x1b[38;2;255;0;0m██   ██ \x1b[0m\x1b[38;2;255;0;0m██      \x1b[0m\x1b[38;2;255;0;0m██      \x1b[0m\x1b[38;2;255;0;0m██      \x1b[0m\x1b[38;2;255;0;0m██    ██ \x1b[0m\n\x1b[38;2;255;0;0m███████ \x1b[0m\x1b[38;2;255;0;0m█████   \x1b[0m\x1b[38;2;255;0;0m██      \x1b[0m\x1b[38;2;255;0;0m██      \x1b[0m\x1b[38;2;255;0;0m██    ██ \x1b[0m\n\x1b[38;2;255;0;0m██   ██ \x1b[0m\x1b[38;2;255;0;0m██      \x1b[0m\x1b[38;2;255;0;0m██      \x1b[0m\x1b[38;2;255;0;0m██      \x1b[0m\x1b[38;2;255;0;0m██    ██ \x1b[0m\n\x1b[38;2;255;0;0m██   ██ \x1b[0m\x1b[38;2;255;0;0m███████ \x1b[0m\x1b[38;2;255;0;0m███████ \x1b[0m\x1b[38;2;255;0;0m███████ \x1b[0m\x1b[38;2;255;0;0m ██████  \x1b[0m\n\n"

testdata/snapshots/TestBigTextPrinter_RenderRGBNoStyling.testza

@@ -0,0 +1 @@
+(string) (len=6) "Hello\n"