home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _0a57eaf7f53918e6a9aac7656edd4d19 < prev    next >
Text File  |  2000-03-23  |  6KB  |  146 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>Test - utilities to aid in testing WWW::Search backends</TITLE>
  5. <LINK REL="stylesheet" HREF="../../../../Active.css" TYPE="text/css">
  6. <LINK REV="made" HREF="mailto:">
  7. </HEAD>
  8.  
  9. <BODY>
  10. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  11. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  12. <STRONG><P CLASS=block> Test - utilities to aid in testing WWW::Search backends</P></STRONG>
  13. </TD></TR>
  14. </TABLE>
  15.  
  16. <A NAME="__index__"></A>
  17. <!-- INDEX BEGIN -->
  18.  
  19. <UL>
  20.  
  21.     <LI><A HREF="#name">NAME</A></LI><LI><A HREF="#supportedplatforms">SUPPORTED PLATFORMS</A></LI>
  22.  
  23.     <LI><A HREF="#synopsys">SYNOPSYS</A></LI>
  24.     <LI><A HREF="#description">DESCRIPTION</A></LI>
  25.     <LI><A HREF="#methods and functions">METHODS AND FUNCTIONS</A></LI>
  26.     <UL>
  27.  
  28.         <LI><A HREF="#new">new</A></LI>
  29.         <LI><A HREF="#mode">mode</A></LI>
  30.         <LI><A HREF="#relevant_test">relevant_test</A></LI>
  31.         <LI><A HREF="#eval_test">eval_test</A></LI>
  32.         <LI><A HREF="#test">test</A></LI>
  33.         <LI><A HREF="#no_test">no_test</A></LI>
  34.         <LI><A HREF="#not_working">not_working</A></LI>
  35.         <LI><A HREF="#not_working_with_tests">not_working_with_tests</A></LI>
  36.         <LI><A HREF="#not_working_and_abandoned">not_working_and_abandoned</A></LI>
  37.         <LI><A HREF="#wc_l (private, not a method)">wc_l (private, not a method)</A></LI>
  38.         <LI><A HREF="#diff (private, not a method)">diff (private, not a method)</A></LI>
  39.     </UL>
  40.  
  41. </UL>
  42. <!-- INDEX END -->
  43.  
  44. <HR>
  45. <P>
  46. <H1><A NAME="name">NAME</A></H1>
  47. <P>Test - utilities to aid in testing WWW::Search backends</P>
  48. <P>
  49. <HR>
  50. <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
  51. <UL>
  52. <LI>Linux</LI>
  53. <LI>Solaris</LI>
  54. <LI>Windows</LI>
  55. </UL>
  56. <HR>
  57. <H1><A NAME="synopsys">SYNOPSYS</A></H1>
  58. <PRE>
  59.   $oTest = new WWW::Search::Test('HotBot,Yahoo,Excite');
  60.   $oTest->test('HotBot', 'Kingpin', 'one', $sQuery, $TEST_RANGE, 1, 10);</PRE>
  61. <P>
  62. <HR>
  63. <H1><A NAME="description">DESCRIPTION</A></H1>
  64. <P>See file test.pl in the WWW-Search-HotBot distribution for a detailed
  65. ``real-world'' example.</P>
  66. <P>
  67. <HR>
  68. <H1><A NAME="methods and functions">METHODS AND FUNCTIONS</A></H1>
  69. <P>
  70. <H2><A NAME="new">new</A></H2>
  71. <P>Create a new WWW::Search::Test object.
  72. All arguments are strings, names of backends that this object will be able to test.
  73. If no arguments are given, will be able to test all backends.</P>
  74. <P>
  75. <H2><A NAME="mode">mode</A></H2>
  76. <P>Set / get the test mode of this object.
  77. If an argument is given, sets the mode to that value.
  78. Returns the current (or newly set) value.</P>
  79. <P>There are three test modes available.  They are:</P>
  80. <PRE>
  81.   $MODE_INTERNAL: parse URLs out of saved pages (as a sanity check or regression test);
  82.   $MODE_EXTERNAL: send the query to the search engine "live", parse the results, and compare them to the previously saved results;
  83. and
  84.   $MODE_UPDATE: send the query to the search engine "live", parse the results, and save them for future testing.</PRE>
  85. <P>
  86. <H2><A NAME="relevant_test">relevant_test</A></H2>
  87. <P>Given the name of a backend, 
  88. returns true if this Test object is able to test that backend.</P>
  89. <P>
  90. <H2><A NAME="eval_test">eval_test</A></H2>
  91. <P>Given the name of a backend, 
  92. grabs the $TEST_CASES variable from that backend and evaluates it.</P>
  93. <P>
  94. <H2><A NAME="test">test</A></H2>
  95. <P>Run <CODE>test(s)</CODE> for a backend.
  96. Arguments are, in order: 
  97. name of a backend to test (string, required);
  98. name of backend maintainer (string, if undef $backend::MAINTAINER will be used);
  99. filename for results storage/comparison (string, required);
  100. query to be sent to backend (string, required);
  101. test method (required, one of the following).</P>
  102. <P>Several test methods are possible:</P>
  103. <PRE>
  104.   $TEST_EXACTLY: list of URLs must match exactly (line for line, in order);
  105.   $TEST_BY_COUNTING: test passes if number of resulting URLs is equal;
  106.   $TEST_GREATER_THAN: test passes if we get more than N result URLs;
  107. and
  108.   $TEST_RANGE: like $TEST_GREATER_THAN but constrained on both ends.</PRE>
  109. <P>
  110. <H2><A NAME="no_test">no_test</A></H2>
  111. <P>Prints a message stating that this backend does not have a test suite.
  112. Takes two arguments, the backend name and the name of the maintainer.</P>
  113. <P>
  114. <H2><A NAME="not_working">not_working</A></H2>
  115. <P>Prints a message stating that this backend is known to be broken.
  116. Takes two arguments, the backend name and the name of the maintainer.</P>
  117. <P>
  118. <H2><A NAME="not_working_with_tests">not_working_with_tests</A></H2>
  119. <P>Prints a message stating that this backend is known to be broken
  120. even though it has a test suite.
  121. Takes two arguments, the backend name and the name of the maintainer.</P>
  122. <P>
  123. <H2><A NAME="not_working_and_abandoned">not_working_and_abandoned</A></H2>
  124. <P>Prints a message stating that this backend is known to be broken
  125. and is not being actively maintained.
  126. Takes two arguments, the backend name and the name of the maintainer.</P>
  127. <P>
  128. <H2><A NAME="wc_l (private, not a method)">wc_l (private, not a method)</A></H2>
  129. <P>Given a filename, count the number of lines of text contained
  130. within the file.  
  131. (I.e. simulate running UNIX command wc -l on a file)</P>
  132. <P>
  133. <H2><A NAME="diff (private, not a method)">diff (private, not a method)</A></H2>
  134. <P>Given two files, returns TRUE if contents are line-by-line
  135. different, or FALSE if contents are line-by-line same.
  136. (I.e. like the UNIX command diff, but just reports true or false)</P>
  137. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  138. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  139. <STRONG><P CLASS=block> Test - utilities to aid in testing WWW::Search backends</P></STRONG>
  140. </TD></TR>
  141. </TABLE>
  142.  
  143. </BODY>
  144.  
  145. </HTML>
  146.