gemview 1.0.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ad8aeeac9963c5eb52cb650708827b9a25a223bfa4597af3466142700e51850b
-  data.tar.gz: efdbcb9c871e4462e2e216adf675c9ba2b3373616f6494f60208c9ec39b6f8d3
+  metadata.gz: 8629621d995d5e02e26408fe60b949ab64154916223d615ace7fe9a4b76afc3f
+  data.tar.gz: 9f1d30fcdae52a7a465fb993f16a298ac17cbdd09362c114b7c98f5c47babeb8
 SHA512:
-  metadata.gz: c997980d1fca42aa4bb49a1f7d43443591907d04f3c20f93a6b72f045a77a8a49a9b85499cd3152b6ccbb349324417dd91be9323b78e57aa1b2825905504b5d8
-  data.tar.gz: deec958df2e6515729a091d3f073df221297c01562ae2af1de65b787a566c7b46dde6d3260aa5bbf6063c3978982a225f259a2e3ff27135e4227c59c392a4535
+  metadata.gz: 58e9f2b048c6a20bd354d296709a28b3ecea843dbafb6b80f29ef4ffe9532d01fd5db4fadf01c0b2be0dd2457212c44d33395c1a6c667128f10e93d4ff0fea29
+  data.tar.gz: 1c28c79d4349727a7eb54be5a46ab865d3784b9b8277a31e5ce88063e69eaddd1f9459f46df522b9963a04b68e3805d870b5e65b165f303f0eced79bea2be344

data/CHANGELOG.md

@@ -1,5 +1,23 @@
 ## [Unreleased]
 
+## [1.2.0] - 2025-08-30
+
+- Add prompt message to pager
+- Add navigation section to the readme
+
+- Remove table from info pages
+
+## [1.1.0] - 2025-08-16
+
+- Add better support for showing the changelog
+- Add ability to sort search results by total and version downloads
+- Add ruby version to gem version output
+- Add ability to disable readme and changelog viewing if they are unreachable
+- Add support for Codeberg readmes and changelogs (before only Github and Gitlab were supported)
+
+- Change pager to align TUI at the top of the screen
+- Change default pager to use less for consistent paging
+
 ## [1.0.0] - 2024-12-08
 
 - Initial release

data/README.md

@@ -1,6 +1,8 @@
 # Gemview
 
