使用go-xkcd访问XKCD API

go-xkcd是一个用于访问XKCD漫画API的Golang客户端库，它提供了简单易用的方式来获取XKCD漫画信息。下面我将详细介绍如何使用这个库。

安装go-xkcd

首先，你需要安装go-xkcd库：

go get github.com/nishanths/go-xkcd

基本使用方法

1. 获取最新漫画

package main

import (
	"fmt"
	"log"
	"github.com/nishanths/go-xkcd"
)

func main() {
	client := xkcd.NewClient()
	
	// 获取最新漫画
	comic, err := client.Latest()
	if err != nil {
		log.Fatal(err)
	}
	
	fmt.Printf("最新漫画 #%d: %s\n", comic.Number, comic.Title)
	fmt.Printf("发布日期: %s\n", comic.Date())
	fmt.Printf("图片URL: %s\n", comic.ImageURL)
	fmt.Printf("说明文字: %s\n", comic.Alt)
}

2. 获取特定编号的漫画

func getComicByNumber() {
	client := xkcd.NewClient()
	
	// 获取编号为614的漫画(著名的"sudo"漫画)
	comic, err := client.Get(614)
	if err != nil {
		log.Fatal(err)
	}
	
	fmt.Printf("漫画 #%d: %s\n", comic.Number, comic.Title)
	fmt.Printf("说明文字: %s\n", comic.Alt)
}

3. 搜索漫画

func searchComics() {
	client := xkcd.NewClient()
	
	// 搜索包含"python"关键字的漫画
	results, err := client.Search("python", nil)
	if err != nil {
		log.Fatal(err)
	}
	
	fmt.Printf("找到 %d 个结果:\n", len(results))
	for _, comic := range results {
		fmt.Printf("#%d: %s\n", comic.Number, comic.Title)
	}
}

高级功能

1. 使用上下文和超时

import (
	"context"
	"time"
)

func withContext() {
	client := xkcd.NewClient()
	
	ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
	defer cancel()
	
	comic, err := client.GetWithContext(ctx, 100)
	if err != nil {
		log.Fatal(err)
	}
	
	fmt.Println(comic.Title)
}

2. 自定义HTTP客户端

import "net/http"

func customHTTPClient() {
	// 创建自定义HTTP客户端
	httpClient := &http.Client{
		Timeout: 10 * time.Second,
	}
	
	// 使用自定义HTTP客户端创建XKCD客户端
	client := xkcd.NewClientCustom(httpClient, nil)
	
	comic, err := client.Latest()
	if err != nil {
		log.Fatal(err)
	}
	
	fmt.Println(comic.Title)
}

处理漫画数据

XKCD API返回的漫画数据包含以下主要字段：

type Comic struct {
	Number     int    `json:"num"`       // 漫画编号
	Title      string `json:"title"`     // 标题
	SafeTitle  string `json:"safe_title"`// 安全标题
	ImageURL   string `json:"img"`       // 图片URL
	Alt        string `json:"alt"`       // 悬停文本
	Transcript string `json:"transcript"`// 完整文本
	Year       string `json:"year"`      // 年份
	Month      string `json:"month"`     // 月份
	Day        string `json:"day"`       // 日
	News       string `json:"news"`      // 新闻文本
	Link       string `json:"link"`      // 相关链接
}

错误处理

go-xkcd可能返回以下类型的错误：

func handleErrors() {
	client := xkcd.NewClient()
	
	_, err := client.Get(999999) // 不存在的漫画编号
	if err != nil {
		if err == xkcd.ErrComicNotFound {
			fmt.Println("漫画不存在")
		} else if err == xkcd.ErrInvalidNumber {
			fmt.Println("无效的漫画编号")
		} else {
			fmt.Printf("其他错误: %v\n", err)
		}
		return
	}
}

完整示例

下面是一个完整的示例程序，展示如何使用go-xkcd获取并显示漫画信息：

package main

import (
	"fmt"
	"log"
	"os"
	"github.com/nishanths/go-xkcd"
)

func main() {
	if len(os.Args) < 2 {
		fmt.Println("使用方法: xkcd [漫画编号|latest|search 关键字]")
		return
	}

	client := xkcd.NewClient()

	switch os.Args[1] {
	case "latest":
		comic, err := client.Latest()
		if err != nil {
			log.Fatal(err)
		}
		printComic(comic)

	case "search":
		if len(os.Args) < 3 {
			fmt.Println("请提供搜索关键字")
			return
		}
		results, err := client.Search(os.Args[2], nil)
		if err != nil {
			log.Fatal(err)
		}
		for _, comic := range results {
			printComicShort(comic)
		}

	default:
		var num int
		_, err := fmt.Sscanf(os.Args[1], "%d", &num)
		if err != nil {
			fmt.Println("无效的漫画编号")
			return
		}
		comic, err := client.Get(num)
		if err != nil {
			log.Fatal(err)
		}
		printComic(comic)
	}
}

func printComic(c *xkcd.Comic) {
	fmt.Printf("漫画 #%d: %s\n", c.Number, c.Title)
	fmt.Printf("发布日期: %s-%s-%s\n", c.Year, c.Month, c.Day)
	fmt.Printf("图片URL: %s\n", c.ImageURL)
	fmt.Printf("说明文字: %s\n", c.Alt)
	fmt.Printf("完整文本:\n%s\n", c.Transcript)
}

func printComicShort(c *xkcd.Comic) {
	fmt.Printf("#%d: %s (%s-%s-%s)\n", 
		c.Number, c.Title, c.Year, c.Month, c.Day)
}

注意事项

1. XKCD API有速率限制，不要频繁请求
2. 漫画编号从1开始，最新漫画的编号可以通过Latest()方法获取
3. 部分漫画可能有特殊格式(如交互式漫画)，需要特殊处理
4. 考虑缓存结果以减少API调用

go-xkcd库提供了简单直观的方式来访问XKCD的丰富内容，你可以基于它构建自己的XKCD阅读器、通知系统或其他有趣的应用。