召唤Sage

要运行Sage，基本上只需要输入 sage 从命令行提示符启动Sage解释器。有关确保 $PATH 设置正确等。

Sage的命令行选项

运行Sage，最常见的选择

  • file.[sage|py|spyx] --运行给定的.sage、.py或.spyx文件（如 sage my_file.sage ）

  • -h ， -? ， --help --打印简短的帮助消息

  • -v ， --version --打印Sage版本

  • --advanced --打印（本质上是这个）Sage选项列表

  • -c cmd --评估 cmd sage代码。例如， sage -c 'print(factor(35))' 将打印“5*7”。

运行Sage，其他选项

  • --preparse file.sage --准备 file.sage ，一个Sage代码文件，并生成相应的Python文件 file.sage.py . 有关准备以及Sage和Python之间的区别，请参阅Sage教程。

  • -q --安静；从没有横幅开始

  • --grep [options] <string> --grep通过所有的Sage库代码 string . 任何选项都将传递给“grep”命令；例如， sage --grep -i epstein 将搜索 epstein 和 -i 标志告诉grep在搜索时忽略大小写。请注意，在运行Sage时，也可以使用函数 search_src 去完成同样的事情。

  • --grepdoc [options] <string> --通过所有的Sage文档 string . 请注意，在运行Sage时，也可以使用函数 search_doc 去完成同样的事情。

  • --min [...] --不填充全局命名空间（必须是第一个选项）

  • -gthread ， -qthread ， -q4thread ， -wthread ， -pylab --将选项传递给IPython

  • --nodotsage --运行Sage而不使用用户的 .sage 目录：创建并使用临时 .sage 而不是目录。警告：笔记本存储在 .sage 目录，因此运行时创建的任何笔记本 --nodotsage 也是暂时的。

运行笔记本

  • -n [...] ， --notebook=[...] --启动笔记本，有效的选项是 default ， sagenb ， jupyter 和 export （参见 sage --notebook --help 有关如何传递可选参数的详细信息和示例）

  • -bn [...] ， --build-and-notebook [...] --建立Sage库（通过运行 sage -b )然后启动Sage笔记本

  • --inotebook [...] --启动 不安全的 Sage笔记本

运行外部程序和实用程序

  • --cython [...] --用给定的参数运行Cython

  • --ecl [...] ， --lisp [...] --使用给定的参数运行Sage的ECL（可嵌入通用Lisp）副本

  • --gap [...] --用给定的论据来填补塞奇的空白

  • --git [...] --用给定的参数运行Sage的Git

  • --gp [...] --用给定的参数运行Sage的PARI/GP计算器

  • --ipython [...] --使用默认环境（而不是Sage）运行Sage的IPython，将附加选项传递给IPython

  • --kash [...] --用给定的参数运行Sage的Kash

  • --M2 [...] --用给定的参数运行Sage的macaula2

  • --maxima [...] --用给定的论据来运行Sage的格言

  • --mwrank [...] --用给定的参数运行Sage的mwrank

  • --python [...] ， --python2 [...] --运行python2解释器

  • --python3 [...] --运行python3解释器

  • -R [...] --用给定的参数运行Sage的R

  • --scons [...] --运行Sage's scons

  • --singular [...] --用给定的参数计算Sage的单数

  • --twistd [...] --运行Twisted服务器

  • --sh [...] --使用Sage环境变量运行shell，因为它们是在Sage运行时设置的

  • --buildsh [...] --在构建Sage及其包时，使用Sage环境变量运行shell

  • --gdb --在gdb的控制下运行Sage

  • --gdb-ipython --在gdb的控制下运行Sage的IPython

  • --cleaner --运行Sage清洁剂。这将在Sage之后清理，删除临时目录和生成的进程。（这是由Sage自动运行的，因此通常不需要单独运行它。）

安装包和升级

  • -i [options] [packages] --安装给定的Sage软件包（除非已经安装）；如果没有提供软件包，则打印所有已安装软件包的列表。选项：

    • -c --运行包的测试套件，重写的设置 SAGE_CHECK 和 SAGE_CHECK_PACKAGES .

    • -f --强制生成：安装包，即使它们已经安装。

    • -s --不要删除 spkg/build 成功生成后的目录——对调试很有用。

  • -f [options] [packages] --的快捷方式 -i -f ：强制生成给定的Sage包。

  • --info [packages] --显示 SPKG.txt 给定Sage包的文件。

  • --standard --列出所有可以安装的标准软件包

  • --optional --列出所有可以安装的可选软件包

  • --experimental --列出所有可以安装的实验包

  • --upgrade [url] --从标准url下载和安装。如果未指定url，则自动选择合适的镜像。如果url='ask'，它允许您选择镜像。

