Opened 8 years ago
Closed 8 years ago
#14203 closed enhancement (fixed)
Move DOCTEST_MODE to doctesting framework
Reported by: | jdemeyer | Owned by: | roed |
---|---|---|---|
Priority: | major | Milestone: | sage-5.10 |
Component: | doctest framework | Keywords: | |
Cc: | jhpalmieri | Merged in: | sage-5.10.beta1 |
Authors: | John Palmieri | Reviewers: | Volker Braun |
Report Upstream: | N/A | Work issues: | |
Branch: | Commit: | ||
Dependencies: | #12415 | Stopgaps: |
Description
Move the DOCTEST_MODE
setting to the doctesting framework, for example in the file sage/doctest/all.py
.
Attachments (1)
Change History (17)
comment:1 Changed 8 years ago by
- Dependencies set to #12415
comment:2 Changed 8 years ago by
- Cc jhpalmieri added
comment:3 follow-ups: ↓ 4 ↓ 7 Changed 8 years ago by
comment:4 in reply to: ↑ 3 ; follow-ups: ↓ 5 ↓ 6 Changed 8 years ago by
Replying to jhpalmieri:
This patch puts
DOCTEST_MODE
insage/doctest/__init__.py
. It also removes it entirely fromsage/plot/plot.py
, since it wasn't used there at all. Should we leave it there for backwards compatibility with optional/experimental packages and third party code?
We need a combined lazy_import
/deprecate
for this situation. :-)
At some point, we might do the same with
EMBEDDED_MODE
, but this will also require patches to sagenb, and therefore is more annoying.
Where would EMBEDDED_MODE
move to?
comment:5 in reply to: ↑ 4 Changed 8 years ago by
comment:6 in reply to: ↑ 4 Changed 8 years ago by
comment:7 in reply to: ↑ 3 Changed 8 years ago by
Replying to jhpalmieri:
At some point, we might do the same with
EMBEDDED_MODE
, but this will also require patches to sagenb, and therefore is more annoying.
And rename EMBEDDED_MODE
to HTML_MODE
or something else which describes the usage better.
And EMBEDDED_MODE
is actually independently defined in 6 different modules:
devel/sagenb/sagenb/misc/support.py devel/sage/sage/misc/pager.py devel/sage/sage/misc/sageinspect.py devel/sage/sage/misc/latex.py devel/sage/sage/plot/plot.py devel/sage/sage/server/support.py
comment:8 Changed 8 years ago by
Is NOTEBOOK_MODE
a good name?
Maybe we should import it from sagenb.misc.support
for now, and then rename it later. Or we could do this once somewhere in the Sage library:
try: from sagenb.misc.support import NOTEBOOK_MODE except ImportError: from sagenb.misc.support import EMBEDDED_MODE as NOTEBOOK_MODE
Then there can be an independent sagenb patch eventually.
comment:9 Changed 8 years ago by
- Component changed from doctest to doctest framework
- Owner changed from mvngu to roed
comment:10 Changed 8 years ago by
Is this ticket ready for review?
comment:12 Changed 8 years ago by
Rebased to 5.9.beta2.
comment:13 Changed 8 years ago by
- Milestone changed from sage-5.9 to sage-5.10
- Reviewers set to Volker Braun
- Status changed from needs_review to positive_review
Looks good to me!
comment:14 Changed 8 years ago by
Umm... what about the #14275 situation? I don't think this would mess things up as much as moving EMBEDDED_MODE
but perhaps it's still unwise to do without this...
comment:15 Changed 8 years ago by
I don't agree with #14275, for starters. It would be a mistake to make any guarantees about the implementation of the doctesting framework. If your code depends on the location of DOCTEST_MODE
then your code is broken.
comment:16 Changed 8 years ago by
- Merged in set to sage-5.10.beta1
- Resolution set to fixed
- Status changed from positive_review to closed
This patch puts
DOCTEST_MODE
insage/doctest/__init__.py
. It also removes it entirely fromsage/plot/plot.py
, since it wasn't used there at all. Should we leave it there for backwards compatibility with optional/experimental packages and third party code?At some point, we might do the same with
EMBEDDED_MODE
, but this will also require patches to sagenb, and therefore is more annoying.