使用golyrics从Wikia获取音乐歌词数据

golyrics是一个Go语言库，用于从Wikia(现Fandom)网站获取音乐歌词数据。下面我将介绍如何使用这个库以及提供示例代码。

安装golyrics

首先，你需要安装golyrics库：

go get github.com/michiwend/golyrics

基本使用方法

1. 获取歌词

package main

import (
	"fmt"
	"log"

	"github.com/michiwend/golyrics"
)

func main() {
	// 创建Lyrics实例
	l := golyrics.Lyrics{}
	
	// 搜索并获取歌词
	// 参数：艺术家名，歌曲名
	err := l.GetLyrics("Coldplay", "Viva La Vida")
	if err != nil {
		log.Fatalf("获取歌词失败: %v", err)
	}
	
	// 打印歌词
	fmt.Println("歌词内容:")
	fmt.Println(l.Text)
	
	// 打印来源URL
	fmt.Println("\n来源:", l.URL)
}

2. 获取多个结果

有时候一首歌可能有多个版本的歌词，可以获取所有结果：

package main

import (
	"fmt"
	"log"

	"github.com/michiwend/golyrics"
)

func main() {
	// 获取所有匹配的歌词结果
	results, err := golyrics.GetAllLyrics("Adele", "Hello")
	if err != nil {
		log.Fatalf("获取歌词失败: %v", err)
	}
	
	// 遍历所有结果
	for i, lyric := range results {
		fmt.Printf("版本 %d:\n", i+1)
		fmt.Println(lyric.Text)
		fmt.Println("来源:", lyric.URL)
		fmt.Println("-------------------")
	}
}

高级用法

1. 设置自定义HTTP客户端

package main

import (
	"fmt"
	"log"
	"net/http"
	"time"

	"github.com/michiwend/golyrics"
)

func main() {
	// 创建自定义HTTP客户端
	client := &http.Client{
		Timeout: 10 * time.Second,
	}
	
	// 创建Lyrics实例并设置客户端
	l := golyrics.Lyrics{Client: client}
	
	err := l.GetLyrics("Ed Sheeran", "Shape of You")
	if err != nil {
		log.Fatalf("获取歌词失败: %v", err)
	}
	
	fmt.Println(l.Text)
}

2. 错误处理

package main

import (
	"fmt"
	"log"

	"github.com/michiwend/golyrics"
)

func main() {
	l := golyrics.Lyrics{}
	
	// 尝试获取不存在的歌曲
	err := l.GetLyrics("Unknown Artist", "Nonexistent Song")
	if err != nil {
		switch err {
		case golyrics.ErrNoLyricsFound:
			fmt.Println("未找到歌词")
		case golyrics.ErrNoAPIConnection:
			fmt.Println("无法连接到Wikia API")
		default:
			log.Fatalf("未知错误: %v", err)
		}
		return
	}
	
	fmt.Println(l.Text)
}

注意事项

1. API限制：Wikia/Fandom可能有请求频率限制，大量请求可能导致IP被封。
2. 数据准确性：歌词数据来自用户贡献，可能存在错误或不完整。
3. 可用性：Wikia的API结构可能变化，导致库失效。
4. 替代方案：如果golyrics不可用，可以考虑其他歌词API如Genius、Musixmatch等。

完整示例

下面是一个更完整的示例，包含错误处理和结果验证：

package main

import (
	"bufio"
	"fmt"
	"log"
	"os"
	"strings"

	"github.com/michiwend/golyrics"
)

func main() {
	reader := bufio.NewReader(os.Stdin)
	
	fmt.Print("请输入艺术家名称: ")
	artist, _ := reader.ReadString('\n')
	artist = strings.TrimSpace(artist)
	
	fmt.Print("请输入歌曲名称: ")
	title, _ := reader.ReadString('\n')
	title = strings.TrimSpace(title)
	
	// 获取歌词
	l := golyrics.Lyrics{}
	err := l.GetLyrics(artist, title)
	if err != nil {
		if err == golyrics.ErrNoLyricsFound {
			fmt.Printf("未找到 %s - %s 的歌词\n", artist, title)
		} else {
			log.Fatalf("获取歌词失败: %v", err)
		}
		return
	}
	
	// 显示结果
	fmt.Printf("\n%s - %s 的歌词:\n\n", artist, title)
	fmt.Println(l.Text)
	fmt.Printf("\n来源: %s\n", l.URL)
	
	// 可选：保存到文件
	fmt.Print("\n是否要保存到文件？(y/n): ")
	save, _ := reader.ReadString('\n')
	if strings.TrimSpace(strings.ToLower(save)) == "y" {
		filename := fmt.Sprintf("%s_%s.txt", artist, title)
		err = os.WriteFile(filename, []byte(l.Text), 0644)
		if err != nil {
			log.Printf("保存文件失败: %v", err)
		} else {
			fmt.Printf("歌词已保存到 %s\n", filename)
		}
	}
}

这个库提供了一个简单的方式来从Wikia获取歌词数据，但请注意它依赖于Wikia的网站结构，如果Wikia改变其API或页面结构，这个库可能需要更新。