CANTCL is a proposed Tcl package repository which will provide a URI based interface where each resource (package) has a unique URI and various kinds of package searches and browsing are available via URIs as well. Here's an evolving list, comments are welcome.
cantcl/ -- front page
The front page lists the various starting URIs below, it's HTML
cantcl/<pkgname> -- get a package cantcl/packages/anagif.zip -- get latest version of anagif cantcl/packages/anagif.kit -- get latest version of anagif as a starkit cantcl/packages/anagif1.0.zip -- get version 1.0 cantcl/packages/anagif/
cantcl/packages/anagif/tcl/anagif.tcl
With the purl is activated, this will give us a way of referencing the latest version of any package as
http://purl.org/tcl/cantcl/packages/anagif.zip
Browse Interface
cantcl/browse/
This page might eventually list the top level of some set of package categories (eg. Trove) from which a web user might browse.
cantcl/browse/platform=Linux cantcl/browse/subject=CGI cantcl/browse/name=*image* -- glob style search
<cantcl> <description>Results of query /browse/platform=Linux</description> <ul> <li><a href="/packages/anagif/">Anagif</a> - ...description...</li> <li><a href="/packages/bwidget/">BWidget</a> - ...description...</li> </ul> </cantcl>
perhaps with an appropriate stylesheet to allow it to render nicely in a web browser.
Upload
According to REST, creation of new web resources should be done via POST or PUT. POST is for creating new sub-objects, PUT for completely new resources. PUT seems appropriate here, although supporting POST would allow for browser forms based upload as in the initial implementation.
It would be useful if the URL resolution was done in a manner that allowed authorized updating by authors or designated maintainers.
SC authorisation can be done via the usual HTTP methods if needed. Updates can be POSTed -- currently I've not concieved of updating already uploaded packages preferring to have new versions of packages uploaded (perhaps with the same version number overwriting the existing one). Upload authorisation would be a good idea to give some credibility to any repository.
Note: why not write a 'cantcl' implementation for tclvfs? Then you could mount a cantcl:/ new volume, and perhaps do things like glob -dir cantcl:/newpackages * -- this code could even transparently send information on the user's current system (win/mac/unix etc) and therefore only show things which apply. The newpackages directory could be constructed on the fly to represent only things the user doesn't yet have. Similarly there could be an upgrades directory -- all dynamic!!
Note: with tclvfs currently having a prototype webdav vfs, probably the best long term solution would be to a) provide support in cantcl for webdav and b) to update tclvfs so that its webdav support is better. Then we not only have CANTCL support, but also WebDAV.
SC since CANTCL works via http the current http vfs should work via the browse interface. Having WebDAV support would depend on having an appropriately capable web server. It would be nice at some point to put together a customised tclhttpd (or the mini httpd implementation) to handle CANTCL and enable a starkit which includes everything needed to run a repository.