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 -~----------~----~----~----~------~----~------~--~---