hacknews

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

Documentation

Index

• type Initializer
  • func (init Initializer) GetCodesStory() ([]int, error)
  • func (init Initializer) GetPostStory(codes []int) ([]Post, error)
• type Post

Types

type Initializer

type Initializer struct {
	Story   string
	NbPosts int
}

Initializer -- represents the kind of requests that we want to fetch

func (Initializer) GetCodesStory

func (init Initializer) GetCodesStory() ([]int, error)

GetCodesStory -- Return the ids of a story

func (Initializer) GetPostStory

func (init Initializer) GetPostStory(codes []int) ([]Post, error)

GetPostStory -- Return the posts of story thanks their ids

type Post

type Post struct {
	Id          int    `json:"id"`
	Deleted     bool   `json:"deleted"`
	Type        string `json:"type"`
	By          string `json:"by"`
	Time        int    `json:"time"`
	Text        string `json:"text"`
	Dead        bool   `json:"dead"`
	Parent      int    `json:"parent"`
	Poll        int    `json:"poll"`
	Kids        []int  `json:"kids"`
	Url         string `json:"url"`
	Score       int    `json:"score"`
	Title       string `json:"title"`
	Parts       []int  `json:"parts"`
	Descendants int    `json:"descendants"`
}

Post -- represents the json object returned by the API