Designing libraries in Go way

Transcript

1. at Gopherಓ৔ ಉ૭ձ2021
   Go Β͍͠ϥΠϒϥϦΛ

   ͭ͘ΔͨΊʹߟ͑Δ͜ͱ
   

   View Slide

2. LUS !LUS@!LUS
   
   .FSQBZ$PEFQBZNFOU5FBN #BDLFOE
   
   XIPBNJ
   

   View Slide

3. at Gopherಓ৔ ಉ૭ձ2021
   Go Β͍͠ϥΠϒϥϦΛ

   ͭ͘ΔͨΊʹߟ͑Δ͜ͱ
   

   View Slide

4. w Ͱ΋Ͳ͏͢Ε͹ʜʁ
   w (PΒ͍͠ॻ͖ํɺϦϙδτϦͷઃఆɺ഑෍ͷ࢓ํʜ
   w ϦϙδτϦʹΑͬͯ͞·͟·
   (P੡ϥΠϒϥϦΛެ։͍ͨ͠ʂ
   

   View Slide

5. (PQIFS͔Βݟͯɺ

   ͲΜͳϥΠϒϥϦͩͱخ͍͠ͷ͔ΛΫϦΞʹ͢Δ
   ͜ͷτʔΫͰ఻͍͑ͨ͜ͱ
   

   View Slide

6. (PQIFS͔Βݟͯɺ

   ͲΜͳ044ͩͱخ͍͠ͷ͔ΛΫϦΞʹ͢Δ
   ͜ͷτʔΫͰ఻͍͑ͨ͜ͱ
   ࣮ࡍʹ044Λग़͢ࡍͷ໎͍Λখ͘͢͞Δʂ
   

   View Slide

7. w $-*πʔϧݻ༗ͷϓϥΫςΟε
   w ಛఆͷϥΠϒϥϦ΍ϑϨʔϜϫʔΫͷ۷ΓԼ͛
   ͜ͷτʔΫͰѻΘͳ͍͜ͱ
   

   View Slide

8. ϥΠϒϥϦઃܭͰؾΛ͚͍ͭͯΔ͜ͱ
   044ͱͯ͠ެ։͢ΔͨΊʹ
   ·ͱΊ
   ໨࣍
   

   View Slide

9. ϥΠϒϥϦઃܭͰؾΛ͚͍ͭͯΔ͜ͱ
   

   View Slide

10. Τϥʔ
    

    View Slide

11. w αʔυύʔςΟͷΤϥʔϥΠϒϥϦ΍YFSSPST͸
    ͔ͭΘͳ͍
    w ϥΠϒϥϦͷϢʔβʹͦͷΤϥʔϥΠϒϥϦͷ

    ࢖༻Λڧ੍ͤͯ͞͠·͏ͨΊ
    Ͱ͖ΔݶΓඪ४ΤϥʔͷΈΛ͔ͭ͏
    

    View Slide

12. w Ͱ͖ΔݶΓerrorsύοέʔδͷ"1*ͱޓ׵ੑ
    Λ࣋ͭ΋ͷΛબͿ
    w errors.Asɺerrors.Isɺerrors.Unwrap
    ඪ४ΤϥʔҎ֎Λ͔ͭ͏৔߹
    

    View Slide

13. $POUFYU
    

    View Slide

14. w DPOUFYUΩϟϯηϧػߏΛந৅Խͨ͠΋ͷ
    w ࣮ߦʹ௕͍͕͔͔࣌ؒΔՄೳੑͷ͋Δ΋ͷ͸
    DPOUFYUΛαϙʔτ͢΂͖
    $POUFYUBXBSF
    

    View Slide

15. ྫLUSBQJHFO
    

    View Slide

16. w (P੡ϥΠϒϥϦ
    w DVSMίϚϯυΛ࣮ߦͨ݁͠Ռ͔Β(P"1*ΫϥΠΞϯτ
    Λࣗಈੜ੒͢Δ
    LUSBQJHFO
    

    View Slide

17. $ curl https://api.github.com/repos/ktr0731/apigen
    {
    "id": 312020626,
    "node_id": "MDEwOlJlcG9zaXRvcnkzMTIwMjA2MjY=",
    "name": "apigen",
    "full_name": "ktr0731/apigen",
    "private": false,
    "owner": {
    "login": "ktr0731",
    "id": 12953836,
    "node_id": "MDQ6VXNlcjEyOTUzODM2",
    …
    

    View Slide

18. View Slide

19. View Slide

20. w ಺෦Ͱ"1*ϦΫΤετΛߦ͍ͬͯΔͨΊ
    w ͙͢ʹ݁Ռ͕ฦͬͯ͘Δͱ͸ݶΒͳ͍
    w DPOUFYUΛड͚औΔ͜ͱͰ্ҐϨΠϠʔʹΩϟϯηϧɾ
    λΠϜΞ΢τͷ࢓૊ΈΛఏڙͰ͖Δ
    ͳͥDPOUFYUBXBSFͳؔ਺ͳͷ͔ʁ
    

    View Slide

21. Φϓγϣϯ
    

    View Slide

22. w ߏ଄ମ
    w GVODUJPOBMPQUJPOQBUUFSO
    Φϓγϣϯ
    

    View Slide

23. w $PNNBOEܕͷϑΟʔϧυͰΦϓγϣϯ஋Λड͚Δ
    w
    TQGDPCSB
    

    View Slide

24. w ؔ਺ͱՄม௕Ҿ਺ͷ૊Έ߹ΘͤͰΦϓγϣϯΛදݱ
    w ΦϓγϣϯܕΛΤΫεϙʔτ͢Δඞཁ͕ͳ͍
    w ؆ܿͰ໌շͳهड़ʹͳΔ
    GVODUJPOBMPQUJPOQBUUFSO
    

    View Slide

25. LUSBQJHFO
    

    View Slide

26. LUSBQJHFO
    

    View Slide

27. LUSBQJHFO
    

    View Slide

28. w Ұ௕Ұ୹
    w Φϓγϣϯ͕ଟ͍৔߹ɺߏ଄ମͷ΄͏͕ݟ௨͕͠ྑ͍
    w (PGNU͕ϑΟʔϧυΛଗ͑ͯ͘ΕΔ
    w ͦΕҎ֎͸GVODUJPOBMPQUJPOQBUUFSO͕ྑͦ͞͏
    ߏ଄ମWTGVODUJPOBMPQUJPOQBUUFSO
    

    View Slide

29. w Φϓγϣϯ΋࢓༷ͷҰ෦
    w ૿΍ͨ͢ͼʹϥΠϒϥϦͷෳࡶੑ͕૿͢
    w ඞཁ࠷௿ݶʹอͭ
    ΦϓγϣϯΛ૿΍͗͢͠ͳ͍
    

    View Slide

30. ྫ"1*ΫϥΠΞϯτͷϦτϥΠ
    

    View Slide

31. View Slide

32. ϦτϥΠʹؔ͢ΔΦϓγϣϯ͕

    ͨ͘͞Μ͋ͬͯෳࡶʜ🤔
    

    View Slide

33. Φϓγϣϯ͕Ұ͚ͭͩʹͳͬͯ

    Θ͔Γ΍͘͢ͳͬͨ☺
    

    View Slide

34. DFOLBMUJCBDLP⒎ʹґଘͯ͠͠·͍ͬͯΔ😨
    

    View Slide

35. w )551ϦΫΤετʹࣦഊͨ͠ͱ͖ʹҰఆ࣌ؒ଴ͪɺ

    ࠶౓ϦΫΤετΛ౤͛Δ
    ϦτϥΠʹ͍ͭͯ΋͏Ұ૚ਂ͘ߟ͑Δ
    

    View Slide

36. w )551ϦΫΤετʹࣦഊͨ͠ͱ͖ʹҰఆ࣌ؒ଴ͪɺ

    ࠶౓ϦΫΤετΛ౤͛Δ
    w ϦτϥΠ͸)551ϦΫΤετͷͨΊʹ͔͠࢖ΘΕͳ͍
    ϦτϥΠʹ͍ͭͯ΋͏Ұ૚ਂ͘ߟ͑Δ
    

    View Slide

37. w )551ϦΫΤετʹࣦഊͨ͠ͱ͖ʹҰఆ࣌ؒ଴ͪɺ

    ࠶౓ϦΫΤετΛ౤͛Δ
    w ϦτϥΠ͸)551ϦΫΤετͷͨΊʹ͔͠࢖ΘΕͳ͍
    w )551ΫϥΠΞϯτͰ࣮૷Ͱ͖ΔͷͰ͸ʜʁ
    ϦτϥΠʹ͍ͭͯ΋͏Ұ૚ਂ͘ߟ͑Δ
    

    View Slide

38. w )551ϦΫΤετʹࣦഊͨ͠ͱ͖ʹҰఆ࣌ؒ଴ͪɺ

    ࠶౓ϦΫΤετΛ౤͛Δ
    w ϦτϥΠ͸)551ϦΫΤετͷͨΊʹ͔͠࢖ΘΕͳ͍
    w )551ΫϥΠΞϯτͰ࣮૷Ͱ͖ΔͷͰ͸ʜʁ
    w ͦ΋ͦ΋ϦτϥΠʹؔͯ͜͠ͷϥΠϒϥϦͰߟ͑Δඞཁ͋Δʜʁ
    ϦτϥΠʹ͍ͭͯ΋͏Ұ૚ਂ͘ߟ͑Δ
    

    View Slide

