Yippieh,
that's what I really love about Sage:
you'll never walk alone!
What about the following idea: let's create

sage.libs.playground

and, say, Cython (sub-)modules

sage.libs.playground.exampleclib
sage.libs.playground.examplecpplib

which are amply documented despite their names, but in a setting that
does encourage one to add some

sage.libs.playground.mylib

and step-by-step (or whatever helpful) instructions how to do this as
easy as 1-2-3.

I now admit that already twice, I had created an "exampleclib.spkg"
together with complete Cython interface code. But I made (twice ...)
the mistake to put the latter under .../python/site-packages/... and I
think that in the end, this offended the referee(s) to such a degree,
that these attempts had to fail. (I also admit that I had made almost
any other mistake, too, e.g. not only creating a patch-bomb spkg, but
also uploading it to trac, introducing far more than needed
complexity, etc.pp. If you wish, have a look at the history of the
"needs work" trac ticket #4857 ...)

We (Michael Abshoff and me) could reach agreement on how the "Example
C Library spkg" shall look like, so this is almost 100% re-usable.
(Although e.g. Frobby is much more complete, especially concerning the/
an optional test suite.) The Cython interface code pre-dates the Sage
ReST-/Sphinxification, so there might be some work to do here. (The
move *into* the Sage Library is actually very easy, now that the
distinct "module_list.py" came into existence.)

Both the Frobby-Cython interface to be created, and the Cliquer.spkg
and Cliquer-Cython interfaces to come into existence, may serve as
first "real-life" tests to round off the edges of this new "Sage
playground" . And of course, I'm happy not only to answer a question
or two, but to try to improve the documentation in such a way, that
others will find these answers, too, should they have the same
questions.

Or do you have a better idea/name for the above than
"sage.libs.playground"?


Cheers,
gsw


P.S.:
William, to answer that one of your remarks:
IMHO, the best "current" example C(CPP) library / Cython interface
code in Sage is the "hypellfrob" one from David Harvey, but it's
neither under "sage.libs" (the content of which is quite, ahem,
inhomogeneous), nor is the non-Cython part of it in spkg format  ...
--~--~---------~--~----~------------~-------~--~----~
To post to this group, send email to sage-devel@googlegroups.com
To unsubscribe from this group, send email to 
sage-devel-unsubscr...@googlegroups.com
For more options, visit this group at http://groups.google.com/group/sage-devel
URLs: http://www.sagemath.org
-~----------~----~----~----~------~----~------~--~---

Reply via email to