package type = pip needs documentation

[mkoeppe]

There are now several packages where build/pkgs/PACKAGE/type is "pip".

Is there any documentation on this?

Some related tickets:

• Use pip to install Python dependencies #20218: Use pip to install Python dependencies
• Cleaning sage-package-list #19213: For packages listed in build/pkgs/piprules, allow 'sage --optional' to list them
• Add mock, pytest, tox, virtualenv optional packages #19680: Add mock, pytest, tox, virtualenv optional packages

Discussions:

• https://groups.google.com/d/topic/sage-devel/gRxr36XAR6I/discussion

Depends on #29287

CC: @videlec @vbraun @embray @jdemeyer @nexttime @jhpalmieri

Component: build

Reviewer: Matthias Koeppe, Samuel Lelièvre

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

[jdemeyer]

comment:1

I don't know if everybody agrees to "officially" support the pip type packages. It was mainly meant as stopgap for some disappearing old-style packages.

[jdemeyer]

comment:3

Also, shouldn't the way in which a package is installed (traditional way vs. pip way) be orthogonal to whether a package is considered standard, optional, or experimental?

Certainly not standard since we need to ship the sources of standard packages with Sage. They aren't really optional nor experimental either. I see it as just a shortcut to ./sage --pip install PKG.

[vbraun]

comment:4

The pip-type package could be enhanced to use a mirrored tarball if there is one, then we could also use it for standard packages. Though really the benefit seems pretty small compared to putting pip install in the spkg-install.

[mkoeppe]

comment:5

Replying to @jdemeyer:

I don't know if everybody agrees to "officially" support the pip type packages. It was mainly meant as stopgap for some disappearing old-style packages.

"Official" or not, documentation is better than no documentation, no?

[mkoeppe]

comment:6

Replying to @jdemeyer:
Description modified

Let me ask again my question which you removed from the description above:

I tried to add a package of this type for pypolymake (for #20892), but adding the file build/pkgs/pypolymake/type does not seem to enable "sage -i pypolymake". What am I missing?

[mkoeppe]

comment:11

#29287 is adding documentation

[mkoeppe]

Dependencies: #29287

[slel]

Reviewer: Matthias Koeppe, Samuel Lelièvre

[slel]

comment:13

Fixed by #29287.