go-hacknews

📟 Tiny utility Go client for HackerNews API.

Programming language: Go

License: MIT License

Tags: Third-party APIs    

Latest version: v1.2

README

go-hacknews

Tiny utility Go client for HackerNews API.

Official Hackernews API

Install

 go get github.com/PaulRosset/go-hacknews

Usage

Few examples are available inside the examples/ folder.

package main

import (
        "fmt"
        "github.com/PaulRosset/go-hacknews"
)

func main() {

    // Init struct with the kind of story you want
    // (topstories/newstories/beststories/askstories/showstories/jobstories)
    // and the number of posts that you want to fetch.
    init := hacknews.Initializer{"topstories", 10}

    // Get the code of posts.
    // Return a slice of int with the entry id if everything is ok or return an error.
    codes, err := init.GetCodesStory()
    if err != nil {
        fmt.Println(err)
        return
    }

    // Get the posts thanks their id fetched above.
    // Return a slice of Post type with a readable format in go or return an err if fail.
    posts, err := init.GetPostStory(codes)
    if err != nil {
        fmt.Println(err)
        return
    }

    // Iterate over the slice to get what we want.
    // Here, get Title and Url of post. But we can access all fields from the official hackernews api
    // Note : Field are empty, if no data belong to them
    for _, post := range posts {
        fmt.Printf("Title : %v // Url : %v\n", post.Title ,post.Url)
    }

}

Test

Tests are available :

$ go test

License

MIT