Perl入学式 #8

http://www.perl-entrance.org

日時
- 2012年9月23日（日） 14:00 - 17:00
会場
- Joe'sクラウドコンピューティング
- http://www.joeswebhosting.net

Perl入学式について

Perl入学式(http://www.perl-entrance.org)は, プログラミング未経験者からPerl初心者を対象としたワークショップです
公式Twitter
- @Perl_Entrance
公式ハッシュタグ
- #Perl入学式
公式Facebookページ
- https://www.facebook.com/PerlEntrance

会場について

今回のPerl入学式は「Joe'sオープンソースJelly」の一環ということで、株式会社Joe'sクラウドコンピューティング（http://www.joeswebhosting.net）様より特別に会場をお借りしています
この場をお借りしてお礼申し上げます

ロゴについて

Perl入学式

横山陽平さん(http://yokoyamayohei.com/)にデザインしていただきました
この場をお借りしてお礼申し上げます

IT勉強会スタンプラリー

Perl入学式は, IT勉強会スタンプラリー(http://it-stamp.jp/)に参加しています
今回のPerl入学式は, スタンプラリーの対象となる勉強会です
台紙は勉強会終了後にお渡しします

喋ってる人

名前： papix (ぱぴっくす)
Twitter ： @papix
仕事：大学院生
ブログ： Masteries

YAPC::Asiaに行こう!

Yet Another Perl Conference
- 日本最大級のPerlの祭典！
- 2012年9月27日から29日！！
- 会場：東京大学！！！

Perl入学式も出ます！

Perl入学式をやってみた!
開始時間：2012-09-29（土） 15:20:00
是非お越しください！
papixが喋ります！！

本日の内容

Perlでのテスト - Test::More
復習問題
Mojoliciousを使ってみよう
Mojoliciousでhello, world!
スタイルを整えてみよう
複数のページを作ってみよう

Perlでのテスト - Test::More

プログラミング言語を使ってプロダクトを作る上で, テストは非常に重要です.
- まずテストから書き始める, というTDD(test-driven development)という開発手法があったりもします.
もちろんPerlには, テストを助けるモジュールがいくつかあります.
今回は, その中の1つ, Test::Moreをご紹介します.

sample.pl

use strict;
use warnings;
# &pow($x, $y) = $x ** $y を計算する関数
sub pow {
    my ($left, $right) = @_;
    return $left ** $right;
}
1;

このスクリプトをテストします.

sample.t

use Test::More;
require_ok( 'sample.pl' ); # テストするスクリプト
# &pow(2, 3) = 2 ** 3 = 8になるか確かめるテスト
is( &pow(2, 3), 8, '&pow(2, 3) is 8');
# テストの終わりを示すお約束
done_testing;

is関数は, 1つ目の引数と2つ目の引数の値を比較して真ならok, 偽ならngとなります.
3つ目の引数はコメント(テストの説明)です.
テスト用スクリプトは拡張子を.tにして, tディレクトリに格納することが習慣となっています.

テスト実行

$ perl t/sample.t
ok 1 - require 'sample.pl';
ok 2 - &pow(2, 3) is 8
1..2

問題がないなら, このように'ok'が出力されます.

失敗した場合

$ perl t/sample.t
ok 1 - require 'sample.pl';
not ok 2 - &pow(2, 3) is 8
#   Failed test '&pow(2, 3) is 8'
#   at t/sample.t line 5.
#          got: '9'
#     expected: '8'
1..2
# Looks like you failed 1 test of 2.

実装した関数に問題があり, 条件式が偽になる場合, このようなエラーが出力されます.

テスト用関数(1)

# 引数の$gotと$expectedをeqで比較して真かどうかテスト.
is( $got, $expected, $test_name );
# 引数の1つ目が真かどうかテスト.
ok( $got eq $expected, $test_name);
# 引数の$gotが正規表現のqr/expected/にマッチするかテスト.
like( $got, qr/expected/, $test_name );
# リファレンスである$gotと$expectedが同じ構造(内容)かテスト.
is_deeply( $got, $expected, $test_name );

$test_nameはテストの説明です.

テスト用関数(2)

# 引数の$gotと$expectedをneで比較して真かどうかテスト.
isnt( $got, $expected, $test_name );
# 引数の$gotが正規表現のqr/expected/にマッチしないかテスト.
unlike( $got, qr/expected/, $test_name );
# 引数の$gotと$expectedを演算子$opで比較して真かどうかテスト.
cmp_ok( $got, $op, $expected, $test_name );
# 例: $gotと$expectedを'&&'演算子で比較
cmp_ok( $got, '&&', $expected, $test_name );

Test::Moreの詳細

perldocに詳しい説明があります.
- Test::More - テストを書くためのもう一つのフレームワーク
大抵のモジュールにはテストがあるので, それを参考にしてみるのもいいかもしれません.

Let's challenge!

Test::Moreを使いつつ, ここまで学んできたことを復習してみましょう.
- Perl入学式のgithubアカウントに, 第8回用の復習問題リポジトリがあります.
- まず最初に, $ git clone git://github.com/perl-entrance-org/perl-entrance-2012-08.gitでclone(ダウンロード)しましょう.
gitがインストールされていない場合インストールしましょう.
- Ubuntuの場合, $ sudo apt-get install git-coreでOKです.

お約束

#!/usr/bin/env perl
use utf8;
use strict;
use warnings;
binmode STDIN,  ":encoding(UTF-8)";
binmode STDOUT, ":utf8";
binmode STDERR, ":utf8";

スクリプトを書く前に, このお約束のコードを書くようにしましょう.
以下, お約束は省略します.

復習問題(時間: 30分)

t/perl-entrance-08.tがテストスクリプト, perl-entrance-08.plが回答用スクリプトです.
回答用スクリプトに問題が書いてありますので, 問題に従ってスクリプトを記述すれば, perl-entrance-08.tが全てOKになるはずです.
わからない点, こまった所は遠慮せず聞いて下さいね.
- ちなみに, t/sample.t, sample.plは, 先程Test::Moreの説明で使ったスクリプトです.

Mojoliciousを使ってみよう

Perl入学式 #8以降は, Mojoliciousを利用した簡単なウェブアプリケーション開発を経験しつつ, ここまでに学んだ知識や, ここまで紹介できなかったテクニックを披露していきたいと考えています.
#8から#12までの全4回で構成する... 予定です.

What's is Mojolicious?

Mojolicious(もじょりしゃす)は, PerlのWebアプリケーションフレームワークです.
cpanでMojoliciousをインストールすれば, 試験用サーバ'morbo'などの環境も用意できます.
日本語マニュアルもあります.

Mojoliciousの環境構築

#8に向けた宿題でも解説しましたが, 念の為もう一度...
Perlbrewなどでcpanmがインストールされている場合, $ cpanm MojoliciousでOKです.
cpanmがインストールされていない場合, $ sudo cpan Mojoliciousでインストールできます.

Mojoliciousの動作を確認

ワンライナーでMojoliciousがインストールできたか確認します.
- mojo versionを実行してPerlのバージョンやMojoliciousのバージョンが表示されればOKです.
- $ perl -Mojo -E 'a( { "text" => "Neko" } )->start;' daemonを実行した後, ブラウザで127.0.0.1:3000を開いて, Necoと表示されればOKです.

Mojoliciousでhello, world!

use Mojolicious::Lite;
use utf8;
get '/' => sub {
    my $self = shift;
    $self->render(text => 'Hello, world!');
};
app->start;

早速, Mojoliciousでhello, world!を動かしてみましょう.
このスクリプトをhello.plという名前で保存して, $ morbo hello.plで実行してみましょう.
ブラウザで127.0.0.1:3000を開けば, Hello, world!と表示されるはずです.

コードの解説(1)

use Mojolicious::Lite;
use utf8;

Mojolicious::LiteはMojoliciousのLite版... って, そのまんまですね.
Mojolicious::Liteは1つのスクリプトで複数のページを作成できます. 一方Mojoliciousは, 1ページ=1スクリプトで構成されます.
もちろん, Mojolicious::Liteで作成した複数のページを, Mojoliciousの為に分割することも可能です.
｢まずはMojolicious::Liteで作って, 大規模になったらMojoliciousに｣という事も可能です.

コードの説明(1)

use Mojolicious::Lite;
use utf8;

Mojolicious::LiteはMojoliciousをインストールすれば同時にインストールされますので, 別にインストールする必要はありません.
use Mojolicious::Lite;をすれば, 自動的にuse warnings;とuse strict;が有効になります. わざわざ書く必要はありません.
以下, この2行は省略します.

コードの説明(2)

get '/' => sub {
    my $self = shift;
    $self->render(text => 'Hello, world!');
};

get '/' => sub { ... };は, getメソッドで'/'にアクセスした場合, subの中の...の処理を行う, という意味です.
my $self = shift;は｢お約束｣と思っておいて下さい.

コードの説明(2)

get '/' => sub {
    my $self = shift;
    $self->render(text => 'Hello, world!');
};

$self->render(text => 'Hello, world!');で, ｢textの形式で, 'hello, world!'と出力せよ!｣という命令をしています.
renderの引数がjson => { x => 3 }なら, json形式で{"x":3}が出力されますし, text => 'Oops!', status => '410'とすれば, ステータスコードを指定することもできます.

コードの説明(3)

app->start;

アプリケーションとして実行します, というような意味があります.
これも｢お約束｣と思っておいて下さい.

練習問題A(10分)

Mojolicious::Liteを使って, hello, mojolicious! my name is (あなたの名前)と出力するスクリプトを書いて, 実行してみましょう.

スタイルを整えてみよう

とりあえずテキストは出力されましたが, シンプルです.
もう少し, ｢スタイリッシュに｣キメたいところです.
HTMLを使って整形してみましょう.

テンプレート

__DATA__
@@ index.html.ep
<html>
<head><title><%= $title %></title></head>
<body style='padding: 30px;'>
<%= $string %>
</body>
</html>

hello.plの末尾に(app->start;の後に), このようなテンプレートを用意します.
テンプレートを用意することで, 複数のページで同じようなHTMLを使うことができます.
テンプレートを別ファイルとして保存する場合はtemplate/index.html.epとして保存することで適用されます.

テンプレートとデータ

get '/' => sub {
    my $self = shift;
    $self->stash(string => 'Hello, world!', title => 'hello');
    $self->render();
} => 'index';

/にアクセスした際の動作を記載する関数を, このように書き換えましょう.
$self->stashで, 先程記述したテンプレートにデータを渡すことができます.
最後に=> 'index';と記載することで, 使用するテンプレートを指定できます.

テンプレートと変数

__DATA__
@@ index.html.ep
<html>
<head><title><%= $title %></title></head>
<body style='padding: 30px;'>
<%= $string %>
</body>
</html>

stashでデータが渡されているので, テンプレートの中の<%= $title %>はhelloに, <%= $string %>は, Hello, world!に置き換わります.
<%= $xxx %>は, テンプレートの中で使える変数だと思って下さい.

練習問題B(10分)

@@ profile.html.ep
<html>
<head><title><%= $name %>のプロフィール</title></head>
<body style='padding: 30px;'>
私の名前は<%= $name %>です.<br>
趣味は<%= $hobby %>で, 好きなプログラミング言語は<%= $language %>です.
</body>
</html>

このようなテンプレートに対し, stashでname, hobby, languageを与え, あなたの自己紹介(プロフィール)ページを作ってみよう.

複数のページを作ってみよう

さきほどのプロフィールを独立したページにして, トップページからリンクを踏めば, プロフィールページを閲覧できるようにしてみましょう.

インデックスページの用意

先程練習問題の為にcloneしたgitリポジトリの中にある, app.plを編集していきます.
必要なテンプレートはapp.plの中に用意してあります.
stashで渡すデータであるnameが空になっているので, あなたの名前を入力してください.
morboで実行し, ブラウザでアクセスするとリンクが出てきます. しかし, リンクをクリックするとエラーが出力されます.

プロフィールページの用意

get '/profile' => sub {
    ...
};

リンク先の, プロフィールページを作りましょう.
テンプレートは既に用意してあるので, $app->start;よりも上に, 次のようなコードを書きましょう.
関数の中身は, 練習問題Bで関数の中に書いたコードと同じです.

動作確認

morboで実行し, ブラウザでアクセスしてみましょう.
リンクを踏めば, 練習問題Bで作ったプロフィールページが表示されるはずです.

最終問題C(30分)

インデックスページ, プロフィールページの他, もう1つページを作ってみてください.

Perl入学式 #8

Perl入学式について

会場について

ロゴについて

IT勉強会スタンプラリー

喋ってる人

YAPC::Asiaに行こう!

Perl入学式も出ます！

本日の内容

Perlでのテスト - Test::More

sample.pl

sample.t

テスト実行

失敗した場合

テスト用関数(1)

テスト用関数(2)

Test::Moreの詳細

Let's challenge!

お約束

復習問題(時間: 30分)

Mojoliciousを使ってみよう

What's is Mojolicious?

Mojoliciousの環境構築

Mojoliciousの動作を確認

Mojoliciousでhello, world!

コードの解説(1)

コードの説明(1)

コードの説明(2)

コードの説明(2)

コードの説明(3)

練習問題A(10分)

スタイルを整えてみよう

テンプレート

テンプレートとデータ

テンプレートと変数

練習問題B(10分)

複数のページを作ってみよう

インデックスページの用意

プロフィールページの用意

動作確認

最終問題C(30分)

質問タイム

お疲れさまでした