Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

wiki::toolkit::testlib(3pm) [debian man page]

Wiki::Toolkit::TestLib(3pm)				User Contributed Perl Documentation			       Wiki::Toolkit::TestLib(3pm)

NAME

       Wiki::Toolkit::TestLib - Utilities for writing Wiki::Toolkit tests.

DESCRIPTION

       When 'perl Makefile.PL' is run on a Wiki::Toolkit distribution, information will be gathered about test databases etc that can be used for
       running tests. Wiki::Toolkit::TestLib gives convenient access to this information.

SYNOPSIS

	 use strict;
	 use Wiki::Toolkit::TestLib;
	 use Test::More;

	 my $iterator = Wiki::Toolkit::TestLib->new_wiki_maker;
	 plan tests => ( $iterator->number * 6 );

	 while ( my $wiki = $iterator->new_wiki ) {
	     # put some test data in
	     # run six tests
	 }

       Each time you call "->next" on your iterator, you will get a fresh blank wiki object. The iterator will iterate over all configured search
       and storage backends.

METHODS

       new_wiki_maker
	     my $iterator = Wiki::Toolkit::TestLib->new_wiki_maker;

       number
	     use Test::More;
	     my $iterator = Wiki::Toolkit::TestLib->new_wiki_maker;
	     plan tests => ( $iterator->number * 6 );

	   Returns the number of new wikis that your iterator will be able to give you.

       new_wiki
	     my $wiki = $iterator->new_wiki;

	   Returns a fresh blank wiki object, or false if you've used up all the configured search and storage backends.

       configured_databases
	     my @configured_databases = $iterator->configured_databases;

	     Returns the @configured_databases array detailing configured test databases.
	     Useful for very low-level testing only.

SEE ALSO

       Wiki::Toolkit

AUTHOR

       Kake Pugh (kake@earth.li).

COPYRIGHT

	    Copyright (C) 2003-2004 Kake Pugh.	All Rights Reserved.
	    Copyright (C) 2008 the Wiki::Toolkit team. All Rights Reserved.

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

CAVEATS

       If you have the Search::InvertedIndex backend configured (see Wiki::Toolkit::Search::SII) then your tests will raise warnings like

	 (in cleanup) Search::InvertedIndex::DB::Mysql::lock() -
	   testdb is not open. Can't lock.
	 at /usr/local/share/perl/5.6.1/Search/InvertedIndex.pm line 1348

       or

	 (in cleanup) Can't call method "sync" on an undefined value
	   at /usr/local/share/perl/5.6.1/Tie/DB_File/SplitHash.pm line 331
	   during global destruction.

       in unexpected places. I don't know whether this is a bug in me or in Search::InvertedIndex.

perl v5.14.2							    2011-09-25					       Wiki::Toolkit::TestLib(3pm)

Check Out this Related Man Page

Wiki::Toolkit::Plugin::RSS::Reader(3pm) 		User Contributed Perl Documentation		   Wiki::Toolkit::Plugin::RSS::Reader(3pm)

NAME

       Wiki::Toolkit::Plugin::RSS::Reader - retrieve RSS feeds for inclusion in Wiki::Toolkit nodes

DESCRIPTION

       Use this Wiki::Toolkit plugin to retrieve an RSS feed from a given URL so that you can include it in a wiki node.

SYNOPSIS

	   use Wiki::Toolkit::Plugin::RSS::Reader;

	   my $rss = Wiki::Toolkit::Plugin::RSS::Reader->new(
	     url   => 'http://example.com/feed.rss'
	   );

	   my @items = $rss->retrieve;

USAGE

       This is a plugin for Wiki::Toolkit, a toolkit for building wikis; therefore please consult the documentation for Wiki::Toolkit for relevant
       information.  This module can, however, be used standalone if you wish.

METHODS

   "new"
	   my $rss = Wiki::Toolkit::Plugin::RSS::Reader->new([options]);

       Create a new RSS reader. Valid options are "url" or "file" (a path to an RSS file); only one can be specified.

   "retrieve"
	   my @items = $rss->retrieve;

       "retrieve" will return an array of hashes, one for each item in the RSS feed. The hashes contain three items, "title", "link", and
       "description".

       If the URL or file you specified cannot be retrieved/read, "retrieve" will return undef rather than blowing up and surprising the person
       reading your wiki. If you want, you can specify "debug" to be 1 in the options to "new", which will cause the module to croak instead of
       failing silently.

AUTHOR

       Earle Martin (EMARTIN@cpan.org) The Wiki::Toolkit team, (http://www.wiki-toolkit.org/)

LEGAL

       Copyright 2004 Earle Martin.  Copyright 2006 the Wiki::Toolkit team.

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

perl v5.10.1							    2009-10-25				   Wiki::Toolkit::Plugin::RSS::Reader(3pm)
Man Page