Newer Older
147 lines | 3.408kb
copy gitweblite soruce code
root authored on 2012-11-23
1
package Mojo::Loader;
2
use Mojo::Base -base;
3

            
4
use File::Basename 'fileparse';
upgraded Mojolicious to v3.7...
Yuki Kimoto authored on 2013-01-28
5
use File::Spec::Functions qw(catdir catfile splitdir);
copy gitweblite soruce code
root authored on 2012-11-23
6
use Mojo::Exception;
upgraded Mojolicious to v3.7...
Yuki Kimoto authored on 2013-01-28
7
use Mojo::Util qw(b64_decode class_to_path);
8

            
update Mojolicious to 4.57
Yuki Kimoto authored on 2013-12-02
9
my (%BIN, %CACHE);
upgraded Mojolicious to v3.7...
Yuki Kimoto authored on 2013-01-28
10

            
update Mojolicious to 4.57
Yuki Kimoto authored on 2013-12-02
11
sub data { $_[1] ? $_[2] ? _all($_[1])->{$_[2]} : _all($_[1]) : undef }
12

            
13
sub is_binary { keys %{_all($_[1])} ? !!$BIN{$_[1]}{$_[2]} : undef }
copy gitweblite soruce code
root authored on 2012-11-23
14

            
15
sub load {
16
  my ($self, $module) = @_;
17

            
18
  # Check module name
upgraded Mojolicious to v3.7...
Yuki Kimoto authored on 2013-01-28
19
  return 1 if !$module || $module !~ /^\w(?:[\w:']*\w)?$/;
copy gitweblite soruce code
root authored on 2012-11-23
20

            
21
  # Load
upgraded Mojolicious to v3.7...
Yuki Kimoto authored on 2013-01-28
22
  return undef if $module->can('new') || eval "require $module; 1";
copy gitweblite soruce code
root authored on 2012-11-23
23

            
upgraded Mojolicious to v3.7...
Yuki Kimoto authored on 2013-01-28
24
  # Exists
update Mojolicious to 4.57
Yuki Kimoto authored on 2013-12-02
25
  return 1 if $@ =~ /^Can't locate \Q@{[class_to_path $module]}\E in \@INC/;
copy gitweblite soruce code
root authored on 2012-11-23
26

            
upgraded Mojolicious to v3.7...
Yuki Kimoto authored on 2013-01-28
27
  # Real error
28
  return Mojo::Exception->new($@);
copy gitweblite soruce code
root authored on 2012-11-23
29
}
30

            
31
sub search {
32
  my ($self, $namespace) = @_;
33

            
34
  my (@modules, %found);
upgraded Mojolicious to v3.7...
Yuki Kimoto authored on 2013-01-28
35
  for my $directory (@INC) {
36
    next unless -d (my $path = catdir $directory, split(/::|'/, $namespace));
copy gitweblite soruce code
root authored on 2012-11-23
37

            
upgraded Mojolicious to v3.7...
Yuki Kimoto authored on 2013-01-28
38
    # List "*.pm" files in directory
copy gitweblite soruce code
root authored on 2012-11-23
39
    opendir(my $dir, $path);
upgraded Mojolicious to v3.7...
Yuki Kimoto authored on 2013-01-28
40
    for my $file (grep /\.pm$/, readdir $dir) {
copy gitweblite soruce code
root authored on 2012-11-23
41
      next if -d catfile splitdir($path), $file;
upgraded Mojolicious to v3.7...
Yuki Kimoto authored on 2013-01-28
42
      my $class = "${namespace}::" . fileparse $file, qr/\.pm/;
copy gitweblite soruce code
root authored on 2012-11-23
43
      push @modules, $class unless $found{$class}++;
44
    }
45
  }
46

            
47
  return \@modules;
48
}
49

            
upgraded Mojolicious to v3.7...
Yuki Kimoto authored on 2013-01-28
50
sub _all {
51
  my $class = shift;
52

            
53
  my $handle = do { no strict 'refs'; \*{"${class}::DATA"} };
update Mojolicious to 4.57
Yuki Kimoto authored on 2013-12-02
54
  return $CACHE{$class} || {} if $CACHE{$class} || !fileno $handle;
upgraded Mojolicious to v3.7...
Yuki Kimoto authored on 2013-01-28
55
  seek $handle, 0, 0;
update Mojolicious to 4.57
Yuki Kimoto authored on 2013-12-02
56
  my $data = join '', <$handle>;
upgraded Mojolicious to v3.7...
Yuki Kimoto authored on 2013-01-28
57

            
58
  # Ignore everything before __DATA__ (Windows will seek to start of file)
update Mojolicious to 4.57
Yuki Kimoto authored on 2013-12-02
59
  $data =~ s/^.*\n__DATA__\r?\n/\n/s;
upgraded Mojolicious to v3.7...
Yuki Kimoto authored on 2013-01-28
60

            
61
  # Ignore everything after __END__
update Mojolicious to 4.57
Yuki Kimoto authored on 2013-12-02
62
  $data =~ s/\n__END__\r?\n.*$/\n/s;
upgraded Mojolicious to v3.7...
Yuki Kimoto authored on 2013-01-28
63

            
update Mojolicious and added...
Yuki Kimoto authored on 2013-03-20
64
  # Split files
update Mojolicious to 4.57
Yuki Kimoto authored on 2013-12-02
65
  (undef, my @files) = split /^@@\s*(.+?)\s*\r?\n/m, $data;
upgraded Mojolicious to v3.7...
Yuki Kimoto authored on 2013-01-28
66

            
67
  # Find data
68
  my $all = $CACHE{$class} = {};
update Mojolicious to 4.57
Yuki Kimoto authored on 2013-12-02
69
  while (@files) {
70
    my ($name, $data) = splice @files, 0, 2;
71
    $all->{$name} = $name =~ s/\s*\(\s*base64\s*\)$//
72
      && ++$BIN{$class}{$name} ? b64_decode($data) : $data;
upgraded Mojolicious to v3.7...
Yuki Kimoto authored on 2013-01-28
73
  }
74

            
75
  return $all;
76
}
77

            
copy gitweblite soruce code
root authored on 2012-11-23
78
1;
79

            
update Mojolicious to 4.57
Yuki Kimoto authored on 2013-12-02
80
=encoding utf8
81

            
copy gitweblite soruce code
root authored on 2012-11-23
82
=head1 NAME
83

            
84
Mojo::Loader - Loader
85

            
86
=head1 SYNOPSIS
87

            
88
  use Mojo::Loader;
89

            
90
  # Find modules in a namespace
91
  my $loader = Mojo::Loader->new;
92
  for my $module (@{$loader->search('Some::Namespace')}) {
93

            
upgraded Mojolicious to v3.7...
Yuki Kimoto authored on 2013-01-28
94
    # Load them safely
copy gitweblite soruce code
root authored on 2012-11-23
95
    my $e = $loader->load($module);
upgraded Mojolicious to v3.7...
Yuki Kimoto authored on 2013-01-28
96
    warn qq{Loading "$module" failed: $e} and next if ref $e;
97

            
98
    # And extract files from the DATA section
99
    say $loader->data($module, 'some_file.txt');
copy gitweblite soruce code
root authored on 2012-11-23
100
  }
101

            
102
=head1 DESCRIPTION
103

            
104
L<Mojo::Loader> is a class loader and plugin framework.
105

            
106
=head1 METHODS
107

            
108
L<Mojo::Loader> inherits all methods from L<Mojo::Base> and implements the
109
following new ones.
110

            
update Mojolicious and added...
Yuki Kimoto authored on 2013-03-20
111
=head2 data
upgraded Mojolicious to v3.7...
Yuki Kimoto authored on 2013-01-28
112

            
113
  my $all   = $loader->data('Foo::Bar');
114
  my $index = $loader->data('Foo::Bar', 'index.html');
115

            
116
Extract embedded file from the C<DATA> section of a class.
117

            
118
  say for keys %{$loader->data('Foo::Bar')};
119

            
update Mojolicious to 4.57
Yuki Kimoto authored on 2013-12-02
120
=head2 is_binary
121

            
122
  my $bool = $loader->is_binary('Foo::Bar', 'test.png');
123

            
124
Check if embedded file from the C<DATA> section of a class was Base64 encoded.
125

            
update Mojolicious and added...
Yuki Kimoto authored on 2013-03-20
126
=head2 load
copy gitweblite soruce code
root authored on 2012-11-23
127

            
128
  my $e = $loader->load('Foo::Bar');
129

            
130
Load a class and catch exceptions. Note that classes are checked for a C<new>
131
method to see if they are already loaded.
132

            
133
  if (my $e = $loader->load('Foo::Bar')) {
update Mojolicious to 4.57
Yuki Kimoto authored on 2013-12-02
134
    die ref $e ? "Exception: $e" : 'Not found!';
copy gitweblite soruce code
root authored on 2012-11-23
135
  }
136

            
update Mojolicious and added...
Yuki Kimoto authored on 2013-03-20
137
=head2 search
copy gitweblite soruce code
root authored on 2012-11-23
138

            
139
  my $modules = $loader->search('MyApp::Namespace');
140

            
141
Search for modules in a namespace non-recursively.
142

            
143
=head1 SEE ALSO
144

            
145
L<Mojolicious>, L<Mojolicious::Guides>, L<http://mojolicio.us>.
146

            
147
=cut