#6908: [with patch, needs review] programmers' guide --- doctesting and parallel
doctesting
---------------------------+------------------------------------------------
Reporter: mvngu | Owner: tba
Type: enhancement | Status: new
Priority: major | Milestone: sage-4.1.2
Component: documentation | Keywords:
Reviewer: | Author: Minh Van Nguyen
Merged: |
---------------------------+------------------------------------------------
Comment(by mvngu):
Replying to [comment:6 jhpalmieri]:
> Try using a version of Sage for which you have all the necessary
permissions, and doctest a file outside of the Sage library by specifying
a path name including slashes:
{{{
[mv...@sage sage-4.1.1]$ ./sage -t ../testing/junk.py
}}}
> or
{{{
[mv...@sage sage-4.1.1]$ ./sage -t [path to
sage-4.0]/devel/sage/sage/algebras/steenrod_algebra.py
}}}
> Does that give you an error?
Yes, it did.
[[BR]][[BR]]
> Maybe my point is that "sage -t" is inconsistent: it can accept a
filename within the current directory, or it can accept a pathname if that
path points to a location within the Sage library (can it accept any such
path?), but it won't accept a path which includes directories pointing
outside of the Sage library. This throws me off all the time, and I don't
think I even knew the pattern until writing this. I'm not even sure that
I have it right. Since inconsistencies are confusing, perhaps this could
be mentioned, or the allowable file- and/or path-name arguments to {{{sage
-t}}} described.
I added a little explanation at the start on the general syntax to use for
doctesting. It doesn't cover all cases, but I think it should cover cases
where someone wants to do basic doctesting. There is now a new section
called "Beyond the Sage library" that explains the limited support for
doctesting modules outside of the Sage library.
[[BR]][[BR]]
> Along these lines, do you want cross-references between this new chapter
and the section on "Automated Testing" in conventions.rst?
Done.
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/6908#comment:7>
Sage <http://sagemath.org/>
Sage: Creating a Viable Open Source Alternative to Magma, Maple, Mathematica,
and MATLAB
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups
"sage-trac" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to
[email protected]
For more options, visit this group at
http://groups.google.com/group/sage-trac?hl=en
-~----------~----~----~----~------~----~------~--~---
