script to create spkg template

[sagetrac-GeorgSWeber]

(see also the respective thread at sage-devel)

Although this spkg is pretty small, putting it in a trac ticket is probably not the best idea. But currently, I haven't got access to any other web space where I could place it.

Install with "sage -i exampleclib-1.0.0.spkg"; the documentation is the under

$SAGE_ROOT/devel/exampleclib/src/README.txt

$SAGE_ROOT/devel/exampleclib/src/doc/*

Component: documentation

Reviewer: Jeroen Demeyer

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

[sagetrac-mabshoff]

comment:1

-1 by a wide margin. This spkg does numerous things badly and introduces many "features" we don't need or are completely overdesigned. The idea about spkg-install and its friends is KISS and this certainly isn't it.

The place to have this is not trac either.

Cheers,

Michael

[sagetrac-mabshoff]

comment:2

I have removed the attached spkg. It can now be found at

http://sage.math.washington.edu/home/mabshoff/exampleclib-1.0.0.spkg

Cheers,

Michael

[sagetrac-GeorgSWeber]

Attachment: 4857-scripts.patch.gz

a new script "sage-create-spkg" to go in the scripts repo /local/bin

[sagetrac-GeorgSWeber]

Attachment: 4857-examples.patch.gz

two example "upstream src" packages (sample spkg input) to go in the examples/ repo

[sagetrac-GeorgSWeber]

rewritten and enhanced chapter about spkg in prog.tex resp. the doc/ repo (probably rather easily rebased after the ReST move)

[sagetrac-GeorgSWeber]

comment:3

Attachment: 4857-doc.patch.gz

The current documentation in the Sage Developer's Guide says in Chapter 2, subsection 8.1, item (f) about Creating a New spkg: ... Post a copy on the Sage trac server ...

This is outdated. I took the opportunitiy to rewrite subsection 8.1, add two subsections 8.2 and 8.3, and assemble two live examples (to go under the examples directory) and a script "sage-create-spkg" which e.g. creates a template SPKG.txt and the mandatory hg repo. The script called on the examples result in working spkg, that install fine.

Well, at least at the author's Mac. So it would be good if the referee could use and test it on a Linux machine.

The contents are based on a discussion with Michael Abshoff on sage-devel, half of the credit (at least) goes to him. All the remaining mistakes are mine, of course :-)