Skip to content

Commit 451aa00

Browse files
tamndtamnd
committed
wire cli commands: latest, search, trending
Add App struct with client, render, and progress helpers to root.go. Wire latestCmd, searchCmd, trendingCmd on top of the hackernoon library. Add errors.go with isNotFound and mapFetchErr. Include pkg/render, types, go.sum, and completed hackernoon package files.
1 parent ae2e24a commit 451aa00

11 files changed

Lines changed: 1042 additions & 61 deletions

File tree

‎cli/cmd_latest.go‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
package cli
2+
3+
import (
4+
"github.com/spf13/cobra"
5+
)
6+
7+
func (a *App) latestCmd() *cobra.Command {
8+
return &cobra.Command{
9+
Use: "latest",
10+
Short: "Latest Hackernoon stories",
11+
RunE: func(cmd *cobra.Command, _ []string) error {
12+
n := a.effectiveLimit(20)
13+
a.progressf("fetching %d latest stories...", n)
14+
stories, err := a.client.Latest(cmd.Context(), n)
15+
if err != nil {
16+
return mapFetchErr(err)
17+
}
18+
return a.renderOrEmpty(stories, len(stories))
19+
},
20+
}
21+
}

‎cli/cmd_search.go‎

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
package cli
2+
3+
import (
4+
"github.com/spf13/cobra"
5+
)
6+
7+
func (a *App) searchCmd() *cobra.Command {
8+
return &cobra.Command{
9+
Use: "search <query>",
10+
Short: "Search Hackernoon stories",
11+
Args: cobra.ExactArgs(1),
12+
RunE: func(cmd *cobra.Command, args []string) error {
13+
n := a.effectiveLimit(20)
14+
a.progressf("searching for %q...", args[0])
15+
stories, err := a.client.Search(cmd.Context(), args[0], n)
16+
if err != nil {
17+
return mapFetchErr(err)
18+
}
19+
return a.renderOrEmpty(stories, len(stories))
20+
},
21+
}
22+
}

‎cli/cmd_trending.go‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
package cli
2+
3+
import (
4+
"github.com/spf13/cobra"
5+
)
6+
7+
func (a *App) trendingCmd() *cobra.Command {
8+
return &cobra.Command{
9+
Use: "trending",
10+
Short: "Trending Hackernoon stories",
11+
RunE: func(cmd *cobra.Command, _ []string) error {
12+
n := a.effectiveLimit(20)
13+
a.progressf("fetching %d trending stories...", n)
14+
stories, err := a.client.Trending(cmd.Context(), n)
15+
if err != nil {
16+
return mapFetchErr(err)
17+
}
18+
return a.renderOrEmpty(stories, len(stories))
19+
},
20+
}
21+
}

‎cli/errors.go‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
package cli
2+
3+
import (
4+
"errors"
5+
6+
"github.com/tamnd/hackernoon-cli/hackernoon"
7+
)
8+
9+
func isNotFound(err error) bool {
10+
return errors.Is(err, hackernoon.ErrNotFound)
11+
}
12+
13+
func mapFetchErr(err error) error {
14+
if err == nil {
15+
return nil
16+
}
17+
if isNotFound(err) {
18+
return codeError(exitNoData, err)
19+
}
20+
return codeError(exitError, err)
21+
}

‎cli/root.go‎

Lines changed: 120 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,14 @@
22
package cli
33

44
import (
5+
"fmt"
6+
"io"
7+
"os"
8+
9+
term "github.com/charmbracelet/x/term"
510
"github.com/spf13/cobra"
11+
"github.com/tamnd/hackernoon-cli/hackernoon"
12+
"github.com/tamnd/hackernoon-cli/pkg/render"
613
)
714

815
// Build metadata, set via -ldflags at release time.
@@ -12,20 +19,128 @@ var (
1219
Date = "unknown"
1320
)
1421

