RE: [Tm4j-developers] Test code

[Kal A. <ka...@te...>]

> Hi,
> >
> > I couldn't agree more! You should find that there is some test
> code in the
> > CVS tree (src/com/techquila/topicmap/test) which is written
> using JUnit. But
> > this test code is by no means exhaustive.
> >
> > I have been working recently on making that test code
> idependant of which
> > back-end is in use (the memory package or the ozone one) and I
> don't think I
> > have quite checked in all my changes yet. I'll have a look and check in
> > anything that needs to be.
> >
> > If you would like to contribute test cases, then the only thing
> I would ask
> > is that you write them using the JUnit framework (www.junit.org).
> >
>
> Junit is also my favourite suite. Additional ant has a junit target that
> makes it easy to include test running in the build process.
>
> Could we agree on these guidelines:
>
> - test code is part of the source tree (some tend to divide test code
> completely)

+1

> - test code for package are stored in packages parallel to the packages
> to test with
>    an test suffix. package a.b.c would have a test package a.b.ctest.

Yes, except that the packages that implement the com.techquila.topicmap
interface (com.techquila.topicmap.memory and com.techquila.topicmap.ozone)
should be tested by the package com.techquila.topicmap.test - to validate
that the back-end transparency is correct.

> - one additional package as a test suite base. this provides a package
> for the main
>    test classes and for the classes which are wiring several test suites.
>

+1 This should include plumbing to enable the selective running of tests.

> Is this ok?
>

Looks really good to me!

> What about the package names of the API. Are there any plans to move the
> package
> naming from com.techquila to org.tm4j ? It isn't really important at the
> moment but some things should be clear to everyone who is
> contributing code.
> This includes the license thing.
>

Indeed - I only recently acquired the tm4j.org domain. I've been planning
that the 0.5 release should be the last release with packages in the
techquila.com domain.

The license text was changed for the 0.5 release to specify The TM4J Project
as copyright owner. I would like to add a contributors list to the
distribution starting with the next release. Is there something more that
should be done ?


Cheers,

Kal