Re: Naming advice - Our World in Data
[email protected] (Neil Bowers) Tue, 15 Jul 2025 11:14:10 +0100
| Newsgroups | perl.module-authors |
|---|---|
| Message-ID | <c0f621a2-1d42-4529-bbc4-ce19298b3f7e@Spark> |
--687629fa_25a70bf7_54d0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Content-Disposition: inline Hi Boyd, I'd go for WebService::OurWorldInData -- you're not going to type the mod= ule name that many times, so I think the longer name is worth it: =C2=A0 =C2=A0 use WebService::OurWorldInData; =C2=A0 =C2=A0 my =24owid =3D WebService::OurWorldInData->new(...); When it shows up in various places, it will be more obvious what it is. Just my 2p. Cheers, Neil On 15 Jul 2025 at 11:05 +0100, Boyd Duffee <boyd.duffee=40gmail.com>, wro= te: > Hi all, > > Having no connection to the project but just goaded into it by there on= ly being a python client to downloading their data, I've written a Perl A= PI for the =22Our World in Data=22 grapher endpoint at https://ourworldin= data.org > > After looking through the maillist archive and given that the python mo= dule for their ETL catalog endpoint is =22owid-catalog=22, I'm thinking t= hat WebService::Owid or WebService::OWID are the best names for this modu= le (as mixed caps OWiD is just going to be visually confusing). It's shor= t and descriptive. > > Which would you find less annoying: all caps, ucfirst=3F Carolingian ma= juscules=3F > Suggestions for better names welcome. > > Their ETL endpoint is still in beta, but I expect to incorporate that i= nto the same namespace at a later date. > > thanks, > -- > Boyd Duffee > > And if we put 'user fell out window' every time that happened we'd ge= t database normalisation warnings from the helpdesk software. - BO=46H: =22= The trouble with, er, windows installs=22 > MAGA is a rehab facility for charlatans and the cancelled > Trump is a moron whose bankruptcy was bailed out by Putin who is now pu= lling his strings. --687629fa_25a70bf7_54d0 Content-Type: text/html; charset="utf-8" Content-Transfer-Encoding: quoted-printable Content-Disposition: inline <html xmlns=3D=22http://www.w3.org/1999/xhtml=22> <head> <title></title> </head> <body> <div name=3D=22messageBodySection=22> <div>Hi Boyd,</div> <div>&=23160;</div> <div>I'd go for WebService::OurWorldInData -- you're not going to type th= e module name that many times, so I think the longer name is worth it:</d= iv> <div>&=23160;</div> <div>&=23160; &=23160; use WebService::OurWorldInData;</div> <div>&=23160; &=23160; my =24owid =3D WebService::OurWorldInData->new(= ...);</div> <div>&=23160;</div> <div>When it shows up in various places, it will be more obvious what it = is.</div> <div>&=23160;</div> <div>Just my 2p.</div> <div>&=23160;</div> <div>Cheers,</div> <div>Neil</div> <div>&=23160;</div> </div> <div name=3D=22messageReplySection=22>On 15 Jul 2025 at 11:05 +0100, Boyd= Duffee <boyd.duffee=40gmail.com>, wrote:<br /> <blockquote type=3D=22cite=22> <div dir=3D=22ltr=22> <div>Hi all,</div> <div><br /></div> <div>Having no connection to the project but just goaded into it by there= only being a python client to downloading their data, I've written a Per= l API for the =22Our World in Data=22 grapher endpoint at <a href=3D=22ht= tps://ourworldindata.org=22>https://ourworldindata.org</a></div> <div><br /></div> <div>After looking through the maillist archive and given that the python= module for their ETL catalog endpoint is =22owid-catalog=22, I'm thinkin= g that WebService::Owid or WebService::OWID are the best names for this m= odule (as mixed caps OWiD is just going to be visually confusing). It's s= hort and descriptive.<br /></div> <div><br /></div> <div>Which would you find less annoying: all caps, ucfirst=3F Carolingian= majuscules=3F</div> <div>Suggestions for better names welcome.</div> <div><br /></div> <div>Their ETL endpoint is still in beta, but I expect to incorporate tha= t into the same namespace at a later date.</div> <div><br /></div> <div>thanks,<br /></div> <span class=3D=22gmail=5Fsignature=5Fprefix=22>--</span><br /> <div dir=3D=22ltr=22 class=3D=22gmail=5Fsignature=22 data-smartmail=3D=22= gmail=5Fsignature=22> <div dir=3D=22ltr=22> <div> <div dir=3D=22ltr=22> <div>Boyd Duffee</div> <blockquote style=3D=22margin:0px 0px 0px 0.8ex;border-left:1px solid rgb= (204,204,204);padding-left:1ex=22>And if we put 'user fell out window' ev= ery time that happened we'd get database normalisation warnings from the = helpdesk software. - BO=46H: =22The trouble with, er, windows installs=22= <br /></blockquote> <div><font color=3D=22=23=46=46=46=46=46=46=22>MAGA is a rehab facility f= or charlatans and the cancelled</font></div> <div><font color=3D=22=23=46=46=46=46=46=46=22>Trump is a moron whose ban= kruptcy was bailed out by Putin who is now pulling his strings.</font></d= iv> </div> </div> </div> </div> </div> </blockquote> </div> </body> </html> --687629fa_25a70bf7_54d0--