构建和测试Sage库

  • --root --打印Sage根目录

  • -b --构建Sage库——如果在中修改了任何源代码文件，请执行此操作 $SAGE_ROOT/src/sage/ .

  • -ba --与…相同 -b ，但要重建 all 赛顿密码。这可能需要一段时间，因此将询问您是否要继续。

  • -ba-force --与…相同 -ba ，但在重建之前不要查询

  • --br --构建并运行Sage

  • -t [options] <files|dir> --在.py、.pyx、.sage或.tex文件中测试示例。选项：

    • --long --包括带有短语“长时间”的行

    • --verbose --测试期间打印调试输出

    • --optional -- also test all examples labeled # optional

    • --only-optional[=tags] --如果没有 tags 只运行包含标记的行的测试块 # optional . 如果指定了逗号分隔的标记列表，则只运行包含标记的行的块 # optional tag 对于给定的任何标记，在这些块中只运行未标记或标记的行 #optional 或者贴上标签 #optional tag 对于给定的任何标签。

    • --randorder[=seed] --随机试验顺序

    • --short[=seconds] --在大约300秒（或给定的秒数）内运行尽可能多的doctest。这将从文件顶部为每个模块运行测试，并在超出为该文件分配的预算时跳过测试。

  • -tnew [...] --像 -t 但只测试自上次提交后修改的文件

  • -tp <N> [...] -- like -t above, but tests in parallel using N threads with 0 interpreted as minimum(8, cpu_count())

  • --testall [options] --测试所有源文件、文档和示例；选项与for相同 -t .

  • -bt [...] --构建和测试，选项包括 -t 在上面

  • -btp <N> [...] --并行构建和测试，选项如下 -tp 在上面

  • -btnew [...] -- build and test modified files, options like -tnew

  • --fixdoctests file.py [output_file] [--long] --编写的新版本 file.py 到 output_file （默认： file.py.out )医生会通过的。用可选的 --long 参数长时间测试也被检查。新文件的修补程序将打印到stdout。

  • --startuptime [module] --显示Sage的每个组件启动所需的时间。可选地指定一个模块（例如“Sage）获取有关该特定模块的更多详细信息。

  • --coverage <files> --提供有关文档的doctest覆盖率的信息

  • --coverageall --提供Sage库中所有文件的doctest覆盖率摘要信息

文档

  • --docbuild [options] document (format | command) --生成或返回有关Sage文档的信息。

    • document --要生成的文档的名称

    • format --文件输出格式

    • command --文档特定命令

    A document 或者 format 或A command 是必需的，除非要求提供其中一个或多个列表。

    选项：

    • help ， -h ， --help --打印帮助消息

    • -H ， --help-all --打印扩展帮助消息，包括选项的输出 -h ， -D ， -F ， -C all ，以及一个简短的示例列表。

    • -D ， --documents --列出所有可用文档

    • -F ， --formats --列出所有输出格式

    • -C DOC ， --commands=DOC --列出文档的所有命令 DOC 使用 -C all 列出全部

    • -i ， --inherited --可能继承的成员可能会在PDF中被继承，可能会在手动输出中失败

    • -u ， --underscore --包含前缀为 _ 在参考手册中；可能很慢，可能无法进行PDF输出

    • -j, --jsmath -- render math using jsMath; formats: html, json, pickle, web

    • --no-pdf-links -- do not include PDF links in document website; formats: html, json, pickle, web

    • --check-nested -- check picklability of nested classes in document reference

    • -N ， --no-colors --不着色输出；不影响子级

    • -q, --quiet -- work quietly; same as --verbose=0

    • -v LEVEL ， --verbose=LEVEL --报告级别为0（安静）、1（正常）、2（信息）或3（调试）的进度；不影响子级

    高级--小心使用这些选项：

    • -S OPTS ， --sphinx-opts=OPTS --传递逗号分隔 OPTS 斯芬克斯建筑

    • -U ， --update-mtimes --在构建参考手册之前，更新自动生成的ReST文件的修改时间

制作Sage包或分发

  • --pkg dir -- create the Sage package dir.spkg from the directory dir

  • --pkg_nc dir --作为 --pkg ，但不要压缩包

  • --merge --运行Sage的自动合并和测试脚本

  • --sdist --建立Sage的来源分布

Valgrind内存调试

  • --cachegrind --使用Valgrind的cachegrind工具运行Sage

  • --callgrind --使用Valgrind的callgrind工具运行Sage

  • --massif --使用Valgrind的massif工具运行Sage

  • --memcheck --使用Valgrind的memcheck工具运行Sage

  • --omega --使用Valgrind的omega工具运行Sage

  • --valgrind -- this is an alias for --memcheck