README
1NAME
2 POE::Loop::AnyEvent - AnyEvent event loop support for POE
3
4VERSION
5 version 0.004
6
7SYNOPSIS
8 use POE qw( Loop::AnyEvent );
9
10 # The rest of your program goes here.
11 # There should be little or no changes necessary.
12 # All POE APIs and most modules should work with no changes.
13
14DESCRIPTION
15 POE::Loop::AnyEvent replaces POE's default select() event loop with
16 AnyEvent. This allows POE programs to transparently use most of the
17 event loops AnyEvent can provide.
18
19 POE::Loop::AnyEvent changes POE's internal implementation without
20 altering its APIs. By design, nearly all software that are already uses
21 POE should continue to work normally without any changes.
22
23 Conflicts
24 It may seem obvious, but AnyEvent::Impl::POE and POE::Loop::AnyEvent are
25 mutually exclusive of one another. Using both would result in a deadlock
26 as each event system called upon the other in infinite recursion.
27
28 This deadlock also affects AnyEvent's support of Wx and Prima. AnyEvent
29 doesn't natively support these event loops. Instead it takes advantage
30 of POE's more flexible, comprehensive, and open event loop abstractions.
31
32 Callbacks from AnyEvent to POE
33 POE::Session's callback() and postback() methods simplify callbacks from
34 plain-coderef systems like Tk and AnyEvent to POE's named event
35 handlers. Please see POE::Session for more details.
36
37 Private Methods
38 POE::Loop::AnyEvent implements the private POE::Loop API. Please see
39 POE::Loop for an explanation of that API, especially if you'd like to
40 publish support for a new event loop. POE is structured so that new
41 event loops can be supported without core distribution changes.
42
43 Also see POE::Test::Loops for over 35 test files and more than 490 tests
44 you can use for free when writing new POE::Loop modules.
45
46SEE ALSO
47 POE
48
49 POE::Kernel
50
51 POE::Session
52
53 POE::Loop
54
55 POE::Test::Loops
56
57 AnyEvent
58
59AUTHOR
60 Chris Williams <chris@bingosnet.co.uk>
61
62COPYRIGHT AND LICENSE
63 This software is copyright (c) 2013 by Chris Williams.
64
65 This is free software; you can redistribute it and/or modify it under
66 the same terms as the Perl 5 programming language system itself.
67
68