tiny_hnews 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 3e075115863db50ddcfca86659c7a2e52e28de6d4e2260d49ec20b1800f04101
+  data.tar.gz: 8eaad66ab94ebd85eab634333314a3c341a353c3bd4ea91bbcb529b2cb4d64b0
+SHA512:
+  metadata.gz: 361da4be16c1c17c110d0a4ec84f0b98878c74a0e0745fabcb54b95d14f98c12dfbc4de6821ffe2eda48879057c1f1e4bc14a5e3f2519eedd95f530af4602005
+  data.tar.gz: e49627fbaae8f30620c2619a315bdc674ba4a61226f76460198f81429bc2cd0969e2226d05e4bb01f6ea66e0610e8451fc788f68c01198d51c8b0e087eb22df6

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.1.0] - 2025-09-25
+
+- Initial release

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Fernando Guillén Suárez
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,3 @@
+# TinyHNews
+
+API wraper for: https://github.com/HackerNews/API

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "minitest/test_task"
+
+Minitest::TestTask.create
+
+require "rubocop/rake_task"
+
+RuboCop::RakeTask.new
+
+task default: %i[test rubocop]

data/etc/script_html_to_markdown.rb

@@ -0,0 +1,13 @@
+URL = "https://en.wikipedia.org/wiki/Ortega_hypothesis"
+
+require "nokogiri"
+require "html2markdown"
+require "faraday"
+require "reverse_markdown"
+
+html = Faraday.get(URL).body
+doc = Nokogiri::HTML(html)
+body = doc.at("body").to_html
+
+rm = ReverseMarkdown.convert(body, unknown_tags: :bypass)
+h2m = HTMLPage.new(contents: body).markdown

data/lib/tiny_hnews/api.rb

@@ -0,0 +1,76 @@
+require "faraday"
+
+module TinyHNews
+  class API
+    def topstories
+      log("Fetching top stories")
+      JSON.parse(client.get("topstories.json").body)
+    end
+
+    def newstories
+      log("Fetching new stories")
+      JSON.parse(client.get("newstories.json").body)
+    end
+
+    def beststories
+      log("Fetching best stories")
+      JSON.parse(client.get("beststories.json").body)
+    end
+
+    def story(story_id)
+      log("Fetching story #{story_id}")
+      item(story_id)
+    end
+
+    def comment(comment_id)
+      log("Fetching comment #{comment_id}")
+      item(comment_id)
+    end
+
+    def item(item_id)
+      log("Fetching item #{item_id}")
+      JSON.parse(client.get("item/#{item_id}.json").body)
+    end
+
+    private
+
+    def client
+      @client ||=
+        Faraday.new(
+          url: "https://hacker-news.firebaseio.com/v0",
+          headers: { "Content-Type" => "application/json" }
+        )
+    end
+
+    def log(message)
+      puts "[TinyHNews::API] #{message}"
+    end
+
+    # Class methods that delegate to instance methods
+    class << self
+      def topstories
+        new.topstories
+      end
+
+      def newstories
+        new.newstories
+      end
+
+      def beststories
+        new.beststories
+      end
+
+      def story(story_id)
+        new.story(story_id)
+      end
+
+      def comment(comment_id)
+        new.comment(comment_id)
+      end
+
+      def item(item_id)
+        new.item(item_id)
+      end
+    end
+  end
+end

data/lib/tiny_hnews/story.rb

