migrated from package cli to flag for xlsx2csv

Author: rsdoiel

cmd/xlsx2csv/xlsx2csv.go

@@ -21,52 +21,107 @@ package main
 
 import (
 	"encoding/csv"
+	"flag"
 	"fmt"
 	"io"
 	"os"
+	"path"
 	"strings"
 
 	// CaltechLibrary packages
-	"github.com/caltechlibrary/cli"
 	"github.com/caltechlibrary/datatools"
 
 	// 3rd Party packages
 	"github.com/tealeg/xlsx"
 )
 
 var (
-	description = `
-%s is a tool that converts individual Excel Sheets to CSV output.
-`
+	helpText = `---
+title: "{app_name} (1) user manual"
+author: "R. S. Doiel"
+pubDate: 2023-01-09
+---
+
+# NAME
+
+{app_name}
+
+# SYNOPSIS
+
+{app_name} [OPTIONS] EXCEL_WORKBOOK_NAME [SHEET_NAME]
+
+# DESCRIPTION
+
+{app_name} is a tool that converts individual Excel Sheets to CSV output.
+
+# OPTIONS
+
+-help
+: display help
+
+-license
+: display license
+
+-version
+: display version
+
+-N, -sheets
+: display the Workbook sheet names
+
+-c, -count
+: display number of Workbook sheets
+
+-nl, -newline
+: if true add a trailing newline
+
+-o, -output
+: output filename
+
+-quiet
+: suppress error messages
+
+
+# EXAMPLES
 
-	examples = `
 Extract a workbook sheet as a CSV file
 
-    %s MyWorkbook.xlsx "My worksheet 1" > sheet1.csv
+~~~
+    {app_name} MyWorkbook.xlsx "My worksheet 1" > sheet1.csv
+~~~
 
 This would get the first sheet from the workbook and save it as a CSV file.
 
-    %s -count MyWorkbook.xlsx
+~~~
+    {app_name} -count MyWorkbook.xlsx
+~~~
+
 
 This will output the number of sheets in the Workbook.
 
-    %s -sheets MyWorkbook.xlsx
+~~~
+    {app_name} -sheets MyWorkbook.xlsx
+~~~
 
 This will display a list of sheet names, one per line.
 Putting it all together in a shell script.
 
-	%s -N MyWorkbook.xlsx | while read SHEET_NAME; do
+~~~
+	{app_name} -N MyWorkbook.xlsx | while read SHEET_NAME; do
     	CSV_NAME="${SHEET_NAME// /-}.csv"
-    	%s -o "${CSV_NAME}" MyWorkbook.xlsx "${SHEET_NAME}" 
+    	{app_name} -o "${CSV_NAME}" MyWorkbook.xlsx "${SHEET_NAME}" 
 	done
+~~~
+
+{app_name} {version}
+
 `
 
 	// Standard Options
 	showHelp     bool
 	showLicense  bool
 	showVersion  bool
 	showExamples bool
-	//inputFName           string
+
 	outputFName      string
 	generateMarkdown bool
 	generateManPage  bool
@@ -79,6 +134,10 @@ Putting it all together in a shell script.
 	showSheetNames bool
 )
 
+func fmtTxt(src string, appName string, version string) string {
+	return strings.ReplaceAll(strings.ReplaceAll(src, "{app_name}", appName), "{version}", version)
+}
+
 func sheetCount(workBookName string) (int, error) {
 	xlFile, err := xlsx.OpenFile(workBookName)
 	if err != nil {
@@ -131,107 +190,100 @@ func xlsx2CSV(out io.Writer, workBookName, sheetName string) error {
 }
 
 func main() {
-	app := cli.NewCli(datatools.Version)
-	appName := app.AppName()
+	appName := path.Base(os.Args[0])
 
-	// Add Help Docs
-	app.AddHelp("license", []byte(fmt.Sprintf(datatools.LicenseText, appName, datatools.Version)))
-	app.AddHelp("description", []byte(fmt.Sprintf(description, appName)))
-	app.AddHelp("examples", []byte(fmt.Sprintf(examples, appName, appName, appName, appName, appName)))
+	// Standard Options
+	flag.BoolVar(&showHelp, "help", false, "display help")
+	flag.BoolVar(&showLicense, "license", false, "display license")
+	flag.BoolVar(&showVersion, "version", false, "display version")
 
-	// Document non-option parameters
-	app.SetParams("EXCEL_WORKBOOK_NAME", "[SHEET_NAME]")
+	flag.StringVar(&outputFName, "o", "", "output filename")
+	flag.StringVar(&outputFName, "output", "", "output filename")
+	flag.BoolVar(&quiet, "quiet", false, "suppress error messages")
+	
 
-	// Standard Options
-	app.BoolVar(&showHelp, "h,help", false, "display help")
-	app.BoolVar(&showLicense, "l,license", false, "display license")
-	app.BoolVar(&showVersion, "v,version", false, "display version")
-	app.BoolVar(&showExamples, "examples", false, "display example(s)")
-	//app.StringVar(&inputFName, "i,input", "", "input filename")
-	app.StringVar(&outputFName, "o,output", "", "output filename")
-	app.BoolVar(&quiet, "quiet", false, "suppress error messages")
-	app.BoolVar(&generateMarkdown, "generate-markdown", false, "generate markdown documentation")
-	app.BoolVar(&generateManPage, "generate-manpage", false, "generate man page")
-	app.BoolVar(&newLine, "nl,newline", false, "if true add a trailing newline")
+	flag.BoolVar(&newLine, "nl", false, "if true add a trailing newline")
+	flag.BoolVar(&newLine, "newline", false, "if true add a trailing newline")
 
 	// App Specific Options
-	app.BoolVar(&showSheetCount, "c,count", false, "display number of Workbook sheets")
-	app.BoolVar(&showSheetNames, "N,sheets", false, "display the Workbook sheet names")
+	flag.BoolVar(&showSheetCount, "c", false, "display number of Workbook sheets")
+	flag.BoolVar(&showSheetCount, "count", false, "display number of Workbook sheets")
+	flag.BoolVar(&showSheetNames, "N", false, "display the Workbook sheet names")
+	flag.BoolVar(&showSheetNames, "sheets", false, "display the Workbook sheet names")
 
 	// Parse env and options
-	app.Parse()
-	args := app.Args()
+	flag.Parse()
+	args := flag.Args()
 
 	// Setup IO
 	var err error
-	app.Eout = os.Stderr
 
-	/* NOTE: this command does not read from stdin
-	   app.In, err = cli.Open(inputFName, os.Stdin)
-	   cli.ExitOnError(app.Eout, err, quiet)
-	   defer cli.CloseFile(inputFName, app.In)
-	*/
+	out := os.Stdout
+	eout := os.Stderr
 
-	app.Out, err = cli.Create(outputFName, os.Stdout)
-	cli.ExitOnError(app.Eout, err, quiet)
-	defer cli.CloseFile(outputFName, app.Out)
+	if outputFName != "" {
+		out, err = os.Create(outputFName)
+		if err != nil {
+			fmt.Fprintln(eout, err)
+			os.Exit(1)
+		}
+		defer out.Close()
 
-	// Process options
-	if generateMarkdown {
-		app.GenerateMarkdown(app.Out)
-		os.Exit(0)
-	}
-	if generateManPage {
-		app.GenerateManPage(app.Out)
-		os.Exit(0)
 	}
 
-	if showHelp || showExamples {
-		if len(args) > 0 {
-			fmt.Fprintln(app.Out, app.Help(args...))
-		} else {
-			app.Usage(app.Out)
-		}
+	// Process options
+	if showHelp {
+		fmt.Fprintf(out, "%s\n", fmtTxt(helpText, appName, datatools.Version))
 		os.Exit(0)
 	}
 	if showLicense {
-		fmt.Fprintln(app.Out, app.License())
+		fmt.Fprintf(out, "%s\n", datatools.LicenseText)
 		os.Exit(0)
 	}
 	if showVersion {
-		fmt.Fprintln(app.Out, app.Version())
+		fmt.Fprintf(out, "%s %s\n", appName, datatools.Version)
 		os.Exit(0)
 	}
 	if newLine {
 		eol = "\n"
 	}
 
 	if len(args) < 1 {
-		cli.ExitOnError(app.Eout, fmt.Errorf("Missing Excel Workbook names"), quiet)
+		fmt.Fprintln(eout, "Missing Excel Workbook names")
+		os.Exit(1)
 	}
 
 	workBookName := args[0]
 	if showSheetCount == true {
 		cnt, err := sheetCount(workBookName)
-		cli.ExitOnError(app.Eout, err, quiet)
-		fmt.Fprintf(app.Out, "%d%s", cnt, eol)
+		if err != nil {
+			fmt.Fprintln(eout, err)
+			os.Exit(1)
+		}
+		fmt.Fprintf(out, "%d%s", cnt, eol)
 		os.Exit(0)
 	}
 
 	if showSheetNames == true {
 		names, err := sheetNames(workBookName)
-		cli.ExitOnError(app.Eout, err, quiet)
-		fmt.Fprintf(app.Out, "%s%s", strings.Join(names, "\n"), eol)
+		if err != nil {
+			fmt.Fprintln(eout, err)
+			os.Exit(1)
+		}
+		fmt.Fprintf(out, "%s%s", strings.Join(names, "\n"), eol)
 		os.Exit(0)
 	}
 
 	if len(args) < 2 {
-		cli.ExitOnError(app.Eout, fmt.Errorf("Missing worksheet name"), quiet)
+		if err != nil {
+			fmt.Fprintln(eout, err)
+			os.Exit(1)
+		}
 	}
 	for _, sheetName := range args[1:] {
 		if len(sheetName) > 0 {
-			xlsx2CSV(app.Out, workBookName, sheetName)
+			xlsx2CSV(out, workBookName, sheetName)
 		}
 	}
-	fmt.Fprintf(app.Out, "%s", eol)
+	fmt.Fprintf(out, "%s", eol)
 }

xlsx2csv.1.md

@@ -1,45 +1,78 @@
+---
+title: "{app_name} (1) user manual"
+author: "R. S. Doiel"
+pubDate: 2023-01-09
+---
 
-USAGE: xlsx2csv [OPTIONS] EXCEL_WORKBOOK_NAME [SHEET_NAME]
+# NAME
 
-DESCRIPTION
+{app_name}
 
-xlsx2csv is a tool that converts individual Excel Sheets to CSV output.
+# SYNOPSIS
 
-OPTIONS
+{app_name} [OPTIONS] EXCEL_WORKBOOK_NAME [SHEET_NAME]
 
-    -N, -sheets          display the Workbook sheet names
-    -c, -count           display number of Workbook sheets
-    -examples            display example(s)
-    -generate-manpage    generate man page
-    -generate-markdown   generate markdown documentation
-    -h, -help            display help
-    -l, -license         display license
-    -nl, -newline        if true add a trailing newline
-    -o, -output          output filename
-    -quiet               suppress error messages
-    -v, -version         display version
+# DESCRIPTION
 
+{app_name} is a tool that converts individual Excel Sheets to CSV output.
 
-EXAMPLES
+# OPTIONS
+
+-help
+: display help
+
+-license
+: display license
+
+-version
+: display version
+
+-N, -sheets
+: display the Workbook sheet names
+
+-c, -count
+: display number of Workbook sheets
+
+-nl, -newline
+: if true add a trailing newline
+
+-o, -output
+: output filename
+
+-quiet
+: suppress error messages
+
+
+# EXAMPLES
 
 Extract a workbook sheet as a CSV file
 
-    xlsx2csv MyWorkbook.xlsx "My worksheet 1" > sheet1.csv
+~~~
+    {app_name} MyWorkbook.xlsx "My worksheet 1" > sheet1.csv
+~~~
 
 This would get the first sheet from the workbook and save it as a CSV file.
 
-    xlsx2csv -count MyWorkbook.xlsx
+~~~
+    {app_name} -count MyWorkbook.xlsx
+~~~
+
 
 This will output the number of sheets in the Workbook.
 
-    xlsx2csv -sheets MyWorkbook.xlsx
+~~~
+    {app_name} -sheets MyWorkbook.xlsx
+~~~
 
 This will display a list of sheet names, one per line.
 Putting it all together in a shell script.
 
-	xlsx2csv -N MyWorkbook.xlsx | while read SHEET_NAME; do
+~~~
+	{app_name} -N MyWorkbook.xlsx | while read SHEET_NAME; do
     	CSV_NAME="${SHEET_NAME// /-}.csv"
-    	xlsx2csv -o "${CSV_NAME}" MyWorkbook.xlsx "${SHEET_NAME}" 
+    	{app_name} -o "${CSV_NAME}" MyWorkbook.xlsx "${SHEET_NAME}" 
 	done
+~~~
+
+{app_name} {version}
 
-xlsx2csv 1.2.1