3 redditnews.go (First Iteration)

This is the first draft of my program.

In your browser, open the site http://reddit.com/r/golang.json the browser output is a huge blob of JSON that we receive from the Golang Subreddit. This may be difficult to look at in the browser, unless you have the JSONView plugin installed. These extensions are available for Firefox and Chrome. With the extension installed, here’s a partial view of the JSON:

JSON

Now let’s write the first draft of our program.

Make a new folder and cd to it as follows:

$ mkdir $GOPATH/src/github.com/SatishTalim/redditnews
$ cd $GOPATH/src/github.com/SatishTalim/redditnews

In this folder, create a file named redditnews.go, open it in your favorite editor, and add the following lines:

package main

import (
	"io"
	"log"
	"net/http"
	"os"
)

func main() {
	resp, err := http.Get("http://reddit.com/r/golang.json")
	if err != nil {
		log.Fatal(err)
	}

	defer resp.Body.Close()

	if resp.StatusCode != http.StatusOK {
		log.Fatal(resp.Status)
	}

	_, err = io.Copy(os.Stdout, resp.Body)
	if err != nil {
		log.Fatal(err)
	}
}

You can download this code here.

• Like all Go programs that need to be executed, our program has a package main.
• Package io provides basic interfaces to I/O primitives.
• On an error we use log. Package log implements a simple logging package. It defines a type, Logger, with methods for formatting output. It also has a predefined ‘standard’ Logger accessible through helper functions Print[f|ln], Fatal[f|ln], and Panic[f|ln], which are easier to use than creating a Logger manually. That logger writes to standard error and prints the date and time of each logged message.
• The log.Fatal function prints the error message and exits the program.
• For web related http functionality, we import the package net/http. Any functions within that we refer as http.function_name.
• Package os provides a platform-independent interface to operating system functionality.
• In our main() function, we are setting a variable resp and doing a GET request to the Reddit API on our chosen Subreddit.
• The func Get(url string) (resp *Response, err error) issues a GET to the specified URL. When err is nil, resp always contains a non-nil resp.Body. Caller should close resp.Body when done reading from it. The resp is of type Response.
• We use the defer function to clean up after the HTTP request, and this call will only be executed after the function returns.
• In our Error Handling, check that the HTTP server returns a “200 OK” response. If not, bail, printing the HTTP status message (“500 Internal Server Error”, for example).
• The package net/http defines many constants.
• _ is a blank identifier which can be used when we don’t care about a particular return value.
• Finally, we copy the resp.Body (filled with the JSON received from the Reddit API) to the os.Stdout. The resp.Body type implements io.Reader and os.Stdout implements io.Writer.

Now you can run the program with the go tool:

$ cd $GOPATH/src/github.com/SatishTalim/redditnews
$ go run redditnews.go

When you run the program we are outputting (through os.Stdout) a huge blob of JSON that we received from the Golang Subreddit. Although we can actually see the Articles inside there, this is no good to us. We want to receive the Article’s Title, Author’s name, a Link to the Article, and we want to assess the value of the article, based on the Reddit link Score the Article has received.