Golang Trello API集成开发插件库Trello的使用

安装

Go Trello API已经测试兼容Go 1.7及以上版本。它唯一的依赖是github.com/pkg/errors包，其他仅依赖Go标准库。

go get github.com/adlio/trello

基本用法

所有交互都从trello.Client开始。使用您的appKey和token创建一个客户端：

client := trello.NewClient(appKey, token)

所有API请求都接受一个trello.Arguments对象，这是一个简单的map[string]string，在API调用中转换为查询字符串参数。

board, err := client.GetBoard("bOaRdID", trello.Defaults())
if err != nil {
  // 处理错误
}

客户端持久性

当从Board获取Lists或从Lists获取Cards时，原始的trello.Client指针会在返回的子对象中传递。这使得您可以通过在接收到的对象上调用函数来发起额外的API调用：

client := trello.NewClient(appKey, token)
board, err := client.GetBoard("ID", trello.Defaults())

// GetLists使用`client`中的凭据向/boards/:id/lists发起API调用
lists, err := board.GetLists(trello.Defaults())

for _, list := range lists {
  // GetCards使用`client`中的凭据向/lists/:id/cards发起API调用
  cards, err := list.GetCards(trello.Defaults())
}

获取用户的Trello Boards

可以通过ID直接检索Board，或者通过请求成员的所有Board：

member, err := client.GetMember("usernameOrId", trello.Defaults())
if err != nil {
  // 处理错误
}

boards, err := member.GetBoards(trello.Defaults())
if err != nil {
  // 处理错误
}

获取Board上的Lists

board, err := client.GetBoard("bOaRdID", trello.Defaults())
if err != nil {
  // 处理错误
}

lists, err := board.GetLists(trello.Defaults())
if err != nil {
  // 处理错误
}

获取Board上的Cards

board, err := client.GetBoard("bOaRdID", trello.Defaults())
if err != nil {
  // 处理错误
}

cards, err := board.GetCards(trello.Defaults())
if err != nil {
  // 处理错误
}

获取List上的Cards

list, err := client.GetList("lIsTID", trello.Defaults())
if err != nil {
  // 处理错误
}

cards, err := list.GetCards(trello.Defaults())
if err != nil {
  // 处理错误
}

创建和删除Board

可以在使用其凭据的用户的Board结构上创建或删除Board。

board := trello.NewBoard("My bucket list")

// POST
err := client.CreateBoard(&board, trello.Defaults())

// DELETE
err := board.Delete(trello.Defaults())
if err != nil {
  fmt.Println(err)
}

向Board添加新成员

board, err := client.GetBoard("bOaRdID", trello.Defaults())
if err != nil {
  // 处理错误
}

member := Member{Email: "user@example.com"}
_, err := board.AddMember(&member, trello.Defaults())

if err != nil {
  // 处理错误
}

归档、取消归档和删除Card

// 归档
err := card.Archive()

// 取消归档
err := card.Unarchive()

// 删除
err := card.Delete()

创建Card

API提供了几种创建新Card的机制。

在客户端从头创建Card

这种方法需要最多的Card输入数据：

card := trello.Card{
  Name: "Card Name",
  Desc: "Card description",
  Pos: 12345.678,
  IDList: "iDOfaLiSt",
  IDLabels: []string{"labelID1", "labelID2"},
}
err := client.CreateCard(card, trello.Defaults())

在List上创建Card

list, err := client.GetList("lIsTID", trello.Defaults())
list.AddCard(&trello.Card{ Name: "Card Name", Desc: "Card description" }, trello.Defaults())

通过复制另一个Card创建Card

err := card.CopyToList("listIdNUmber", trello.Defaults())

获取Board上的Actions

board, err := client.GetBoard("bOaRdID", trello.Defaults())
if err != nil {
  // 处理错误
}

actions, err := board.GetActions(trello.Defaults())
if err != nil {
  // 处理错误
}

获取Card上的Actions

card, err := client.GetCard("cArDID", trello.Defaults())
if err != nil {
  // 处理错误
}

actions, err := card.GetActions(trello.Defaults())
if err != nil {
  // 处理错误
}

在List内重新排列Cards

err := card.MoveToTopOfList()
err = card.MoveToBottomOfList()
err = card.SetPos(12345.6789)

将Card移动到另一个List

err := card.MoveToList("listIdNUmber", trello.Defaults())

Card祖先关系

Trello在Card作为其他Card的副本创建时提供祖先跟踪。这个包提供了处理这些数据的函数：

// ancestors将保存一个*trello.Cards切片，第一个
// 是Card的父级，最后一个是父级的父级的父级...
ancestors, err := card.GetAncestorCards(trello.Defaults())

// GetOriginatingCard()是祖先Card切片中最后一个元素的别名
ultimateParentCard, err := card.GetOriginatingCard(trello.Defaults())

调试日志

如果您想查看所有API调用的日志，可以将一个.Logger（实现Debugf(string, ...interface{})）附加到您的客户端。记录器的接口模仿logrus。示例用法：

logger := logrus.New()
logger.SetLevel(logrus.DebugLevel)
client := trello.NewClient(appKey, token)
client.Logger = logger