uechi.io/source/_posts/2015/alfred-qiita-workflow-in-go.md

42 lines
2.1 KiB
Markdown
Raw Permalink Normal View History

2017-10-07 11:43:26 +09:00
---
title: Alfred Qiita Workflow in Go
2017-12-02 13:24:20 +09:00
date: 2015-09-07 09:00:00 +09:00
2019-08-14 21:24:49 +09:00
redirect_from: "/blog/2015/09/07/alfred-qiita-workflow-in-go"
2017-10-07 11:43:26 +09:00
---
2022-12-24 03:20:02 +09:00
![](/uploads/alfred-qiita-workflow.png)
2017-10-07 11:43:26 +09:00
2018-07-19 20:53:12 +09:00
Ruby で書かれている [Alfred Qiita Workflow](https://github.com/uetchy/alfred-qiita-workflow) を[バグ修正](https://github.com/uetchy/alfred-qiita-workflow/issues/3)のついでに Go で書き直した。
2017-10-07 11:43:26 +09:00
2018-07-19 20:53:12 +09:00
Qiita API v2 に対応し、ユーザー名とパスワードの代わりとして、[Personal Access Token](https://qiita.com/settings/tokens/new)を使い始めた。
2017-10-07 11:43:26 +09:00
これで、ストックした記事や自分で書いた記事を検索することがより気軽に出来る。
2018-07-19 20:53:12 +09:00
Alfred に返却する XML の生成には[go-alfred](https://github.com/pascalw/go-alfred)というライブラリを利用した。
2017-10-07 11:43:26 +09:00
## go-qiita
2018-07-19 20:53:12 +09:00
Alfred Qiita Workflow の API クライアント部分を切り出して [go-qiita](https://github.com/uetchy/go-qiita) としてリリースした。Workflow で必要だった部分しか実装してないが、記事の検索など基本的なことは出来る。
2017-10-07 11:43:26 +09:00
2018-07-19 20:53:12 +09:00
設計は Google の [go-github](https://github.com/google/go-github) を参考にしている。クライアントの初期化時に、以下のように http.Client 互換の Interface を渡してやれば、それを経由して通信するようになっている。
2017-10-07 11:43:26 +09:00
```go
// Personal Access Tokenを使ったOAuth2クライアントを作る
ts := oauth2.StaticTokenSource(&oauth2.Token{AccessToken: "personal access token"})
tc := oauth2.NewClient(oauth2.NoContext, ts)
// OAuth2クライアントをgo-qiitaに引き渡す
client := qiita.NewClient(tc)
// 今までに書いた記事を取得
items, _, _ := client.AuthenticatedUser.Items()
```
2018-07-19 20:53:12 +09:00
このようにすることで、API クライアントは認証系を気にせず API サーバーとのやりとりを考えることが出来る。このやり方はかなりスマートだと思うのでもっと流行って欲しい。
2017-10-07 11:43:26 +09:00
ちなみに認証をしない場合は`NewClient()``nil`を渡せばよい。
```go
client := qiita.NewClient(nil)
```