Mojo. The web in a box!

Mojo.The web in a box!

Saint Perl 2009English version

6 января 2010 г.

http://mojolicious.org/6 января 2010 г.

Sebastian Riedelавтор Catalyst и Mojohttp://labs.kraih.com/

http://twitter.com/kraih6 января 2010 г.

Sebastian Riedelавтор Catalyst и Mojohttp://labs.kraih.com/

Sebastian Riedelcreator of Catalyst and Mojo

http://labs.kraih.com/

Catalyst + Mojo = ?6 января 2010 г.

What is Mojo?

What is Mojo?• Pure Perl framework, without

any hidden magick

• No requirements besides Perl 5.8.1

• Very clean and object oriented API

• Full stack HTTP 1.1 (client / server)

• CGI, FastCGI, PSGI, Daemon и Prefork

• Two MVC web frameworks: Mojolicious and Mojolicious::Lite

Pure Perl framework

• Mojo::Base

• Mojo::ByteStream

• Mojo::Template, Mojo::JSON

• Mojo::Loader, Mojo::Log, Mojo::Path

• Mojo::URL, Mojo::Parameters, Mojo::Content

• Mojo::Message::Request, Mojo::Message::Response,Mojo::Headers, Mojo::Cookie, Mojo::Date

• Mojo::Base

Minimal Base Class For Mojo Projects

Mojo::Base

package App;use base ‘Mojo::Base’;

__PACKAGE__->attr(conf => sub { return do ‘conf/app.conf’;});__PACKAGE__->attr(db => sub { my $self = shift; return Util->db($self->conf->{'db'});});

sub dispatch { ... }6 января 2010 г.

• Mojo::Base

ByteStream

Mojo::ByteStream

use Mojo::ByteStream;my $s = Mojo::ByteStream->new('foo_bar');

$s->camelize; $s->decamelize;$s->b64_encode; $s->b64_decode;$s->encode('utf8'); $s->decode('utf8');$s->html_escape; $s->html_unescape;$s->qp_encode; $s->qp_decode;$s->quote; $stream->unquote;$s->url_escape; $s->url_unescape;$s->xml_escape;

• Mojo::Base

Perlish Templates!

Mojo::Template

% my $list = $self->stash(‘list’);

<ul>% for (@$list) { <li> <%= $_->{title} %> </li>% }</ul>

%= my $list = $self->stash(‘list’);

%== my $list = $self->stash(‘list’);

% use Foo::Bar;

<ul>% for (@$list) { <li> <%== $_->{title} %> </li>% }</ul>

• Mojo::Base

Minimalistic JSON

Mojo::JSON

my $json = Mojo::JSON->new;

my $string = $json->encode({foo => ‘bar’});

my $hash = $json->decode(‘{"foo":"bar"}’);

• Mojo::Base

Class loader: load, reload, search

Mojo::Loader

Class loader: load, reload, search

Mojo::Loader

• Mojo::Base

• Mojo::Trasaction, Mojo::Stateful

• Mojo::IOLoop

• Mojo::Client, Mojo::Server

• Mojo::Server::CGI, Mojo::Server::FastCGI

• Mojo::Server::PSGI

• Mojo::Server::Daemon и ::Prefork

• Mojo::Command

• Mojo::Command::Generate и ~ Server

• Mojo::IOLoop

• Mojo::Command

• Mojo::IOLoop

• Mojo::Command

• Mojo::IOLoop

• Mojo::Command

my $client = Mojo::Client->new;

