sagemath/sage

Developer's Guide: Add instructions for sagelib development in a conda environment

mkoeppe opened this issue · 35 comments

#28745 updates the installation manual and explains the use of SAGE_ROOT/environment[-optional].yml.

As section in the developer's guide should explain the use of SAGE_ROOT/src/environment-[optional].yml

... from https://wiki.sagemath.org/Conda

including answers to the following questions (from #31099):

  • How do I now create a conda environment with a given name in a given location with the sage dependencies installed, and activate this env later and run say the doctests? Similarly, say I've created a conda env myself and activated it.
  • How can I now install the sage dependencies and run tests/lints using tox in this env?

Depends on #28745

CC: @dimpase @isuruf @saraedum @tobiasdiez

Component: documentation

Keywords: conda, sd110, sd111

Author: Isuru Fernando, Matthias Koeppe

Branch/Commit: b4e9e8c

Reviewer: Matthias Koeppe, Tobias Diez

Issue created by migration from https://trac.sagemath.org/ticket/28746

comment:1

Ticket retargeted after milestone closed

Changed keywords from none to Anaconda

Changed keywords from Anaconda to Anaconda, conda

Changed keywords from Anaconda, conda to conda

comment:5

pushing these forward to 9.2

Changed keywords from conda to conda, sd110

Description changed:

--- 
+++ 
@@ -1 +1 @@
-
+... from https://wiki.sagemath.org/Conda

Description changed:

--- 
+++ 
@@ -1 +1,6 @@
+#28745 updates the installation manual and explains the use of `SAGE_ROOT/environment[-optional].yml`.
+
+As section in the developer's guide should explain the use of `SAGE_ROOT/src/environment-[optional].yml`
+
+
 ... from https://wiki.sagemath.org/Conda
comment:11

Hoping we can make progress on this ticket this week - https://wiki.sagemath.org/days111

Changed keywords from conda, sd110 to conda, sd110, sd111

Description changed:

--- 
+++ 
@@ -4,3 +4,10 @@
 
 
 ... from https://wiki.sagemath.org/Conda
+
+including answers to the following questions (from #31099):
+
+- How do I now create a conda environment with a given name in a given location with the sage dependencies installed, and activate this env later and run say the doctests? Similarly, say I've created a conda env myself and activated it. 
+- How can I now install the sage dependencies and run tests/lints using tox in this env?
+
+

New commits:

4f1ff2fremove sagelib conda.txt

Commit: 4f1ff2f

Branch pushed to git repo; I updated commit sha1. New commits:

028c702use conda to provide all SPKGs

Changed commit from 4f1ff2f to 028c702

Branch pushed to git repo; I updated commit sha1. New commits:

b9928fdrun ./bootstrap again just in case it failed with m4/gettext errors before

Changed commit from 028c702 to b9928fd

Changed commit from b9928fd to 29ce3fa

Branch pushed to git repo; I updated commit sha1. New commits:

29ce3faUse update so that it is self-explanatory

Author: Isuru Fernando

Changed commit from 29ce3fa to d08601d

Branch pushed to git repo; I updated commit sha1. New commits:

d08601dclarify the difference
comment:19

Wondering if the environment files in src/ should use a different environment name...

comment:20

Sure. Feel free to push a change.

Changed branch from u/isuruf/sagelib to u/mkoeppe/sagelib

Changed commit from d08601d to 5912ab3

Changed author from Isuru Fernando to Isuru Fernando, Matthias Koeppe

Reviewer: Matthias Koeppe, ...

New commits:

5912ab3src/environment*.yml: Use sage, not sage-build, as environment name

Branch pushed to git repo; I updated commit sha1. New commits:

b4e9e8csrc/doc/en/installation/source.rst: Expand slightly

Changed commit from 5912ab3 to b4e9e8c

Changed reviewer from Matthias Koeppe, ... to Matthias Koeppe, Tobias Diez

comment:24

LGTM

Changed branch from u/mkoeppe/sagelib to b4e9e8c