gosearch.go

package main

// @hipbot gopkg <package-name>
// Search Godoc.org's docs for <package-name> via their API
// return a text 1-sentence explanation of package or else a text no-results response

import (
	"encoding/json"
	"log"
	"net/http"
	"net/url"
)

const GO_DOC_ENDPOINT = "http://api.godoc.org/search"

type GoPackageResult struct {
	Path     string `json:"path"`
	Synopsis string `json:"synopsis"`
}

type GoPackageResponse struct {
	Results []*GoPackageResult `json:"results"`
}

// Search Godoc.org's documentation sets via their API
func goSearch(query string) string {
	// Send GET request, collect response
	res, err := http.Get(GO_DOC_ENDPOINT + "?q=" + url.QueryEscape(query))

	if err != nil {
		log.Println("Error in HTTP GET:", err)
		return "error"
	}

	defer res.Body.Close()

	// Decode JSON body
	decoder := json.NewDecoder(res.Body)
	response := new(GoPackageResponse)
	decoder.Decode(response)

	// Check for no results
	if len(response.Results) == 0 {
		return "I found nothing! So sorry."
	} else {
		// Only show first (most relevant) package
		firstResult := (*(response.Results[0]))

		// Split response text into "Synopsis" and "Path"
		textResponse := "Synopsis: " + firstResult.Synopsis
		textResponse += "\nPath: \"" + firstResult.Path + "\""

		return textResponse
	}
}