Add fetchPackageReleaseXml method to get package releasei nfo

Author: c9s

README.md

@@ -25,33 +25,40 @@ Features:
 Channel operations:
 
 ```php
-<?php
-    use CacheKit\FileSystemCache;
-
-    $channel = new PEARX\Channel($host);
-    $categories = $channel->getCategories();
-
-    foreach( $categories as $category ) {
-        // $category->name
-        // $category->infoUrl
-
-        $packages = $category->getPackages();
-        foreach( $packages as $package ) {
-            $package->name;
-            $package->summary;
-            $package->desc;
-            $package->channel;
-            $package->license;
-            $package->deps;
-            $package->releases;
-
-            $package->stable; // version string
-            $package->alpha;  // version string
-            $package->latest; // version string
-
-            $stability = $package->getRelease('0.0.1');
-        }
+use CacheKit\FileSystemCache;
+
+$channel = new PEARX\Channel($host);
+
+
+// find package from the remote pear host
+$package = $channel->findPackage('PEAR');
+
+
+
+// traverse pear channel categories
+$categories = $channel->getCategories();
+
+foreach( $categories as $category ) {
+    // $category->name
+    // $category->infoUrl
+
+    $packages = $category->getPackages();
+    foreach( $packages as $package ) {
+        $package->name;
+        $package->summary;
+        $package->desc;
+        $package->channel;
+        $package->license;
+        $package->deps;
+        $package->releases;
+
+        $package->stable; // version string
+        $package->alpha;  // version string
+        $package->latest; // version string
+
+        $stability = $package->getRelease('0.0.1');
     }
+}
 ```
 
 

src/PEARX/Channel.php

@@ -85,6 +85,28 @@ public function getRestBaseUrl($version = null)
         return rtrim($this->primary[ $this->rest ],'/');
     }
 
+    public function fetchPackageReleaseXml($packageName, $version = 'stable')
+    {
+        $baseUrl = $this->getRestBaseUrl();
+        $url = "$baseUrl/r/" . strtolower($packageName);
+
+        if( $version === 'stable'
+            || $version === 'latest'
+            || $version === 'beta' ) 
+        {
+            // get version info
+            $version = file_get_contents($url . '/' . $version . '.txt' );
+        }
+        $url = $url . '/' . $version . '.xml';
+        $xmlStr = $this->core->request($url);
+
+        // libxml_use_internal_errors(true);
+        $xml = Utils::create_dom();
+        if( false === $xml->loadXml( $xmlStr ) ) {
+            throw new Exception("Error in XMl document: $url");
+        }
+        return $xml;
+    }
 
     /**
      * fetch channel.xml from PEAR channel server.
@@ -151,6 +173,12 @@ public function getCategories()
         return $list;
     }
 
+
+    /**
+     * Get all packages from this channel.
+     *
+     * @return Package[]
+     */
     public function getPackages()
     {
         $packages = array();
@@ -160,6 +188,7 @@ public function getPackages()
         return $packages;
     }
 
+
     public function findPackage($name)
     {
         foreach( $this->getCategories() as $category ) {

tests/PEARX/ChannelTest.php

@@ -3,8 +3,16 @@
 class ChannelTest extends PHPUnit_Framework_TestCase
 {
 
+    public function testPackageReleaseInfoFinderWithLatest()
+    {
+        $channel = new PEARX\Channel('pecl.php.net');
+        ok($channel);
+
+        $xml = $channel->fetchPackageReleaseXml('apc','latest');
+        ok($xml);
+    }
 
-    public function testPackageFindPear()
+    public function testPackageFindPearWithFileSystemCache()
     {
         $cache = new CacheKit\FileSystemCache(array(
             'expiry' => 10,
@@ -27,7 +35,7 @@ public function testPackageFindPear()
         ok( $package->license );
     }
 
-    public function testPackageFind()
+    public function testPackageFindWithFileSystemCache()
     {
         $cache = new CacheKit\FileSystemCache(array(
             'expiry' => 10,