Designing libraries in Go way

Transcript

1. at Gopherಓ৔ ಉ૭ձ2021 Go Β͍͠ϥΠϒϥϦΛ
 ͭ͘ΔͨΊʹߟ͑Δ͜ͱ
2. LUS
   !LUS@
   
   !LUS
   .FSQBZ
   $PEFQBZNFOU
   5FBN
   #BDLFOE 
   XIPBNJ
3. at Gopherಓ৔ ಉ૭ձ2021 Go Β͍͠ϥΠϒϥϦΛ
 ͭ͘ΔͨΊʹߟ͑Δ͜ͱ
4. w Ͱ΋Ͳ͏͢Ε͹ʜʁ
   w (P
   Β͍͠ॻ͖ํɺϦϙδτϦͷઃఆɺ഑෍ͷ࢓ํʜ
   w ϦϙδτϦʹΑͬͯ͞·͟· (P
   ੡ϥΠϒϥϦΛެ։͍ͨ͠ʂ
5. (PQIFS
   ͔Βݟͯɺ
 ͲΜͳϥΠϒϥϦͩͱخ͍͠ͷ͔ΛΫϦΞʹ͢Δ ͜ͷτʔΫͰ఻͍͑ͨ͜ͱ
6. (PQIFS
   ͔Βݟͯɺ
 ͲΜͳ
   044
   ͩͱخ͍͠ͷ͔ΛΫϦΞʹ͢Δ ͜ͷτʔΫͰ఻͍͑ͨ͜ͱ ࣮ࡍʹ
   044
   Λग़͢ࡍͷ໎͍Λখ͘͢͞Δʂ
7. w $-*
   πʔϧݻ༗ͷϓϥΫςΟε
   w ಛఆͷϥΠϒϥϦ΍ϑϨʔϜϫʔΫͷ۷ΓԼ͛ ͜ͷτʔΫͰѻΘͳ͍͜ͱ
8.  ϥΠϒϥϦઃܭͰؾΛ͚͍ͭͯΔ͜ͱ
    044
   ͱͯ͠ެ։͢ΔͨΊʹ
    ·ͱΊ ໨࣍
9. 
   ϥΠϒϥϦઃܭͰؾΛ͚͍ͭͯΔ͜ͱ
10. Τϥʔ
11. w αʔυύʔςΟͷΤϥʔϥΠϒϥϦ΍
    YFSSPST
    ͸ ͔ͭΘͳ͍
    w ϥΠϒϥϦͷϢʔβʹͦͷΤϥʔϥΠϒϥϦͷ
 ࢖༻Λڧ੍ͤͯ͞͠·͏ͨΊ Ͱ͖ΔݶΓඪ४ΤϥʔͷΈΛ͔ͭ͏
12. w Ͱ͖ΔݶΓ
    errors
    ύοέʔδͷ
    "1*
    ͱޓ׵ੑ Λ࣋ͭ΋ͷΛબͿ
    w errors.Asɺerrors.Isɺerrors.Unwrap ඪ४ΤϥʔҎ֎Λ͔ͭ͏৔߹
13. $POUFYU
14. w DPOUFYU
    ΩϟϯηϧػߏΛந৅Խͨ͠΋ͷ
    w ࣮ߦʹ௕͍͕͔͔࣌ؒΔՄೳੑͷ͋Δ΋ͷ͸
    DPOUFYU
    Λαϙʔτ͢΂͖ $POUFYU
    BXBSF
15. ྫ
    LUSBQJHFO
16. w (P
    ੡ϥΠϒϥϦ
    w DVSM
    ίϚϯυΛ࣮ߦͨ݁͠Ռ͔Β
    (P
    "1*
    ΫϥΠΞϯτ Λࣗಈੜ੒͢Δ LUSBQJHFO
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", …
20. w ಺෦Ͱ
    "1*
    ϦΫΤετΛߦ͍ͬͯΔͨΊ
    w ͙͢ʹ݁Ռ͕ฦͬͯ͘Δͱ͸ݶΒͳ͍
    w DPOUFYU
    Λड͚औΔ͜ͱͰ্ҐϨΠϠʔʹΩϟϯηϧɾ λΠϜΞ΢τͷ࢓૊ΈΛఏڙͰ͖Δ ͳͥ
    DPOUFYU
    BXBSF
    ͳؔ਺ͳͷ͔ʁ
21. Φϓγϣϯ
22. w ߏ଄ମ
    w GVODUJPOBM
    PQUJPO
    QBUUFSO Φϓγϣϯ
23. w $PNNBOE
    ܕͷϑΟʔϧυͰΦϓγϣϯ஋Λड͚Δ
    w TQGDPCSB
24. w ؔ਺ͱՄม௕Ҿ਺ͷ૊Έ߹ΘͤͰΦϓγϣϯΛදݱ
    w ΦϓγϣϯܕΛΤΫεϙʔτ͢Δඞཁ͕ͳ͍
    w ؆ܿͰ໌շͳهड़ʹͳΔ GVODUJPOBM
    PQUJPO
    QBUUFSO
25. LUSBQJHFO
26. LUSBQJHFO
27. LUSBQJHFO
28. w Ұ௕Ұ୹
    w Φϓγϣϯ͕ଟ͍৔߹ɺߏ଄ମͷ΄͏͕ݟ௨͕͠ྑ͍
    w (PGNU
    ͕ϑΟʔϧυΛଗ͑ͯ͘ΕΔ
    w ͦΕҎ֎͸
    GVODUJPOBM
    PQUJPO
    QBUUFSO
    ͕ྑͦ͞͏ ߏ଄ମ
    WT
    GVODUJPOBM
    PQUJPO
    QBUUFSO
29. w Φϓγϣϯ΋࢓༷ͷҰ෦
    w ૿΍ͨ͢ͼʹϥΠϒϥϦͷෳࡶੑ͕૿͢
    w ඞཁ࠷௿ݶʹอͭ ΦϓγϣϯΛ૿΍͗͢͠ͳ͍
30. ྫ
    "1*
    ΫϥΠΞϯτͷϦτϥΠ
32. ϦτϥΠʹؔ͢ΔΦϓγϣϯ͕
 ͨ͘͞Μ͋ͬͯෳࡶʜ
    🤔
33. Φϓγϣϯ͕Ұ͚ͭͩʹͳͬͯ
 Θ͔Γ΍͘͢ͳͬͨ
    ☺
34. DFOLBMUJCBDLP⒎
    ʹґଘͯ͠͠·͍ͬͯΔ
    😨
35. w )551
    ϦΫΤετʹࣦഊͨ͠ͱ͖ʹҰఆ࣌ؒ଴ͪɺ
 ࠶౓ϦΫΤετΛ౤͛Δ ϦτϥΠʹ͍ͭͯ΋͏Ұ૚ਂ͘ߟ͑Δ
36. w )551
    ϦΫΤετʹࣦഊͨ͠ͱ͖ʹҰఆ࣌ؒ଴ͪɺ
 ࠶౓ϦΫΤετΛ౤͛Δ
    w ϦτϥΠ͸
    )551
    ϦΫΤετͷͨΊʹ͔͠࢖ΘΕͳ͍ ϦτϥΠʹ͍ͭͯ΋͏Ұ૚ਂ͘ߟ͑Δ
37. w )551
    ϦΫΤετʹࣦഊͨ͠ͱ͖ʹҰఆ࣌ؒ଴ͪɺ
 ࠶౓ϦΫΤετΛ౤͛Δ
    w ϦτϥΠ͸
    )551
    ϦΫΤετͷͨΊʹ͔͠࢖ΘΕͳ͍
    w )551
    ΫϥΠΞϯτͰ࣮૷Ͱ͖ΔͷͰ͸ʜʁ ϦτϥΠʹ͍ͭͯ΋͏Ұ૚ਂ͘ߟ͑Δ
38. w )551
    ϦΫΤετʹࣦഊͨ͠ͱ͖ʹҰఆ࣌ؒ଴ͪɺ
 ࠶౓ϦΫΤετΛ౤͛Δ
    w ϦτϥΠ͸
    )551
    ϦΫΤετͷͨΊʹ͔͠࢖ΘΕͳ͍
    w )551
    ΫϥΠΞϯτͰ࣮૷Ͱ͖ΔͷͰ͸ʜʁ
    w ͦ΋ͦ΋ϦτϥΠʹؔͯ͜͠ͷϥΠϒϥϦͰߟ͑Δඞཁ͋Δʜʁ ϦτϥΠʹ͍ͭͯ΋͏Ұ૚ਂ͘ߟ͑Δ
