added caption support #97, clarify max width #247

Author: olekukonko

README.md

@@ -28,7 +28,7 @@ go get github.com/olekukonko/[email protected]
 #### Latest  Version
 The latest stable version
 ```bash
-go get github.com/olekukonko/[email protected].3
+go get github.com/olekukonko/[email protected].4
 ```
 
 **Warning:** Version `v1.0.0` contains missing functionality and should not be used.
@@ -77,7 +77,7 @@ func main() {
 │   PACKAGE   │ VERSION │ STATUS │
 ├─────────────┼─────────┼────────┤
 │ tablewriter │ v0.0.5  │ legacy │
-│ tablewriter │ v1.0.3  │ latest │
+│ tablewriter │ v1.0.4  │ latest │
 └─────────────┴─────────┴────────┘
 ```
 
@@ -369,10 +369,10 @@ func main() {
 		tablewriter.WithConfig(tablewriter.Config{
 			Row: tw.CellConfig{
 				Formatting: tw.CellFormatting{
-					MaxWidth:  25,            // Limit column width
 					AutoWrap:  tw.WrapNormal, // Wrap long content
 					Alignment: tw.AlignLeft,  // Left-align rows
 				},
+				ColMaxWidths: tw.CellWidth{Global: 25},
 			},
 			Footer: tw.CellConfig{
 				Formatting: tw.CellFormatting{Alignment: tw.AlignRight},
@@ -655,13 +655,9 @@ func main() {
   A | A  │  B | B  
  ---+--- │ ---+--- 
   A | A  │  B | B  
- ---+--- │ ---+--- 
-         │         
-  C | C  │  D | D  
- ---+--- │ ---+--- 
   C | C  │  D | D  
  ---+--- │ ---+--- 
-         │         
+  C | C  │  D | D   
 ```
 
 #### 9. Structs with Database

config.go

@@ -165,7 +165,7 @@ func (b *ConfigBuilder) WithFooterMaxWidth(maxWidth int) *ConfigBuilder {
 	if maxWidth < 0 {
 		return b
 	}
-	b.config.Footer.Formatting.MaxWidth = maxWidth
+	b.config.Footer.ColMaxWidths.Global = maxWidth
 	return b
 }
 
@@ -217,7 +217,7 @@ func (b *ConfigBuilder) WithHeaderMaxWidth(maxWidth int) *ConfigBuilder {
 	if maxWidth < 0 {
 		return b
 	}
-	b.config.Header.Formatting.MaxWidth = maxWidth
+	b.config.Header.ColMaxWidths.Global = maxWidth
 	return b
 }
 
@@ -280,7 +280,7 @@ func (b *ConfigBuilder) WithRowMaxWidth(maxWidth int) *ConfigBuilder {
 	if maxWidth < 0 {
 		return b
 	}
-	b.config.Row.Formatting.MaxWidth = maxWidth
+	b.config.Row.ColMaxWidths.Global = maxWidth
 	return b
 }
 
@@ -371,13 +371,13 @@ func (ff *FooterFormattingBuilder) WithAutoWrap(autoWrap int) *FooterFormattingB
 
 // WithMaxWidth sets the maximum content width for footer cells.
 // Negative values are ignored.
-func (ff *FooterFormattingBuilder) WithMaxWidth(maxWidth int) *FooterFormattingBuilder {
-	if maxWidth < 0 {
-		return ff
-	}
-	ff.config.MaxWidth = maxWidth
-	return ff
-}
+//func (ff *FooterFormattingBuilder) WithMaxWidth(maxWidth int) *FooterFormattingBuilder {
+//	if maxWidth < 0 {
+//		return ff
+//	}
+//	ff.config.Foo = maxWidth
+//	return ff
+//}
 
 // WithNewarkMode sets the merge behavior for footer cells (likely a typo, should be WithMergeMode).
 // Invalid merge modes are ignored.
@@ -489,13 +489,13 @@ func (hf *HeaderFormattingBuilder) WithAutoWrap(autoWrap int) *HeaderFormattingB
 
 // WithMaxWidth sets the maximum content width for header cells.
 // Negative values are ignored.
-func (hf *HeaderFormattingBuilder) WithMaxWidth(maxWidth int) *HeaderFormattingBuilder {
-	if maxWidth < 0 {
-		return hf
-	}
-	hf.config.MaxWidth = maxWidth
-	return hf
-}
+//func (hf *HeaderFormattingBuilder) WithMaxWidth(maxWidth int) *HeaderFormattingBuilder {
+//	if maxWidth < 0 {
+//		return hf
+//	}
+//	hf.config.MaxWidth = maxWidth
+//	return hf
+//}
 
 // WithMergeMode sets the merge behavior for header cells.
 // Invalid merge modes are ignored.
@@ -610,13 +610,13 @@ func (rf *RowFormattingBuilder) WithAutoWrap(autoWrap int) *RowFormattingBuilder
 
 // WithMaxWidth sets the maximum content width for row cells.
 // Negative values are ignored.
-func (rf *RowFormattingBuilder) WithMaxWidth(maxWidth int) *RowFormattingBuilder {
-	if maxWidth < 0 {
-		return rf
-	}
-	rf.config.MaxWidth = maxWidth
-	return rf
-}
+//func (rf *RowFormattingBuilder) WithMaxWidth(maxWidth int) *RowFormattingBuilder {
+//	if maxWidth < 0 {
+//		return rf
+//	}
+//	rf.config.MaxWidth = maxWidth
+//	return rf
+//}
 
 // WithMergeMode sets the merge behavior for row cells.
 // Invalid merge modes are ignored.
@@ -867,7 +867,7 @@ func WithRowMaxWidth(maxWidth int) Option {
 		if maxWidth < 0 {
 			return
 		}
-		target.config.Row.Formatting.MaxWidth = maxWidth
+		target.config.Row.ColMaxWidths.Global = maxWidth
 		if target.logger != nil {
 			target.logger.Debug("Option: WithRowMaxWidth applied to Table: %v", maxWidth)
 		}
@@ -945,7 +945,6 @@ func defaultConfig() Config {
 		MaxWidth: 0,
 		Header: tw.CellConfig{
 			Formatting: tw.CellFormatting{
-				MaxWidth:   0,
 				AutoWrap:   tw.WrapTruncate,
 				Alignment:  tw.AlignCenter,
 				AutoFormat: true,
@@ -957,7 +956,6 @@ func defaultConfig() Config {
 		},
 		Row: tw.CellConfig{
 			Formatting: tw.CellFormatting{
-				MaxWidth:   0,
 				AutoWrap:   tw.WrapNormal,
 				Alignment:  tw.AlignLeft,
 				AutoFormat: false,
@@ -969,7 +967,6 @@ func defaultConfig() Config {
 		},
 		Footer: tw.CellConfig{
 			Formatting: tw.CellFormatting{
-				MaxWidth:   0,
 				AutoWrap:   tw.WrapNormal,
 				Alignment:  tw.AlignRight,
 				AutoFormat: false,
@@ -997,8 +994,8 @@ func mergeCellConfig(dst, src tw.CellConfig) tw.CellConfig {
 	if src.Formatting.AutoWrap != 0 {
 		dst.Formatting.AutoWrap = src.Formatting.AutoWrap
 	}
-	if src.Formatting.MaxWidth != 0 {
-		dst.Formatting.MaxWidth = src.Formatting.MaxWidth
+	if src.ColMaxWidths.Global != 0 {
+		dst.ColMaxWidths.Global = src.ColMaxWidths.Global
 	}
 	if src.Formatting.MergeMode != 0 {
 		dst.Formatting.MergeMode = src.Formatting.MergeMode

renderer/markdown.go

@@ -149,7 +149,7 @@ func (m *Markdown) resolveAlignment(ctx tw.Formatting) tw.Alignment {
 		m.alignment[i] = ctx.Row.Current[i].Align
 	}
 
-	m.logger.Debug(" → Alignment Resolved %s", m.alignment)
+	m.logger.Debug(" → Align Resolved %s", m.alignment)
 	return m.alignment
 }
 

stream.go

@@ -80,7 +80,6 @@ func (t *Table) Close() error {
 func (t *Table) Start() error {
 	t.ensureInitialized() // Ensures basic setup like loggers
 
-	// --- MODIFIED LOGIC START ---
 	if !t.config.Stream.Enable {
 		// Start() should only be called when streaming is explicitly enabled.
 		// Otherwise, the user should call Render() for batch mode.
@@ -761,7 +760,7 @@ func (t *Table) streamRenderFooter(processedFooterLines [][]string) error {
 	f := t.renderer
 	cfg := t.renderer.Config()
 
-	// --- Render Row/Footer or Header/Footer Separator Line ---
+	//  Render Row/Footer or Header/Footer Separator Line
 	// This separator is drawn if ShowFooterLine is enabled AND there was content before the footer.
 	// The last rendered position (t.lastRenderedPosition) should be Row or Header or "separator".
 	if (t.lastRenderedPosition == tw.Row || t.lastRenderedPosition == tw.Header || t.lastRenderedPosition == tw.Position("separator")) &&
@@ -819,7 +818,7 @@ func (t *Table) streamRenderFooter(processedFooterLines [][]string) error {
 		t.lastRenderedMergeState = nil
 		t.logger.Debug("streamRenderFooter: Footer separator line rendered.")
 	}
-	// --- End Render Separator Line ---
+	//  End Render Separator Line
 
 	// Detect horizontal merges for the footer section based on its (assumed stored) raw input.
 	// This is tricky because streamStoreFooter gets []string, but prepareWithMerges expects [][]string.