$client->get( ‘http://goo.gl’ => sub { my ($self, $tx) = @_; say $tx->res; })->process;

$client->post( ‘http://goo.gl’ => sub { my ($self, $tx) = @_; say $tx->res; })->process;

$client->head( ‘http://goo.gl’ => sub { my ($self, $tx) = @_; say $tx->res; })->process;

$client->put( ‘http://goo.gl’ => sub { my ($self, $tx) = @_; say $tx->res; })->process;

• Mojo::IOLoop

• Mojo::Command

• Mojo::IOLoop

• Mojo::Command

• Mojo::IOLoop

• Mojo::Command

• Mojo::IOLoop

• Mojo::Command

• Mojo::IOLoop

• Mojo::Command

Mojo is the web in a box!

No requirementsbesides Perl 5.8.1

Mojo runtime6 января 2010 г.

Perl 5.0056 января 2010 г.

Perl 5.0060026 января 2010 г.

Perl 5.0080016 января 2010 г.

Mojo Perl 5.0106 января 2010 г.

Object oriented API

package TestMojo;use base 'Mojo';

sub handler { my ($self, $tx) = @_; warn $tx->req; warn $tx->req->url; $tx->res->headers ->content_type('text/plain'); $tx->res->body('Hello Mojo!');}

use overload '""' => sub { shift->to_string },

fallback => 1;

GET / HTTP/1.1Connection: keep-aliveAccept: text/html, application/xhtml, ....Accept-Charset: windows-1251, utf-8; ...Accept-Encoding: gzip,deflateAccept-Language: ru,en-us;q=0.7,en;q=0.3Host: localhost:3000User-Agent: Mozilla/5.0 (Macintosh; ...Content-Length: 0Keep-Alive: 300

A generation of the mojo app

mojo generate app TestMojo

[mkdir] test_mojo/script[write] test_mojo/script/test_mojo[chmod] test_mojo/script/test_mojo 744[mkdir] test_mojo/lib[write] test_mojo/lib/TestMojo.pm[mkdir] test_mojo/t[write] test_mojo/t/basic.t

use FindBin;

use lib "$FindBin::Bin/../lib";use lib "$FindBin::Bin/../../lib";

# Application$ENV{MOJO_APP} ||= 'TestMojo';

use Mojo::Commands;Mojo::Commands->start; # ->start(‘cgi’)

#!/usr/bin/env perl

use strict;use warnings;

use Test::More tests => 1;

use_ok('TestMojo');

Full stack HTTP 1.1

MojoX::UserAgentPascal Gaudette

Thanks to the Google of Summer Code 2009!

CGI, FastCGI, PSGI, Daemon, Prefork

support

script/test_mojo COMMAND [OPTIONS]

script/test_mojo cgiscript/test_mojo fastcgiscript/test_mojo daemonscript/test_mojo daemon_prefork --port 80

PATH_INFO='/' script/test_mojo cgi

Easy checkCan profile the mojo app using Devel::NYTProf

Mojo::Server::FCGIscript/test_mojo fcgiscript/test_mojo fcgi_prefork

nginx + fcgi_prefork

location / { fastcgi_pass 127.0.0.1:3000; fastcgi_param MOJO_APP App; fastcgi_param SCRIPT_NAME http://127.0.0.1:3000; fastcgi_param PATH_INFO $fastcgi_script_name; fastcgi_param QUERY_STRING $query_string; fastcgi_param REQUEST_METHOD $request_method; fastcgi_param CONTENT_TYPE $content_type; fastcgi_param CONTENT_LENGTH $content_length;}

MOJO_RELOAD=1 script/test_mojo daemon

Application code will reload on each request

script/test_mojo cgiscript/test_mojo fastcgiscript/test_mojo daemonscript/test_mojo daemon_prefork --port 80script/test_mojo test

script/test_mojo cgiscript/test_mojo fastcgiscript/test_mojo daemonscript/test_mojo daemon_prefork --port 80script/test_mojo testscript/test_mojo get

script/test_mojo cgiscript/test_mojo fastcgiscript/test_mojo daemonscript/test_mojo daemon_prefork --port 80script/test_mojo testscript/test_mojo get http://goo.gl

MVC web frameworks

Mojolicioususe base 'Mojo';

• Mojolicous::Controller

• Mojolicious::Plugin

• Mojolicious::Commands

• MojoX::Types

• MojoX::Dispatcher, MojoX::Routes

• MojoX::Types

Controller Base Class

Mojolicious::Controller

• render

• render_text

• render_json

• render_inner

• render_partial

• pause / resume

• redirect_to / url_for

• render

• render_text

• render_json

• render_inner

• render_partial

• pause / resume

• render(tempate => ‘foo/bar’)

• render_text

• render_json

• render_inner

• render_partial

• pause / resume

• render(controller => ‘foo’, action => ‘bar’)

• render_text

• render_json

• render_inner

• render_partial

• pause / resume

• render(‘foo/bar’, format => ‘html)

• render_text

• render_json

• render_inner

• render_partial

• pause / resume

• render

• render_text

• render_json

• render_inner

• render_partial

• pause / resume

• render

• render(text => ‘Saint Perl 2009’)

• render_json

• render_inner

• render_partial

• pause / resume

• render

• render_text

• render_json

• render_inner

• render_partial

• pause / resume

• render

• render_text

• render(json => {foo => ‘bar’})

• render_inner

• render_partial

• pause / resume

• render

• render_text

• render_json

• render_inner

• render_partial

• pause / resume

• render

• render_text

• render_json

• render_inner

• render_partial

• pause / resume

• render

• render_text

• render_json

• render_inner

• render_partial

• pause / resume

• render

• render_text

• render_json

• render_inner

• render_partial

• pause / resume

• MojoX::Types

Plugin Base Class

Mojolicious::Plugin

Plugins: load_plugin, add_hook, run_hook

Mojolicious::Plugins

• AgentCondition

• Charset

• DefaultHelpers

• EpRenderer

• EplRenderer

• RequestTimer

• AgentCondition

• Charset

• DefaultHelpers

• EpRenderer

• EplRenderer

• RequestTimer

• AgentCondition

• Charset

• DefaultHelpers

• EpRenderer

• EplRenderer

• RequestTimer

• AgentCondition

• Charset

• DefaultHelpers

• EpRenderer

• EplRenderer

• RequestTimer

• dumper

• param

• layout

• include

• content

• extends

• dumper

• param

• layout

• include

• content

• extends

• Data::Dumper (Maxdepth: 2, Indent: 1, Terse: 1)

• param

• layout

• include

• content

• extends

• dumper

• param

• layout

• include

• content

• extends

• dumper

• $self->req->param(...)

• layout

• include

• content

• extends

• dumper

• param

• layout

• include

• content

• extends

• dumper

• param

• $self->stash(layout => ...)

• include

• content

• extends

• dumper

• param

• layout

• include

• content

• extends

• dumper

• param

• layout

• $self->render_partial(...)

• content

• extends

• dumper

• param

• layout

• include

• content

• extends

• dumper

• param

• layout

• include

• $self->render_inner(...)

• extends

• dumper

• param

• layout

• include

• content

• extends

• dumper

• param

• layout

• include

• content

• $self->stash(extends => ...)

• AgentCondition

• Charset

• DefaultHelpers

• EpRenderer

• EplRenderer

• RequestTimer

• extention of temlplates is .epl

• my $self = shift;

• $self->stash(foo => ‘bar’)

• AgentCondition

• Charset

• DefaultHelpers

• EpRenderer

• EplRenderer

• RequestTimer

• extention of temlplates is .ep

• cashing templates with stash parameters

• $self->stash(foo => ‘bar’) – $foo

• any helpers

• default handler

• AgentCondition

• Charset

• DefaultHelpers

• EpRenderer

• EplRenderer

• RequestTimer

• MojoX::Types

script/test_app COMMAND [OPTIONS]

script/test_app cgiscript/test_app fastcgiscript/test_app daemonscript/test_app daemon_prefork --port 80script/test_app testscript/test_app get

script/test_app COMMAND [OPTIONS]

script/test_app cgiscript/test_app fastcgiscript/test_app daemonscript/test_app daemon_prefork --port 80script/test_app testscript/test_app getscritp/test_app routes

• MojoX::Types

A generationthe mojolicious app

mojolicious generate app TestApp

[mkdir] test_app/script[write] test_app/script/test_app[chmod] test_app/script/test_app 744[mkdir] test_app/lib[write] test_app/lib/TestApp.pm[mkdir] test_app/lib/TestApp[write] test_app/lib/TestApp/Example.pm[mkdir] test_app/t[write] test_app/t/basic.t[mkdir] test_app/log[mkdir] test_app/public[write] test_app/public/404.html[exist] test_app/public[write] test_app/public/500.html

package TestApp;

use base 'Mojolicious';sub startup { my $self = shift; my $r = $self->routes; $r->route('/:controller/:action/:id') ->to(controller => 'example', action => 'welcome', id => 1);}

package TestApp;

use base 'Mojolicious';sub startup { my $self = shift; my $r = $self->routes; $r->route('/:controller/:action/:id') ->to(controller => 'example', action => 'welcome', id => 1);}

package TestApp;

use base 'Mojolicious';sub startup { my $self = shift;

my $r = $self->routes; $r->route('/:controller/:action/:id') ->to(controller => 'example', action => 'welcome', id => 1);}

package TestApp;

my $r = $self->routes; $r->bridge->route('/:controller/:action/:id') ->to(controller => 'example', action => 'welcome', id => 1);}

package TestApp;

package TestApp::Example;

use base 'Mojolicious::Controller';sub welcome { my $self = shift; warn $self->stash(‘id’); $self->render(message => 'Welcome!');}

[exist] test_app/public[write] test_app/public/index.html[mkdir] test_app/templates[write] test_app/templates/exception.html.ep[write] test_app/templates/not_found.html.ep[mkdir] test_app/templates/layouts[write] test_app/templates/layouts/default.html.ep[mkdir] test_app/templates/example[write] test_app/templates/example/welcome.html.ep

example/welcome.html.ep

Path to the template

controller/welcome.html.ep

example/action.html.ep

example/welcome.html.handler

example/welcome.html.epl

example/welcome.html.tt

example/welcome.html.ht

example/welcome.html.pro

example/welcome.html.ctpp2

example/welcome.html.foo

example/welcome.format.ep

example/welcome.xml.ep

example/welcome.rss.ep

example/welcome.json.ep

example/welcome.yaml.ep

example/welcome.mail.ep

example/welcome.bar.ep

controller/action.format.handler

% layout 'default';

<a href="<%== url_for %>">click here</a>

<!doctype html><html> <head><title>Welcome</title></head> <body> <%== content %> </body></html>

Global symbol "$message2" requires explicit package name at (eval 280) line 2.

1: % layout 'default';2: <h2><%= $message2 %></h2>3: ...

{ 'status' => 500, 'message' => ‘Saint Perl 2009’, ... }

$ENV{MOJO_MODE}Default value is development

Mojolicious::Liteuse base 'Mojolicious';

mojolicious generate lite_app test_lite

[write] test_lite[chmod] test_lite 744

use Mojolicious::Lite;

get '/' => 'index';

any '/:groovy' => sub { my $self = shift; $self->render_text($self->stash('groovy'));};

shagadelic;

get '/' => 'index';

shagadelic;

get '/' => 'index';

shagadelic;

post '/' => 'index';

shagadelic;

any '/' => 'index';

shagadelic;

get '/' => 'index';

shagadelic;

get '/' => 'index';

any '/:groovy' => [groovy => qr/\d+/] => sub { my $self = shift; $self->render_text($self->stash('groovy'));};

shagadelic;

get '/' => 'index';

any '/:groovy' => {groovy => 42} => sub { my $self = shift; $self->render_text($self->stash('groovy'));};

shagadelic;

get '/' => 'index';

any '/:groovy' => (agent=>qr/Firefox/) => sub { my $self = shift; $self->render_text($self->stash('groovy'));};

shagadelic;

get '/' => 'index';

any '/:groovy' => sub { my $self = shift; $self->render_text($self->stash('groovy'));};app->renderer->default_handler(‘epl’);shagadelic;

use Mojolicious::Lite;ladder sub { ... }; # authget '/' => 'index';

shagadelic;

get '/' => 'index';

shagadelic; # shagadelic(‘cgi’)

__DATA__

@@ index.html.ep% layout 'funky';Yea baby!

@@ layouts/funky.html.ep<!doctype html><html> <body> <%== content %> </body></html>

Mojo modules on CPAN

• Mojo

• Mojo::Server::FCGI

• AnyEvent::Mojo

• Apache::Mojo, Apache2::Mojo

• Catalyst::Engine::Mojo,Squatting::On::Mojo

• MojoX::UserAgent

• MojoX::Routes::AsGraph

• MojoX::Session

• MojoX::Log::*

• MojoX::Renderer::*

• JSON

• TT

• CTTP2, HTP

Mojo Guide StyleRules

• Keep it simple, no magick unless absolutely nessary

• Code should be written with a Perl6 port in mind

• It’s not a feature without a test

• Only add prereqs if absolutely necessary

• No inline POD

• No spaghetti code

• Every files should contain at least one quote fromThe Simpsons or Futurama

Mojo Guide Style

• No inline POD

Mojo Guide Style

• No inline POD

Mojo Guide Style

• No inline POD

Mojo Guide Style

• No inline POD

Mojo Guide Style

• No inline POD

Mojo Guide Style

• No inline POD

• Every files should contain at least one quote fromThe Simpsons or Futurama :)

Mojo Guide Style

The Simpsons or Futurama6 января 2010 г.

Stable version and backwards compatibility

Mojo 0.999915The latest version of Mojo always available

on github.com

http://github.com/kraih/mojo6 января 2010 г.

Nobackwards

compatibility :)Until the first stable version will not be released

First critical bug

get ‘/bug/’ => sub { my $self = shift;

# open my $fh, ‘|-’, ‘/usr/sbin/sendmail -t’; open my $fh, ‘|-’, ‘perl test.pl’; print $fh join "\n", 'To: sharifulin at gmail.com', 'Subject: Test', '', 'Test!'; $self->render_text(‘Test’);;};

get ‘/bug/’ => sub { my $self = shift;

# open my $fh, ‘|-’, ‘/usr/sbin/sendmail -t’; open my $fh, ‘|-’, ‘perl test.pl’; print $fh join "\n", 'To: sharifulin at gmail.com', 'Subject: Test', '', 'Test!'; $self->render_text(‘Test’);;};

test.pl

#!/usr/bin/perlwarn $_ while <STDIN>;

script/test_bug daemon # OK

script/test_bug daemon # OKscript/test_bug daemon_prefork # DIE

Mojo::Server::Daemon::Prefork #323:

$SIG{HUP } = $SIG{INT } = $SIG{CHLD} = $SIG{TERM} = sub { exit 0 };

$SIG{HUP } = $SIG{INT } = $SIG{TERM } = sub { exit 0 };

$SIG{CHLD} = ‘IGNORE’;

Second critical bug

MOJO_RELOAD, daemon и attr

MOJO_RELOAD=1 script/test_bug2 daemon# OK

MOJO_RELOAD=1 script/test_bug2 daemon# sometimes ERROR

script/test_bug2 daemon_prefork # OK

__PACKAGE__->attr(conf => sub { return do ‘conf/app.conf’;});__PACKAGE__->attr(db => sub { my $self = shift; return $::DB ||= Util->db(...->{'db'});});

Documentation

DocumentationLess than necessary :)

• http://mojolicious.org

• http://labs.kraih.com/blog/

• http://search.cpan.org/dist/Mojo/

• http://github.com/kraih/mojo

• http://sharifulin.livejournal.com/tag/mojo

• http://getbootylicious.org/

• http://mojolicious.org

• http://labs.kraih.com/blog/

• http://search.cpan.org/dist/Mojo/

• http://github.com/kraih/mojo

• http://sharifulin.livejournal.com/tag/mojo

• http://getbootylicious.org/

Bootylicious6 января 2010 г.

• irc://irc.perl.org/#mojo

• http://lists.kraih.com/cgi-bin/mailman/listinfo/mojo

• Twitter: @kraih, @vtivti, @sharifulin

• Juick: @vti, @sharifulin

The latest news

• PSGI and Plack is the future of HTTP::Engine that has support for servers like CGI, FastCGI, Apache, AnyEvent and Mojo.

• New #mod_perlite release looks great, #Mojolicious with CGI backend should "just work™" on it.

• Slowly starting with documentation work, crazy how much #Mojolicious has grown recently, looks like it needs a few extra chapters now. :)

• Added native #PSGI support to #Mojolicious

My experience in the development

using Mojo

Mojolicious + MojoX::Renderer::TT6 января 2010 г.

Mojo + JSON6 января 2010 г.

Mojolicious::Lite + MojoX::Renderer::JSON

Mojolicious::Lite + MojoX::Renderer::JSON + RSS

Mojolicious + Mojo::Template6 января 2010 г.

Mojolicious + EpRenderer~7 projects

«Making hard things possible and everything fun!»The motto of Mojolicious

use Mojoor die

use Perlor die

any ‘/questions’ => sub { shift->render( answer => ‘sharifulin’, );};shagadelic;

Thanks!Anatoly SharifulinRostovOnDon.pm

Mojo. The web in a box!

Education

Transcript of Mojo. The web in a box!