39. w ґଘ͕ඪ४ύοέʔδ͚ͩʹͳΔ
    w ϦτϥΠʹ·ͭΘΔؔ৺ࣄΛ෼཭Ͱ͖Δ
    w Ϣʔβ͸೚ҙͷϦτϥΠ࣮૷Λબ΂Δ
    w τϨʔε΍ϩΨʔͳͲΛ࢓ࠐΈ͍ͨ৔߹Ͱ΋ϥΠϒϥϦͷ
 Φϓγϣϯ͕૿͑ͳ͍ʂ )551
    ΫϥΠΞϯτΛड͚औΔϝϦοτ
40. )551
    ΫϥΠΞϯτΛड͚औΔΑ͏ʹͯ͠ΈΔ
42. Ϣʔβ͸
    IBTIJDPSQHPSFUSZBCMFIUUQ
    ͰϦτϥΠΛߦ͏
44. (P
    Β͍͠ΠϯλʔϑΣʔεΛ
 ఏڙ͢Δ
45. w ඪ४ɾ४ඪ४ύοέʔδ͕͓खຊ
    w ޙํޓ׵ੑͷͨΊʹ࿪ʹͳ͍ͬͯΔՕॴ΋
 ΋ͪΖΜ͋ΔͷͰ஫ҙ (P
    Β͍͠ΠϯλʔϑΣʔεΛఏڙ͢Δ
46. ྫ
    LUSBQJHFO
47. w DVSM
    ίϚϯυ
    w ੜ੒͢ΔϑΝΠϧͷύοέʔδ໊
    w ੜ੒͢Δϝιου໊
    w ϝιουͷύϥϝʔλ໊
    w FUD BQJHFO
    ͷೖྗ
48. ίϚϯυϥΠϯʜʁ $ apigen --package api --out api_gen.go \ "curl example.com/post" "GetPost" \ "curl -d "{...}" example.com/posts" "CreatePost"
49. ίϚϯυϥΠϯʜʁ $ apigen --package api --out api_gen.go \ "curl example.com/post" "GetPost" \ "curl -d "{...}" example.com/posts" "CreatePost" ੜ੒ର৅
    "1*
    ͕૿͑ΔͨͼʹҾ਺͕૿͑Δ
    🤔
    ҉໧తʹʮDVSM
    ίϚϯυʯʮϝιου໊ʯͷϖΞΛཁٻ͍ͯͯ͠௚ײతͰ͸ͳ͍ʜ
50. ֎෦ϑΝΠϧʜʁ $ apigen --package api --out api_gen.go definition.yaml
51. ֎෦ϑΝΠϧʜʁ $ apigen --package api --out api_gen.go definition.yaml ࣮ߦ࣌ʹ͔͠ଥ౰ੑ͕ݕূͰ͖ͳ͍ͷͰ࢖͍ͮΒ͍
    🤔
52. w DVSM
    ίϚϯυΛ࣮ߦͨ݁͠Ռ͔Β
    (P
    "1*
    ΫϥΠΞϯτ Λࣗಈੜ੒͢Δ BQJHFO
    ͷ૝ఆϢʔβΛࢥ͍ग़͢
53. w DVSM
    ίϚϯυΛ࣮ߦͨ݁͠Ռ͔Β
    (P
    "1*
    ΫϥΠΞϯτ Λࣗಈੜ੒͢Δ BQJHFO
    ͷ૝ఆϢʔβΛࢥ͍ग़͢
54. w DVSM
    ίϚϯυΛ࣮ߦͨ݁͠Ռ͔Β
    (P
    "1*
    ΫϥΠΞϯτ Λࣗಈੜ੒͢Δ
    w Ϣʔβ͸
    (P
    Ͱ։ൃΛ͍ͯ͠Δ͜ͱΛલఏʹͰ͖Δ
    w (P
    Λ͏·͘࢖ͬͨྑ͍ղܾࡦ͕͋Γͦ͏ʜ BQJHFO
    ͷ૝ఆϢʔβΛࢥ͍ग़͢
55. w ४ඪ४ύοέʔδͷ
    BOBMZTJT
    Λར༻
    w BOBMZTJT"OBMZ[FS
    Λड͚औ͍ͬͯΔ HP
    WFU
    ͷ࣮૷
56. w ϑΟʔϧυͰ͞·͟·ͳઃఆΛ
 ߦ͍ͬͯΔ BOBMZTJT"OBMZ[FS
57. w ϑΟʔϧυͰ͞·͟·ͳઃఆΛ
 ߦ͍ͬͯΔ BOBMZTJT"OBMZ[FS
58. w BOBMZTJT
    ύοέʔδͷΑ͏ʹઃఆΛߦ͏ܕΛ
 ఆٛ͠ɺΤϯτϦϙΠϯτؔ਺΁౉͢ ྑͦ͞͏ͳղܾࡦ
60. "1*
    ఆٛΛߦ͏
61. ίʔυੜ੒ʂ
63. w ੩తܕ෇͚͞ΕͨίʔυδΣωϨʔλ
    w "1*
    ఆٛΛॻ͍ͯ
    apigen.Generate
    ΁౉͚ͩ͢
    w ΦϓγϣϯͰ
    io.Writer
    Λड͚औͬͨΓ͢Δ͜ͱ΋Մೳʂ ސ٬͕ຊ౰ʹཉ͔ͬͨ͠΋ͷ
64. ྫ
    LUSHPGV[[ZpOEFS
65. w (P
    ੡ϥΠϒϥϦ
    w G[G
    ͷΑ͏ͳ
    GV[[Z
    pOEFS
    Λ
    (P
    ੡
    $-*
    πʔϧ ʹ૊ΈࠐΊΔ LUSHPGV[[ZpOEFS
67. ֤ީิΛදࣔ͢ΔͨΊʹ͸ʜ
    🤔
68. ಠࣗܕͰީิΛ౉ͯ͠΋Β͏ʁ
69. Ϣʔβ͸ຖճ
    []*Candidate
    Λͭ͘Βͳ͍ͱ
    ͍͚ͳ͍ͷͰ͋·Γ࢖͍উख͕ྑ͘ͳ͍ʜ
70. w δΣωϦΫε͸
    ·ͩ
    ͳ͍ ೚ҙͷܕͷεϥΠεΛѻ͏ʹ͸ʜʁ
71. w δΣωϦΫε͸
    ·ͩ
    ͳ͍
    w ඪ४ύοέʔδʹ೚ҙͷܕͷεϥΠεΛѻ͍ͬͯ Δؔ਺͕͋ͬͨΑ͏ͳʜʁ ೚ҙͷܕͷεϥΠεΛѻ͏ʹ͸ʜʁ
72. TPSU4MJDF
75. εϥΠεͷܕʹ͸ؔ༩ͤͣɺީิ
    J
    ͷλΠτϧΛ
    ܾఆ͢ΔͨΊͷؔ਺Λड͚औΔΑ͏ʹ
76. εϥΠεͰ͋Ε͹ͳΜͰ΋౉ͤΔΑ͏ʹʂ
78. 
    044
    ͱͯ͠ެ։͢ΔͨΊʹ
79. w (JU)VC
    ͕ެ։͍ͯ͠Δ
    044
    ͷΨΠυ
    w 044
    ͷ
    8)"58):ɺߩݙํ๏ɺϓϩδΣΫτͷ
 ্ཱͪ͛ํͳͲΛ໢ཏ͍ͯ͠Δ
    w ୯७ʹಡΈ෺ͱͯ͠΋͓΋͠Ζ͍ 0QFO
    4PVSDF
    (VJEFT
    ΛಡΉ
80. https://opensource.guide/ja/starting-a-project/
81. w ϓϩδΣΫτͷґଘ؅ཧͷͨΊ
    w όʔδϣϯ؅ཧ͞ΕͨϞδϡʔϧͱͯ͠ఏڙ͢ΔͨΊ (P
    NPEVMFT
    ʹରԠ͢Δ
82. $ go mod init && go mod tidy (P
    NPEVMFT
    ʹରԠ͢Δ
83. $ go mod init && go mod tidy (P
    NPEVMFT
    ʹରԠ͢Δ ˞
    λά෇͚ʹ͍ͭͯ͸ޙड़
84. w ࣗ෼ͷ
    044
    ͕ґଘ͍ͯ͠ΔϞδϡʔϧͷ
 ϥΠηϯε΋දه͢΂͖
    w 4POHNVHPDSFEJUT
    ͕΂ΜΓ ґଘϞδϡʔϧͷϥΠηϯεදه
85. $ gocredits -w . ґଘϞδϡʔϧͷϥΠηϯεදه
86. w (P
    NPEVMFT
    Ͱ
    MJOUFS
    ͳͲͷπʔϧ܈΋؅ཧ͢Δ
    w Ϗϧυ΍ςετͷ࠶ݱੑΛ΋ͨͤΔͨΊ (P
    πʔϧͷґଘ؅ཧ
87. https://github.com/golang/go/wiki/Modules#how-can-i-track-tool-dependencies-for-a-module
88. w (JU
    λάΛ੾ͬͯ
    QVTI
    ͢Ε͹৽͍͠Ϟδϡʔϧ ͱͯ͠ೝࣝ͞ΕΔ ϥΠϒϥϦͷ഑෍
89. w (P3FMFBTFS
    Λ͔ͭ͏ͱΑΓྑ͍͔΋
    w (JU)VC
    3FMFBTFT
    ͷ࡞੒ɺ$IBOHFMPH
    ͷ࡞੒Λ Α͠ͳʹ΍ͬͯ͘ΕΔ ϥΠϒϥϦͷ഑෍
90. $ cat .goreleaser.yaml builds: - skip: true $ git tag v0.1.0 main $ goreleaser ϥΠϒϥϦͷ഑෍
91. w 044
    ͱͯ͠ग़͢ϥΠϒϥϦ͸ϢʔβͷͨΊʹ
 υΩϡϝϯτΛॻ͘΂͖ υΩϡϝϯτ
92. w Ϣʔβͷࢹ఺ͰυΩϡϝϯτΛಡΊΔ
    w (P%PD
    ͚ͩͰ࢖͍ํ͕ཧղͰ͖Δ͔ʁ
    w ެ։͢Δඞཁͷͳ͍΋ͷͳ͍͔ʁ
    w ࢓༷ͷ࿙Ε͸ͳ͍͔ʁ (P%PD
    Λ࢖ͬͨυΩϡϝϯτͷચ࿅
93. w ਓʑ͸υΩϡϝϯτΛಡ·ͳ͍
    w &YBNQMF
    ςετ͕͋Ε͹ɺͦͷϥΠϒϥϦͷ࣭ ͕͋Δఔ౓Θ͔Δ &YBNQMF
    ςετΛ༻ҙ͢Δ
95. w &YBNQMF
    ςετΑΓෳࡶͳ࢖༻ྫΛஔ͍͓ͯ͘ @FYBNQMF
    σΟϨΫτϦ
96. w @
    ΍
    
    ͔Β࢝·ΔϑΝΠϧɾσΟϨΫτϦ
 ͓Αͼ
    UFTUEBUB
    ͱ͍͏σΟϨΫτϦ͸
    
 (P
    πʔϧ͔Βແࢹ͞ΕΔ
    w @FYBNQMF
    ͱ͍͏໋໊͸׳श ಛघͳϑΝΠϧ໊ɾσΟϨΫτϦ໊ https://golang.org/cmd/go/#hdr-Package_lists_and_patterns
97. 
    ·ͱΊ
98. w αʔυύʔςΟ΁ͷґଘΛগͳ͘ɾখ͘͞อͭ
    w ࢓༷Λগͳ͘ɾখ͘͞อͭ
    w DPOUFYU
    ΛͪΌΜͱαϙʔτ͢Δ
    w (P
    Β͍͠ΠϯλʔϑΣʔεΛఏڙ͢Δ
    w ඪ४ɾ४ඪ४ύοέʔδ͕ͱͯ΋ࢀߟʹͳΔ ϥΠϒϥϦઃܭͰؾΛ͚͍ͭͯΔ͜ͱ
99. w 0QFO
    4PVSDF
    (VJEFT
    ΛಡΜͰ͓͘ͱྑ͍͔΋
    w (P
    NPEVMFT
    ͰϥΠϒϥϦͷόʔδϣϯ؅ཧΛ͠Α͏
    w υΩϡϝϯτ͸͕Μ͹ͬͯॻ͜͏
    w ࣗ෼͸ϒϥογϡΞοϓલʹॻ͘͜ͱ͕ଟ͍ 044
    ͱͯ͠ެ։͢ΔͨΊʹ