Lightning Talk at 2016/12/10 YAPC::Hokkaido

1. Publishing
a Perl6 Module
2016/12/10
YAPC::Hokkaido LT
astj

2. astj (あさとじぇー)
github @astj
Twitter @ast_j
hatena id:astj
CPAN ASTJ

3. Perl 5
Scala
Golang
!
……and Perl 6 (personally!)

5. Modules in perl6

6. https://docs.perl6.org/language/
modules.html

7. use v6;!
!
unit module My::Module;!
!
sub foo {!
}!
!
...!

8. Package manager

9. panda / zef
https://github.com/tadzik/panda
https://github.com/ugexe/zef

10. $ panda install SQL::NamedPlaceholder!
==> Fetching SQL::NamedPlaceholder!
==> Building SQL::NamedPlaceholder!
==> Testing SQL::NamedPlaceholder!
t/00-compile.t ..... ok!
t/01-basic.t ....... ok!
t/02-extend.t ...... ok!
t/03-array.t ....... ok!
t/04-name-id.t ..... ok!
t/05-exceptions.t .. ok!
t/99-meta.t ........ ok!
All tests successful.!
Files=7, Tests=58, 2 wallclock secs ( 0.03 usr
0.02 sys + 1.77 cusr 0.21 csys = 2.03 CPU)!
Result: PASS!
==> Installing SQL::NamedPlaceholder!
==> Successfully installed SQL::NamedPlaceholder

11. …from where?

12. panda install .
zef install !
git://github.com/ugexe/zef.git
zef install !
github:tony-o:CSV--Parser:0.1.2
panda install Task::Star

13. panda install .
zef install !
git://github.com/ugexe/zef.git
zef install !
github:tony-o:CSV--Parser:0.1.2
panda install Task::Star

14. ecosystem

15. https://modules.perl6.org

16. $ curl -s http://ecosystem-api.p6c.org/projects.json | jq '.[] | select( .provides | has("Monitor::Monit"))'
{
"resources": [],
"support": {
"source": "git://github.com/jonathanstowe/Monitor-Monit.git"
},
"tags": [
"monitor",
"api",
"system"
],
"version": "0.0.1",
"test-depends": [
"Test",
"CheckSocket"
],
"auth": "github:jonathanstowe",
"license": "perl",
"perl": "6.c",
"meta6": "0",
"name": "Monitor::Monit",
"build-depends": [],
"authors": [
"Jonathan Stowe <jns+gh@gellyfish.co.uk>"
],
"description": "Provide an interface to the monit monitoring daemon",
"depends": [
"HTTP::UserAgent",
"URI::Template",
"XML::Class"
],
"source-url": "git://github.com/jonathanstowe/Monitor-Monit.git",
"provides": {
"Monitor::Monit": "lib/Monitor/Monit.pm"
}
}

17. {
"resources": [],
"support": {
"source": "git://github.com/jonathanstowe/Monitor-Monit.git"
},
...
"auth": "github:jonathanstowe",
"license": "perl",
"perl": "6.c",
"meta6": "0",
"name": "Monitor::Monit",
...
"depends": [
"HTTP::UserAgent",
"URI::Template",
"XML::Class"
],
"source-url": "git://github.com/jonathanstowe/Monitor-Monit.git",
"provides": {
"Monitor::Monit": "lib/Monitor/Monit.pm"
}
}

19. Writing Modules

20. App::Mi6 is good!
https://github.com/skaji/mi6

21. But I wrote one
from scratch

22. SQL::NamedPlaceholder
https://github.com/astj/p6-SQL-NamedPlaceholder
Perl6 port of SQL::NamedPlaceholder of Perl5
ref: https://github.com/cho45/SQL-NamedPlaceholder

23. use SQL::NamedPlaceholder;!
!
my ($sql, $bind) = bind-named(q[!
SELECT *!
FROM entry!
WHERE!
user_id = :user_id!
], {!
user_id => $user_id!
});!
!
$dbh.prepare($sql).execute(|$bind);

24. Write Perl6 code / tests

25. $ tree ./!
./!
"## LICENSE!
"## META.info!
"## README.md!
"## lib!
$ %## SQL!
$ %## NamedPlaceholder.pm6!
%## t!
"## 00-compile.t!
"## 01-basic.t!
"## 02-extend.t!
"## 03-array.t!
"## 04-name-id.t!
"## 05-exceptions.t!
%## 99-meta.t!
!
3 directories, 11 files

26. Module Metadata

27. {!
"name": "SQL::NamedPlaceholder",!
"authors": [ "astj" ],!
"source-url": "ssh://(snip).git",!
"support": {!
"source": "ssh://(snip).git"!
},!
"perl": "6",!
"build-depends": [],!
"provides": {!
"SQL::NamedPlaceholder": "lib/SQL/NamedPlaceholder.pm6"!
},!
"depends": [],!
"test-depends": [!
"Test::META"!
],!
"description": "Perl6 port of p5 SQL::NamedPlaceholder",!
"version": "0.1.0"!
}

28. Testing Metadata

29. Test::META
https://github.com/jonathanstowe/Test-META

30. $ TEST_AUTHOR=1 prove -e 'perl6 -Ilib' -vr t/99-meta.t!
t/99-meta.t ..!
1..1!
ok 1 - have a META file!
ok 2 - META parses okay!
ok 3 - have all required entries!
ok 4 - 'provides' looks sane!
ok 5 - Optional 'authors' and not 'author'!
ok 6 - name has a hypen rather than '::' (if this is intentional
please pass :relaxed-name to meta-ok)!
ok 7 - no 'v' in version strings (meta6 version greater than 0)!
1..7!
ok 1 - Project META file is good!
ok!
All tests successful.!
Files=1, Tests=1, 0 wallclock secs ( 0.02 usr 0.00 sys + 0.27 cusr
0.04 csys = 0.33 CPU)!
Result: PASS

31. Does it work?

32. local
!
git
!
ecosystem
panda install .
panda install !
git://github.com/YOUR/MODULE.git
panda install YOUR::MODULE

33. local
!
git
!
ecosystem
panda install .
panda install !
git://github.com/YOUR/MODULE.git
panda install YOUR::MODULE

35. Release

36. (1) push to github

37. (2) p-r to ecosystem

38. (3) 🎉 🎉 🎉 🎉 🎉 🎉 🎉

40. local
!
git
!
ecosystem
panda install .
panda install !
git://github.com/YOUR/MODULE.git
panda install YOUR::MODULE

41. (Update)

42. (0) edit META

43. (1) push to github

44. (2) 🎉 🎉 🎉 🎉 🎉 🎉 🎉

46. Have Fun!

47. Thank you
for listening!