… | |
… | |
6 | |
6 | |
7 | use Coro; |
7 | use Coro; |
8 | use Coro::Event; |
8 | use Coro::Event; |
9 | |
9 | |
10 | sub keyboard : Coro { |
10 | sub keyboard : Coro { |
11 | my $w = Coro::Event->io(fd => *STDIN, poll => 'r'); |
11 | my $w = Coro::Event->io(fd => \*STDIN, poll => 'r'); |
12 | while() { |
12 | while() { |
13 | print "cmd> "; |
13 | print "cmd> "; |
14 | my $ev = $w->next; my $cmd = <STDIN>; |
14 | my $ev = $w->next; my $cmd = <STDIN>; |
15 | unloop unless $cmd ne ""; |
15 | unloop unless $cmd ne ""; |
16 | print "data> "; |
16 | print "data> "; |
… | |
… | |
32 | function - it will be managed by this module. |
32 | function - it will be managed by this module. |
33 | |
33 | |
34 | Your application should just create all necessary coroutines and then call |
34 | Your application should just create all necessary coroutines and then call |
35 | Coro::Event::loop. |
35 | Coro::Event::loop. |
36 | |
36 | |
|
|
37 | Please note that even programs or modules (such as |
|
|
38 | L<Coro::Handle|Coro::Handle>) that use "traditional" |
|
|
39 | event-based/continuation style will run more efficient with this module |
|
|
40 | then when using only Event. |
|
|
41 | |
|
|
42 | =head1 WARNING |
|
|
43 | |
|
|
44 | Please note that Event does not support coroutines or threads. That |
|
|
45 | means that you B<MUST NOT> block in an event callback. Again: In Event |
|
|
46 | callbacks, you I<must never ever> call a Coroutine fucntion that blocks |
|
|
47 | the current coroutine. |
|
|
48 | |
|
|
49 | While this seems to work superficially, it will eventually cause memory |
|
|
50 | corruption. |
|
|
51 | |
|
|
52 | =head1 FUNCTIONS |
|
|
53 | |
37 | =over 4 |
54 | =over 4 |
38 | |
55 | |
39 | =cut |
56 | =cut |
40 | |
57 | |
41 | package Coro::Event; |
58 | package Coro::Event; |
42 | |
59 | |
43 | BEGIN { eval { require warnings } && warnings->unimport ("uninitialized") } |
60 | no warnings; |
44 | |
61 | |
45 | use Carp; |
62 | use Carp; |
|
|
63 | no warnings; |
46 | |
64 | |
47 | use Coro; |
65 | use Coro; |
|
|
66 | use Coro::Timer; |
48 | use Event qw(loop unloop); # we are re-exporting this, cooool! |
67 | use Event qw(loop unloop); # we are re-exporting this, cooool! |
49 | |
68 | |
50 | use base 'Exporter'; |
69 | use XSLoader; |
51 | |
70 | |
|
|
71 | use base Exporter::; |
|
|
72 | |
52 | @EXPORT = qw(loop unloop sweep reschedule); |
73 | our @EXPORT = qw(loop unloop sweep); |
53 | |
74 | |
54 | BEGIN { |
75 | BEGIN { |
55 | $VERSION = 0.8; |
76 | our $VERSION = 1.9; |
56 | |
77 | |
57 | local $^W = 0; # avoid redefine warning for Coro::ready; |
78 | local $^W = 0; # avoid redefine warning for Coro::ready; |
58 | |
79 | XSLoader::load __PACKAGE__, $VERSION; |
59 | require DynaLoader; |
|
|
60 | push @ISA, 'DynaLoader'; |
|
|
61 | bootstrap Coro::Event $VERSION; |
|
|
62 | } |
80 | } |
63 | |
81 | |
64 | =item $w = Coro::Event->flavour(args...) |
82 | =item $w = Coro::Event->flavour (args...) |
65 | |
83 | |
66 | Create and return a watcher of the given type. |
84 | Create and return a watcher of the given type. |
67 | |
85 | |
68 | Examples: |
86 | Examples: |
69 | |
87 | |
… | |
… | |
76 | |
94 | |
77 | Return the next event of the event queue of the watcher. |
95 | Return the next event of the event queue of the watcher. |
78 | |
96 | |
79 | =cut |
97 | =cut |
80 | |
98 | |
81 | =item do_flavour(args...) |
99 | =item do_flavour args... |
82 | |
100 | |
83 | Create a watcher of the given type and immediately call it's next |
101 | Create a watcher of the given type and immediately call it's next |
84 | method. This is less efficient then calling the constructor once and the |
102 | method. This is less efficient then calling the constructor once and the |
85 | next method often, but it does save typing sometimes. |
103 | next method often, but it does save typing sometimes. |
86 | |
104 | |
… | |
… | |
109 | }; |
127 | }; |
110 | *{ $flavour } = $coronew; |
128 | *{ $flavour } = $coronew; |
111 | *{"do_$flavour"} = sub { |
129 | *{"do_$flavour"} = sub { |
112 | unshift @_, Coro::Event::; |
130 | unshift @_, Coro::Event::; |
113 | my $e = (&$coronew)->next; |
131 | my $e = (&$coronew)->next; |
114 | $e->cancel; # $e = $e->w->cancel ($e == $e->w!) |
132 | $e->cancel; # $e === $e->w |
115 | $e; |
133 | $e; |
116 | }; |
134 | }; |
117 | } |
135 | } |
118 | |
136 | |
119 | # double calls to avoid stack-cloning ;() |
137 | # double calls to avoid stack-cloning ;() |
120 | # is about 10% slower, though. |
138 | # is about 10% slower, though. |
121 | sub next($) { |
139 | sub next($) { |
122 | &Coro::schedule if &_next; $_[0]; |
140 | &Coro::schedule while &_next; |
|
|
141 | |
|
|
142 | $_[0] |
123 | } |
143 | } |
124 | |
144 | |
125 | sub Coro::Event::w { $_[0] } |
145 | sub Coro::Event::w { $_[0] } |
126 | sub Coro::Event::prio { $_[0]{Coro::Event}[3] } |
146 | sub Coro::Event::prio { $_[0]{Coro::Event}[3] } |
127 | sub Coro::Event::hits { $_[0]{Coro::Event}[4] } |
147 | sub Coro::Event::hits { $_[0]{Coro::Event}[4] } |
… | |
… | |
139 | into the Event dispatcher. |
159 | into the Event dispatcher. |
140 | |
160 | |
141 | =cut |
161 | =cut |
142 | |
162 | |
143 | sub sweep { |
163 | sub sweep { |
144 | Event::one_event(0); # for now |
164 | Event::one_event 0; # for now |
145 | } |
165 | } |
146 | |
166 | |
147 | =item $result = loop([$timeout]) |
167 | =item $result = loop([$timeout]) |
148 | |
168 | |
149 | This is the version of C<loop> you should use instead of C<Event::loop> |
169 | This is the version of C<loop> you should use instead of C<Event::loop> |
150 | when using this module - it will ensure correct scheduling in the presence |
170 | when using this module - it will ensure correct scheduling in the presence |
151 | of events. |
171 | of events. |
152 | |
172 | |
153 | =begin comment |
|
|
154 | |
|
|
155 | Unlike loop's counterpart it is not an error when no watchers are active - |
|
|
156 | loop silently returns in this case, as if unloop(undef) were called. |
|
|
157 | |
|
|
158 | =end comment |
|
|
159 | |
|
|
160 | =cut |
|
|
161 | |
|
|
162 | # no longer do something special - it's done internally now |
|
|
163 | |
|
|
164 | #sub loop(;$) { |
|
|
165 | # #local $Coro::idle = $Coro::current; |
|
|
166 | # #Coro::schedule; # become idle task, which is implicitly ready |
|
|
167 | # &Event::loop; |
|
|
168 | #} |
|
|
169 | |
|
|
170 | =item unloop([$result]) |
173 | =item unloop([$result]) |
171 | |
174 | |
172 | Same as Event::unloop (provided here for your convinience only). |
175 | Same as Event::unloop (provided here for your convinience only). |
173 | |
176 | |
174 | =cut |
177 | =cut |
175 | |
178 | |
176 | $Coro::idle = new Coro sub { |
179 | $Coro::idle = \&Event::one_event; # inefficient |
177 | while () { |
|
|
178 | Event::one_event; # inefficient |
|
|
179 | Coro::schedule; |
|
|
180 | } |
|
|
181 | }; |
|
|
182 | |
|
|
183 | # provide hooks for Coro::Timer |
|
|
184 | |
|
|
185 | package Coro::Timer; |
|
|
186 | |
|
|
187 | unless ($override) { |
|
|
188 | $override = 1; |
|
|
189 | *_new_timer = sub { |
|
|
190 | Event->timer(at => $_[0], cb => $_[1]); |
|
|
191 | }; |
|
|
192 | } |
|
|
193 | |
180 | |
194 | 1; |
181 | 1; |
195 | |
182 | |
|
|
183 | =back |
|
|
184 | |
196 | =head1 AUTHOR |
185 | =head1 AUTHOR |
197 | |
186 | |
198 | Marc Lehmann <pcg@goof.com> |
187 | Marc Lehmann <schmorp@schmorp.de> |
199 | http://www.goof.com/pcg/marc/ |
188 | http://home.schmorp.de/ |
200 | |
189 | |
201 | =cut |
190 | =cut |
202 | |
191 | |