On Sun, Jul 5, 2009 at 8:23 AM, Simon King<simon.k...@uni-jena.de> wrote:
>
> Dear sage devel,
>
> currently I am writing a test  suite for my cohomology spkg. In the
> Developer's Guide, I read:
>
> spkg-check: this file runs the test suite. This is somewhat optional
> since not all spkgs have test suites. If possible do create such a
> script since it helps isolate bugs in upstream packages
>
> OK, I have spkg-check. But what exactly is it supposed to do? Is it
> fine to print on the screen whether all tests passed or not, and in
> the latter case to save the log in some file test.log in the current
> directory?
>
> And when will spkg-check be called? Is this something that the user
> has to do manually? Will there be tests on a regular basis?
>
> Perhaps these informations could go into the Developer's Guide as
> well.

The 100% entire point of spkg-check is to run the line

   make check     # or equivalent

that many spkg's upstream scripts provide, analyze the results and
exit with a 0 error code if and only if the test suite passes.    The
point was that we wanted to put running the upstream test suite in
spkg-check instead of spkg-install (which we were doing), since the
test suite often takes a long time to run and it is nice to easily
make it is possible to not run it.

I think that this thread contains a lot of other discussion about what
people think spkg-check is meant for.  I think it's the above, since I
made it up in the first place for that reason only.

Note that spkg-check has remained almost entirely unused in Sage.   It
is only used if you do

   export SAGE_CHECK=yes

in which all spkg-check files are run, and if any exit with a code
other than 0 then the build process stops with an error.

 -- William

--~--~---------~--~----~------------~-------~--~----~
To post to this group, send email to sage-devel@googlegroups.com
To unsubscribe from this group, send email to 
sage-devel-unsubscr...@googlegroups.com
For more options, visit this group at http://groups.google.com/group/sage-devel
URLs: http://www.sagemath.org
-~----------~----~----~----~------~----~------~--~---

Reply via email to