Geddit 项目技术文档

1. 安装指南

Geddit 是一个用 Go 语言编写的，方便使用 Reddit API 的抽象库。在开始使用前，您需要确保已经安装了 Go 语言环境。

安装步骤：

1. 克隆或下载项目：

   git clone https://github.com/jzelinskie/geddit.git
   

2. 进入项目目录：

   cd geddit
   

3. 使用 go get 命令安装项目依赖：

   go get github.com/jzelinskie/geddit
   

2. 项目的使用说明

Geddit 提供了多种方法来与 Reddit API 进行交互。以下是一些基础的使用说明。

示例代码：

package main

import (
	"fmt"
	"github.com/jzelinskie/geddit"
)

func main() {
	// 登录到 Reddit
	session, err := geddit.NewLoginSession(
		"novelty_account",
		"password",
		"gedditAgent v1",
	)
	if err != nil {
		panic(err)
	}

	// 设置列表选项
	subOpts := geddit.ListingOptions{
		Limit: 10,
	}

	// 获取 Reddit 默认首页
	submissions, err := session.DefaultFrontpage(geddit.DefaultPopularity, subOpts)
	if err != nil {
		panic(err)
	}

	// 遍历并打印每个提交的标题和作者
	for _, s := range submissions {
		fmt.Printf("Title: %s\nAuthor: %s\n\n", s.Title, s.Author)
	}

	// 对第一个帖子进行点赞
	err = session.Vote(submissions[0], geddit.UpVote)
	if err != nil {
		panic(err)
	}
}

注意事项：

• 请替换 novelty_account 和 password 为您的 Reddit 账号密码。
• 上面的示例使用了旧的 Cookie 认证方法。Reddit API 的使用频率受限，因此建议使用 OAuth 认证方法。

3. 项目API使用文档

Geddit 提供了一系列 API 方法来与 Reddit 进行交互。以下是一些主要 API 方法的简要说明：

• NewLoginSession：创建一个新的登录会话。
• DefaultFrontpage：获取 Reddit 默认首页。
• Frontpage：获取个人的 Reddit 首页。
• SubredditSubmissions：获取指定子版的提交内容。
• Vote：对帖子进行投票（点赞或点踩）。

更多 API 方法请参考项目源代码中的注释和相关文档。

4. 项目安装方式

请参考上述“安装指南”部分进行项目安装。简而言之，使用 go get 命令可以快速安装 Geddit 库及其依赖项。