Debian Codegraph @

Changes

raw
1 Revision history for IO-Async
2
3 0.805 2026-01-19
4 [CHANGES]
5 * Document and test that separate `->watch_io` calls for read and
6 write-readiness work correctly
7 * Implement (most of) the `Future::IO->poll` API in
8 `Future::IO::Impl::IOAsync`
9
10 [BUGFIXES]
11 * Ensure that `IO::Async::File` copes correctly with missing files
12 (RT136578)
13 * Test2's bail_out() is named in lowercase, not BAIL_OUT.
14 * Update the `time_between()` test helper function to be better
15 suited to `Test2`
16
17 0.804 2025-04-22
18 [CHANGES]
19 * Add extra LoopTests tests for IO and timer operation after a
20 ->post_fork call, in order to help test RT152635
21 * Remove duplicate `use VERSION` declaration from helper package in
22 TimeQueue.pm
23
24 0.803 2024-01-29
25 [CHANGES]
26 * Module style updates:
27 + Use perl v5.14 for `//` operator and `package NAME VER` syntax
28 + Updated Pod style
29 + Swapped unit tests from `Test::More` to `Test2::V0`
30 + Removed several now-unnecessary test-time dependencies
31
32 [BUGFIXES]
33 * Take the first name for each aliased signal in case of aliased
34 names (RT145759)
35
36 0.802 2022-08-15
37 [CHANGES]
38 * Preƫmptively use Future ->udata API from upcoming release, to
39 avoid depending on it being a hashref
40 * Report correct caller file + line number in nested test calls to
41 wait_for {}
42
43 [BUGFIXES]
44 * Use 'SOCK_STREAM' instead of hardcoded 1 in t/50resolver.t
45 * Skip exceptional socket condition test on cygwin because it seems
46 always to fail there
47 * Avoid harmless warnings about undef at global destruction
48 (RT142754)
49
50 0.801 2021-12-15
51 [BUGFIXES]
52 * Remove extraneous test-time use of Data::Dump (RT140143)
53
54 0.800 2021-11-11
55 [CHANGES]
56 * Bumped up to three-digit minor version number
57 * Added IO::Async::OS->signum2name
58 * Implement Future::IO->waitpid API
59 * Skip the `spawn` Routine model if POSIX fork() is not available
60 * Replace getaddrinfo / getnameinfo with virtual mocking functions
61 for unit-testing the resolve, so as not to rely on local platform
62 resolver behaviours
63
64 0.79 2021-08-06
65 [CHANGES]
66 * Permit IO::Async::Routine or Function by module+func names instead
67 of CODE reference
68 * Added new Routine/Function model of `spawn`
69 * Implement IO::Async::Resolver by module+func rather than code
70
71 [BUGFIXES]
72 * Require Socket 2.029 on MSWin32 because of AF_UNIX fix (RT133018)
73
74 0.78 2021-01-21
75 [CHANGES]
76 * Warn on attempts to ->connect to INADDR(6)_LOOPBACK as some OSes
77 (e.g. OpenBSD) do not allow it
78 * Various fixes for IO::Async::LoopTests to better support
79 IO::Async::Loop::UV:
80 + Insert some ->loop_once(0) calls between timing tests to allow
81 libuv to clear its pending queues
82 + Allow loops to declare that they cannot perform all-child PID
83 watch and skip the relevant tests for it if so
84 * Have $loop->later return a future instance if not passed any code
85 (RT133240)
86
87 [BUGFIXES]
88 * Accept more error codes for failure to resolve missing hostname
89 (RT131109)
90 * Defend against some undef values at global destruction time
91 (RT132677)
92
93 0.77 2020-05-13
94 [CHANGES]
95 * Updated for Metrics::Any 0.05
96 * Report an info-type gauge metric to track loop types
97 * Loop processing time should be a timer metric, not a distribution
98 * Don't bother reporting zero-byte stream read/write metrics
99
100 [BUGFIXES]
101 * Skip metrics-related unit tests if metrics aren't active, even
102 though we depend on Test::Metrics::Any
103 * Account for MSWin32's EWOULDBLOCK in t/70future-io.t
104
105 0.76 2020-05-05
106 [CHANGES]
107 * Initial attempt at providing metrics via Metrics::Any
108 * Renamed ->(un)watch_child API to ->(un)watch_process
109 * Renamed 'child' LoopTests suite to 'process'
110
111 0.75 2019-11-26 00:06:59
112 [CHANGES]
113 * Remember to keep O_NONBLOCK off on IO::Async::Channel sync mode
114 filehandles
115 * Added IO::Async::Process->finish_future
116 * Added IO::Async::Routine->result_future
117 * Future-returning version of IO::Async::Function->stop
118 * Don't load IO::Socket or Sereal modules unless required
119
120 [BUGFIXES]
121 * Refresh the sigpipe in ->post_fork if required (RT128588)
122 * Fix some spelling mistakes (RT130087)
123 * Skip the async getprotobyname() test if it doesn't work
124 synchronously (RT131029)
125
126 0.74 2019-06-27 18:44:38
127 [CHANGES]
128 * Warn about IO::Async::Stream using autoflush on a blocking handle
129 * Implement queuing priorities for IO::Async::Function calls (RT129918)
130 * Send a terminating signal to a ->run_process process on cancellation
131 (RT129225)
132 * Optionally make ->run_process future fail when process exits non-zero
133 (RT129225)
134 * Implement the Future::IO->syswrite API
135
136 [BUGFIXES]
137 * Skip t/70future-io.t unless Future::IO is available (RT129807)
138 * Remember to set O_NONBLOCK on IO::Async::Channel async mode
139 filehandles (RT129879)
140 * Handle Windows 7 which returns ENETDOWN to failed AF_UNIX connect()
141 (RT129806)
142
143 0.73 2019-06-12 16:49:28
144 [CHANGES]
145 * Provide an IO::Async implementation of Future::IO
146 * Added $loop->run_process (RT129225)
147 * Clear $ONE_TRUE_LOOP in $loop->fork so that child processes can do
148 IO::Async::Loop->new successfully
149 * Added $notifier->adopted_futures accessor (RT127818)
150 * Various docs fixes
151
152 0.72 2018-04-02 19:34:27
153 [CHANGES]
154 * Expanded docs on Stream's on_read sub return values
155 * Overridable timeout for IO::Async::Test::wait_for
156 * Hide IO::Async::ChildManager as an internal implementation detail;
157 move the docs into main IO::Async::Loop
158 * Added $loop->open_process; suggest using that instead of
159 ->open_child
160 * Begin implementation of $loop->is_running method (part of RT123780)
161
162 [BUGFIXES]
163 * Make IO::Async::Future->await wait until it's ready
164 * Fix calculation of periodic timer in 'skip' mode (RT124414)
165 * Perform synchronous getaddrinfo shortcut even for service-less
166 lookups
167 * Make sure that errors from underlying read/write functions are
168 debug-logged by IO::Async::Stream
169
170 0.71 2016/12/22 15:05:50
171 [CHANGES]
172 * Added 'prefork' option to IO::Async::Channel (RT115920) - thanks
173 GMARLER
174 * Prefer Sereal Channel encoding if that module is available
175 * Ensure that IaFunction still prints debug information on futures
176 * Miscellaneous spelling fixes in docs - thanks genio
177
178 [BUGFIXES]
179 * 'use lib ".";' for perl 5.24
180 * Make t/50resolver.t less sensitive to EAI_NONAME vs EAI_NODATA
181 because some resolvers lie (RT113429)
182 * Fix error message linefeed tests in t/50resolver.t (RT119369)
183 * Ensure that SIGPIPE is ignored if it's still at its default value
184
185 0.70 2015/12/15 18:17:43
186 [CHANGES]
187 * Support perl 5.8.x (tested on 5.8.9, presumed working as far as
188 5.8.4)
189
190 0.69 2015/11/09 19:56:58
191 [CHANGES]
192 * Use Future->catch instead of poorly-implemented string-eq test
193 * Use L<...> instead of C<...> in docs where appropriate (RT107417)
194 (thanks Arthur Axel 'fREW' Schmidt)
195
196 [BUGFIXES]
197 * Don't silently swallow Listener acceptor failures (RT107806)
198 * Don't silently swallow other ->connect errors
199 * Remember to ->unwatch_io before setting IaHandle's handle to undef
200
201 0.68 2015/07/31 20:07:48
202 [CHANGES]
203 * Allow IO::Async::Function body to 'die' with an ARRAYref to set
204 more details on failed Future
205 * Have IO::Async::Resolver calls indicate the failed resolver name
206 * Have IO::Async::Resolver's getaddrinfo and getnameinfo resolvers
207 give error numbers in failure result
208 * Added 'init_code' parameter to IO::Async::Function (RT104127)
209 * Added IO::Async::Channel->encode, ->send_encoded; deprecate the old
210 ->send_frozen method
211 * Added IO::Async::Test::wait_for_future
212
213 [BUGFIXES]
214 * Clean up after 'on_hangup' loop tests (RT106061)
215 * Make ->stop + ->start on IO::Async::Timer::Periodic not forget the
216 first_interval (RT100927)
217
218 0.67 2015/06/01 15:06:13
219 [CHANGES]
220 * Add a ->post_fork method to IO::Async::Loop in case subclasses
221 should take specific action (RT104130)
222 * Remove IO::Async::MergePoint entirely
223 * Add debug_printf() calls to IO::Async::Process
224 * Various documentation additions
225
226 [BUGFIXES]
227 * Remember to actually delete unused filehandles from the pollmask
228 (RT103922)
229
230 0.66 2015/04/17 20:36:39
231 [CHANGES]
232 * Created IO::Async::Debug
233 * Ignore SIGPIPE by default (RT92024)
234 * IaSocket->bind now returns a Future
235 * Added IaSocket->bind resolver support and neatened up UDP examples
236 in synopsis/documentation
237
238 [BUGFIXES]
239 * Correct call to unpack() in IaStream example (RT103143)
240 * Don't silently eat accept() failures in IaListener (RT102677)
241 * Remember to add the new resolver instance to $loop in
242 ->set_resolver (RT103446)
243 * Correct implementation of ->unwatch_io on IaLoop::Poll to prevent
244 100% CPU spin (RT103445)
245 * Ensure that an exception thrown by Timer::Periodic's on_tick
246 doesn't prevent rescheduling
247
248 0.65 2015/02/15 14:28:02
249 [CHANGES]
250 * Optionally allow IO::Async::Channel to use 'Sereal' serialisation
251 * Added documentation about the 'env' Child Manager key and copying
252 %ENV
253 * Take OS "preferred loop subclass" hints from IO::Async::OS directly
254
255 [BUGFIXES]
256 * Nested $stream->read_* inside read_* cause double-completion of
257 Future (RT101774)
258 * Implement IO::Async::Loop::Poll directly on _poll() syscall
259 wrapper, thus avoiding many bugs in IO::Poll (RT93141)
260 * Ensure that IO::Async::Loop::Select can cope with callbacks that
261 remove other IO handle watches (RT101919)
262 * Silently upgrade watched IO handles to O_NONBLOCK (RT102044)
263 * Complain about unrecognised keys to ->extract_addrinfo (RT101453)
264
265 0.64 2014/10/17 17:51:07
266 [CHANGES]
267 * Make specific mention of 'TCP' and 'UDP' around socket examples
268 where appropriate
269 * Allow construction of an IO::Async::Handle using fileno integers
270 directly
271 * Provide a better search for 'all open filehandles' via IO::Async::OS
272 on Linux (RT97942)
273 * Allow IO::Async::Listener to have handle_constructor or handle_class
274 as a subclass method (RT97208)
275 * Clarify documentation on how to use IO::Async::Process's
276 on_exception event (RT98929)
277
278 [BUGFIXES]
279 * Ensure that Stream's write Futures are also informed of write errors
280 (RT97433)
281 * Remember to ->remove_child the individual workers of an
282 IO::Async::Function (RT99552)
283 * Fix IO::Async::Function synopsis example (RT97713)
284
285 0.63 2014/07/11 15:09:08
286 [CHANGES]
287 * Allow Notifier subclasses to last-ditch handle unrecognised
288 ->configure() params
289 * Added $notifier->adopt_future
290 * Added $notifier->invoke_error and 'on_error' event
291 * Ensure that TimeQueue inserts in FIFO order for equal timestamps
292 * Kill remaining docs to long-dead IO::Async::Sequencer
293
294 [BUGFIXES]
295 * Cygwin needs the SELECT_CONNECT_EVEC OS hint as well
296 * Probe for a broken port to perform listen() tests on by using
297 ReuseAddr => 1 so it matches what IO::Async will do (RT84051)
298
299 0.62 2014/03/27 23:15:25
300 [CHANGES]
301 * Added IO::Async::Future->{done,fail}_later
302 * Allow overriding of debug log file or file descriptor
303 * Avoid Future's and_then/or_else methods
304 * Allow Channel->recv in async mode to return a Future (RT91180)
305 * Ensure that Function ->call Futures cancel correctly
306 * Added $routine->kill
307 * Kill the 'getaddrinfo' => 'getaddrinfo_array' legacy redirection
308 * Allow Loop's resolver to be changed to a different object
309
310 [BUGFIXES]
311 * Avoid relying on strong forward references in Future, by creating
312 intentional cycles on pending Futures. Workaround for bugfix in
313 upcoming Future release.
314
315 0.61 2013/10/15 01:10:51
316 [CHANGES]
317 * Some OSes lack signals; forbid the ->*_signal methods, and use
318 waitpid() polling for child processes if so
319 * Rearrangement of $loop->listen and IO::Async::Listener logic to
320 allow Listener subclasses to use listen extensions (e.g. SSL)
321 * Allow ->listen to construct new Stream or Socket handles
322 * Updated documentation and tests to emphasise futures with resolver
323 and ->listen
324 * Support spawning threads and watching for exit
325 * Support IO::Async::Routine based on threads
326 * Various MSWin32 improvements and fixes - it now passes tests \o/
327 * Declare that MSWin32 does not support POSIX-like fork(); skip all
328 unit tests and functionallity based on it if so
329
330 Note: These changes break IO::Async::SSL versions 0.12 or older.
331
332 [BUGFIXES]
333 * Ensure that $stream->write( CODE, on_write/write_len ) works
334 correctly
335
336 With many thanks to Mithaldu for the use of his Windows smoker for
337 development and testing of the MSWin32 fixes
338
339 0.60 2013/09/19 14:26:22
340 [CHANGES]
341 * Updated for Future 0.16 - no longer needs 'return' argument for
342 Future::Utils functions
343 * $stream->connect() ought to default socktype => "stream"
344
345 [BUGFIXES]
346 * Fix unit tests to better handle INADDR_LOOPBACK not being 127.0.0.1
347 * Skip-guard ->socket("inet6") unit tests on machines unable to
348 socket(AF_INET6)
349 * Remmeber to ->accept connections to testing socket in
350 t/63handle-connect.t
351
352 0.59 CHANGES:
353 * Allow IO::Async::Stream to define custom reader/writer methods
354 * Support writeready-for-read and readready-for-write in Stream
355 * Allow Stream->write() on_write and write_len args
356 * Neatened and documented Future ->fail arguments and conventions
357 * Added Stream on_writeable_{start,stop} events
358 * Added Handle->socket, ->bind and ->connect methods
359 * Revamp of Loop->connect logic; allow passing through an
360 IO::Async::Handle instance
361
362 BUGFIXES:
363 * Ensure that stream read EOF state is visible during queued on_read
364 events that caused it
365 * Fix 'return ... or die' precendence bug in Resolver (RT87051)
366 * Need to poll() for POLLPRI on MSWin32 and Cygwin
367
368 0.58 CHANGES:
369 * Added Stream read watermarks
370
371 BUGFIXES:
372 * Fix weakself event handlers' use of "shift or return"
373
374 0.57 CHANGES:
375 * Allow Stream->write from a Future, CODE that returns Future, Future
376 that returns CODE, etc...
377 * Added Future-returning Stream->read_* methods and ->push_on_read
378 * Return a flush-complete notification Future from Stream->write
379 * Allow Timer::Periodic to stop itself from its own on_tick event
380 * Wrap transport on_{read,write}_eof from Protocol::Stream
381
382 0.56 CHANGES:
383 * Added $loop->delay_future and $loop->timeout_future
384 * Added $future->loop accessor
385 * Use a faster splice()-based mechanism for the ARRAY-based TimeQueue
386 * Updated for Future::Utils 0.12 'repeat' function
387
388 BUGFIXES:
389 * Ensure that Process from => "" works
390 * If select() returns -1 ignore the bit vectors
391 * pipe() on Windows doesn't play with select(); emulate ->pipepair
392 using ->socketpair
393 * Correct use of S_ISREG and stat()
394
395 0.55 CHANGES:
396 * Try to ensure IO::Async::OS->socket returns an IO::Socket::IP
397 instance for PF_INET or PF_INET6 if it is available
398 * Don't bother testing subsecond loop_once behaviour because most
399 loops can't actually do it
400 * Use Future::Utils instead of CPS, removing a dependency
401 * Removed IO::Async::Sequencer
402 * Print a deprecation warning on old loop classes with old timer
403 support
404
405 0.54 CHANGES:
406 * Use Future instead of CPS::Future
407 * Created IO::Async::Future subclass
408 * Initial support for Futures on Loops
409 * Rewrite lots of internals to use Futures instead of MergePoints or
410 other logic
411 * Renamed all "task" to "future" in APIs
412 * Allow packing of inet/inet6 address structures to omit the IP or
413 port and presume passive or port 0
414 * Removed $notifier->get_loop synonym
415 * Make IO::Async::MergePoint throw a deprecation warning
416
417 0.53 CHANGES:
418 * Added IO_ASYNC_WATCHDOG debugging support
419
420 BUGFIXES:
421 * Remember to return a task from Function->call even if it's queued
422 (RT79248)
423
424 0.52 CHANGES:
425 * Initial attempt at Tasks using CPS::Future
426 * Minor fixes to timer LoopTests to prevent spurious failures of
427 sub-second timing
428 * Declare dependence on perl 5.10 now we're using 5.10 features
429 * Removed long-since deprecated IO::Async::DetachedCode
430
431 0.51 CHANGES:
432 * Split much code out to new IO::Async::OS heirarchy
433 * Drop dead dependency on Test::Warn
434 * Smaller simpler signal handling, avoid POSIX::SigSet
435 * Expose getfamilybyname and getsocktypebyname as OS methods
436
437 BUGFIXES:
438 * Many small MSWin32 fixes that might help pass some tests. Likely
439 still incomplete though
440
441 0.50 CHANGES:
442 * Added IO::Async::File
443 * Added filename mode of IO::Async::FileStream
444 * Make Heap dependency optional by reimplementing a tiny but less
445 efficient version of TimeQueue using a plain array
446 * No longer need MB-only Build.PL
447
448 BUGFIXES:
449 * Round up select() and poll() timeouts to nearest milisecond, might
450 help correct wait-time vs. gettimeofday() mismatches
451 * Fake read- and write-readiness of S_ISREG filehandles in select()
452 on MSWin32
453 * select() for exceptional status on MSWin32 to check for connect()
454 failures
455 * Don't unit-test that getsockname() works on socketpair()ed sockets
456
457 0.49 CHANGES:
458 * Fix watch_time => enqueue_timer conversions; fix unit tests and
459 Timer implementations
460
461 0.48 CHANGES:
462 * Support Channel long-running on_recv handler
463 * Support Channel directly between two Routines, in sync. mode at
464 both ends
465 * Added Loop->{watch,unwatch}_time API
466 * Added Function->restart and max_worker_calls parameter
467 * Support other reschedule policies for Timer::Periodic to allow
468 tick skipping, or drift
469
470 BUGFIXES:
471 * Fix example in Routine SYNOPSIS (thanks apeiron)
472 * Connector should check definedness of local_{host,port} rather than
473 existence
474
475 0.47 CHANGES:
476 * Support $listener->listen( v6only => ... )
477 * Added new data-passing $loop->run and $loop->stop methods
478
479 BUGFIXES:
480 * Emulate ->socketpair on MSWin32 by connecting to a temporary socket
481 * Account for EWOULDBLOCK on MSWin32
482 * Don't try reading STDIN to block awaiting a signal in unit-tests
483 * Allow zero-delay Countdown timers (RT75954)
484 * Handle dup2() collisions in ChildManager filehandle setups
485 (RT75573)
486 * Fix race condition in t/33process.t (RT75573)
487 * Ensure Timer->stop doesn't fail if the timer isn't running
488 (RT75571)
489 * Possibly-fix some cygwin test failures (RT71706)
490 * Ensure that 'passive' getaddrinfo hint is handled in both
491 synchronous and numeric cases
492
493 0.46 ADDITIONS:
494 * IO::Async::Routine + IO::Async::Channel
495 * IO::Async::Process->kill method
496
497 CHANGES:
498 * Use Socket 1.93 rather than dual-dependency logic on
499 Socket::GetAddrInfo
500 * Rewrote ::Function based on ::Routine and ::Channel
501 * Cleaner refcount behaviour in ::Process
502 * ::Process no longer waits for EOF condition on write-only pipes
503 * Don't unit-test the reading end of a pipe for HUP condition
504 * Documentation updates
505 * Removed documentation for long-since deprecated $loop->detach_child
506 and ->detach_code methods
507
508 0.45 CHANGES:
509 * Added Timer->is_expired predicate, remove_on_expire parameter
510 (RT71767)
511
512 BUGFIXES:
513 * Use fd3/4 in ::Function rather than STDIN/STDOUT, to avoid
514 corrupting the return channel if the body function prints (RT72448)
515 * Better error detection around setuid/setgid/setgroups (RT72407)
516 * IO::Handle->binmode is not available as a method before perl 5.12;
517 use CORE::binmode() instead
518 * Don't attempt to invoke a missing on_notifier callback in
519 Loop->listen (RT71768)
520
521 0.44 CHANGES:
522 * Allow Process to have sockets as handles; including datagram
523 sockets
524
525 BUGFIXES:
526 * Extract TimeQueue entiries before firing them, in case they do
527 something weird like cancelling themselves (RT70231)
528 * Test dollarbang for EWOULDBLOCK which might help MSWin32
529 * Cope correctly with Function handles in the presence of -CS or
530 PERL_UNICODE=S
531
532 0.43 CHANGES:
533 * Allow IO::Async::Notifier to be used as a non-principle mixin class
534 * Provide Notifier->loop accessor
535 * Added (still-experimental) Notifier debug features
536 * Deleted various deprecated features:
537 + Notifier to Handle upgrade
538 + Loop->enable_childmanager, Loop->disable_childmanager
539 * Print deprecation warnings on Loop->detach_code, Loop->detach_child
540 * Minor improvements to LoopTests
541
542 0.42 BUGFIXES:
543 * Test Stream encoding errors on a sequence which still returns
544 U+FFFD immediately on 5.14.0 (RT69020)
545
546 0.41 CHANGES:
547 * Support 'encoding' parameter in IO::Async::Stream
548 * Allow IO::Async::Stream->write with an empty string, for the
549 side-effect of setting an on_flush handler
550 * Support 'first_interval' parameter to IO::Async::Timer::Periodic
551 * Expanded documentation of timers
552
553 BUGFIXES:
554 * Explicitly 'use IO::Handle;'
555
556 0.40 ADDITIONS:
557 * Added IO::Async::FileStream - RT66520
558 * Added IO::Async::Stream 'close_on_read_eof' parameter
559 * Added IO::Async::Listener 'on_accept_failure' event
560
561 CHANGES:
562 * Allow Loop->listen to be extended via extensions, similar to
563 ->connect
564 * Autoflush streams used in Function::Worker objects by default
565 * Default Resolver to idle_timeout=30, min_workers=0
566
567 BUGFIXES:
568 * Don't convert method names to CODErefs during _capture_weakself as
569 it breaks dynamic dispatch and code reload - RT65785
570 * Only calculate Timer::Periodic's next tick time if it actually has
571 a Loop
572 * Put primary GID first in a 'setgroups' list, otherwise some BSDs
573 get upset - RT65127
574 * Load getaddrinfo() from Socket or Socket::GetAddrInfo in
575 t/50resolver.t
576 * Remove the anonymous Listener from the Loop if Loop->listen fails
577 - RT66168
578 * Supply LocalPort => 0 to IO::Socket::INET constructor explicitly
579 during testing
580
581 0.39 CHANGES:
582 * Added IO::Async::Notifier 'notifier_name' parameter, which may be
583 used in debugging code in a later version
584 * Added IO::Async::Stream on_write_eof event
585 * Complain about unrecognised keys in IO::Async::Loop->watch_io and
586 IO::Async::Stream->write
587
588 BUGFIXES:
589 * Don't claim on_hangup supported except on those places we know it
590 will be (Linux, FreeBSD >= 8.0)
591 * Fixed race condition in t/41detached-code.t
592 * Fixed race condition in IO::Async::Function
593
594 0.38 ADDITIONS:
595 * IO::Async::Function
596 * IO::Async::Loop->notifiers accessor
597
598 CHANGES:
599 * Symbolic flags in IO::Async::Resolver as convenience for commonly
600 used flag constants
601 * Distribution now uses Test::Fatal rather than Test::Exception
602 * Resolver is now a subclass of Function, not DetachedCode
603
604 BUGFIXES:
605 * More robust detection of Socket vs Socket::GetAddrInfo
606 * Portability fix for ChildManager's FD_CLOEXEC flag
607
608 0.37 ADDITIONS:
609 * Handle->close_read, ->close_write
610 * Stream on_read_eof event
611 * extract_addrinfo conveniences for 'inet', 'inet6' and 'unix'
612
613 CHANGES:
614 * Allow Process filehandles to set up plain pipes without read/write
615 behaviour on the associated Stream
616 * Renamed Loop->unpack_addrinfo to ->extract_addrinfo
617 * Prepare for Socket::getaddrinfo() in core; prefer it to
618 Socket::GetAddrInfo::getaddrinfo()
619
620 0.36 ADDITIONS:
621 * IO::Async::Process
622
623 CHANGES:
624 * Allow prequeuing of ->write data in Stream
625 * Check that signal handling remains properly deferred in LoopTests
626 * Miscellaneous documentation and examples updates
627
628 BUGFIXES:
629 * RT 64558 - getaddrinfo() returns duplicate addresses for localhost
630 * Don't rely on having NI_NUMERICSERV
631
632 0.35 ADDITIONS:
633 * Loop->unpack_addrinfo
634
635 CHANGES:
636 * Recognise 'inet' and 'unix' as socket families
637 * Recognise 'stream', 'dgram' and 'raw' as socket types
638 * Recognise nicer HASH-based addrinfo layout in ->connect and
639 ->listen
640 * Listener now has on_stream / on_socket as full events, not just
641 CODEref parameters
642 * Make Resolver->getaddrinfo try synchronously if given numeric names
643 * Make Resolver->getnameinfo run synchronously if given
644 NI_NUMERICHOST|NI_NUMERICSERV flags
645 * Try to combine small data buffers from Stream->write calls if
646 possible
647
648 BUGFIXES:
649 * Linefeed in die case of getaddrinfo_hash to preserve exeception
650 string
651 * Deconfigure Protocol->transport after it is closed
652
653 0.34 ADDITIONS:
654 * New Notifier methods ->_replace_weakself, ->maybe_invoke_event,
655 ->maybe_make_event_cb
656 * New Protocol method ->connect
657 * New subclass Protocol::LineStream
658 * Direct Resolver->getaddrinfo and ->getnameinfo methods
659
660 CHANGES:
661 * New Protocol::Stream->new( handle => $io ) parameters, which
662 creates an IO::Async::Stream to use as a transport
663 * Renamed Loop->detach_child to Loop->fork
664 * Pass errno values into ->connect on_connect_error and
665 ->listen on_listen_error
666 * Support timeouts on Resolver operations
667 * Allow direct access to Resolver via Loop->resolver
668
669 BUGFIXES:
670 * Make sure Protocol::Stream handles writersub and on_flush callback
671
672 0.33 ADDITIONS:
673 * Allow watching child PID 0, to capture every child process exit
674 * $loop->time accessor
675 * Stream->write( sub { ... } ) dynamic stream generation
676 * Stream->write( $data, on_flush => sub { ... } ) callback
677
678 CHANGES:
679 * IO::Async::Loop->new magic constructor now caches the loop; useful
680 for wrapping modules, other event system integration, etc..
681
682 0.32 ADDITIONS:
683 * IO::Async::Timer::Absolute
684 * Listener accessors for ->sockname, ->family, ->socktype
685
686 CHANGES:
687 * Implement and document Handle's want_{read,write}ready parameters
688 * Rearranged documentation for Notifier subclasses; new EVENTS
689 sections
690 * Correct location for #io-async channel on irc.perl.org
691
692 0.31 ADDITIONS:
693 * Delegate Protocol->close method and on_closed continuation to its
694 transport object
695 * Stream->new_for_stdin, ->new_for_stdout, ->new_for_stdio
696 * Support Listener->new( handle => $fh )
697 * IO::Async::PID notifier subclass
698
699 CHANGES:
700 * Better documentation of Listener and Connector addr and addrs
701 arguments
702
703 BUGFIXES:
704 * INADDR_ANY/INADDR_LOOPBACK fixes inside BSD jails with restricted
705 networking
706
707 0.30 ADDITIONS:
708 * Added IO::Async::Socket
709 * Added IO::Async::Protocol and ::Protocol::Stream
710 * Added on_stream and on_socket continuations for $loop->connect and
711 Listener
712
713 CHANGES:
714 * Emulate socketpair(AF_INET,...)
715 * Allow IO::Async::Stream 's read_len and write_len to be configured
716 per-instance
717 * Allow a Stream object without an on_read handler
718
719 BUGFIXES:
720 * Cope with exceptional-state sockets in Loop::Poll
721
722 0.29 CHANGES:
723 * Don't require 'CODE' refs for callbacks/continations; this allows
724 the use of CODEref objects, &{} operator overloads, or other things
725 that are callable
726 * Implement 'read_all' and 'write_all' options on IO::Async::Stream
727 * Allow IO::Async::Stream subclasses to override on_closed
728
729 BUGFIXES:
730 * Work around some OSes not implementing SO_ACCEPTCONN
731 * Ensure Handle's on_read_ready/on_write_ready callbacks also take a
732 $self reference
733
734 0.28 BUGFIXES:
735 * Ensure that Timer->start returns $self even when not in a Loop
736 * Accept bare GLOB refs as IO::Async::Listener handles; upgrade them
737 to IO::Socket refs if required
738 * Applied documentation patch from RT 55375 - thanks to
739 Chris Williams
740
741 0.27 CHANGES:
742 * Implement 'autoflush' option on IO::Async::Stream
743
744 BUGFIXES:
745 * Avoid $_ breaking stored signal handler references when invoking
746 them
747 * Ignore EINTR from sysread/syswrite
748 * More reliable socket address tests - don't rely on uninitialised
749 padding bytes between struct members
750
751 0.26 BUGFIXES:
752 * Connect to INADDR_LOOPBACK rather than INADDR_ANY during
753 t/24listener.t; hopefully fixes FAILs on OpenBSD
754 * Fix IO::Async::Stream during combined read/write-ready of a closed
755 stream
756
757 0.25 CHANGES:
758 * Accept 'stream'/'dgram'/'raw' as symbolic shortcuts for socket
759 types in connect/listen operations - avoids 'use Socket'
760 * Accept IO::Handle-derived objects in ChildManager setup keys as
761 well as raw GLOB refs
762
763 BUGFIXES:
764 * Various changes to test scripts to hopefully improve portability or
765 reliability during smoke tests
766
767 0.24 ADDITIONS:
768 * Timer subclasses - Countdown and Periodic
769 * Idleness event watching via low-level 'watch_io/unwatch_io' methods
770 and higher-level 'later' method
771 * Added the missing 'unwatch_child' method
772 * Shareable acceptance testing suite for IO::Async::Loop subclasses
773 for better testing in subclass implementations
774
775 CHANGES:
776 * More future-proof API version checking for subclasses - requires
777 subclasses to declare their version.
778 ### pre-0.24 Loop subclasses are no longer compatible. ###
779 * Entirely remove the need to $loop->enable_childmanager by calling
780 waitpid() in 'watch_child'.
781
782 0.23 CHANGES:
783 * Rearranged IO::Async::Listener to be a constructable Notifier
784 suclass
785 * Allow Signal, Timer and Listener to act as base classes as well as
786 standalone with callbacks
787 * Renamed IO::Async::Loop::IO_Poll to ::Poll; created transparent
788 backward-compatibility wrapper
789
790 0.22 CHANGES:
791 * Added tcp-proxy.pl example
792 * More documentation on IO::Async::Notifier subclass-override methods
793 * Documented that IO::Async::MergePoint is just an Async::MergePoint
794 * Various small updates to keep CPANTS happy
795
796 BUGFIXES:
797 * Don't test Async::MergePoint locally as it's now a separate dist,
798 and the tests here were reporting false negatives.
799
800 0.21 CHANGES:
801 * Added "use warnings" to all modules
802 * Created Notifier->configure method to allow changing properties of
803 a Notifier or subclass after construction
804 * New 'examples' dir with some small example scripts
805
806 BUGFIXES:
807 * More robust timing tests to avoid some spurious test failures due
808 to busy testing servers or other non-issues
809
810 0.20 CHANGES:
811 * Major reworking of underlying Loop implementation:
812 + Unified low-level IO, timer and signal watches as callbacks
813 + Split IO handle parts of Notifier into new IO::Async::Handle
814 class
815 + Created Timer and Signal subclasses of Notifier
816
817 These changes will require a compatible upgrade to the underlying
818 Loop implementation.
819
820 * Hide SignalProxy and TimeQueue from CPAN's indexer, as they are
821 internal-only details that don't need exposing there.
822 * Loop magic constructor now warns if a specifically-requested class
823 is not available
824 * Allow multiple attachment of signals via Loop->attach_signal or new
825 Signal objects
826
827 0.19 CHANGES:
828 * Allow control of Sequencer's pipelining
829 * Documentation fixes
830 * Allow Loop->run_child to take a 'setup' array
831 * Added 'setuid', 'setgid' and 'setgroups' child setup operations
832 * Support 'on_notifier' in Loop->listen
833
834 BUGFIXES:
835 * carp before return in Stream->write so it actually prints
836 * Ensure Streams still work after being closed and reopened by
837 ->set_handle
838 * If IO::Socket->new() fails, try again with generic ->socket
839 (makes IPv6 work on platforms without IO::Socket::INET6)
840
841 0.18 CHANGES:
842 * Allow Sequencer to be a base class as well as using constructor
843 callbacks
844 * Use signal names from Config.pm rather than relying on POSIX.pm.
845 Covers more signals that way
846
847 BUGFIXES:
848 * Gracefully handle accept() returning EAGAIN
849 * Fixed handling of IO::Socket->getsockopt( SOL_SOCKET, SO_ERROR )
850
851 0.17 CHANGES:
852 * Added Stream->close_when_empty and ->close_now. Added docs
853 * Added OS abstractions of socketpair() and pipe()
854 * Many documentation changes and updates
855
856 BUGFIXES:
857 * Properly handle stream read/write errors; close immediately rather
858 than deferring until empty.
859 * Various CPAN testers somketest bug fixes
860 * Fixed http://rt.cpan.org/Ticket/Display.html?id=38476
861
862 0.16 ADDITIONS:
863 * Loop->requeue_timer()
864 * Magic constructor in IO::Async::Loop which tries to find the best
865 subclass
866 * 'chdir' and 'nice' ChildManager operations
867
868 CHANGES:
869 * Make sure that top-level objects are refcount-clean by using
870 Test::Refcount, and Scalar::Util::weaken()
871
872 BUGFIXES:
873 * Keep perl 5.6.1 happy by not passing LocalPort => 0 when
874 constructing IO::Socket::INETs
875 * Pass the Type option to IO::Socket::INET constructor in test
876 scripts
877
878 0.15 REMOVALS:
879 * IO::Async::Set subclasses and IO::Async::Buffer have now been
880 entirely removed.
881
882 CHANGES:
883 * Support handle-less IO::Async::Sequencer, like ::Notifier
884 * Set SO_REUSEADDR on listening sockets by default
885 * Allow Loop->listen() on a plain filehandle containing a socket
886 * No longer any need to explcitly call Loop->enable_childmanager
887
888 BUGFIXES:
889 * IO::Async::Loop->_adjust_timeout actually works properly
890 * Notifier->close() only runs on_closed callback if it actually
891 closed - allows for neater cross-connected Notifiers
892 * Made Notifier->want_{read,write}ready more efficient
893 * Notifier->close() on a child notifier works
894 * Loop->listen() should take the first successful address, rather
895 than trying them all
896
897 0.14 REMOVALS:
898 * IO::Async::Set subclasses and IO::Async::Buffer are now completely
899 deprecated. Any attempt to use them will fail immediately.
900
901 ADDITIONS:
902 * 'keep' ChildManager operation
903 * IO::Async::Test::wait_for_stream()
904 * Loop->listen()
905 * IO::Async::Sequencer class
906
907 CHANGES:
908 * Support dynamic swapping of temporary 'on_read' handlers in Stream
909 * Now requires Socket::GetAddrInfo >= 0.08
910 * Further shortcuts in ChildManager setup keys - IO references and
911 simple string operation names
912 * Support handle-less IO::Async::Notifiers that have IO handles added
913 to them later
914 * Allow 'setup' key to Loop->detach_code()
915 * Various documentation updates
916
917 BUGFIXES:
918 * Allow the same filehandle to be 'dup'ed more than once in
919 ChildManager
920
921 0.13 CHANGES:
922 * Flush all awaiting data from Stream when it becomes writeready
923 * Supply a real IO::Async::Test module to allow testing in 3rd party
924 distros
925 * Various documentation fixes
926
927 BUGFIXES:
928 * Don't rely on STDOUT being writable during test scripts
929
930 0.12 CHANGES:
931 * Allow Notifiers that are write-only.
932 * Added ChildManager->open and ->run; with ->open_child and
933 ->run_child on the containing Loop.
934 * Moved IO::Async::Loop::Glib out to its own CPAN dist, to
935 simplify Build.PL and testing scripts
936
937 BUGFIXES:
938 * Make sure to "use IO::Socket" in IO::Async::Connector
939 * Pass 'socktype' argument to ->connect during testing
940
941 0.11 INCOMPATIBLE CHANGES:
942 * Renamed IO::Async::Set::* to IO::Async::Loop::* - provided
943 backward-compatibility wrappers around old names.
944 IO::Async::Set::GMainLoop has become IO::Async::Lib::Glib
945 * Renamed IO::Async::Buffer to IO::Async::Stream - provided backward-
946 compatibility wrapper around old name.
947 * Loop->get_childmanager() and ->get_sigproxy() no longer allowed
948
949 CHANGES:
950 * Extended ->loop_once() and ->loop() feature out to all
951 IO::Async::Loop classes
952 * Added IO::Async::Resolver and IO::Async::Connector, plus Loop
953 integration
954 * Allow write-only IO::Async::Notifiers that have no read handle or
955 readiness callback.
956
957 0.10 INCOMPATIBLE CHANGES:
958 * Renamed events and methods in IO::Async::Notifier to better fit the
959 naming scheme of normal Perl handles. Backward-compatibility hooks
960 are currently provided, but will be removed in a later release. Any
961 code using the old names should be updated
962
963 CHANGES:
964 * Allow DetachedCode to have multiple back-end worker processes.
965 * Control if a back-end worker exits when the code "die"s
966 * Added 'close()' method on Notifiers/Buffers. Sensible behaviour on
967 buffers with queued data to send
968 * Reset %SIG hash in ChildManager->detach_child()
969
970 BUGFIXES:
971 * Clean up temporary directory during testing
972 * Shut down DetachedCode workers properly on object deref
973 * Better handling of borderline timing failures in t/11set-*.t
974 * Close old handles before dup2()ing new ones when detaching code
975 * Various other minor test script improvements
976
977 0.09 CHANGES:
978 * Added TimeQueue object and integration with IO::Async::Set and
979 subclasses.
980 * Added MergePoint object
981 * Added 'on_closed' callback support to IO::Async::Notifier
982
983 BUGFIXES:
984 * Don't depend on system locale when checking string value of $!
985 * Fixed test scripts to more closely approximate real code behaviour
986 in the presence of poll() vs. deferred signal delivery
987
988 0.08 CHANGES:
989 * Added ChildManager->detach_child() method
990 * Added DetachedCode object
991
992 BUGFIXES:
993 * Better tests for presence of Glib to improve test false failures
994 * More lenient times in test script 11set-IO-Poll-timing to allow for
995 variances at test time
996 * Avoid bugs in post_select()/post_poll() caused by some notifier
997 callbacks removing other notifiers from the set
998
999 0.07 BUGFIXES:
1000 * Avoid race condition in t/30childmanager.t - wait for child process
1001 to actually exit
1002 * Avoid race condition in IO::Async::ChildManager->spawn() by waiting
1003 for SIGCHLD+pipe close, rather than SIGCHLD+pipe data
1004
1005 0.06 CHANGES:
1006 * Allow 'env' setup key to ChildManager->spawn() to change the
1007 child's %ENV
1008 * Updated the way some of the ->spawn() tests are conducted. There
1009 seems to be massive failures reported on cpantesters against 0.05.
1010 These changes won't fix the bugs, but should assist in reporting
1011 and tracking them down.
1012
1013 BUGFIXES:
1014 * Don't rely on existence of /bin/true - test for /usr/bin/true as
1015 well, fall back on "$^X -e 1"
1016 * Avoid kernel race condition in t/32childmanager-spawn-setup.t by
1017 proper use of select() when testing.
1018
1019 0.05 CHANGES:
1020 * Added ChildManager object
1021 * Added singleton storage in IO::Async::Set to store a SignalProxy or
1022 ChildManager conveniently
1023
1024 BUGFIXES:
1025 * Workaround for a bug in IO::Poll version 0.05
1026
1027 0.04 CHANGES:
1028 * Added dynamic signal attach / detach methods to SignalProxy
1029 * Buffer now has on_read_error / on_write_error callbacks for
1030 handling IO errors on underlying sysread()/syswrite() calls
1031
1032 0.03 CHANGES:
1033 * No longer build_requires 'Glib' - print a warning if it's not
1034 installed but carry on anyway.
1035 * IO_Poll->loop_once() now returns the result from the poll() call
1036 * Added concept of nested child notifiers within Notifier object
1037
1038 BUGFIXES:
1039 * Fix to test scripts that call IO_Poll's loop_once() with a timeout
1040 of zero. This can cause a kernel race condition, so supply some
1041 small non-zero value instead.
1042
1043 0.02 INCOMPATIBLE CHANGES:
1044 * Event methods/callback functions now called "on_*" to distinguish
1045 them
1046 * Callback functions now pass $self as first argument to simplify
1047 called code
1048
1049 CHANGES:
1050 * Improved POD in Notifier.pm and Buffer.pm
1051
1052 BUGFIXES:
1053 * GMainLoop.pm - return 1 from callbacks so that glib doesn't remove
1054 our IO sources
1055 * GMainLoop.pm - make sure re-asserting want_writeready actually adds
1056 the IO source again
1057
1058 0.01 First version, released on an unsuspecting world.
1059