22+
// exit codes.
23+
const (
24+
exitError = 1
25+
exitUsage = 2
26+
exitNoData = 3
27+
)
28+
29+
// ExitError carries a process exit code up to main.
30+
type ExitError struct {
31+
Code int
32+
Err error
33+
}
34+
35+
func (e *ExitError) Error() string {
36+
if e.Err != nil {
37+
return e.Err.Error()
38+
}
39+
return fmt.Sprintf("exit %d", e.Code)
40+
}
41+
42+
func (e *ExitError) Unwrap() error { return e.Err }
43+
44+
func codeError(code int, err error) error { return &ExitError{Code: code, Err: err} }
45+
46+
// App holds shared state threaded through every command.
47+
type App struct {
48+
client *hackernoon.Client
49+
cfg hackernoon.Config
50+
out io.Writer
51+
52+
output string
53+
fields []string
54+
noHeader bool
55+
template string
56+
limit int
57+
quiet bool
58+
}
59+
1560
// Root builds the root command and its subtree.
1661
func Root() *cobra.Command {
62+
app := &App{
63+
cfg: hackernoon.DefaultConfig(),
64+
out: os.Stdout,
65+
}
66+
1767
root := &cobra.Command{
1868
Use: "hn2",
1969
Short: "Browse Hackernoon tech stories",
20-
Long: `Browse Hackernoon tech stories
70+
Long: `hn2 reads Hackernoon via public RSS feeds — no API key required.
71+
It returns records as table, JSON, JSONL, CSV, TSV, or URLs.
2172
22-
This is a fresh scaffold. Add your commands here on top of the hackernoon
23-
library package, then wire them into Root with root.AddCommand.`,
73+
hn2 is an independent tool and is not affiliated with Hackernoon.`,
2474
SilenceUsage: true,
2575
SilenceErrors: true,
76+
PersistentPreRunE: func(cmd *cobra.Command, _ []string) error {
77+
return app.setup()
78+
},
2679
}
2780

28-
root.AddCommand(newVersionCmd())
29-
// TODO: root.AddCommand(newGetCmd()), etc.
81+
pf := root.PersistentFlags()
82+
pf.StringVarP(&app.output, "output", "o", "auto", "output: table|json|jsonl|csv|tsv|url|raw (auto=table on TTY, jsonl piped)")
83+
pf.StringSliceVar(&app.fields, "fields", nil, "comma-separated columns to include")
84+
pf.BoolVar(&app.noHeader, "no-header", false, "omit the header row in table/csv/tsv")
85+
pf.StringVar(&app.template, "template", "", "Go text/template applied per record")
86+
pf.IntVarP(&app.limit, "limit", "n", 0, "limit number of records (0 = command default)")
87+
pf.BoolVarP(&app.quiet, "quiet", "q", false, "suppress progress on stderr")
88+
89+
pf.StringVar(&app.cfg.BaseURL, "base-url", app.cfg.BaseURL, "Hackernoon base URL")
90+
pf.DurationVar(&app.cfg.Rate, "delay", app.cfg.Rate, "minimum spacing between requests")
91+
pf.DurationVar(&app.cfg.Timeout, "timeout", app.cfg.Timeout, "per-request timeout")
92+
pf.IntVar(&app.cfg.Retries, "retries", app.cfg.Retries, "retry attempts on 429/5xx")
93+
pf.StringVar(&app.cfg.UserAgent, "user-agent", app.cfg.UserAgent, "User-Agent sent with each request")
94+
95+
root.AddCommand(
96+
app.latestCmd(),
97+
app.searchCmd(),
98+
app.trendingCmd(),
99+
newVersionCmd(),
100+
)
30101
return root
31102
}
103+
104+
func (a *App) setup() error {
105+
if a.output == "" || a.output == "auto" {
106+
if term.IsTerminal(os.Stdout.Fd()) {
107+
a.output = string(render.FormatTable)
108+
} else {
109+
a.output = string(render.FormatJSONL)
110+
}
111+
}
112+
if !render.Format(a.output).Valid() {
113+
return codeError(exitUsage, fmt.Errorf("unknown output format %q", a.output))
114+
}
115+
a.client = hackernoon.NewClient(a.cfg)
116+
return nil
117+
}
118+
119+
func (a *App) render(records any) error {
120+
r := render.New(a.out, render.Format(a.output), a.fields, a.noHeader, a.template)
121+
return r.Render(records)
122+
}
123+
124+
func (a *App) renderOrEmpty(records any, n int) error {
125+
if err := a.render(records); err != nil {
126+
return err
127+
}
128+
if n == 0 {
129+
return codeError(exitNoData, nil)
130+
}
131+
return nil
132+
}
133+
134+
func (a *App) progressf(format string, args ...any) {
135+
if a.quiet {
136+
return
137+
}
138+
_, _ = fmt.Fprintf(os.Stderr, format+"\n", args...)
139+
}
140+
141+
func (a *App) effectiveLimit(def int) int {
142+
if a.limit > 0 {
143+
return a.limit
144+
}
145+
return def
146+
}

