Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

poe::component::ikc::specifier(3pm) [debian man page]

IKC::Specifier(3pm)					User Contributed Perl Documentation				       IKC::Specifier(3pm)

NAME

       POE::Component::IKC::Specifier - IKC event specifer

SYNOPSIS

	   use POE;
	   use POE::Component::IKC::Specifier;
	   $state=specifier_parse('poe://*/timeserver/connect');
	   print 'The foreign state is '.specifier_name($state);

DESCRIPTION

       This is a helper module that encapsulates POE IKC specifiers.  An IKC specifier is a way of designating either a kernel, a session or a
       state within a IKC cluster.

       IKC specifiers have the folloing format :

	   poe:://kernel/session/state

       kernel may a kernel name, a kernel ID, blank (for local kernel), a '*' (all known foreign kernels) or host:port (not currently supported).

       session may be any session alias that has been published by the foreign kernel.

       state is a state that has been published by a foreign session.

       Examples :

       "poe://Pulse/timeserver/connect"
	   State 'connect' in session 'timeserver' on kernel 'Pulse'.

       "poe:/timeserver/connect"
	   State 'connect' in session 'timeserver' on the local kernel.

       "poe://*/timeserver/connect"
	   State 'connect' in session 'timeserver' on any known foreign kernel.

       "poe://Billy/bob/"
	   Session 'bob' on foreign kernel 'Billy'.

EXPORTED FUNCTIONS

   "specifier_parse($spec)"
       Turn a specifier into the internal representation (hash ref).  Returns undef() if the specifier wasn't valid.

	   print Dumper specifer_parse('poe://Pulse/timeserver/time');

       would print

	   $VAR1 = {
	       kernel => 'Pulse',
	       session => 'timeserver',
	       state => 'time',
	   };

       Note : the internal representation might very well change some day.

   "specifier_name($spec)"
       Turns a specifier into a string.

BUGS

AUTHOR

       Philip Gwyn, <perl-ikc at pied.nu>

COPYRIGHT AND LICENSE

       Copyright 1999-2011 by Philip Gwyn.  All rights reserved.

       This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

       See <http://www.perl.com/language/misc/Artistic.html>

SEE ALSO

       POE, POE::Component::IKC::Responder

perl v5.12.4							    2011-08-27						       IKC::Specifier(3pm)

Check Out this Related Man Page

POE::Test::Loops(3pm)					User Contributed Perl Documentation				     POE::Test::Loops(3pm)

NAME

       POE::Test::Loops - Reusable tests for POE::Loop authors

SYNOPSIS

	       #!/usr/bin/perl -w

	       use strict;
	       use Getopt::Long;
	       use POE::Test::Loops;

	       my ($dir_base, $flag_help, @loop_modules, $flag_verbose);
	       my $result = GetOptions(
		       'dirbase=s' => $dir_base,
		       'loop=s' => @loop_modules,
		       'verbose' => $flag_verbose,
		       'help' => $flag_help,
	       );

	       if (
		       !$result or !$dir_base or $flag_help or !@loop_modules
	       ) {
		       die(
			       "$0 usage:
",
			       "  --dirbase DIR   (required) base directory for tests
",
			       "  --loop MODULE   (required) loop modules to test
",
			       "  --verbose   show some extra output
",
			       "  --help   you're reading it
",
		       );
	       }

	       POE::Test::Loops::generate($dir_base, @loop_modules, $flag_verbose);
	       exit 0;

DESCRIPTION

       POE::Test::Loops contains one function, generate(), which will generate all the loop tests for one or more POE::Loop subclasses.

       The "SYNOPSIS" example is a version of poe-gen-tests, which is a stand-alone utility to generate the actual tests.  poe-gen-tests also
       documents the POE::Test::Loops system in more detail.

FUNCTIONS

   generate( $DIRBASE, @LOOPS, $VERBOSE )
       Generates the loop tests.  DIRBASE is the (relative) directory in which a subdirectory for each of the LOOPS is created.  If VERBOSE is set
       to a TRUE value some progress reporting is printed.

	       POE::Test::Loops::generate(
		       "./t",
		       [ "POE::Loop::Yours" ],
		       1,
	       );

SEE ALSO

       POE::Loop and poe-gen-tests.

AUTHOR &; COPYRIGHT
       See poe-gen-tests.

perl v5.14.2							    2012-03-11						     POE::Test::Loops(3pm)
Man Page