@@ -0,0 +1,69 @@
+module TinyHNews
+  class Story
+    attr_reader :id, :by, :descendants, :kids, :score, :time, :title, :type, :url, :text, :comments, :article
+
+    def initialize(id:, comments_depth: 2, comments_limit: 10)
+      @id = id
+      @comments_depth = comments_depth
+      @comments_limit = comments_limit
+    end
+
+    def wrap
+      fetch
+      scrap
+      load_comments
+      self
+    end
+
+    private
+
+    def fetch
+      response = TinyHNews::API.story(@id)
+      @title = response["title"]
+      @type = response["type"]
+      @by = response["by"]
+      @url = response["url"]
+      @text = response["text"]
+      @kids = response["kids"]
+      @score = response["score"]
+      @time = response["time"]
+      @descendants = response["descendants"]
+      @article = nil
+    end
+
+    def scrap
+      @article = TinyHNews::ToMarkdown.from_url(@url)
+    end
+
+    def load_comments
+      return [] unless @kids
+
+      @comments = fetch_comments(comment_ids: @kids)
+    end
+
+    def fetch_comments(
+      comment_ids:,
+      aggregated_comments: [],
+      current_depth: 0
+    )
+      comment_ids.each do |comment_id|
+        break if aggregated_comments.size >= @comments_limit
+
+        comment = TinyHNews::API.comment(comment_id)
+
+        aggregated_comments << ToMarkdown.from_hml(comment["text"]).strip
+
+        next if current_depth + 1 >= @comments_depth
+        next if comment["kids"].nil? || comment["kids"].empty?
+
+        fetch_comments(
+          comment_ids: comment["kids"],
+          aggregated_comments:,
+          current_depth: current_depth + 1
+        )
+      end
+
+      aggregated_comments
+    end
+  end
+end

data/lib/tiny_hnews/to_markdown.rb

@@ -0,0 +1,24 @@
+require "reverse_markdown"
+require "faraday"
+
+module TinyHNews
+  class ToMarkdown
+    def self.from_url(url)
+      html = fetch(url)
+      doc = Nokogiri::HTML(html)
+      body = doc.at("body").to_html
+      from_hml(body)
+    rescue StandardError => e
+      puts "[TinyHNews::ToMarkdown] Error fetching or converting URL #{url}: #{e.message}"
+      nil
+    end
+
+    def self.from_hml(html)
+      ReverseMarkdown.convert(html, unknown_tags: :bypass)
+    end
+
+    def self.fetch(url)
+      Faraday.get(url).body
+    end
+  end
+end

data/lib/tiny_hnews/top_stories.rb

@@ -0,0 +1,31 @@
+module TinyHNews
+  class TopStories
+    attr_reader :stories
+
+    def initialize(
+      number_of_stories: 10,
+      comments_depth: 2,
+      comments_limit: 20
+    )
+      @number_of_stories = number_of_stories
+      @comments_depth = comments_depth
+      @comments_limit = comments_limit
+      @stories = []
+    end
+
+    def fetch
+      top_stories = TinyHNews::API.topstories.first(@number_of_stories)
+
+      @stories =
+        top_stories.map do |story_id|
+          TinyHNews::Story.new(
+            id: story_id,
+            comments_depth: @comments_depth,
+            comments_limit: @comments_limit
+          ).wrap
+        end
+
+      self
+    end
+  end
+end

data/lib/tiny_hnews/version.rb

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

data/lib/tiny_hnews.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require_relative "tiny_hnews/version"
+require_relative "tiny_hnews/api"
+require_relative "tiny_hnews/top_stories"
+require_relative "tiny_hnews/story"
+require_relative "tiny_hnews/to_markdown"
+
+module TinyHNews
+end

metadata

@@ -0,0 +1,182 @@
+--- !ruby/object:Gem::Specification
+name: tiny_hnews
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Fernando Guillén Suárez
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  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: json
+  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: reverse_markdown
+  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: debug
+  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'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  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'
+- !ruby/object:Gem::Dependency
+  name: mocha
+  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'
+- !ruby/object:Gem::Dependency
+  name: rake
+  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'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  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'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  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'
+description: A command-line tool to fetch and display top stories from Hacker News,
+  including comments and article content.
+email:
+- fguillen.mail@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- etc/script_html_to_markdown.rb
+- lib/tiny_hnews.rb
+- lib/tiny_hnews/api.rb
+- lib/tiny_hnews/story.rb
+- lib/tiny_hnews/to_markdown.rb
+- lib/tiny_hnews/top_stories.rb
+- lib/tiny_hnews/version.rb
+homepage: https://github.com/fguillen/TinyHNews
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/fguillen/TinyHNews
+  source_code_uri: https://github.com/fguillen/TinyHNews
+  changelog_uri: https://github.com/fguillen/TinyHNews/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.8
+specification_version: 4
+summary: Fetch and display top stories from Hacker News.
+test_files: []