hncr

hncr

A Hacker News API wrapper for Crystal

Installation

Add this to your application's shard.yml:

dependencies:
  hncr:
    github: aretrace/hncr
    branch: main

Usage

require "hncr"

# Get ten stories of the 'top' category and print them
HN::Item.new(type: "top", count: 10) do |item|
  puts "#{ item["title"] }, by #{ item["by"] }\n#{ item["url"]? }\n\n"
end

# Get user by id and print the 'about' field
HN::User.new(id: "jl") do |user|
  puts user["about"]
end

API

NOTE:

The API returns items concurrently.

Items constructor:

HN::Item(type, count, &block)

  • type : String One of the following strings for the type of story: new, top, best, ask, show, or job.

  • count : Int32 The number of stories to return.

  • &block Block takes one argument that returns a JSON::Any struct containing the item's json fields.

User constructor:

HN::User(id, &block)

  • id : String The id of the user.

  • &block Block takes one argument that returns a JSON::Any struct containing the user's json fields.

Repository

hncr

Owner
Statistic
  • 0
  • 0
  • 0
  • 1
  • 0
  • almost 2 years ago
  • March 1, 2023
License

MIT License

Links
Synced at

Sun, 22 Dec 2024 12:49:51 GMT

Languages