39. w ґଘ͕ඪ४ύοέʔδ͚ͩʹͳΔ
    w ϦτϥΠʹ·ͭΘΔؔ৺ࣄΛ෼཭Ͱ͖Δ
    w Ϣʔβ͸೚ҙͷϦτϥΠ࣮૷Λબ΂Δ
    w τϨʔε΍ϩΨʔͳͲΛ࢓ࠐΈ͍ͨ৔߹Ͱ΋ϥΠϒϥϦͷ

    Φϓγϣϯ͕૿͑ͳ͍ʂ
    )551ΫϥΠΞϯτΛड͚औΔϝϦοτ
    

    View Slide

40. )551ΫϥΠΞϯτΛड͚औΔΑ͏ʹͯ͠ΈΔ
    

    View Slide

41. View Slide

42. Ϣʔβ͸IBTIJDPSQHPSFUSZBCMFIUUQͰϦτϥΠΛߦ͏
    

    View Slide

43. View Slide

44. (PΒ͍͠ΠϯλʔϑΣʔεΛ

    ఏڙ͢Δ
    

    View Slide

45. w ඪ४ɾ४ඪ४ύοέʔδ͕͓खຊ
    w ޙํޓ׵ੑͷͨΊʹ࿪ʹͳ͍ͬͯΔՕॴ΋

    ΋ͪΖΜ͋ΔͷͰ஫ҙ
    (PΒ͍͠ΠϯλʔϑΣʔεΛఏڙ͢Δ
    

    View Slide

46. ྫLUSBQJHFO
    

    View Slide

47. w DVSMίϚϯυ
    w ੜ੒͢ΔϑΝΠϧͷύοέʔδ໊
    w ੜ੒͢Δϝιου໊
    w ϝιουͷύϥϝʔλ໊
    w FUD
    BQJHFOͷೖྗ
    

    View Slide

48. ίϚϯυϥΠϯʜʁ
    $ apigen --package api --out api_gen.go \
    "curl example.com/post" "GetPost" \
    "curl -d "{...}" example.com/posts" "CreatePost"
    

    View Slide

49. ίϚϯυϥΠϯʜʁ
    $ apigen --package api --out api_gen.go \
    "curl example.com/post" "GetPost" \
    "curl -d "{...}" example.com/posts" "CreatePost"
    ੜ੒ର৅"1*͕૿͑ΔͨͼʹҾ਺͕૿͑Δ🤔
    ҉໧తʹʮDVSMίϚϯυʯʮϝιου໊ʯͷϖΞΛཁٻ͍ͯͯ͠௚ײతͰ͸ͳ͍ʜ
    

    View Slide

50. ֎෦ϑΝΠϧʜʁ
    $ apigen --package api --out api_gen.go definition.yaml
    

    View Slide

51. ֎෦ϑΝΠϧʜʁ
    $ apigen --package api --out api_gen.go definition.yaml
    ࣮ߦ࣌ʹ͔͠ଥ౰ੑ͕ݕূͰ͖ͳ͍ͷͰ࢖͍ͮΒ͍🤔
    

    View Slide

52. w DVSMίϚϯυΛ࣮ߦͨ݁͠Ռ͔Β(P"1*ΫϥΠΞϯτ
    Λࣗಈੜ੒͢Δ
    BQJHFOͷ૝ఆϢʔβΛࢥ͍ग़͢
    

    View Slide

53. w DVSMίϚϯυΛ࣮ߦͨ݁͠Ռ͔Β(P"1*ΫϥΠΞϯτ
    Λࣗಈੜ੒͢Δ
    BQJHFOͷ૝ఆϢʔβΛࢥ͍ग़͢
    

    View Slide

54. w DVSMίϚϯυΛ࣮ߦͨ݁͠Ռ͔Β(P"1*ΫϥΠΞϯτ
    Λࣗಈੜ੒͢Δ
    w Ϣʔβ͸(PͰ։ൃΛ͍ͯ͠Δ͜ͱΛલఏʹͰ͖Δ
    w (PΛ͏·͘࢖ͬͨྑ͍ղܾࡦ͕͋Γͦ͏ʜ
    BQJHFOͷ૝ఆϢʔβΛࢥ͍ग़͢
    

    View Slide

55. w ४ඪ४ύοέʔδͷBOBMZTJTΛར༻
    w BOBMZTJT"OBMZ[FSΛड͚औ͍ͬͯΔ
    HPWFUͷ࣮૷
    

    View Slide

56. w ϑΟʔϧυͰ͞·͟·ͳઃఆΛ

    ߦ͍ͬͯΔ
    BOBMZTJT"OBMZ[FS
    

    View Slide

57. w ϑΟʔϧυͰ͞·͟·ͳઃఆΛ

    ߦ͍ͬͯΔ
    BOBMZTJT"OBMZ[FS
    

    View Slide

58. w BOBMZTJTύοέʔδͷΑ͏ʹઃఆΛߦ͏ܕΛ

    ఆٛ͠ɺΤϯτϦϙΠϯτؔ਺΁౉͢
    ྑͦ͞͏ͳղܾࡦ
    

    View Slide

59. View Slide

60. "1*ఆٛΛߦ͏
    

    View Slide

61. ίʔυੜ੒ʂ
    

    View Slide

62. View Slide

63. w ੩తܕ෇͚͞ΕͨίʔυδΣωϨʔλ
    w "1*ఆٛΛॻ͍ͯapigen.Generate΁౉͚ͩ͢
    w ΦϓγϣϯͰio.WriterΛड͚औͬͨΓ͢Δ͜ͱ΋Մೳʂ
    ސ٬͕ຊ౰ʹཉ͔ͬͨ͠΋ͷ
    

    View Slide

64. ྫLUSHPGV[[ZpOEFS
    

    View Slide

65. w (P੡ϥΠϒϥϦ
    w G[GͷΑ͏ͳGV[[ZpOEFSΛ(P੡$-*πʔϧ
    ʹ૊ΈࠐΊΔ
    LUSHPGV[[ZpOEFS
    

    View Slide

66. View Slide

67. ֤ީิΛදࣔ͢ΔͨΊʹ͸ʜ🤔
    

    View Slide

68. ಠࣗܕͰީิΛ౉ͯ͠΋Β͏ʁ
    

    View Slide

69. Ϣʔβ͸ຖճ[]*CandidateΛͭ͘Βͳ͍ͱ
    ͍͚ͳ͍ͷͰ͋·Γ࢖͍উख͕ྑ͘ͳ͍ʜ
    

    View Slide

70. w δΣωϦΫε͸ ·ͩ
    ͳ͍
    ೚ҙͷܕͷεϥΠεΛѻ͏ʹ͸ʜʁ
    

    View Slide

71. w δΣωϦΫε͸ ·ͩ
    ͳ͍
    w ඪ४ύοέʔδʹ೚ҙͷܕͷεϥΠεΛѻ͍ͬͯ
    Δؔ਺͕͋ͬͨΑ͏ͳʜʁ
    ೚ҙͷܕͷεϥΠεΛѻ͏ʹ͸ʜʁ
    

    View Slide

72. TPSU4MJDF
    

    View Slide

73. View Slide

74. View Slide

75. εϥΠεͷܕʹ͸ؔ༩ͤͣɺީิJͷλΠτϧΛ
    ܾఆ͢ΔͨΊͷؔ਺Λड͚औΔΑ͏ʹ
    

    View Slide

76. εϥΠεͰ͋Ε͹ͳΜͰ΋౉ͤΔΑ͏ʹʂ
    

    View Slide

77. View Slide

78. 044ͱͯ͠ެ։͢ΔͨΊʹ
    

    View Slide

79. w (JU)VC͕ެ։͍ͯ͠Δ044ͷΨΠυ
    w 044ͷ8)"58):ɺߩݙํ๏ɺϓϩδΣΫτͷ

    ্ཱͪ͛ํͳͲΛ໢ཏ͍ͯ͠Δ
    w ୯७ʹಡΈ෺ͱͯ͠΋͓΋͠Ζ͍
    0QFO4PVSDF(VJEFTΛಡΉ
    

    View Slide

80. https://opensource.guide/ja/starting-a-project/
    

    View Slide

81. w ϓϩδΣΫτͷґଘ؅ཧͷͨΊ
    w όʔδϣϯ؅ཧ͞ΕͨϞδϡʔϧͱͯ͠ఏڙ͢ΔͨΊ
    (PNPEVMFTʹରԠ͢Δ
    

    View Slide

82. $ go mod init && go mod tidy
    (PNPEVMFTʹରԠ͢Δ
    

    View Slide

83. $ go mod init && go mod tidy
    (PNPEVMFTʹରԠ͢Δ
    ˞λά෇͚ʹ͍ͭͯ͸ޙड़
    

    View Slide

84. w ࣗ෼ͷ044͕ґଘ͍ͯ͠ΔϞδϡʔϧͷ

    ϥΠηϯε΋දه͢΂͖
    w 4POHNVHPDSFEJUT͕΂ΜΓ
    ґଘϞδϡʔϧͷϥΠηϯεදه
    

    View Slide

85. $ gocredits -w .
    ґଘϞδϡʔϧͷϥΠηϯεදه
    

    View Slide

86. w (PNPEVMFTͰMJOUFSͳͲͷπʔϧ܈΋؅ཧ͢Δ
    w Ϗϧυ΍ςετͷ࠶ݱੑΛ΋ͨͤΔͨΊ
    (Pπʔϧͷґଘ؅ཧ
    

    View Slide

87. https://github.com/golang/go/wiki/Modules#how-can-i-track-tool-dependencies-for-a-module
    

    View Slide

88. w (JUλάΛ੾ͬͯQVTI͢Ε͹৽͍͠Ϟδϡʔϧ
    ͱͯ͠ೝࣝ͞ΕΔ
    ϥΠϒϥϦͷ഑෍
    

    View Slide

89. w (P3FMFBTFSΛ͔ͭ͏ͱΑΓྑ͍͔΋
    w (JU)VC3FMFBTFTͷ࡞੒ɺ$IBOHFMPHͷ࡞੒Λ
    Α͠ͳʹ΍ͬͯ͘ΕΔ
    ϥΠϒϥϦͷ഑෍
    

    View Slide

90. $ cat .goreleaser.yaml
    builds:
    - skip: true
    $ git tag v0.1.0 main
    $ goreleaser
    ϥΠϒϥϦͷ഑෍
    

    View Slide

91. w 044ͱͯ͠ग़͢ϥΠϒϥϦ͸ϢʔβͷͨΊʹ

    υΩϡϝϯτΛॻ͘΂͖
    υΩϡϝϯτ
    

    View Slide

92. w Ϣʔβͷࢹ఺ͰυΩϡϝϯτΛಡΊΔ
    w (P%PD͚ͩͰ࢖͍ํ͕ཧղͰ͖Δ͔ʁ
    w ެ։͢Δඞཁͷͳ͍΋ͷͳ͍͔ʁ
    w ࢓༷ͷ࿙Ε͸ͳ͍͔ʁ
    (P%PDΛ࢖ͬͨυΩϡϝϯτͷચ࿅
    

    View Slide

93. w ਓʑ͸υΩϡϝϯτΛಡ·ͳ͍
    w &YBNQMFςετ͕͋Ε͹ɺͦͷϥΠϒϥϦͷ࣭
    ͕͋Δఔ౓Θ͔Δ
    &YBNQMFςετΛ༻ҙ͢Δ
    

    View Slide

94. View Slide

95. w &YBNQMFςετΑΓෳࡶͳ࢖༻ྫΛஔ͍͓ͯ͘
    @FYBNQMFσΟϨΫτϦ
    

    View Slide

96. w @΍͔Β࢝·ΔϑΝΠϧɾσΟϨΫτϦ

    ͓ΑͼUFTUEBUBͱ͍͏σΟϨΫτϦ͸

    (Pπʔϧ͔Βແࢹ͞ΕΔ
    w @FYBNQMFͱ͍͏໋໊͸׳श
    ಛघͳϑΝΠϧ໊ɾσΟϨΫτϦ໊
    https://golang.org/cmd/go/#hdr-Package_lists_and_patterns
    

    View Slide

97. ·ͱΊ
    

    View Slide

98. w αʔυύʔςΟ΁ͷґଘΛগͳ͘ɾখ͘͞อͭ
    w ࢓༷Λগͳ͘ɾখ͘͞อͭ
    w DPOUFYUΛͪΌΜͱαϙʔτ͢Δ
    w (PΒ͍͠ΠϯλʔϑΣʔεΛఏڙ͢Δ
    w ඪ४ɾ४ඪ४ύοέʔδ͕ͱͯ΋ࢀߟʹͳΔ
    ϥΠϒϥϦઃܭͰؾΛ͚͍ͭͯΔ͜ͱ
    

    View Slide

99. w 0QFO4PVSDF(VJEFTΛಡΜͰ͓͘ͱྑ͍͔΋
    w (PNPEVMFTͰϥΠϒϥϦͷόʔδϣϯ؅ཧΛ͠Α͏
    w υΩϡϝϯτ͸͕Μ͹ͬͯॻ͜͏
    w ࣗ෼͸ϒϥογϡΞοϓલʹॻ͘͜ͱ͕ଟ͍
    044ͱͯ͠ެ։͢ΔͨΊʹ
    

    View Slide