hackernews-tui 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 5ee2d5fd17591b63f01af5c2afcd4444a2ba60a634e5416bbd81d086869afa70
+  data.tar.gz: 948b7b8bd56b8e634c04921b5137724cbc017a2ffc4594c4d27be8d17f9e9711
+SHA512:
+  metadata.gz: 44ef23cc5c9c021a430b60702cd829f9b6e248a45a027341f47a47221638017ae0d69124f02935447620322af0d3f771ae351df9426143f3b19ce21880363e85
+  data.tar.gz: d17b3d34810941fd7d306e78d8e99d2159117dc6de6785645ddade5218fe4d59c84348c7b8c6fc4250cdb1d0c0afc1189c892a8df7b60b47351cb3cdd09e709b

data/README.md

@@ -0,0 +1,75 @@
+# Hackernews
+
+A terminal-based UI for reading Hacker News, built with Charming.
+
+Browse top, new, best, ask HN, show HN, and jobs feeds from your terminal. Open articles inline, navigate with a familiar Vim-inspired keyboard layout, and style it with any of the built-in Charming themes.
+
+## Features
+
+- **6 feed tabs** — Top, New, Best, Ask HN, Show HN, Jobs
+- **Story cards** with rank, score, domain, author, and comment count
+- **Inline article reading** — fetches full article text via trafilatura for CLI-based extraction
+- **Async background loading** — feeds load in parallel threads without blocking the interface
+- **Vim-inspired navigation** — j/k keys mapped to down/up, page up/down for big jumps
+- **Theme support** — all Charming built-in themes are available out of the box, Phosphor by default
+
+## Installation
+
+```sh
+gem install hackernews-tui
+```
+
+Or use it locally:
+
+```sh
+git clone https://github.com/lbpdevcodes/hackernews.git
+cd hackernews
+bundle install
+bundle exec hackernews
+```
+
+### System dependency
+
+Article extraction requires [trafilatura](https://github.com/adverb-xyz/trafilatura) to be installed and on your PATH.
+
+## Usage
+
+```sh
+hackernews
+# or
+bundle exec hackernews
+```
+
+### Keyboard shortcuts
+
+| Key           | Action                  |
+|-------------|-------------------------|
+| j / Down     | Move cursor down        |
+| k / Up       | Move cursor up          |
+| Page up      | Jump 10 items up        |
+| Page down    | Jump 10 items down      |
+| n / Right    | Next page of stories    |
+| Left         | Previous page           |
+| Enter        | Open selected article   |
+| Escape       | Close article, return to feed |
+| r            | Refresh current feed    |
+
+## Architecture
+
+- **State** — `HomeState` manages local state: stories by page, feed index, article cache, loading indicators
+- **Controllers** — `HomeController` coordinates data fetching from the Firebase API and article extraction
+- **Views** — Ruby view classes under `app/views`
+- **Components** — reusable widgets like `StoryListComponent` that handle their own rendering
+
+Key libraries: Charming (UI framework), HTTParty (HTTP client), Zeitwerk (auto-loading).
+
+## Development
+
+```sh
+rspec         # run tests
+rake          # all gem tasks
+```
+
+## License
+
+TODO: Add license information.

data/app/components/app_frame_component.rb

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+
+module Hackernews
+  class AppFrameComponent < Charming::Component
+    def render
+      column(*lines, gap: 1)
+    end
+
+    private
+
+    def lines
+      output = [title_line]
+      output << status_line if home.error.to_s.strip != ""
+      output << activity_line if home.working?
+      output << content_line
+      output << help_line
+      output
+    end
+
+    def title_line
+      text "#{home.title} / #{feed_title}", style: theme.title
+    end
+
+    def status_line
+      text home.error, style: theme.warn
+    end
+
+    def activity_line
+      render_component(Charming::Components::ActivityIndicator.new(
+        width: 24,
+        label: home.loading_label.to_s,
+        index: home.activity_index,
+        seed: "hackernews-loading",
+        label_style: theme.muted,
+        max_width: content_width,
+        fallback_label: "Working"
+      ))
+    end
+
+    def content_line
+      if home.reading?
+        article_view
+      else
+        render_component(StoryListComponent.new(home: home, width: content_width, height: content_height, theme: theme))
+      end
+    end
+
+    def article_view
+      article = home.article || {}
+      header = text(article.fetch(:url, ""), style: theme.muted)
+      markdown = Charming::Components::Markdown.new(
+        content: article.fetch(:markdown, ""),
+        width: content_width,
+        theme: theme,
+        base_url: article.fetch(:url, nil)
+      )
+      body = render_component(Charming::Components::Viewport.new(
+        content: markdown,
+        width: content_width,
+        height: [content_height - 2, 1].max,
+        offset: home.article_scroll,
+        wrap: true
+      ))
+      column(header, body)
+    end
+
+    def help_line
+      text help_text, style: theme.muted
+    end
+
+    def help_text
+      if home.reading?
+        "j/k scroll, pgup/pgdn jump, esc back. p commands, q quit."
+      else
+        "j/k move, enter read, r refresh, left/right page. p commands, q quit."
+      end
+    end
+
+    def feed_title
+      HomeController::FEEDS.fetch(home.feed).fetch(:title)
+    end
+
+    def content_width
+      if screen.narrow?(below: 72, min_height: 20)
+        [screen.width - 12, 20].max
+      else
+        [screen.width - 42, 20].max
+      end
+    end
+
+    def content_height
+      [screen.height - 12, 5].max
+    end
+  end
+end

data/app/components/story_list_component.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+module Hackernews
+  class StoryListComponent < Charming::Component
+    def render
+      return empty_state if home.current_stories.empty?
+
+      column(*story_lines, footer_line, gap: 1)
+    end
+
+    private
+
+    def empty_state
+      message = if home.loading
+        ""
+      elsif home.error.to_s.strip != ""
+        "Press r to retry."
+      else
+        "No stories loaded. Press r to refresh."
+      end
+
+      text message, style: theme.muted
+    end
+
+    def story_lines
+      visible_stories.each_with_index.map do |story, index|
+        absolute_index = viewport_start + index
+        rank = (home.page * Client::DEFAULT_PER_PAGE) + absolute_index + 1
+        title = "#{rank}. #{story.title}"
+        title += " (#{story.domain})" unless story.domain.empty?
+        meta = "   #{story.score} points by #{story.by} | #{story.descendants} comments"
+        line = "#{title}\n#{meta}"
+        absolute_index == home.selected_index ? text(line, style: theme.selected) : text(line)
+      end
+    end
+
+    def footer_line
+      text footer_text, style: theme.muted
+    end
+
+    def footer_text
+      total = home.current_story_ids.length
+      loaded = home.current_stories.length
+      page = home.page + 1
+      return "Page #{page} | #{loaded} loaded" if total.zero?
+
+      "Page #{page}/#{page_count(total)} | #{loaded} loaded on this page | #{total} ids cached"
+    end
+
+    def visible_stories
+      home.current_stories.slice(viewport_start, viewport_height) || []
+    end
+
+    def viewport_start
+      (home.selected_index - viewport_height + 1).clamp(0, max_viewport_start)
+    end
+
+    def viewport_height
+      [height.to_i / 3, 1].max
+    end
+
+    def max_viewport_start
+      [home.current_stories.length - viewport_height, 0].max
+    end
+
+    def page_count(total)
+      (total.to_f / Client::DEFAULT_PER_PAGE).ceil
+    end
+  end
+end

data/app/controllers/application_controller.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module Hackernews
+  class ApplicationController < Charming::Controller
+    include Charming::Shell::Sidebar
+    include Charming::Shell::Palette
+
+    layout Layouts::ApplicationLayout
+    focus_ring :content, :sidebar
+
+    key "p", :open_command_palette, scope: :global
+    key "q", :quit, scope: :global
+
+    command "Top" do
+      navigate :root
+    end
+
+    command "New" do
+      navigate :new
+    end
+
+    command "Best" do
+      navigate :best
+    end
+
+    command "Ask HN" do
+      navigate :ask
+    end
+
+    command "Show HN" do
+      navigate :show
+    end
+
+    command "Jobs" do
+      navigate :jobs
+    end
+
+    command "Theme", :open_theme_palette
+    command "Close palette", :close_command_palette
+    command "Quit app", :quit
+  end
+end

data/app/controllers/home_controller.rb

@@ -0,0 +1,257 @@
+# frozen_string_literal: true
+
+module Hackernews
+  class HomeController < ApplicationController
+    FEEDS = {
+      "top" => {title: "Top Stories", screen: :root},
+      "new" => {title: "New", screen: :new},
+      "best" => {title: "Best", screen: :best},
+      "ask" => {title: "Ask HN", screen: :ask},
+      "show" => {title: "Show HN", screen: :show},
+      "jobs" => {title: "Jobs", screen: :jobs}
+    }.freeze
+
+    key "r", :refresh
+    key "up", :move_up
+    key "k", :move_up
+    key "down", :move_down
+    key "j", :move_down
+    key "page_up", :page_up
+    key "page_down", :page_down
+    key "left", :previous_page
+    key "right", :next_page
+    key "n", :next_page
+    key "enter", :open_selected_story
+    key "escape", :close_article
+
+    timer :activity, every: 0.12, action: :tick_activity
+    on_task :load_feed, action: :load_feed_done
+    on_task :extract_article, action: :extract_article_done
+
+    def show
+      ensure_feed_loaded
+      render :show, home: home, palette: command_palette
+    end
+
+    def new
+      switch_feed("new")
+    end
+
+    def best
+      switch_feed("best")
+    end
+
+    def ask
+      switch_feed("ask")
+    end
+
+    def show_hn
+      switch_feed("show")
+    end
+
+    def jobs
+      switch_feed("jobs")
+    end
+
+    def refresh
+      key = home.page_key
+      home.stories_by_page.delete(key)
+      home.story_ids_by_feed.delete(home.feed)
+      home.failed_pages.delete(key)
+      start_feed_load(force: true)
+      render :show, home: home, palette: command_palette
+    end
+
+    def tick_activity
+      home.activity_index += 1 if home.working?
+      show
+    end
+
+    def load_feed_done
+      value = event.value || {}
+      feed = value[:feed] || home.feed
+      page = value[:page] || home.page
+      key = home.page_key(feed, page)
+      current_page = feed == home.feed && page == home.page
+
+      if value[:error]
+        home.error = value[:error]
+        home.failed_pages[key] = true
+      else
+        home.error = ""
+        home.failed_pages.delete(key)
+        home.story_ids_by_feed[value.fetch(:feed)] = value.fetch(:ids)
+        home.stories_by_page[key] = value.fetch(:stories)
+        home.selected_index = 0 if current_page
+      end
+
+      if home.loading_key == key || current_page
+        home.loading = false
+        home.loading_key = nil
+      end
+
+      show
+    end
+
+    def extract_article_done
+      value = event.value || {}
+      story_id = value[:story_id].to_i
+      home.extracting_story_id = nil if home.extracting_story_id.to_i == story_id
+
+      if value[:error]
+        home.error = value[:error]
+      else
+        home.error = ""
+        home.articles_by_story_id[story_id] = value.fetch(:article)
+        home.reading_story_id = story_id
+        home.article_scroll = 0
+      end
+
+      show
+    end
+
+    def move_up
+      if home.reading?
+        home.article_scroll = [home.article_scroll - 1, 0].max
+      else
+        home.selected_index = [home.selected_index - 1, 0].max
+      end
+      show
+    end
+
+    def move_down
+      if home.reading?
+        home.article_scroll += 1
+      else
+        max = [home.current_stories.length - 1, 0].max
+        home.selected_index = [home.selected_index + 1, max].min
+      end
+      show
+    end
+
+    def page_up
+      if home.reading?
+        home.article_scroll = [home.article_scroll - 10, 0].max
+      else
+        home.selected_index = [home.selected_index - 10, 0].max
+      end
+      show
+    end
+
+    def page_down
+      if home.reading?
+        home.article_scroll += 10
+      else
+        max = [home.current_stories.length - 1, 0].max
+        home.selected_index = [home.selected_index + 10, max].min
+      end
+      show
+    end
+
+    def previous_page
+      return show if home.reading?
+      return show if home.page.to_i <= 0
+
+      home.page -= 1
+      home.reset_list_position
+      show
+    end
+
+    def next_page
+      return show if home.reading?
+      return show unless more_pages?
+
+      home.page += 1
+      home.reset_list_position
+      show
+    end
+
+    def open_selected_story
+      story = home.selected_story
+      return show unless story
+
+      if home.articles_by_story_id.key?(story.id)
+        home.reading_story_id = story.id
+        home.article_scroll = 0
+      elsif story.url.to_s.strip.empty?
+        home.articles_by_story_id[story.id] = {url: story.article_url, markdown: story.hn_markdown}
+        home.reading_story_id = story.id
+        home.article_scroll = 0
+      else
+        start_article_extract(story)
+      end
+
+      show
+    end
+
+    def close_article
+      home.reading_story_id = nil
+      home.article_scroll = 0
+      show
+    end
+
+    def current_route?(route)
+      route.name == FEEDS.fetch(home.feed).fetch(:screen)
+    end
+
+    private
+
+    def home
+      state(:home, HomeState)
+    end
+
+    def switch_feed(feed)
+      home.feed = feed
+      home.page = 0
+      home.error = ""
+      home.reset_list_position
+      show
+    end
+
+    def ensure_feed_loaded
+      return if home.cached_page? || home.failed_page?
+
+      start_feed_load
+    end
+
+    def start_feed_load(force: false)
+      key = home.page_key
+      return if home.loading_key == key
+      return if home.cached_page? && !force
+
+      feed = home.feed
+      page = home.page
+      home.loading = true
+      home.loading_key = key
+      home.loading_label = "Loading #{FEEDS.fetch(feed).fetch(:title)}"
+      home.error = ""
+
+      run_task(:load_feed, with: {feed: feed, page: page}) do |ctx|
+        Client.new.stories(feed: ctx[:feed], page: ctx[:page])
+      rescue StandardError => e
+        {feed: ctx[:feed], page: ctx[:page], error: e.message}
+      end
+    end
+
+    def start_article_extract(story)
+      return if home.extracting_story_id.to_i == story.id
+
+      home.extracting_story_id = story.id
+      home.loading_label = "Extracting article"
+      home.error = ""
+
+      run_task(:extract_article, with: {story: story}) do |ctx|
+        {story_id: ctx[:story].id, article: ArticleExtractor.new.extract(ctx[:story].url)}
+      rescue StandardError => e
+        {story_id: ctx[:story].id, error: e.message}
+      end
+    end
+
+    def more_pages?
+      ids = home.current_story_ids
+      return true if ids.empty?
+
+      (home.page + 1) * Client::DEFAULT_PER_PAGE < ids.length
+    end
+  end
+end

data/app/state/application_state.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module Hackernews
+  class ApplicationState < Charming::ApplicationState
+  end
+end

data/app/state/home_state.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module Hackernews
+  class HomeState < ApplicationState
+    attribute :title, :string, default: "Hackernews"
+    attribute :feed, :string, default: "top"
+    attribute :page, :integer, default: 0
+    attribute :selected_index, :integer, default: 0
+    attribute :loading, :boolean, default: false
+    attribute :loading_label, :string, default: ""
+    attribute :error, :string, default: ""
+    attribute :activity_index, :integer, default: 0
+    attribute :reading_story_id, :integer
+    attribute :article_scroll, :integer, default: 0
+
+    attr_accessor :story_ids_by_feed, :stories_by_page, :articles_by_story_id,
+      :failed_pages, :loading_key, :extracting_story_id
+
+    def initialize(**attributes)
+      super
+      @story_ids_by_feed = {}
+      @stories_by_page = {}
+      @articles_by_story_id = {}
+      @failed_pages = {}
+    end
+
+    def page_key(feed_name = feed, page_number = page)
+      "#{feed_name}:#{page_number.to_i}"
+    end
+
+    def current_stories
+      stories_by_page.fetch(page_key, [])
+    end
+
+    def current_story_ids
+      story_ids_by_feed.fetch(feed, [])
+    end
+
+    def cached_page?
+      stories_by_page.key?(page_key)
+    end
+
+    def failed_page?
+      failed_pages[page_key]
+    end
+
+    def selected_story
+      current_stories[selected_index]
+    end
+
+    def selected_story=(story)
+      self.selected_index = current_stories.index(story) || 0
+    end
+
+    def article
+      articles_by_story_id[reading_story_id]
+    end
+
+    def reading?
+      reading_story_id.to_i.positive?
+    end
+
+    def working?
+      (loading && !cached_page?) || extracting_story_id.to_i.positive?
+    end
+
+    def reset_list_position
+      self.selected_index = 0
+      self.article_scroll = 0
+      self.reading_story_id = nil
+    end
+  end
+end

data/app/views/home/show_view.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Hackernews
+  module Home
+    class ShowView < Charming::View
+      def render
+        render_component AppFrameComponent.new(home: home, screen: screen, theme: theme)
+      end
+    end
+  end
+end

data/app/views/layouts/application_layout.rb

@@ -0,0 +1,127 @@
+# frozen_string_literal: true
+
+module Hackernews
+  module Layouts
+    class ApplicationLayout < Charming::View
+      def render
+        modal = command_palette_modal
+
+        screen_layout(background: theme.background) do
+          split(narrow? ? :vertical : :horizontal, gap: 1) do
+            pane(:sidebar, **sidebar_options, border: :rounded, padding: [1, 2], style: sidebar_style) do
+              column(app_title, navigation, shortcuts, gap: 1)
+            end
+
+            pane(:content, grow: 1, border: :rounded, padding: [1, 2], style: content_style) do
+              yield_content
+            end
+          end
+
+          overlay modal if modal
+        end
+      end
+
+      private
+
+      def palette_component
+        assigns.fetch(:palette, nil)
+      end
+
+      def narrow?
+        screen.narrow?(below: 72, min_height: 20)
+      end
+
+      def sidebar_options
+        narrow? ? {height: sidebar_outer_height} : {width: sidebar_outer_width}
+      end
+
+      def sidebar_outer_width
+        sidebar_inner_width + 6
+      end
+
+      def sidebar_outer_height
+        sidebar_routes.length + 10
+      end
+
+      def sidebar_inner_width
+        narrow? ? [screen.width - 6, 20].max : 22
+      end
+
+      def app_title
+        text "Hackernews", style: theme.header_accent.align(:center).width(sidebar_inner_width)
+      end
+
+      def navigation
+        column(*nav_items)
+      end
+
+      def nav_items
+        sidebar_routes.each_with_index.map do |route, index|
+          text nav_item_label(route, index), style: nav_item_style(route, index)
+        end
+      end
+
+      def nav_item_label(route, index)
+        cursor = (sidebar_focused? && index == sidebar_index) ? ">" : " "
+        active = current_route?(route) ? "●" : " "
+        "#{cursor} #{active} #{route.title}"
+      end
+
+      def nav_item_style(route, index)
+        if sidebar_focused? && index == sidebar_index
+          theme.selected
+        elsif current_route?(route)
+          theme.title
+        else
+          theme.muted
+        end
+      end
+
+      def shortcuts
+        text "tab focus\np commands\nq quit", style: theme.muted
+      end
+
+      def sidebar_style
+        panel_style(sidebar_focused?)
+      end
+
+      def content_style
+        panel_style(content_focused?)
+      end
+
+      def panel_style(focused)
+        style = focused ? theme.title : theme.border
+        palette_component ? style.faint : style
+      end
+
+      def command_palette_modal
+        return unless palette_component
+
+        render_component Charming::Components::CommandPaletteModal.new(
+          content: palette_component,
+          theme: theme
+        )
+      end
+
+      def sidebar_focused?
+        controller.sidebar_focused?
+      end
+
+      def content_focused?
+        controller.content_focused?
+      end
+
+      def sidebar_index
+        controller.sidebar_index
+      end
+
+      def sidebar_routes
+        controller.sidebar_routes
+      end
+
+      def current_route?(route)
+        controller.current_route?(route)
+      end
+    end
+  end
+end

data/config/routes.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+Hackernews::Application.routes do
+  root "home#show", title: "Top"
+  screen :new, "home#new", title: "New"
+  screen :best, "home#best", title: "Best"
+  screen :ask, "home#ask", title: "Ask HN"
+  screen :show, "home#show_hn", title: "Show HN"
+  screen :jobs, "home#jobs", title: "Jobs"
+end

data/exe/hackernews

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "bundler/setup"
+require "hackernews"
+
+Charming.run(Hackernews::Application.new)

data/lib/hackernews/application.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Hackernews
+  class Application < Charming::Application
+    root File.expand_path("../..", __dir__)
+
+    Charming::UI::Theme.built_in_names.each do |theme_name|
+      theme theme_name.to_sym, built_in: theme_name
+    end
+
+    default_theme :phosphor
+  end
+end

data/lib/hackernews/article_extractor.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require "open3"
+require "timeout"
+
+module Hackernews
+  class ArticleExtractor
+    COMMAND = "trafilatura"
+    TIMEOUT = 30
+
+    def extract(url)
+      url = url.to_s.strip
+      raise ArgumentError, "story has no article URL" if url.empty?
+
+      stdout, stderr, status = Timeout.timeout(TIMEOUT) do
+        Open3.capture3(COMMAND, "--markdown", "--images", "--no-comments", "--no-tables", "-u", url)
+      end
+
+      unless status.success?
+        message = stderr.strip.empty? ? stdout.strip : stderr.strip
+        raise "trafilatura extraction failed: #{message}"
+      end
+
+      markdown = stdout.strip
+      raise "trafilatura did not find readable article content" if markdown.empty?
+
+      {url: url, markdown: markdown}
+    rescue Errno::ENOENT
+      raise "trafilatura is required. Install it separately and ensure `trafilatura` is on PATH."
+    rescue Timeout::Error
+      raise "article extraction timed out"
+    end
+  end
+end

data/lib/hackernews/client.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+require "httparty"
+require "thread"
+
+module Hackernews
+  class Client
+    include HTTParty
+
+    FEEDS = {
+      "top" => "topstories",
+      "new" => "newstories",
+      "best" => "beststories",
+      "ask" => "askstories",
+      "show" => "showstories",
+      "jobs" => "jobstories"
+    }.freeze
+
+    DEFAULT_LIMIT = 500
+    DEFAULT_PER_PAGE = 30
+    DEFAULT_CONCURRENCY = 8
+
+    base_uri "https://hacker-news.firebaseio.com/v0"
+
+    def initialize(per_page: DEFAULT_PER_PAGE, limit: DEFAULT_LIMIT, concurrency: DEFAULT_CONCURRENCY)
+      @per_page = per_page
+      @limit = limit
+      @concurrency = concurrency
+    end
+
+    def stories(feed:, page: 0)
+      feed = feed.to_s
+      ids = story_ids(feed).first(limit)
+      page_ids = ids.slice(page.to_i * per_page, per_page) || []
+
+      {
+        feed: feed,
+        page: page.to_i,
+        ids: ids,
+        stories: stories_for_ids(page_ids)
+      }
+    end
+
+    def story_ids(feed)
+      endpoint = FEEDS.fetch(feed.to_s) { FEEDS.fetch("top") }
+      fetch_json("/#{endpoint}.json")
+    end
+
+    def item(id)
+      Story.from_hash(fetch_json("/item/#{id}.json"))
+    end
+
+    private
+
+    attr_reader :per_page, :limit, :concurrency
+
+    def stories_for_ids(ids)
+      return [] if ids.empty?
+
+      work = Queue.new
+      ids.each_with_index { |id, index| work << [index, id] }
+      stories = Array.new(ids.length)
+      errors = Queue.new
+
+      [concurrency, ids.length].min.times.map do
+        Thread.new do
+          loop do
+            index, id = work.pop(true)
+            story = item(id)
+            stories[index] = story if story&.readable?
+          rescue ThreadError
+            break
+          rescue StandardError => e
+            errors << e
+            break
+          end
+        end
+      end.each(&:join)
+
+      raise errors.pop unless errors.empty?
+
+      stories.compact
+    end
+
+    def fetch_json(path)
+      response = self.class.get(path, timeout: 10)
+      raise "Hacker News API returned #{response.code}" unless response.success?
+
+      response.parsed_response
+    end
+  end
+end

data/lib/hackernews/story.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+require "cgi"
+require "uri"
+
+module Hackernews
+  Story = Data.define(:id, :type, :by, :time, :title, :url, :score, :descendants, :text) do
+    def self.from_hash(hash)
+      return unless hash
+
+      new(
+        id: hash.fetch("id", nil),
+        type: hash.fetch("type", nil),
+        by: hash.fetch("by", ""),
+        time: hash.fetch("time", 0).to_i,
+        title: hash.fetch("title", "Untitled"),
+        url: hash.fetch("url", ""),
+        score: hash.fetch("score", 0).to_i,
+        descendants: hash.fetch("descendants", 0).to_i,
+        text: hash.fetch("text", "")
+      )
+    end
+
+    def readable?
+      %w[story job poll].include?(type)
+    end
+
+    def article_url
+      url.to_s.strip.empty? ? "https://news.ycombinator.com/item?id=#{id}" : url
+    end
+
+    def domain
+      return "news.ycombinator.com" if url.to_s.strip.empty?
+
+      URI.parse(url).hostname.to_s.delete_prefix("www.")
+    rescue URI::InvalidURIError
+      ""
+    end
+
+    def hn_markdown
+      body = CGI.unescapeHTML(text.to_s)
+      body = body.gsub("<p>", "\n\n")
+      body = body.gsub("<pre><code>", "\n\n```")
+      body = body.gsub("</code></pre>", "```\n\n")
+      "# #{title}\n\n#{body}"
+    end
+  end
+end

data/lib/hackernews/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Hackernews
+  VERSION = "0.1.1"
+end

data/lib/hackernews.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require "charming"
+require "zeitwerk"
+
+module Hackernews
+end
+
+loader = Zeitwerk::Loader.new
+loader.tag = "hackernews"
+loader.inflector.inflect("version" => "VERSION")
+loader.push_dir(File.expand_path("hackernews", __dir__), namespace: Hackernews)
+loader.push_dir(File.expand_path("../app/state", __dir__), namespace: Hackernews)
+loader.push_dir(File.expand_path("../app/components", __dir__), namespace: Hackernews)
+loader.push_dir(File.expand_path("../app/views", __dir__), namespace: Hackernews)
+loader.push_dir(File.expand_path("../app/controllers", __dir__), namespace: Hackernews)
+loader.setup
+
+require_relative "../config/routes"

metadata

@@ -0,0 +1,98 @@
+--- !ruby/object:Gem::Specification
+name: hackernews-tui
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- lbpdevcodes
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: charming
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.4.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.4.0
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+email:
+- info@lbp.dev
+executables:
+- hackernews
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- app/components/app_frame_component.rb
+- app/components/story_list_component.rb
+- app/controllers/application_controller.rb
+- app/controllers/home_controller.rb
+- app/state/application_state.rb
+- app/state/home_state.rb
+- app/views/home/show_view.rb
+- app/views/layouts/application_layout.rb
+- config/routes.rb
+- exe/hackernews
+- lib/hackernews.rb
+- lib/hackernews/application.rb
+- lib/hackernews/article_extractor.rb
+- lib/hackernews/client.rb
+- lib/hackernews/story.rb
+- lib/hackernews/version.rb
+licenses: []
+metadata:
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 4.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.16
+specification_version: 4
+summary: A Charming terminal user interface.
+test_files: []