jvanzyl     02/01/17 07:19:33

  Added:       xdocs    core-testing.xml
  Log:
  - adding the start of a core turbine testing document.
  
  - a first runtime test is now working, i just need to make it copy
    files from lib.repo to setup the testapp right now i have everything
    piled up in a directory. i need to assemble it so that i don't have
    to check in the JARs to the testapp directory.
  
  Revision  Changes    Path
  1.1                  jakarta-turbine-3/xdocs/core-testing.xml
  
  Index: core-testing.xml
  ===================================================================
  <?xml version="1.0"?>
  
  <document>
  
    <properties>
      <title>Turbine 3</title>
      <author email="[EMAIL PROTECTED]">Jason van Zyl</author>
    </properties>
  
    <body>
      
      <section name="Turbine Core Testing">
        <p>
          This document outlines the testing procedures that
          help verify the integrity of Turbine while making changes 
          to core functionality. These tests should be run as a course
          of habit when making changes to the core so that you ensure your
          modifications are sound and don't negatively impact projects that
          expect certain patterns of behaviour from Turbine. <b>Testing your
          changes against your own project is not enough</b>.
        </p>
        <p>
          The tests to date are very shallow, but the framework is in place
          so that we can expand the tests to ensure that as we make changes
          we don't introduce any new unexpected behaviour. This
          should allow us to aggresively refactor Turbine with a certain degree
          of safety. The impact changes have on the core will become more
          apparent as the tests and test procedures expand. We have two flavours
          of tests: the basic unit tests, and runtime tests that employ the use
          of <a href="http://jakarta.apache.org/cactus/";>Cactus</a>.
        </p>
      </section>
      
      <section name="Basic Unit Tests">
        <p>
          The sources for the basic unit tests are located in the /test/org
          directory. These test sources are copied to our working sources
          directory where they are compiled along with the other Turbine
          classes. We then employ a standard Junit batchtest provided
          by Ant.
        </p>
      </section>
  
      <section name="Runtime Tests">
        <p>
          The sources for the basic unit tests are located in the /rttest/org
          directory. These test sources are copied to our working sources
          directory where they are compiled along with the other Turbine
          classes. We use Cactus to startup up our selected servlet container
          and then employ a standard Junit batchtest to run all of our
          servlet test cases.
        </p>
      </section>
    
    </body>
  </document>
  
  
  

--
To unsubscribe, e-mail:   <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>

Reply via email to