‎go.mod‎

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,3 +6,31 @@ require (
66
github.com/charmbracelet/fang v1.0.0
77
github.com/spf13/cobra v1.10.2
88
)
9+
10+
require (
11+
charm.land/lipgloss/v2 v2.0.0-beta.3.0.20251106193318-19329a3e8410 // indirect
12+
github.com/charmbracelet/colorprofile v0.3.3 // indirect
13+
github.com/charmbracelet/ultraviolet v0.0.0-20251106190538-99ea45596692 // indirect
14+
github.com/charmbracelet/x/ansi v0.11.0 // indirect
15+
github.com/charmbracelet/x/exp/charmtone v0.0.0-20250603201427-c31516f43444 // indirect
16+
github.com/charmbracelet/x/term v0.2.2 // indirect
17+
github.com/charmbracelet/x/termios v0.1.1 // indirect
18+
github.com/charmbracelet/x/windows v0.2.2 // indirect
19+
github.com/clipperhouse/displaywidth v0.4.1 // indirect
20+
github.com/clipperhouse/stringish v0.1.1 // indirect
21+
github.com/clipperhouse/uax29/v2 v2.3.0 // indirect
22+
github.com/inconshreveable/mousetrap v1.1.0 // indirect
23+
github.com/lucasb-eyer/go-colorful v1.3.0 // indirect
24+
github.com/mattn/go-runewidth v0.0.19 // indirect
25+
github.com/muesli/cancelreader v0.2.2 // indirect
26+
github.com/muesli/mango v0.1.0 // indirect
27+
github.com/muesli/mango-cobra v1.2.0 // indirect
28+
github.com/muesli/mango-pflag v0.1.0 // indirect
29+
github.com/muesli/roff v0.1.0 // indirect
30+
github.com/rivo/uniseg v0.4.7 // indirect
31+
github.com/spf13/pflag v1.0.9 // indirect
32+
github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e // indirect
33+
golang.org/x/sync v0.17.0 // indirect
34+
golang.org/x/sys v0.37.0 // indirect
35+
golang.org/x/text v0.24.0 // indirect
36+
)

