Version 7 of CANTCL URL interface

Updated 2003-02-04 10:57:18

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/
  • returns a page of links to package contents which can then be browsed or traversed by a client, including at some point URIs of individual files inside the package, eg:
 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
  • each of these returns a package list with links into the /packages/ hierarchy, eg:
  <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.


Category Suggestions | Category Internet |