Re: open questions about pear's REST interface to channels

> > While writing the documents for the REST interface in peardoc, I > > stumbled about some sections lacking clarity. Maybe someone could help: > > > > - r/$package/stable.txt > > - r/$package/beta.txt > > - r/$package/alpha.txt > > - r/$package/devel.txt > > Do they exist if there is no stable/beta/alpha/devel version so that > > the access to the file results in a 404? > > I don't think they exist --- why would they, and what would be the > contents? I think 404 is adequate here. One thing I'm wondering is, > are the .txt files just convenience files for the installer? I would > think anything official/required would be the xml files. > > > > - r/$package/latest.txt > > Does that list the most recently released version, or the highest > > version? > > We currently have a problem with Chiara_PEAR_Server: stable version is > > 1.0.5, beta is 1.1.0b1. The stable version has been released *after* > > the beta, which in turn has the higher version number. Which one should > > be in latest.txt? The pear installer does not recognize the beta and > > always wants to install the stable version unless forced in combination > > with the direct version number. > > > > Does the file exist when there has been no release yet? It appears that 404 is the expected behavior when there is no release of _____ stability. Latest simply points to the latest release. These files are used by the REST v 1.0 for the listAll and listCategory commands. @see PEAR/REST/10.php Rest 1.1 and 1.3 only use these by inheritance of the two functions. > > - r/${packagename}/deps.0.1.2.txt > > Is the array format described somewhere? This is a simple array representation of the dependencies in the package.xml file: Array ( [required] => Array ( [php] => Array ( [min] => 5.0.0 ) [pearinstaller] => Array ( [min] => 1.4.3 ) [package] => Array ( [name] => HTTP_Request [channel] => pear.php.net [min] => 1.3.0 ) ) ) <dependencies> <required> <php> <min>5.0.0</min> </php> <pearinstaller> <min>1.4.3</min> </pearinstaller> <package> <name>HTTP_Request</name> <channel>pear.php.net</channel> <min>1.3.0</min> </package> </required> </dependencies> -- Brett Bieber http://saltybeagle.com/