‎go.sum‎

Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,72 @@
1+
charm.land/lipgloss/v2 v2.0.0-beta.3.0.20251106193318-19329a3e8410 h1:D9PbaszZYpB4nj+d6HTWr1onlmlyuGVNfL9gAi8iB3k=
2+
charm.land/lipgloss/v2 v2.0.0-beta.3.0.20251106193318-19329a3e8410/go.mod h1:1qZyvvVCenJO2M1ac2mX0yyiIZJoZmDM4DG4s0udJkU=
3+
github.com/aymanbagabas/go-udiff v0.3.1 h1:LV+qyBQ2pqe0u42ZsUEtPiCaUoqgA9gYRDs3vj1nolY=
4+
github.com/aymanbagabas/go-udiff v0.3.1/go.mod h1:G0fsKmG+P6ylD0r6N/KgQD/nWzgfnl8ZBcNLgcbrw8E=
5+
github.com/charmbracelet/colorprofile v0.3.3 h1:DjJzJtLP6/NZ8p7Cgjno0CKGr7wwRJGxWUwh2IyhfAI=
6+
github.com/charmbracelet/colorprofile v0.3.3/go.mod h1:nB1FugsAbzq284eJcjfah2nhdSLppN2NqvfotkfRYP4=
7+
github.com/charmbracelet/fang v1.0.0 h1:jESBY40agJOlLYnnv9jE0mLqDGTxEk0hkOnx7YGyRlQ=
8+
github.com/charmbracelet/fang v1.0.0/go.mod h1:P5/DNb9DddQ0Z0dbc0P3ol4/ix5Po7Ofr2KMBfAqoCo=
9+
github.com/charmbracelet/ultraviolet v0.0.0-20251106190538-99ea45596692 h1:r/3jQZ1LjWW6ybp8HHfhrKrwHIWiJhUuY7wwYIWZulQ=
10+
github.com/charmbracelet/ultraviolet v0.0.0-20251106190538-99ea45596692/go.mod h1:Y8B4DzWeTb0ama8l3+KyopZtkE8fZjwRQ3aEAPEXHE0=
11+
github.com/charmbracelet/x/ansi v0.11.0 h1:uuIVK7GIplwX6UBIz8S2TF8nkr7xRlygSsBRjSJqIvA=
12+
github.com/charmbracelet/x/ansi v0.11.0/go.mod h1:uQt8bOrq/xgXjlGcFMc8U2WYbnxyjrKhnvTQluvfCaE=
13+
github.com/charmbracelet/x/exp/charmtone v0.0.0-20250603201427-c31516f43444 h1:IJDiTgVE56gkAGfq0lBEloWgkXMk4hl/bmuPoicI4R0=
14+
github.com/charmbracelet/x/exp/charmtone v0.0.0-20250603201427-c31516f43444/go.mod h1:T9jr8CzFpjhFVHjNjKwbAD7KwBNyFnj2pntAO7F2zw0=
15+
github.com/charmbracelet/x/exp/golden v0.0.0-20250806222409-83e3a29d542f h1:pk6gmGpCE7F3FcjaOEKYriCvpmIN4+6OS/RD0vm4uIA=
16+
github.com/charmbracelet/x/exp/golden v0.0.0-20250806222409-83e3a29d542f/go.mod h1:IfZAMTHB6XkZSeXUqriemErjAWCCzT0LwjKFYCZyw0I=
17+
github.com/charmbracelet/x/term v0.2.2 h1:xVRT/S2ZcKdhhOuSP4t5cLi5o+JxklsoEObBSgfgZRk=
18+
github.com/charmbracelet/x/term v0.2.2/go.mod h1:kF8CY5RddLWrsgVwpw4kAa6TESp6EB5y3uxGLeCqzAI=
19+
github.com/charmbracelet/x/termios v0.1.1 h1:o3Q2bT8eqzGnGPOYheoYS8eEleT5ZVNYNy8JawjaNZY=
20+
github.com/charmbracelet/x/termios v0.1.1/go.mod h1:rB7fnv1TgOPOyyKRJ9o+AsTU/vK5WHJ2ivHeut/Pcwo=
21+
github.com/charmbracelet/x/windows v0.2.2 h1:IofanmuvaxnKHuV04sC0eBy/smG6kIKrWG2/jYn2GuM=
22+
github.com/charmbracelet/x/windows v0.2.2/go.mod h1:/8XtdKZzedat74NQFn0NGlGL4soHB0YQZrETF96h75k=
23+
github.com/clipperhouse/displaywidth v0.4.1 h1:uVw9V8UDfnggg3K2U84VWY1YLQ/x2aKSCtkRyYozfoU=
24+
github.com/clipperhouse/displaywidth v0.4.1/go.mod h1:R+kHuzaYWFkTm7xoMmK1lFydbci4X2CicfbGstSGg0o=
25+
github.com/clipperhouse/stringish v0.1.1 h1:+NSqMOr3GR6k1FdRhhnXrLfztGzuG+VuFDfatpWHKCs=
26+
github.com/clipperhouse/stringish v0.1.1/go.mod h1:v/WhFtE1q0ovMta2+m+UbpZ+2/HEXNWYXQgCt4hdOzA=
27+
github.com/clipperhouse/uax29/v2 v2.3.0 h1:SNdx9DVUqMoBuBoW3iLOj4FQv3dN5mDtuqwuhIGpJy4=
28+
github.com/clipperhouse/uax29/v2 v2.3.0/go.mod h1:Wn1g7MK6OoeDT0vL+Q0SQLDz/KpfsVRgg6W7ihQeh4g=
29+
github.com/cpuguy83/go-md2man/v2 v2.0.6/go.mod h1:oOW0eioCTA6cOiMLiUPZOpcVxMig6NIQQ7OS05n1F4g=
30+
github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
31+
github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
32+
github.com/inconshreveable/mousetrap v1.1.0 h1:wN+x4NVGpMsO7ErUn/mUI3vEoE6Jt13X2s0bqwp9tc8=
33+
github.com/inconshreveable/mousetrap v1.1.0/go.mod h1:vpF70FUmC8bwa3OWnCshd2FqLfsEA9PFc4w1p2J65bw=
34+
github.com/lucasb-eyer/go-colorful v1.3.0 h1:2/yBRLdWBZKrf7gB40FoiKfAWYQ0lqNcbuQwVHXptag=
35+
github.com/lucasb-eyer/go-colorful v1.3.0/go.mod h1:R4dSotOR9KMtayYi1e77YzuveK+i7ruzyGqttikkLy0=
36+
github.com/mattn/go-runewidth v0.0.19 h1:v++JhqYnZuu5jSKrk9RbgF5v4CGUjqRfBm05byFGLdw=
37+
github.com/mattn/go-runewidth v0.0.19/go.mod h1:XBkDxAl56ILZc9knddidhrOlY5R/pDhgLpndooCuJAs=
38+
github.com/muesli/cancelreader v0.2.2 h1:3I4Kt4BQjOR54NavqnDogx/MIoWBFa0StPA8ELUXHmA=
39+
github.com/muesli/cancelreader v0.2.2/go.mod h1:3XuTXfFS2VjM+HTLZY9Ak0l6eUKfijIfMUZ4EgX0QYo=
40+
github.com/muesli/mango v0.1.0 h1:DZQK45d2gGbql1arsYA4vfg4d7I9Hfx5rX/GCmzsAvI=
41+
github.com/muesli/mango v0.1.0/go.mod h1:5XFpbC8jY5UUv89YQciiXNlbi+iJgt29VDC5xbzrLL4=
42+
github.com/muesli/mango-cobra v1.2.0 h1:DQvjzAM0PMZr85Iv9LIMaYISpTOliMEg+uMFtNbYvWg=
43+
github.com/muesli/mango-cobra v1.2.0/go.mod h1:vMJL54QytZAJhCT13LPVDfkvCUJ5/4jNUKF/8NC2UjA=
44+
github.com/muesli/mango-pflag v0.1.0 h1:UADqbYgpUyRoBja3g6LUL+3LErjpsOwaC9ywvBWe7Sg=
45+
github.com/muesli/mango-pflag v0.1.0/go.mod h1:YEQomTxaCUp8PrbhFh10UfbhbQrM/xJ4i2PB8VTLLW0=
46+
github.com/muesli/roff v0.1.0 h1:YD0lalCotmYuF5HhZliKWlIx7IEhiXeSfq7hNjFqGF8=
47+
github.com/muesli/roff v0.1.0/go.mod h1:pjAHQM9hdUUwm/krAfrLGgJkXJ+YuhtsfZ42kieB2Ig=
48+
github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
49+
github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
50+
github.com/rivo/uniseg v0.4.7 h1:WUdvkW8uEhrYfLC4ZzdpI2ztxP1I582+49Oc5Mq64VQ=
51+
github.com/rivo/uniseg v0.4.7/go.mod h1:FN3SvrM+Zdj16jyLfmOkMNblXMcoc8DfTHruCPUcx88=
52+
github.com/russross/blackfriday/v2 v2.1.0/go.mod h1:+Rmxgy9KzJVeS9/2gXHxylqXiyQDYRxCVz55jmeOWTM=
53+
github.com/spf13/cobra v1.10.2 h1:DMTTonx5m65Ic0GOoRY2c16WCbHxOOw6xxezuLaBpcU=
54+
github.com/spf13/cobra v1.10.2/go.mod h1:7C1pvHqHw5A4vrJfjNwvOdzYu0Gml16OCs2GRiTUUS4=
55+
github.com/spf13/pflag v1.0.9 h1:9exaQaMOCwffKiiiYk6/BndUBv+iRViNW+4lEMi0PvY=
56+
github.com/spf13/pflag v1.0.9/go.mod h1:McXfInJRrz4CZXVZOBLb0bTZqETkiAhM9Iw0y3An2Bg=
57+
github.com/stretchr/testify v1.10.0 h1:Xv5erBjTwe/5IxqUQTdXv5kgmIvbHo3QQyRwhJsOfJA=
58+
github.com/stretchr/testify v1.10.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY=
59+
github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e h1:JVG44RsyaB9T2KIHavMF/ppJZNG9ZpyihvCd0w101no=
60+
github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e/go.mod h1:RbqR21r5mrJuqunuUZ/Dhy/avygyECGrLceyNeo4LiM=
61+
go.yaml.in/yaml/v3 v3.0.4/go.mod h1:DhzuOOF2ATzADvBadXxruRBLzYTpT36CKvDb3+aBEFg=
62+
golang.org/x/exp v0.0.0-20231006140011-7918f672742d h1:jtJma62tbqLibJ5sFQz8bKtEM8rJBtfilJ2qTU199MI=
63+
golang.org/x/exp v0.0.0-20231006140011-7918f672742d/go.mod h1:ldy0pHrwJyGW56pPQzzkH36rKxoZW1tw7ZJpeKx+hdo=
64+
golang.org/x/sync v0.17.0 h1:l60nONMj9l5drqw6jlhIELNv9I0A4OFgRsG9k2oT9Ug=
65+
golang.org/x/sync v0.17.0/go.mod h1:9KTHXmSnoGruLpwFjVSX0lNNA75CykiMECbovNTZqGI=
66+
golang.org/x/sys v0.37.0 h1:fdNQudmxPjkdUTPnLn5mdQv7Zwvbvpaxqs831goi9kQ=
67+
golang.org/x/sys v0.37.0/go.mod h1:OgkHotnGiDImocRcuBABYBEXf8A9a87e/uXjp9XT3ks=
68+
golang.org/x/text v0.24.0 h1:dd5Bzh4yt5KYA8f9CJHCP4FB4D51c2c6JvN37xJJkJ0=
69+
golang.org/x/text v0.24.0/go.mod h1:L8rBsPeo2pSS+xqN0d5u2ikmjtmoJbDBT1b7nHvFCdU=
70+
gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
71+
gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
72+
gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=

0 commit comments

Comments
 (0)