ずっと昔に Star をつけたはずの 思い出せない GitHub リポジトリを見つけたい！

Transcript

1. ずっと昔に Star をつけたはずの 思い出せない GitHub リポジトリを見つけたい！ 2024/12/15 (Sun) Kyoto.go #56

   松本紘輝 / rokuosan / id:rokuokun

2. 自己紹介 松本紘輝 Matsumoto Kouki 京都産業大学 情報理工学部 1年 コーヒーが好きです。 Go の他に

   Kotlin, Perl を書くこともあります。 たまに疑問符がつく会社でアルバイトをしています。 https://github.com/rokuosan https://twitter.com/rokuosan_dev ↑現実の姿 インターネットの姿 ↑ rokuosan / id:rokuokun

3. 1. GitHub Star

4. はじめに GitHub Star ってありますよね

5. GitHub Star いい感じのリポジトリをマークできる

6. GitHub Star ・検索可能 ・リストとかも作れる ・他人の Star も見れる

7. GitHub Star GitHub Star 最高！便利！ 今日はこれだけ覚えて帰ってください

8. GitHub Star の課題 気づけば大量にあるStar 「昔に星つけたリポジトリなんだっけ？」 ↓ 検索に微妙にヒットしない （名前かDescriptionの中しか見ないので）

9. GitHub Star の課題

10. GitHub Star 解決策 「READMEからも検索したい！！」

11. GitHub Star 解決策 「READMEからも検索したい！！」 ↓ 作るぜ

12. 2. アプリケーションの形式を考える

13. どうやって実装するか 要望 「とにかくお手軽に作りたい！」 「Token 発行もやりたくない！」

14. どうやって実装するか お馴染みの GitHub CLI

15. どうやって実装するか GitHub CLI には拡張機能の仕組みがある

16. どうやって実装するか これだ！！

17. ちなみに コマンド一発で 雛形＋リリースCI が作成できる $ gh extension create --precompiled=go sample

18. 3. どう作るかを考える

19. 作る方法を考える 1. ユーザーのStarをつけた リポジトリ情報を取得 2. READMEの内容を見る 3. 取得したデータから検索 基本的な流れ この部分を考える。

    ・HTTP REST API ・GraphQL API 上記どちらかで取得

20. GitHub REST API で取る例 https://api.github.com/user/starred https://api.github.com/repos/{owner}/{repo}/readme 1. Star を付けたリポジトリ情報を取得 →

    オーナーや関連するURLが取れる 100個Starある時に101リクエストになる → これは困る 2. 指定したリポジトリのREADMEを取得 → 1リクエストに1リポジトリの情報のみ取得可能

21. GitHub GraphQL API で取る例 https://api.github.com/graphql GraphQL エンドポイント 1. Star を付けたリポジトリ情報を取得

    2. 指定したリポジトリのREADMEを取得 右のクエリで 1. 2. の両方を同時にできる

22. GitHub GraphQL API で取る例 これだ！！

23. 実装はこうなる struct で右のクエリを表現する

24. 実装はこうなる struct でクエリを書く gh コマンド内部で使用されている api package を使ってリクエストをする

25. 作る方法を考える 1. ユーザーのStarをつけた リポジトリ情報を取得 2. READMEの内容を見る 3. 取得したデータから検索 基本的な流れ GraphQL

    で決まり！

26. 作る方法を考える 1. ユーザーのStarをつけた リポジトリ情報を取得 2. READMEの内容を見る 3. 取得したデータから検索 基本的な流れ ここはどうする？

27. データ検索手法を考える よくわからないので直感で選ぶ Bleve Bluge ・スター数 10.1k (2024/12/14 現在) ・Grafana で使われていた！

    ・スター数 1.9k (2024/12/14 現在) ・開発が止まっている・・・？ ひとまずこれで

28. 実装はこうなる Getting Started を眺めて書く ここを改善すると 検索体験が良くなるはず （有識者教えてください）

29. 4. カッコいい表示にしたい

30. イケイケなCLI（TUI）を作るには Bubble Tea がいいらしい https://github.com/charmbracelet/bubbletea Kyoto.go remote #32 で紹介済み（らしい） id:motemen

    による記事 https://motemen.hatenablog.com/entry/2022/06/introduction-to-go-bubbletea

31. イケイケなCLI（TUI）を作るには 検索結果をいい感じにリスト表示したい ↓ 発表に間に合わなかったので断念

32. 5. 成果物

33. 成果物 https://github.com/rokuosan/gh-find-starred

34. 成果物 gh find-starred golang golang で検索してみた graphql が一番上…!?

35. 6. 終わりに

36. 終わりに 検索結果にやや不満は残るが、 機能としては実現できたのでヨシッ！

37. 終わりに : 余談 GitHub Star を管理するいい感じのサービスがあるらしい（？） https://astralapp.com/

38. ずっと昔に Star をつけたはずの 思い出せない GitHub リポジトリを見つけたい！ 2024/12/15 (Sun) Kyoto.go #56

    松本紘輝 / rokuosan / id:rokuokun