feat: added NewLettersFromStringWithRGB

_examples/bigtext/main.go

@@ -12,4 +12,9 @@ func main() {
 		pterm.NewLettersFromStringWithStyle("P", pterm.NewStyle(pterm.FgCyan)),
 		pterm.NewLettersFromStringWithStyle("Term", pterm.NewStyle(pterm.FgLightMagenta))).
 		Render()
+
+	// NewLettersFromStringWithRGB can be used to create a large text with a specific RGB color.
+	pterm.DefaultBigText.WithLetters(
+		pterm.NewLettersFromStringWithRGB("PTerm", pterm.NewRGB(255, 215, 0))).
+		Render()
 }

bigtext_printer.go

@@ -32,10 +32,27 @@ func NewLettersFromStringWithStyle(text string, style *Style) Letters {
 	return l
 }
 
+// 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{}
+
+	for _, s2 := range s {
+		l = append(l, Letter{
+			String: s2,
+			Style:  &Style{},
+			RGB:    rgb,
+		})
+	}
+
+	return l
+}
+
 // Letter is an object, which holds a string and a specific Style for it.
 type Letter struct {
 	String string
 	Style  *Style
+	RGB    RGB
 }
 
 // WithStyle returns a new Letter with a specific Style.
@@ -44,6 +61,12 @@ func (l Letter) WithStyle(style *Style) *Letter {
 	return &l
 }
 
+// WithRGB returns a new Letter with a specific RGB color (overwrites style).
+func (l Letter) WithRGB(rgb RGB) *Letter {
+	l.RGB = rgb
+	return &l
+}
+
 // WithString returns a new Letter with a specific String.
 func (l Letter) WithString(s string) *Letter {
 	l.String = s
@@ -91,6 +114,7 @@ func (p BigTextPrinter) Srender() (string, error) {
 			bigLetters = append(bigLetters, Letter{
 				String: val,
 				Style:  l.Style,
+				RGB:    l.RGB,
 			})
 		}
 	}
@@ -116,7 +140,12 @@ func (p BigTextPrinter) Srender() (string, error) {
 			if letterLineLength < maxLetterWidth {
 				letterLine += strings.Repeat(" ", maxLetterWidth-letterLineLength)
 			}
-			ret += letter.Style.Sprint(letterLine)
+
+			if letter.RGB != (RGB{}) {
+				ret += letter.RGB.Sprint(letterLine)
+			} else {
+				ret += letter.Style.Sprint(letterLine)
+			}
 		}
 		ret += "\n"
 	}

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