Detecting external software

This module makes up a list of external software that Sage interfaces. Availability of each software is tested only when necessary. This is mainly used for the doctests which require certain external software installed on the system.

Even though the functions in this module should also work when an external software is not present, most doctests in this module are only tested if testing of external software is explicitly enabled in order to avoid invoking external software otherwise. See github issue #28819 for details.

AUTHORS:

• Kwankyu Lee (2016-03-09) – initial version, based on code by Robert Bradshaw and Nathann Cohen

class sage.doctest.external.AvailableSoftware

Bases: object

This class keeps the set of available software whose availability is detected lazily from the list of external software.

EXAMPLES:

sage: from sage.doctest.external import external_software, available_software
sage: external_software
['cplex',
 'dvips',
 'ffmpeg',
 'gurobi',
 'internet',
 'latex',
 'latex_package_tkz_graph',
 'lualatex',
 'macaulay2',
 'magma',
 'maple',
 'mathematica',
 'matlab',
 'octave',
 'pdflatex',
 'scilab',
 'xelatex']
sage: 'internet' in available_software # random, optional - internet
True
sage: available_software.issuperset(set(['internet','latex'])) # random, optional - internet latex
True

detectable()

Return the list of names of those features for which testing their presence is allowed.

issuperset(other)

Return True if other is a subset of self.

EXAMPLES:

sage: from sage.doctest.external import available_software
sage: available_software.issuperset(set(['internet','latex','magma'])) # random, optional - internet latex magma
True

seen()

Return the list of detected external software.

EXAMPLES:

sage: from sage.doctest.external import available_software
sage: available_software.seen() # random
['internet', 'latex', 'magma']

sage.doctest.external.external_features()

Generate the features that are only to be tested if --optional=external is used.

EXAMPLES:

sage: from sage.doctest.external import external_features
sage: next(external_features())
Feature('internet')

sage.doctest.external.has_4ti2()

Test if the 4ti2 package is available.

EXAMPLES:

sage: from sage.doctest.external import has_4ti2
sage: has_4ti2()   # optional -- 4ti2
FeatureTestResult('4ti2', True)

sage.doctest.external.has_cplex()

Test if CPLEX is available.

EXAMPLES:

sage: from sage.doctest.external import has_cplex
sage: has_cplex() # random, optional - CPLEX
FeatureTestResult('cplex', True)

sage.doctest.external.has_dvipng()

Test if dvipng is available.

EXAMPLES:

sage: from sage.doctest.external import has_dvipng
sage: has_dvipng() # optional -- dvipng
FeatureTestResult('dvipng', True)

sage.doctest.external.has_ffmpeg()

Test if ffmpeg is available.

EXAMPLES:

sage: from sage.doctest.external import has_ffmpeg
sage: has_ffmpeg()      # optional -- ffmpeg
FeatureTestResult('ffmpeg', True)

sage.doctest.external.has_graphviz()

Test if graphviz (dot, twopi, neato) are available.

EXAMPLES:

sage: from sage.doctest.external import has_graphviz
sage: has_graphviz()   # optional -- graphviz
FeatureTestResult('graphviz', True)

sage.doctest.external.has_gurobi()

Test if Gurobi is available.

EXAMPLES:

sage: from sage.doctest.external import has_gurobi
sage: has_gurobi() # random, optional - Gurobi
FeatureTestResult('gurobi', True)

sage.doctest.external.has_imagemagick()

Test if ImageMagick (command convert) is available.

EXAMPLES:

sage: from sage.doctest.external import has_imagemagick
sage: has_imagemagick() # optional -- imagemagick
FeatureTestResult('imagemagick', True)

sage.doctest.external.has_internet()

Test if Internet is available.

Failure of connecting to the site “https://www.sagemath.org” within a second is regarded as internet being not available.

EXAMPLES:

sage: from sage.doctest.external import has_internet
sage: has_internet()  # random, optional -- internet
FeatureTestResult('internet', True)

sage.doctest.external.has_latex()

Test if Latex is available.

EXAMPLES:

sage: from sage.doctest.external import has_latex
sage: has_latex() # optional - latex
FeatureTestResult('latex', True)

sage.doctest.external.has_lualatex()

Test if lualatex is available.

EXAMPLES:

sage: from sage.doctest.external import has_lualatex
sage: has_lualatex()   # optional - lualatex
FeatureTestResult('lualatex', True)

sage.doctest.external.has_macaulay2()

Test if Macaulay2 is available.

EXAMPLES:

sage: from sage.doctest.external import has_macaulay2
sage: has_macaulay2() # random, optional - macaulay2
True

sage.doctest.external.has_magma()

Test if Magma is available.

EXAMPLES:

sage: from sage.doctest.external import has_magma
sage: has_magma() # random, optional - magma
True

sage.doctest.external.has_maple()

Test if Maple is available.

EXAMPLES:

sage: from sage.doctest.external import has_maple
sage: has_maple() # random, optional - maple
True

sage.doctest.external.has_mathematica()

Test if Mathematica is available.

EXAMPLES:

sage: from sage.doctest.external import has_mathematica
sage: has_mathematica() # random, optional - mathematica
True

sage.doctest.external.has_matlab()

Test if Matlab is available.

EXAMPLES:

sage: from sage.doctest.external import has_matlab
sage: has_matlab() # random, optional - matlab
True

sage.doctest.external.has_octave()

Test if Octave is available.

EXAMPLES:

sage: from sage.doctest.external import has_octave
sage: has_octave() # random, optional - octave
True

sage.doctest.external.has_pandoc()

Test if pandoc is available.

EXAMPLES:

sage: from sage.doctest.external import has_pandoc
sage: has_pandoc()      # optional -- pandoc
FeatureTestResult('pandoc', True)

sage.doctest.external.has_pdf2svg()

Test if pdf2svg is available.

EXAMPLES:

sage: from sage.doctest.external import has_pdf2svg
sage: has_pdf2svg() # optional -- pdf2svg
FeatureTestResult('pdf2svg', True)

sage.doctest.external.has_pdflatex()

Test if pdflatex is available.

EXAMPLES:

sage: from sage.doctest.external import has_pdflatex
sage: has_pdflatex()   # optional - pdflatex
FeatureTestResult('pdflatex', True)

sage.doctest.external.has_rubiks()

Test if the rubiks package (cu2, cubex, dikcube, mcube, optimal, and size222) is available.

EXAMPLES:

sage: from sage.doctest.external import has_rubiks
sage: has_rubiks()   # optional -- rubiks
FeatureTestResult('rubiks', True)

sage.doctest.external.has_scilab()

Test if Scilab is available.

EXAMPLES:

sage: from sage.doctest.external import has_scilab
sage: has_scilab() # random, optional - scilab
True

sage.doctest.external.has_xelatex()

Test if xelatex is available.

EXAMPLES:

sage: from sage.doctest.external import has_xelatex
sage: has_xelatex()   # optional - xelatex
FeatureTestResult('xelatex', True)