msgraph: Microsoft Graph API Client with Ruby

3VCZ,BJHJ5BLFPVU 0%")JSPIJUP NTHSBQI.JDSPTPGU(SBQI"1*$MJFOUXJUI3VCZ

*.1035"/5 *EP/05UBML BCPVU(SBQI%BUBCBTFT FH/FPK

w *OUSPEVDUJPO w "CPVU.JDSPTPGU(SBQI w "CPVU.JDSPTPGU(SBQI"1*DMJFOU w )PXUPDSFBUF"1*DMJFOU w %FFQEJWFJOUPNJDSPTPGU@HSBQI
w "CPVUNTHSBQI w $PODMVTJPOT "HFOEB

*OUSPEVDUJPO

w OBNF0%")JSPIJUP w UXJUUFS!KJNMPDL w HJUIVC!KJOSPR w DPNNVOJUZ w 'VLVPLBSCDPPSHBOJ[FS
w 3VCZ,BJHJ-PDBM0SHBOJ[FS TFMGJOTQFDU

.BU[JTNZ#FTU'SJFOE

"CPVU.JDSPTPGU(SBQI

.JDSPTPGU(SBQI IUUQTEFWFMPQFSNJDSPTPGUDPNFOVTHSBQI

.JDSPTPGU(SBQI IUUQTEPDTNJDSPTPGUDPNFOVTHSBQIPWFSWJFX

4VQQPSUFEQMBUGPSNT IUUQTEPDTNJDSPTPGUDPNFOVTHSBQITELTTELTPWFSWJFXTVQQPSUFEQMBUGPSNT

"CPVU.JDSPTPGU(SBQI"1*DMJFOU

NJDSPTPGU@HSBQI IUUQTSVCZHFNTPSHHFNTNJDSPTPGU@HSBQI

NJDSPTPGU@HSBQI IUUQTSVCZHFNTPSHHFNTNJDSPTPGU@HSBQI Do we need to reinvent the wheel?

NJDSPTPGU@HSBQI IUUQTSVCZHFNTPSHHFNTNJDSPTPGU@HSBQI The answer is 'Yes!!!'.

NJDSPTPGU@HSBQI IUUQTHJUIVCDPNNJDSPTPGUHSBQINTHSBQITELSVCZ

.JDSPTPGU(SBQI3VCZDMJFOUMJCSBSZJTOPUBDUJWFMZTVQQPSUFE IUUQTHJUIVCDPNNJDSPTPGUHSBQINTHSBQITELSVCZJTTVFT

3VCZJT%FBE IUUQTZPVUVCF[CE98:69

3VCZJT%FBE IUUQTZPVUVCF[CE98:69 • Ruby is NOT dead. • I wish
to aim for constructive development.

.PUJWBUJPO

w *XJTIUPFMJNJOBUFUIFQPTTJCJMJUZUIBU.JDSPTPGUXJMMTUPQ TVQQPSUJOH3VCZ w *XBOUUPDSFBUFBMJCSBSZUIBU*DBONBJOUBJO w 3VCZ,BJHJ%SJWFO%FWFMPQNFOU .PUJWBUJPO

)PXUPDSFBUF"1*DMJFOU

w 4BNQMFDPEFTPGNJDSPTPGU@HSBQIJTCSPLFO w .JDSPTPGU(SBQI"1*TQFDJpDBUJPOTBSFUPPEJ⒏DVMUUPVOEFSTUBOE w 4PVSDFDPEFTPGNJDSPTPGU@HSBQIJTIBSEUPSFBE 1SPCMFNTGPSEFWFMPQJOH"1*DMJFOU

4UBOEPOUIFTIPVMEFSTPG(JBOUT IUUQTSVCZLBJHJPSHQSFTFOUBUJPOTPUBZIUNMBQS )PXUPVTF0QFO"1*GPS"1*EFWFMPQFS IUUQTSVCZLBJHJPSHQSFTFOUBUJPOTTVFIUNMBQS #FTUQSBDUJDFTJOXFC"1*DMJFOUEFWFMPQNFOU

OpenAPI Generator • Generate API client and Server stub from
OpenAPI deﬁnition • Many language and framework supported (OpenAPI Generator is a folk of Swagger Codegen) 6TJOH0QFO"1*(FOFSBUPS IUUQTTQFBLFSEFDLDPNPUBZIPXUPVTFPQFOBQJGPSBQJEFWFMPQFSSVCZLBJHJ TMJEF

NJDSPTPGUHSBQIPQFOBQJ IUUQTHJUIVCDPNNJDSPTPGUHSBQINJDSPTPGUHSBQIPQFOBQJ

w 0QFO%BUB 0%BUB 1SPUPDPM w $VSSFOUWFSTJPOJT w %BUBGPSNBUT w 0%BUBSFRVFTUTBOESFTQPOTFTJTVTJOHB+40/GPSNBU
w 4DIFNBEFpOJUJPOBOEEBUBNPEFMJTVTJOH9.-PS+40/GPSNBU w .JDSPTPGU(SBQIQSPWJEFT9.-POMZ w 4UBOEBSEJ[FECZ0"4*4JO w "QQSPWFEBTBO*40*&$JOUFSOBUJPOBMTUBOEBSEJO .JDSPTPGU(SBQI"1*4QFDJpDBUJPOT

+40/GPSNBUpMFDPOWFSUFE GSPNUIF0%BUB1SPUPDPM UPUIF0QFO"1*4QFDJpDBUJPO 8IBUJTNJDSPTPGUHSBQIPQFOBQJ

Ɣ GEWIW ;L]-QEOI%4-GPMIRXW 4YFPMG%4-W 4VMZEXI%4-W 'PMIRXHIZIPSTIVÓÓ%4-HIZIPSTIV
'PMIRXHIZIPSTIVÓ%4-HIZIPSTIV 6TJOHTVFNFUIPE 5FOUBUJWF/BNF IUUQTTQFBLFSEFDLDPNTVFCFTUQSBDUJDFTJOXFCBQJDMJFOUEFWFMPQNFOUOVNCFSSVCZLBJHJ TMJEF

Ɣ GEWIW ;L]-QEOI%4-GPMIRXW 4YFPMG%4-W 4VMZEXI%4-W 'PMIRXHIZIPSTIVÓÓ%4-HIZIPSTIV
'PMIRXHIZIPSTIVÓ%4-HIZIPSTIV 6TJOHTVFNFUIPE IUUQTTQFBLFSEFDLDPNTVFCFTUQSBDUJDFTJOXFCBQJDMJFOUEFWFMPQNFOUOVNCFSSVCZLBJHJ TMJEF

Ɣ 8LIVIEVIQSWXP]I\MWXMRK%4-GPMIRXWKIQWJSVQENSVWIVZMGIW ż 7IEVGLMRLXXTWVYF]KIQWSVK Ɣ 6IGSQQIRHIHXSYWIXLISJJMGMEP%4-GPMIRX 4YFPMG%4-WQEHIF]SXLIVW 6TJOHTVFNFUIPE
IUUQTTQFBLFSEFDLDPNTVFCFTUQSBDUJDFTJOXFCBQJDMJFOUEFWFMPQNFOUOVNCFSSVCZLBJHJ TMJEF

Ɣ 1SXMZEXMSR ż 6IMRZIRXMSRSJ[LIIP ż 2I[WIVZMGIW ż 1MRSVWIVZMGIW
4YFPMG%4-WQEHIF]SXLIVW 6TJOHTVFNFUIPE IUUQTTQFBLFSEFDLDPNTVFCFTUQSBDUJDFTJOXFCBQJDMJFOUEFWFMPQNFOUOVNCFSSVCZLBJHJ TMJEF

Ɣ 1SXMZEXMSR ż 6IMRZIRXMSRSJ[LIIP ż 2I[WIVZMGIW ż 1MRSVWIVZMGIW
4YFPMG%4-WQEHIF]SXLIVW 6TJOHTVFNFUIPE IUUQTTQFBLFSEFDLDPNTVFCFTUQSBDUJDFTJOXFCBQJDMJFOUEFWFMPQNFOUOVNCFSSVCZLBJHJ TMJEF Me

3FJOWFOUJOHUIFXIFFM -JTUVTFST (&5 IUUQTHSBQINJDSPTPGUDPNWVTFST (FUVTFS (&5 IUUQTHSBQINJDSPTPGUDPNWVTFSTVTFS@JE $SFBUFVTFS 1045 IUUQTHSBQINJDSPTPGUDPNWVTFST
6QEBUFVTFS 1"5$) IUUQTHSBQINJDSPTPGUDPNWVTFSTVTFS@JE %FMFUFVTFS %&-&5& IUUQTHSBQINJDSPTPGUDPNWVTFSTVTFS@JE .JDSPTPGU(SBQI"1*&OEQPJOUT

3FJOWFOUJOHUIFXIFFM -JTUVTFST (&5 IUUQTHSBQINJDSPTPGUDPNWVTFST (FUVTFS (&5 IUUQTHSBQINJDSPTPGUDPNWVTFSTVTFS@JE $SFBUFVTFS 1045 IUUQTHSBQINJDSPTPGUDPNWVTFST
6QEBUFVTFS 1"5$) IUUQTHSBQINJDSPTPGUDPNWVTFSTVTFS@JE %FMFUFVTFS %&-&5& IUUQTHSBQINJDSPTPGUDPNWVTFSTVTFS@JE mg = MicrosoftGraph.new .JDSPTPGU(SBQI"1*4JNQMF*OUFSGBDF &YBNQMF

3FJOWFOUJOHUIFXIFFM -JTUVTFST (&5 NHVTFSMJTU (FUVTFS (&5 NHVTFSHFU VTFS@JE $SFBUFVTFS 1045
NHVTFSDSFBUF 6QEBUFVTFS 1"5$) NHVTFSVQEBUF VTFS@JE %FMFUFVTFS %&-&5& NHVTFSEFMFUF VTFS@JE mg = MicrosoftGraph.new .JDSPTPGU(SBQI"1*4JNQMF*OUFSGBDF &YBNQMF

3FJOWFOUJOHUIFXIFFM !"" lib/ #"" microsoft_graph.rb !"" microsoft_graph/ !"" user.rb .JDSPTPGU(SBQI"1*%JSFDUPSZIJFSBSDIZ
&YBNQMF

3FJOWFOUJOHUIFXIFFM !"" lib/ #"" microsoft_graph.rb !"" microsoft_graph/ !"" user.rb .JDSPTPGU(SBQI"1*%JSFDUPSZIJFSBSDIZ
&YBNQMF But…

3FJOWFOUJOHUIFXIFFM !"" lib #"" microsoft_graph.rb !"" microsoft_graph #"" ... #""
many many many classes!! #"" ... !"" user.rb .JDSPTPGU(SBQI"1*%JSFDUPSZIJFSBSDIZ &YBNQMF Too many

(P$POGFSFODF"VUVNO IUUQTHPDPOKQ

1MGVSWSJX+VETL%4-0MFVEV]JSV+S 8EOIWLM=EIKEWLM +S'SRJIVIRGI%YXYQR .JDSPTPGU(SBQI"1*-JCSBSZGPS(P IUUQTXXXTMJEFTIBSFOFUZBFHBTIJNJDSPTPGUHSBQIBQJMJCSBSZGPSHP

✀㢮䛾䝁䞊䝗䝆䜵䝛䝺䞊䝍䛾Ꮡᅾ Ɣ 17+VETL7(/'SHI+IRIVEXSV LXXTWKMXLYFGSQQMGVSWSJXKVETL17+VETL7(/'SHI+IRIVEXSV ż 1MGVSWSJXබᘧ17+VETL7(/䝁䞊䝗䝆䜵䝛䝺䞊䝍 ż '䛚䜘䜃2)8*VEQI[SVO䛻䜘䜛ᐇ⿦ 㛤Ⓨ䛻;MRHS[W䛜ᚲせ ż
' 2)8'SVI .EZE.EZE7GVMTX3FNIGXMZI'4]XLSR Ɣ QWKVETLKS䝁䞊䝗䝆䜵䝛䝺䞊䝍 LXXTWKMXLYFGSQ]EIKEWLMQWKVETLKSKIR ż 4YVI+S䛻䜘䜛ᐇ⿦ .4(SBQI4%,$PEF(FOFSBUPS IUUQTXXXTMJEFTIBSFOFUZBFHBTIJNJDSPTPGUHSBQIBQJMJCSBSZGPSHP

.JDSPTPGU(SBQI4%,$PEF(FOFSBUPS IUUQTHJUIVCDPNNJDSPTPGUHSBQI.4(SBQI4%,$PEF(FOFSBUPS

.JDSPTPGU(SBQI4%,$PEF(FOFSBUPS IUUQTHJUIVCDPNNJDSPTPGUHSBQI.4(SBQI4%,$PEF(FOFSBUPS Ruby is unsupported…

NJDSPTPGU@HSBQI IUUQTHJUIVCDPNNJDSPTPGUHSBQINTHSBQITELSVCZ

NJDSPTPGU@HSBQI IUUQTHJUIVCDPNNJDSPTPGUHSBQINTHSBQITELSVCZ This gem’s code is not generated by the
generator.

NJDSPTPGU@HSBQI IUUQTHJUIVCDPNNJDSPTPGUHSBQINTHSBQITELSVCZ How to develop this gem?

%FFQEJWFJOUPNJDSPTPGU@HSBQI

w IUUQTHJUIVCDPNNJDSPTPGUHSBQI NTHSBQITELSVCZQVMM w 5IBOLT IUUQBSUZFYBNQMFT w IUUQTHJUIVCDPNKOVOFNBLFS IUUQBSUZCMPCNBTUFSFYBNQMFT NJDSPTPGU@HSBQISC
)PXUPFYFDVUFTBNQMFDPEF

w 0QFO%BUB 0%BUB 1SPUPDPM w $VSSFOUWFSTJPOJT w %BUBGPSNBUT w 0%BUBSFRVFTUTBOESFTQPOTFTJTVTJOHB+40/GPSNBU
w 4DIFNBEFpOJUJPOBOEEBUBNPEFMJTVTJOH9.-PS+40/GPSNBU w .JDSPTPGU(SBQIQSPWJEFT9.-POMZ w 4UBOEBSEJ[FECZ0"4*4JO w "QQSPWFEBTBO*40*&$JOUFSOBUJPOBMTUBOEBSEJO .JDSPTPGU(SBQI"1*4QFDJpDBUJPOT

0%BUB$PNNPO4DIFNB%FpOJUJPO-BOHVBHF9.- 3FQSFTFOUBUJPO7FSTJPO IUUQEPDTPBTJTPQFOPSHPEBUBPEBUBDTEMYNMWPEBUBDTEMYNMWIUNM

w &OUJUZ$POUBJOFS w &OUJUZ4FU w /BWJHBUJPO1SPQFSUZ#JOEJOH .JDSPTPGU(SBQI"1*4QFDJpDBUJPOT IUUQTHSBQINJDSPTPGUDPNWNFUBEBUB

.FUBQSPHSBNNJOHPGNJDSPTPGU@HSBQI IUUQTHJUIVCDPNNJDSPTPGUHSBQINTHSBQITELSVCZCMPCNBTUFSMJCNJDSPTPGU@HSBQIDMBTT@CVJMEFSSC

3FJOWFOUJOHUIFXIFFM -JTUVTFST (&5 NHVTFSMJTU (FUVTFS (&5 NHVTFSHFU VTFS@JE $SFBUFVTFS 1045
NHVTFSDSFBUF 6QEBUFVTFS 1"5$) NHVTFSVQEBUF VTFS@JE %FMFUFVTFS %&-&5& NHVTFSEFMFUF VTFS@JE mg = MicrosoftGraph.new .JDSPTPGU(SBQI"1*4JNQMF*OUFSGBDF &YBNQMF

.FUBQSPHSBNNJOHPGNJDSPTPGU@HSBQI IUUQTHJUIVCDPNNJDSPTPGUHSBQINTHSBQITELSVCZCMPCNBTUFSMJCNJDSPTPGU@HSBQIDMBTT@CVJMEFSSC

.FUBQSPHSBNNJOHPGNJDSPTPGU@HSBQI IUUQTHJUIVCDPNNJDSPTPGUHSBQINTHSBQITELSVCZCMPCNBTUFSMJCNJDSPTPGU@HSBQIDMBTT@CVJMEFSSC <EntitySet Name=“users" EntityType=“microsoft.graph.user"> GET https://graph.microsoft.com/v1.0/users/

"CPVUNTHSBQI

NTHSBQI IUUQTHJUIVCDPNKJOSPRNTHSBQI

NTHSBQIEJSFDUPSZIJFSBSDIZ NJDSPTPGU@HSBQI NTHSBQI

0%BUB4FSWJDF IUUQTHJUIVCDPNNJDSPTPGUHSBQINTHSBQITELSVCZCMPCNBTUFSMJCPEBUBTFSWJDFSC

'JYFEBCVH IUUQTHJUIVCDPNKJOSPRNTHSBQIQVMMpMFT

*BTLFEBRVFTUJPOPOTUBDLPWFSqPX IUUQTTUBDLPWFSqPXDPNRVFTUJPOTEPFTUIFNJDSPTPGUHSBQI BQJNFUBEBUBDPOpSNUIFPEBUBQSPUPDPMTQFDJpDBUJPO

$PODMVTJPOT

w 6TJOH.JDSPTPGUTFSWJDFTUPFOTVSFUIBU3VCZTEFWFMPQNFOUOFWFS FOETJO.JDSPTPGU w NTHSBQIEPFTOPUIBWF34QFD $PODMVTJPOT

msgraph: Microsoft Graph API Client with Ruby

msgraph: Microsoft Graph API Client with Ruby

More Decks by jinroq

Other Decks in Programming

Featured

Transcript