-An unofficial CLI interface for querying information from rubygems.org. It uses the [gems](https://rubygems.org/gems/gems) gem internally.
+[![Gem Version](https://badge.fury.io/rb/gemview.svg)](https://badge.fury.io/rb/gemview)
+
+An unofficial TUI interface for querying information from rubygems.org. It uses the [gems](https://rubygems.org/gems/gems) gem internally. It requires the presence of the `less` pager and is tested on macOS and Linux.
 
 Note: This gem is not directly affiliated with `rubygems.org`. It's just a hobby project.
 
@@ -16,10 +18,22 @@ Commands:
   gemview version                     # Print version
 ```
 
+## Navigation
+
+For menus the arrow keys and j/k can be used for movement. Press enter to select a choice and escape or q to return to the previous menu or quit.
+
+For paged content `less` is used internally so all the normal navigation commands work as expected.
+
 ## Demo
 
 ![GIF demoing the info and search subcommands](./assets/gemview-v1.0.0.gif)
 
+## Implementation
+
+Changelog and readme fetching is only supported for `github.com` and `gitlab.com` currently. This works by parsing the URI associated with one of these two sites from gem metadata, building a new URI associated with the given file and trying to download it as a raw file. Let me know if there are any other platforms I should add support for.
+
+Markdown highlighting is added on a best effort basis and if the parser fails for some reason it just falls back to the raw text file.
+
 ## Development
 
 ### Testing & Linting

data/lib/gemview/commands.rb

@@ -40,15 +40,24 @@ module Gemview
 
       argument :term, type: :string, required: true, desc: "Search term"
 
-      example %w[cli json]
+      option :downloads, values: %w[total version], desc: "Sort results by most downloads"
 
-      def call(term:, **)
+      example ["cli", "json --downloads=total"]
+
+      def call(term:, downloads: nil, **)
         gems = Gem.search(term: term)
 
         if gems.empty?
           abort("Error: No gems found for the search term: #{term}")
         end
 
+        case downloads
+        when "total"
+          gems.sort_by! { |gem| -gem.downloads }
+        when "version"
+          gems.sort_by! { |gem| -gem.version_downloads }
+        end
+
         View.list(gems: gems)
       end
     end

data/lib/gemview/gem.rb

@@ -1,70 +1,76 @@
-# frozen_string_literal: true
-
-require "dry-struct"
+# frozen_string_literal: true"
 
 module Gemview
-  class Gem < Dry::Struct
-    module Types
-      include Dry.Types()
-    end
-
-    transform_keys(&:to_sym)
-
-    # resolve default types on nil
-    transform_types do |type|
-      if type.default?
-        type.constructor do |value|
-          value.nil? ? Dry::Types::Undefined : value
-        end
-      else
-        type
+  class Gem
+    attr_reader(
+      :name,
+      :downloads,
+      :version,
+      :version_downloads,
+      :version_created_at,
+      :authors,
+      :info,
+      :licenses,
+      :project_uri,
+      :homepage_uri,
+      :source_code_uri,
+      :changelog_uri,
+      :development_dependencies,
+      :runtime_dependencies
+    )
+
+    # @param options [Hash]
+    def initialize(options)
+      @name = options.fetch("name")
+      @downloads = options.fetch("downloads")
+      @version = options.fetch("version")
+      @version_downloads = options.fetch("version_downloads")
+      # Note: This is not returned by `Gems.search`.
+      @version_created_at = options["version_created_at"]
+        &.then { |time| Time.parse(time) }
+      @authors = options.fetch("authors")
+      @info = options.fetch("info")
+      # Note: This is occasionally nil so a default value is required.
+      @licenses = (options.fetch("licenses") || []).freeze
+      @project_uri = options.fetch("project_uri")
+      @homepage_uri = options.fetch("homepage_uri")
+      @source_code_uri = options.fetch("source_code_uri")
+      @changelog_uri = options.fetch("changelog_uri")
+      # Note: Dependencies are not returned by `Gems.search`.
+      @development_dependencies = options
+        .dig("dependencies", "development")
+        &.map { |hash| Dependency.new(hash).freeze }
+        &.freeze
+      @runtime_dependencies = options
+        .dig("dependencies", "runtime")
+        &.map { |hash| Dependency.new(hash).freeze }
+        &.freeze
+    end
+
+    class Dependency
+      attr_reader :name, :requirements
+
+      # @param options [Hash]
+      def initialize(options)
+        @name = options.fetch("name")
+        @requirements = options.fetch("requirements")
       end
-    end
-
-    attribute :name, Types::Strict::String
-    attribute :downloads, Types::Strict::Integer
-    attribute :version, Types::Strict::String
-    # Note: This is not returned by `Gems.search`.
-    attribute? :version_created_at, Types::Params::Time
-    attribute :authors, Types::Strict::String
-    attribute :info, Types::Strict::String
-    # Note: This is occasionally nil so a default value is required.
-    attribute :licenses, Types::Array.of(Types::Strict::String).default([].freeze)
-    attribute :project_uri, Types::Strict::String
-    attribute :homepage_uri, Types::String.optional
-    attribute :source_code_uri, Types::String.optional
-    attribute :changelog_uri, Types::String.optional
-
-    class Dependency < Dry::Struct
-      transform_keys(&:to_sym)
-
-      attribute :name, Types::Strict::String
-      attribute :requirements, Types::Strict::String
 
       def to_str
         %(gem "#{name}", "#{requirements}")
       end
     end
 
-    # Note: This is not returned by `Gems.search`.
-    attribute? :dependencies do
-      attribute :development, Types::Strict::Array.of(Dependency)
-      attribute :runtime, Types::Strict::Array.of(Dependency)
-    end
-
-    class Version < Dry::Struct
-      transform_keys(&:to_sym)
-
-      attribute :number, Types::Strict::String
-      alias_method :version, :number
+    class Version
+      attr_reader :version, :downloads, :release_date, :ruby_version
 
-      attribute :downloads_count, Types::Strict::Integer
-      alias_method :downloads, :downloads_count
-
-      attribute :created_at, Types::Params::Time
-
-      # @return [Date]
-      def release_date = created_at.to_date
+      # @param options [Hash]
+      def initialize(options)
+        @version = options.fetch("number")
+        @downloads = options.fetch("downloads_count")
+        @release_date = Date.parse(options.fetch("created_at"))
+        @ruby_version = options.fetch("ruby_version") || "(unknown)"
+      end
     end
 
     # Ex. 1234567890 -> "1,234,567,890"
@@ -75,16 +81,29 @@ module Gemview
 
     # @return [String]
     def selector_str
+      one_line_info = info.gsub(/\s+/, " ").strip
+
       <<~SELECT
         #{name} [#{version}]
-          -- #{Strings.truncate(info.lines.map(&:strip).join(" "), 75)}
+          -- #{Strings.truncate(one_line_info, 75)}
       SELECT
     end
 
+    # @return [String]
+    def title_str(subsection:)
+      Terminal.prettify_markdown(<<~LINE)
+        ## [#{version}] #{name} >> #{subsection}
+      LINE
+    end
+
     # @return [String]
     def header_str
-      info_lines = Strings.wrap(info, 80).lines.map(&:strip)
-      info_lines = info_lines.take(3).append("...") if info_lines.size > 3
+      info_lines = Strings.wrap(info.gsub(/\s+/, " ").strip, 79).lines.map(&:strip)
+
+      if info_lines.size > 3
+        info_lines = info_lines.take(3)
+        info_lines.last << "…"
+      end
 
       header = <<~HEADER
         ## [#{version}] #{name}
@@ -103,16 +122,21 @@ module Gemview
       Terminal.prettify_markdown(header)
     end
 
+    # @return [Boolean]
+    def dependencies?
+      !runtime_dependencies.nil? && !development_dependencies.nil?
+    end
+
     # @return [String]
     def dependencies_str
-      runtime_deps_str = dependencies.runtime.join("\n").strip
+      runtime_deps_str = runtime_dependencies.join("\n").strip
       runtime_deps_str = if runtime_deps_str.empty?
         "(none)"
       else
         "```rb\n#{runtime_deps_str}\n```"
       end
 
-      dev_deps_str = dependencies.development.join("\n").strip
+      dev_deps_str = development_dependencies.join("\n").strip
       dev_deps_str = if dev_deps_str.empty?
         "(none)"
       else
@@ -132,46 +156,53 @@ module Gemview
       Terminal.prettify_markdown(dependencies)
     end
 
+    # @return [String]
     def versions_str
       rows = self.class.versions(name: name).map do |version|
         pretty_downloads = Number.humanized_integer(version.downloads)
-        "| #{version.release_date} | #{version.version} | #{pretty_downloads} |"
+        "| #{version.release_date} | #{version.version} | #{pretty_downloads} | #{version.ruby_version}"
       end
 
       table = <<~TABLE
         ## [Versions]
 
-        | *Release Date* | *Version* | *Downloads* |
-        |----------------|-----------|-------------|
+        | *Release Date* | *Gem Version* | *Downloads* | *Ruby Version* |
+        |----------------|---------------|-------------|----------------|
         #{rows.join("\n")}
       TABLE
 
       Terminal.prettify_markdown(table)
     end
 
-    # @return [Array<String>]
-    def urls
-      [
-        homepage_uri,
-        source_code_uri,
-        changelog_uri
-      ].compact
-    end
+    # @return [Gemview::GitRepo, nil]
+    def git_repo
+      return @git_repo if defined? @git_repo
 
-    # @return [String|nil]
-    def fetch_readme
-      GitRepo.from_urls(urls: urls, version: version)&.readme ||
-        "Info: Unable to find a valid readme based on available gem info"
+      @git_repo = GitRepo.from_urls(
+        homepage_uri: homepage_uri,
+        source_code_uri: source_code_uri,
+        changelog_uri: changelog_uri,
+        version: version
+      )
     end
 
-    # @return [String|nil]
-    def fetch_changelog
-      GitRepo.from_urls(urls: urls, version: version)&.changelog ||
-        "Info: Unable to find a valid changelog based on available gem info"
-    end
+    # @return [Boolean]
+    def git_repo? = !git_repo.nil?
+
+    # @return [Boolean]
+    def readme? = git_repo? && git_repo.readme?
+
+    # @return [String, nil]
+    def readme = git_repo&.readme
+
+    # @return [Boolean]
+    def changelog? = git_repo? && git_repo.changelog?
+
+    # @return [String, nil]
+    def changelog = git_repo&.changelog
 
     # @param name [String]
-    # @param version [String|nil] will default to latest if not provided
+    # @param version [String, nil] will default to latest if not provided
     # @return [Gemview::Gem]
     def self.find(name:, version: nil)
       @find ||= {}
@@ -186,30 +217,30 @@ module Gemview
     # @param term [String] search term
     # @return [Array<Gemview::Gem>]
     def self.search(term:)
-      Client.v1.search(term).map { |gem_hash| new gem_hash }
+      Client.v1.search(term).map { |gem_hash| new(gem_hash) }
     end
 
     # @param username [String] rubygems.org username
     # @return [Array<Gemview::Gem>]
     def self.author(username:)
-      Client.v1.gems(username).map { |gem_hash| new gem_hash }
+      Client.v1.gems(username).map { |gem_hash| new(gem_hash) }
     end
 
     # @return [Array<Gemview::Gem>]
     def self.latest
-      Client.v1.latest.map { |gem_hash| new gem_hash }
+      Client.v1.latest.map { |gem_hash| new(gem_hash) }
     end
 
     # @return [Array<Gemview::Gem>]
     def self.just_updated
-      Client.v1.just_updated.map { |gem_hash| new gem_hash }
+      Client.v1.just_updated.map { |gem_hash| new(gem_hash) }
     end
 
     # @param name [String] gem name
     # @return [Array<Gemview::Gem::Version>]
     def self.versions(name:)
       @versions ||= {}
-      @versions[name] ||= Client.v1.versions(name).map { |gem_hash| Version.new gem_hash }
+      @versions[name] ||= Client.v1.versions(name).map { |gem_hash| Version.new(gem_hash).freeze }.freeze
     end
   end
 end

data/lib/gemview/git_repo.rb

@@ -4,21 +4,24 @@ module Gemview
   class GitRepo
     HOSTS = [
       GITHUB = :github,
-      GITLAB = :gitlab
+      GITLAB = :gitlab,
+      CODEBERG = :codeberg
     ].freeze
 
-    # @param urls [Array<String>]
+    HTTPS_PORT = 443
+
+    # @param homepage_uri [String, nil]
+    # @param source_code_uri [String, nil]
+    # @param changelog_uri [String, nil]
     # @param version [String]
-    # @return [Gemview::GitRepo|nil]
-    def self.from_urls(urls:, version:)
-      @from_urls ||= {}
-
-      base_url, git_host = nil
-      urls.each do |url|
-        base_url, git_host = parse_base_url(url)
-        if base_url && git_host
-          return @from_urls[base_url] ||= new(
-            base_url: base_url,
+    # @return [Gemview::GitRepo, nil]
+    def self.from_urls(homepage_uri:, source_code_uri:, changelog_uri:, version:)
+      [homepage_uri, source_code_uri, changelog_uri].compact.each do |uri|
+        base_uri, git_host = parse_base_uri(uri)
+        if base_uri && git_host
+          return new(
+            base_uri: base_uri,
+            changelog_uri: changelog_uri,
             git_host: git_host,
             version: version
           )
@@ -28,99 +31,176 @@ module Gemview
     end
 
     # @param [String]
-    # @return [base_url as `String` and git_host as `Symbol`] or nil if unsuccessful
-    def self.parse_base_url(url)
-      github_base_url = url[%r{^https?://github\.com/[^/]+/[^/]+}, 0]
-      return [github_base_url, GITHUB] if github_base_url
+    # @return [base_uri as `String` and git_host as `Symbol`] or nil if unsuccessful
+    def self.parse_base_uri(uri)
+      github_base_uri = uri[%r{^https?://github\.com/[^/]+/[^/]+}, 0]
+      return [github_base_uri, GITHUB] if github_base_uri
+
+      gitlab_base_uri = uri[%r{^https?://gitlab\.com/[^/]+/[^/]+}, 0]
+      return [gitlab_base_uri, GITLAB] if gitlab_base_uri
 
-      gitlab_base_url = url[%r{^https?://gitlab\.com/[^/]+/[^/]+}, 0]
-      [gitlab_base_url, GITLAB] if gitlab_base_url
+      codeberg_base_uri = uri[%r{^https?://codeberg\.org/[^/]+/[^/]+}, 0]
+      [codeberg_base_uri, CODEBERG] if codeberg_base_uri
     end
 
-    private_class_method :new, :parse_base_url
+    private_class_method :new
 
-    attr_reader :base_url, :git_host, :version
+    attr_reader :base_uri, :changelog_uri, :git_host, :version
 
-    # @param base_url [String] base Git repo url for `HOSTS`
+    # @param base_uri [String] base Git repo uri for `HOSTS`
+    # @param changelog_uri [String, nil] from the gem metadata
     # @param git_host [Symbol] from `HOSTS`
     # @param version [String]
-    def initialize(base_url:, git_host:, version:)
+    def initialize(base_uri:, changelog_uri:, git_host:, version:)
       raise ArgumentError, "Invalid host: #{git_host}" unless HOSTS.include?(git_host)
 
-      @base_url = base_url.dup.freeze
+      @base_uri = base_uri.dup.freeze
+      @changelog_uri = changelog_uri.dup.freeze
       @git_host = git_host
       @version = version.dup.freeze
     end
 
-    # @return [String|nil]
+    # @return [Boolean]
+    def readme? = !defined?(@readme) || !readme.nil?
+
+    # @return [String, nil]
     def readme
       return @readme if defined?(@readme)
 
       @readme = fetch_raw_file("README.md")
     end
 
-    # @return [String|nil]
+    # @return [Boolean]
+    def changelog? = !defined?(@changelog) || !changelog.nil?
+
+    # @return [String, nil]
     def changelog
       return @changelog if defined?(@changelog)
 
-      @changelog = fetch_raw_file("CHANGELOG.md")
+      filenames = [changelog_filename, "CHANGELOG.md"].compact.uniq
+      filenames.each do |filename|
+        break if (@changelog = fetch_raw_file(filename))
+      end
+
+      @changelog
     end
 
     private
 
+    def changelog_filename
+      return unless @changelog_uri&.end_with?(".md")
+
+      changelog_base_uri, changelog_git_host = self.class.parse_base_uri(@changelog_uri)
+      return if changelog_base_uri != base_uri
+      return if changelog_git_host != git_host
+
+      @changelog_uri.split("/").last
+    end
+
     # @param filename [String]
-    # @return [String|nil]
+    # @return [String, nil]
     def fetch_raw_file(filename)
       case @git_host
       when GITHUB then github_raw_file(filename)
       when GITLAB then gitlab_raw_file(filename)
+      when CODEBERG then codeberg_raw_file(filename)
       end
     end
 
     # @param filename [String]
-    # @return [String|nil]
+    # @return [String, nil]
     def github_raw_file(filename)
       # From: `https://github.com/charmbracelet/bubbles`
       # To: `https://raw.githubusercontent.com/charmbracelet/bubbles/refs/tags/v0.20.0/README.md`
-      path = @base_url.sub(%r{^https?://github\.com}, "")
-
-      [
-        "https://raw.githubusercontent.com#{path}/refs/tags/v#{@version}/#{filename}",
-        "https://raw.githubusercontent.com#{path}/refs/tags/#{@version}/#{filename}"
-      ].each do |url|
-        content = fetch(url)
-        return content if content
-      end
-      nil
+      path = @base_uri.sub(%r{^https?://github\.com}, "")
+
+      fetch_markdown(
+        host: "raw.githubusercontent.com",
+        tag_paths: [
+          "#{path}/refs/tags/v#{@version}/#{filename}",
+          "#{path}/refs/tags/#{@version}/#{filename}"
+        ],
+        head_paths: [
+          "#{path}/refs/heads/main/#{filename}",
+          "#{path}/refs/heads/master/#{filename}"
+        ]
+      )
     end
 
     # @param filename [String]
-    # @return [String|nil]
+    # @return [String, nil]
     def gitlab_raw_file(filename)
       # From: `https://gitlab.com/gitlab-org/gitlab`
-      # To: `https://gitlab.com/gitlab-org/gitlab/-/raw/v17.5.1-ee/README.md?ref_type=tags&inline=false`
-      path = @base_url.sub(%r{^https?://gitlab\.com}, "")
-
-      [
-        "https://gitlab.com#{path}/-/raw/v#{@version}/#{filename}?ref_type=tags&inline=false",
-        "https://gitlab.com#{path}/-/raw/#{@version}/#{filename}?ref_type=tags&inline=false"
-      ].each do |url|
-        content = fetch(url)
-        return content if content
-      end
-      nil
+      # To: `https://gitlab.com/gitlab-org/gitlab/-/raw/v17.5.1-ee/README.md`
+      path = @base_uri.sub(%r{^https?://gitlab\.com}, "")
+
+      fetch_markdown(
+        host: "gitlab.com",
+        tag_paths: [
+          "#{path}/-/raw/v#{@version}/#{filename}",
+          "#{path}/-/raw/#{@version}/#{filename}"
+        ],
+        head_paths: [
+          "#{path}/-/raw/main/#{filename}",
+          "#{path}/-/raw/master/#{filename}"
+        ]
+      )
+    end
+
+    # @param filename [String]
+    # @return [String, nil]
+    def codeberg_raw_file(filename)
+      # From: `https://codeberg.org/bendangelo/wiktionary_api`
+      # To: `https://codeberg.org/bendangelo/wiktionary_api/raw/tag/v0.1.1/README.md`
+      path = @base_uri.sub(%r{^https?://codeberg\.org}, "")
+
+      fetch_markdown(
+        host: "codeberg.org",
+        tag_paths: [
+          "#{path}/raw/tag/v#{@version}/#{filename}",
+          "#{path}/raw/tag/#{@version}/#{filename}"
+        ],
+        head_paths: [
+          "#{path}/raw/branch/main/#{filename}",
+          "#{path}/raw/branch/master/#{filename}"
+        ]
+      )
     end
 
-    # @param url [String]
-    # @return [String|nil]
-    def fetch(url)
-      response = Net::HTTP.get_response(URI(url))
-      if response.is_a?(Net::HTTPSuccess)
-        body = response.body.force_encoding("UTF-8")
-        Terminal.prettify_markdown(body)
+    # @param host [String]
+    # @param tag_paths [Array<String>]
+    # @param head_paths [Array<String>]
+    # @return [String, nil]
+    def fetch_markdown(host:, tag_paths:, head_paths:)
+      body = nil
+
+      Net::HTTP.start(host, HTTPS_PORT, use_ssl: true, open_timeout: 2, read_timeout: 2) do |http|
+        tag_paths.each do |path|
+          response = http.get(path)
+          if response.is_a?(Net::HTTPSuccess)
+            body = response.body.force_encoding("UTF-8")
+            break
+          end
+        end
+
+        unless body
+          head_paths.each do |path|
+            response = http.get(path)
+            if response.is_a?(Net::HTTPSuccess)
+              body = <<~BODY
+                *FYI*: This was fetched from the HEAD branch of the Git repository.
+
+                #{response.body.force_encoding("UTF-8")}
+              BODY
+              break
+            end
+          end
+        end
       end
-    rescue Net::HTTPError
-      nil
+
+      Terminal.prettify_markdown(body) if body
+    rescue Net::OpenTimeout, Net::ReadTimeout
+      nil # this is best effort so we silence network errors here
     end
   end
 end

data/lib/gemview/terminal.rb

@@ -2,6 +2,11 @@
 
 module Gemview
   module Terminal
+    # Clears the screen using escape codes.
+    def self.clear_screen
+      print "\e[2J\e[f"
+    end
+
     # @param question [String]
     # @return [Boolean]
     def self.confirm(question:)
@@ -10,15 +15,25 @@ module Gemview
 
     # @param content [String]
     def self.page(content)
-      TTY::Pager.page(content)
+      command = [
+        "less",
+        "--clear-screen", # make sure everything is top-justified
+        "--RAW-CONTROL-CHARS", # correctly interpret ANSI control sequences
+        "--tilde", # don't show tildes on lines after the output
+        "--prompt='(press h for help or q to quit)'"
+      ].join(" ")
+
+      TTY::Pager::SystemPager.new(command: command).page(content)
     end
 
     # @param prompt [String]
-    # @param choices [Array<String>] or [Hash<String, String>] where all choices are unique
+    # @param choices [Array<String, Hash>, Proc] where all choices are unique
     # @yield [String] yields until the user exits the prompt gracefully
     def self.choose(message:, choices:, per_page: 6)
-      while (choice = selector.select(message, choices, per_page))
-        yield choice
+      loop do
+        choice_list = choices.is_a?(Proc) ? choices.call : choices
+        choice = selector.select(message, choice_list, per_page)
+        choice ? yield(choice) : break
       end
     end
 
@@ -82,10 +97,12 @@ module Gemview
       end
 
       # @param prompt [String]
-      # @param choices [Array<String>] where all choices are unique
+      # @param choices [Array<String, Hash>] where all choices are unique
       # @param per_page [Integer] results per page
-      # @return [String|nil]
+      # @return [String, nil]
       def select(message, choices, per_page)
+        # TODO: Add support for preserving the previous selection if this ever gets fixed upstream.
+        # Issue: https://github.com/piotrmurach/tty-prompt/issues/206
         choice = @prompt.select(
           message,
           choices,
@@ -93,10 +110,22 @@ module Gemview
           help: "(Press Enter to select and Escape to leave)",
           show_help: :always
         )
+
         choice unless @exit
       ensure
         @exit = false
       end
+
+      private
+
+      # @param choice [String, nil]
+      # @param choices [Array<String, Hash>]
+      # @return [Boolean]
+      def disabled_choice?(choice, choices)
+        choices.any? do |possible_choice|
+          possible_choice in {name: ^choice, disabled: String}
+        end
+      end
     end
     private_constant :Selector
   end

data/lib/gemview/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Gemview
-  VERSION = "1.0.0"
+  VERSION = "1.2.0"
 end

data/lib/gemview/view.rb

@@ -3,22 +3,33 @@
 module Gemview
   module View
     def self.info(gem:)
-      gem = Gem.find(name: gem.name, version: gem.version) if gem.dependencies.nil?
+      gem = Gem.find(name: gem.name, version: gem.version) unless gem.dependencies?
       prompt = <<~PROMPT.chomp
         #{gem.header_str}
         More info:
       PROMPT
 
-      Terminal.choose(message: prompt, choices: %w[Readme Changelog Dependencies Versions]) do |choice|
+      choices_proc = proc do
+        [
+          {name: "Readme", disabled: gem.readme? ? nil : "(missing)"},
+          {name: "Changelog", disabled: gem.changelog? ? nil : "(missing)"},
+          "Dependencies",
+          "Versions"
+        ]
+      end
+
+      Terminal.clear_screen
+      Terminal.choose(message: prompt, choices: choices_proc) do |choice|
+        title = gem.title_str(subsection: choice)
         case choice
         when "Readme"
-          Terminal.page([gem.header_str, gem.fetch_readme].join("\n"))
+          Terminal.page([title, gem.readme].join("\n")) if gem.readme
         when "Changelog"
-          Terminal.page([gem.header_str, gem.fetch_changelog].join("\n"))
+          Terminal.page([title, gem.changelog].join("\n")) if gem.changelog
         when "Dependencies"
-          Terminal.page([gem.header_str, gem.dependencies_str].join("\n"))
+          Terminal.page([title, gem.dependencies_str].join("\n"))
         when "Versions"
-          Terminal.page([gem.header_str, gem.versions_str].join("\n"))
+          Terminal.page([title, gem.versions_str].join("\n"))
         else
           raise ArgumentError, "Unknown choice: #{choice}"
         end
@@ -30,8 +41,9 @@ module Gemview
         [gem.selector_str, gem]
       end
 
-      Terminal.choose(message: "Choose a gem:", choices: gems_by_description) do |gem|
-        info(gem: gem)
+      Terminal.clear_screen
+      Terminal.choose(message: "Choose a gem:", choices: gems_by_description.keys) do |description|
+        info(gem: gems_by_description.fetch(description))
       end
     end
   end

data/lib/gemview.rb

@@ -12,16 +12,12 @@ module Gemview
   autoload :GitRepo, "gemview/git_repo"
   autoload :Number, "gemview/number"
   autoload :Terminal, "gemview/terminal"
-  autoload :Version, "gemview/version"
   autoload :View, "gemview/view"
 end
 
 # External
 autoload :Gems, "gems"
 autoload :Strings, "strings"
-module Net
-  autoload :HTTP, "net/http"
-end
 
 module TTY
   autoload :Markdown, "tty-markdown"

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: gemview
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.2.0
 platform: ruby
 authors:
-- apainintheneck
-autorequire:
+- Kevin Robell
 bindir: exe
 cert_chain: []
-date: 2024-12-08 00:00:00.000000000 Z
+date: 2025-08-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dry-cli
@@ -24,20 +23,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 1.2.0
-- !ruby/object:Gem::Dependency
-  name: dry-struct
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 1.6.0
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 1.6.0
 - !ruby/object:Gem::Dependency
   name: gems
   requirement: !ruby/object:Gem::Requirement
@@ -108,20 +93,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.23.1
-- !ruby/object:Gem::Dependency
-  name: zeitwerk
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '2.7'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '2.7'
 description: 'An unofficial CLI interface to browse rubygems.org. Search for gems
   by name, see which ones have been recently updated and look at their dependencies.
 
@@ -155,7 +126,6 @@ metadata:
   homepage_uri: https://github.com/apainintheneck/gemview
   source_code_uri: https://github.com/apainintheneck/gemview
   changelog_uri: https://github.com/apainintheneck/gemview/blob/main/CHANGELOG.md
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -170,8 +140,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.23
-signing_key:
+rubygems_version: 3.6.2
 specification_version: 4
 summary: An unofficial CLI interface to browse rubygems.org
 test_files: []