docs(readme): update help output example

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

.github/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.0.5"
+  ".": "0.0.6"
 }

.goreleaser.yml

@@ -44,6 +44,6 @@ brews:
       system "#{bin}/macos-battery-exporter -v"
     repository:
       owner: jimeh
-      name: homebrew-macos-battery-exporter
+      name: homebrew-tap
       branch: main
       token: "{{ .Env.BREW_TAP_TOKEN }}"

CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.0.6](https://github.com/jimeh/macos-battery-exporter/compare/v0.0.5...v0.0.6) (2023-12-21)
+
+
+### Bug Fixes
+
+* **output:** write log output to stderr by default instead of stdout ([7b2e98e](https://github.com/jimeh/macos-battery-exporter/commit/7b2e98e150f9ee6d630023879395df0912047667))
+
 ## [0.0.5](https://github.com/jimeh/macos-battery-exporter/compare/v0.0.4...v0.0.5) (2023-12-16)
 
 

README.md

@@ -16,9 +16,9 @@
   <a href="https://github.com/jimeh/macos-battery-exporter/blob/main/LICENSE"><img src="https://img.shields.io/github/license/jimeh/macos-battery-exporter.svg?style=flat" alt="License Status"></a>
 </p>
 
-A Prometheus exporter for macOS which exposes most useful details available from
+A Prometheus exporter for macOS battery information, exposing wide range of
-`ioreg`. Includes a lot more details than what `node_exporter` supports via it's
+details available from `ioreg` about batteries. Includes a lot more details than
-`node_power_supply_*` metrics.
+what `node_exporter` supports via its `node_power_supply_*` metrics.
 
 ## Installation
 
@@ -29,12 +29,11 @@ Binary releases are available on the
 
 ### Homebrew
 
-You can install it from the
+You can install it from the [`jimeh/tap`](https://github.com/jimeh/homebrew-tap)
-[`jimeh/macos-battery-exporter`](https://github.com/jimeh/homebrew-macos-battery-exporter)
 Tap:
 
 ```bash
-brew install jimeh/macos-battery-exporter/macos-battery-exporter
+brew install jimeh/tap/macos-battery-exporter
 ```
 
 #### Service
@@ -63,19 +62,22 @@ macos-battery-exporter -h
 ```
 
 ```
-Usage of macos-battery-exporter:
+usage: macos-battery-exporter [<options>]
+
   -b string
-        Bind address to run server on (default "127.0.0.1")
+    	Bind address to run server on (default "127.0.0.1")
+  -d string
+    	Log output device (stderr or stdout) (default "stderr")
   -l string
-        Log level (default "info")
+    	Log level (default "info")
   -n string
-        Namespace for metrics (default "macos")
+    	Namespace for metrics (default "macos")
   -o string
-        Output file to write to in Prometheus format
+    	Output file to write to in Prometheus format
   -p int
-        Port to run server on (default 9108)
+    	Port to run server on (default 9108)
-  -s    Run as a Prometheus metrics server
+  -s	Run as a Prometheus metrics server
-  -v    Print version and exit
+  -v	Print version and exit
 ```
 
 ### Print to STDOUT
@@ -159,3 +161,7 @@ macos-battery-exporter -s
 ```bash
 curl http://localhost:9108/metrics
 ```
+
+## License
+
+[MIT](https://github.com/jimeh/macos-battery-exporter/blob/main/LICENSE)

main.go

@@ -5,7 +5,7 @@ package main
 import (
 	"flag"
 	"fmt"
-	"log"
+	"io"
 	"log/slog"
 	"os"
 	"strings"
@@ -16,93 +16,159 @@ import (
 )
 
 var (
+	name    = "macos-battery-exporter"
 	version = "0.0.0-dev"
 	commit  = "unknown"
+)
 
-	outputFlag = flag.String(
+type configuration struct {
+	Output       string
+	Server       bool
+	Bind         string
+	Port         int
+	Namespace    string
+	LogLevel     string
+	LogDevice    string
+	PrintVersion bool
+}
+
+func configure() (*configuration, *flag.FlagSet, error) {
+	fs := flag.NewFlagSet(name, flag.ExitOnError)
+	fs.Usage = func() {
+		fmt.Fprintf(fs.Output(),
+			"usage: %s [<options>]\n\n", fs.Name(),
+		)
+		fs.PrintDefaults()
+	}
+
+	config := &configuration{}
+
+	fs.StringVar(&config.Output,
 		"o", "", "Output file to write to in Prometheus format",
 	)
-	serverFlag = flag.Bool("s", false, "Run as a Prometheus metrics server")
+	fs.BoolVar(&config.Server,
-	bindFlag   = flag.String(
+		"s", false, "Run as a Prometheus metrics server",
+	)
+	fs.StringVar(&config.Bind,
 		"b", "127.0.0.1", "Bind address to run server on",
 	)
-	portFlag      = flag.Int("p", 9108, "Port to run server on")
+	fs.IntVar(&config.Port, "p", 9108, "Port to run server on")
-	namespaceFlag = flag.String(
+	fs.StringVar(&config.Namespace,
 		"n", prombat.DefaultNamespace, "Namespace for metrics",
 	)
-	logLevelFlag = flag.String("l", "info", "Log level")
+	fs.StringVar(&config.LogLevel,
-	versionFlag  = flag.Bool("v", false, "Print version and exit")
+		"l", "info", "Log level",
-)
+	)
+	fs.StringVar(&config.LogDevice,
+		"d", "stderr", "Log output device (stderr or stdout)",
+	)
+	fs.BoolVar(&config.PrintVersion,
+		"v", false, "Print version and exit",
+	)
+
+	err := fs.Parse(os.Args[1:])
+	if err != nil {
+		return nil, nil, err
+	}
+
+	return config, fs, nil
+}
 
 func main() {
 	if err := mainE(); err != nil {
-		log.Fatal(err)
+		slog.Error(err.Error())
+		os.Exit(1)
 	}
 }
 
 func mainE() error {
-	flag.Parse()
+	config, _, err := configure()
-
-	err := setupSLog(*logLevelFlag)
 	if err != nil {
 		return err
 	}
 
-	if *versionFlag {
+	err = setupSLog(config.LogDevice, config.LogLevel)
-		fmt.Printf("macos-battery-exporter %s (%s)\n", version, commit)
+	if err != nil {
+		return err
+	}
+
+	if config.PrintVersion {
+		fmt.Printf("%s %s (%s)\n", name, version, commit)
 		return nil
 	}
 
-	if *serverFlag {
+	if config.Server {
-		opts := prombat.ServerOptions{
+		return runServer(config)
-			Bind: *bindFlag,
-			Port: *portFlag,
-		}
-
-		return prombat.RunServer(
-			*namespaceFlag,
-			prometheus.DefaultRegisterer.(*prometheus.Registry),
-			opts,
-		)
 	}
 
-	registry := prometheus.NewRegistry()
+	metrics, err := renderMetrics(config)
-	err = registry.Register(prombat.NewCollector(*namespaceFlag))
 	if err != nil {
 		return err
 	}
 
+	if config.Output != "" {
+		return writeToFile(metrics, config.Output)
+	}
+
+	fmt.Print(metrics)
+	return nil
+}
+
+func runServer(config *configuration) error {
+	opts := prombat.ServerOptions{
+		Bind: config.Bind,
+		Port: config.Port,
+	}
+
+	return prombat.RunServer(
+		config.Namespace,
+		prometheus.DefaultRegisterer.(*prometheus.Registry),
+		opts,
+	)
+}
+
+func renderMetrics(config *configuration) (string, error) {
+	registry := prometheus.NewRegistry()
+	err := registry.Register(prombat.NewCollector(config.Namespace))
+	if err != nil {
+		return "", err
+	}
+
 	gatherers := prometheus.Gatherers{registry}
 	metricFamilies, err := gatherers.Gather()
 	if err != nil {
-		return err
+		return "", err
 	}
 
 	var sb strings.Builder
 	for _, mf := range metricFamilies {
 		_, err := expfmt.MetricFamilyToText(&sb, mf)
 		if err != nil {
-			return err
+			return "", err
 		}
 	}
 
-	if *outputFlag != "" {
+	return sb.String(), nil
-		return writeToFile(sb.String(), *outputFlag)
-	}
-
-	fmt.Print(sb.String())
-
-	return nil
 }
 
-func setupSLog(levelStr string) error {
+func setupSLog(device string, levelStr string) error {
+	var w io.Writer
+	switch device {
+	case "stderr":
+		w = os.Stderr
+	case "stdout":
+		w = os.Stdout
+	default:
+		return fmt.Errorf("invalid log device: %s", device)
+	}
+
 	var level slog.Level
 	err := level.UnmarshalText([]byte(levelStr))
 	if err != nil {
 		return err
 	}
 
-	handler := slog.NewTextHandler(os.Stdout, &slog.HandlerOptions{
+	handler := slog.NewTextHandler(w, &slog.HandlerOptions{
 		Level: level,
 	})
 	logger := slog.New(handler)