From 7211ccab2860800e10f6949caeec04d23dd24fa4 Mon Sep 17 00:00:00 2001
From: aheritier <aheritier@13f79535-47bb-0310-9956-ffa450edef68>
Date: Tue, 30 May 2006 22:58:28 +0000
Subject: [PATCH] New RSS feed for releases.

git-svn-id: https://svn.apache.org/repos/asf/maven/maven-1/plugins/trunk@410401 13f79535-47bb-0310-9956-ffa450edef68
---
 multichanges/plugin.jelly                     |  34 ++++++++++-
 multichanges/project.xml                      |  11 +++-
 .../multichanges/util/RssDateFormatter.java   |  56 ++++++++++++++++++
 .../src/plugin-resources/images/rss.png       | Bin 0 -> 360 bytes
 .../src/plugin-resources/releases.jsl         |   6 +-
 .../src/plugin-resources/releases2rss.jsl     |  48 +++++++++++++++
 multichanges/xdocs/changes.xml                |   1 +
 7 files changed, 153 insertions(+), 3 deletions(-)
 create mode 100644 multichanges/src/main/org/apache/maven/plugin/multichanges/util/RssDateFormatter.java
 create mode 100644 multichanges/src/plugin-resources/images/rss.png
 create mode 100644 multichanges/src/plugin-resources/releases2rss.jsl

diff --git a/multichanges/plugin.jelly b/multichanges/plugin.jelly
index 9a6507ec..c509ca1f 100644
--- a/multichanges/plugin.jelly
+++ b/multichanges/plugin.jelly
@@ -61,7 +61,9 @@
        the latest release of projects.
      ========================================================================
   -->
-  <goal name="multichanges:report" prereqs="multichanges:init">
+  <goal name="multichanges:report" prereqs="multichanges:generates-releases-report,multichanges:generates-releases-rss"/>
+
+  <goal name="multichanges:generates-releases-file" prereqs="multichanges:init">
 
     <!-- Gather project list using the maven reactor -->
     <m:reactor
@@ -136,6 +138,10 @@
       </releases>
     </j:file>
 
+  </goal>
+
+  <goal name="multichanges:generates-releases-report" prereqs="multichanges:generates-releases-file">
+
     <ant:dirname property="reportDir" file="${maven.multichanges.report}"/>
     <ant:mkdir dir="${reportDir}"/>
 
@@ -145,7 +151,33 @@
         stylesheet="${plugin.resources}/releases.jsl"
         outputMode="xml"
         prettyPrint="true"/>
+        
+  </goal>
 
+  <goal name="multichanges:generates-releases-rss" prereqs="multichanges:generates-releases-file">
+
+    <tstamp>
+      <format property="currentDate" pattern="EEE, dd MMM yyyy HH:mm:ss Z"/>
+    </tstamp>
+    <tstamp>
+      <format property="currentYear" pattern="yyyy"/>
+    </tstamp>
+    
+    <!-- Generate a RSS feed of the changes -->
+    <doc:jsl
+      input="${maven.multichanges.data}"
+      output="releases.rss"
+      stylesheet="${plugin.resources}/releases2rss.jsl"
+      encoding="${maven.docs.outputencoding}"
+      outputMode="xml"
+      prettyPrint="false"/>
+
+    <!-- Copy the images -->
+    <mkdir dir="${maven.docs.dest}/images"/>
+    <copy todir="${maven.docs.dest}/images">
+      <fileset dir="${plugin.resources}/images"/>
+    </copy>
+        
   </goal>
 
   <!--
diff --git a/multichanges/project.xml b/multichanges/project.xml
index a610cf60..445dcd4b 100644
--- a/multichanges/project.xml
+++ b/multichanges/project.xml
@@ -64,5 +64,14 @@
       <timezone>+1</timezone>
     </developer>
   </developers>
-  <dependencies/>
+  <dependencies>
+    <dependency>
+      <groupId>commons-logging</groupId>
+      <artifactId>commons-logging</artifactId>
+      <version>1.0.4</version>
+      <properties>
+        <comment>This library is already loaded by maven's core. Be careful to use the same version number as in the core.</comment>
+      </properties>
+    </dependency>
+  </dependencies>
 </project>
diff --git a/multichanges/src/main/org/apache/maven/plugin/multichanges/util/RssDateFormatter.java b/multichanges/src/main/org/apache/maven/plugin/multichanges/util/RssDateFormatter.java
new file mode 100644
index 00000000..c222da1f
--- /dev/null
+++ b/multichanges/src/main/org/apache/maven/plugin/multichanges/util/RssDateFormatter.java
@@ -0,0 +1,56 @@
+package org.apache.maven.plugin.multichanges.util;
+
+import java.text.ParseException;
+import java.text.SimpleDateFormat;
+
+import org.apache.commons.logging.Log;
+import org.apache.commons.logging.LogFactory;
+
+/**
+ * This class provides a method to convert a date in the changes plugin format
+ * (yyyy-MM-dd) to a date in RSS format (RFC 822).
+ * 
+ */
+public class RssDateFormatter {
+	/**
+	 * The date format used in changes report file (changes.xml used in
+	 * maven-changes-plugin).
+	 */
+	private final static SimpleDateFormat changesSDF = new SimpleDateFormat(
+			"yyyy-MM-dd");
+
+	/**
+	 * The date format defined in RFC 822 and used in RSS feeds.
+	 */
+	private final static SimpleDateFormat rfc822DF = new SimpleDateFormat(
+			"EEE, dd MMM yyyy HH:mm:ss Z");
+
+	/**
+	 * Log for debug output
+	 */
+	private static Log log = LogFactory.getLog(RssDateFormatter.class);
+
+	/**
+	 * Converts a date in the changes plugin format (yyyy-MM-dd) to a date in
+	 * RSS format (RFC 822).
+	 * 
+	 * @param changesDate
+	 *            the date to convert
+	 * @return the date in the RFC 822 format. An empty String if an exception
+	 *         occurs.
+	 */
+	public static final String convertDate(final String changesDate) {
+		try {
+			return rfc822DF.format(changesSDF.parse(changesDate));
+		} catch (ParseException e) {
+			if (log.isDebugEnabled())
+				log
+						.error("Unable to convert the date [" + changesDate
+								+ "]", e);
+			else
+				log.error("Unable to convert the date [" + changesDate + "] : "
+						+ e.getMessage());
+			return "";
+		}
+	}
+}
diff --git a/multichanges/src/plugin-resources/images/rss.png b/multichanges/src/plugin-resources/images/rss.png
new file mode 100644
index 0000000000000000000000000000000000000000..f0796ac886201eb43b7a15113e2deb1b32fa9a09
GIT binary patch
literal 360
zcmV-u0hj)XP)<h;3K|Lk000e1NJLTq0012T000jN0{{R3FH<zF0002JP)t-s|NsA5
zgt8Pzisb9`*5T}pjg2Q(lu=PpGh&>1pTfh($;sL0vc}u{{{FPIw4<Y<^7i`p`uw@g
z;qv(YgQCcxxzk@?Uh?wt-QC?gXrM}SsCJmYV~Muv>gub**+Xunj;hMg-Rk@N{o&!^
z{r&#_{{B{et%#+@{r~@)vdh1}zle=^0GR*(m;g35HkdZcHkixX<?qkX&=Nj{v97I-
zu+NmP%;@m;`uh5wy4BRw)YsV9X^^`AW&mbpW_Z=8>Hq)$8FWQhbW?9;ba!ELWdKKV
zVQ^?^V?%Flc4cyOWpXuLNbUdt06|GaK~#90Vz9#p80;8u1CXpOE<hDo1_(x?Q1miD
zWEemQQ`VLNrUs8*>?Whx%fLW2AK{k88_xIu00030{{sMfLr(Xb|5zme0000<MNUMn
GLSTXjIl1Tn

literal 0
HcmV?d00001

diff --git a/multichanges/src/plugin-resources/releases.jsl b/multichanges/src/plugin-resources/releases.jsl
index f0e49734..d176b97b 100644
--- a/multichanges/src/plugin-resources/releases.jsl
+++ b/multichanges/src/plugin-resources/releases.jsl
@@ -2,7 +2,7 @@
 <!--
  * ========================================================================
  * 
- * Copyright 2004 The Apache Software Foundation.
+ * Copyright 2004-2006 The Apache Software Foundation.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -24,8 +24,12 @@
       <properties>
         <title>Latest releases</title>
       </properties>
+      <head>
+        <link rel="alternative" href="releases.rss" type="application/rss+xml" />
+      </head>
       <body>
         <section name="Latest releases">
+          <p>Get the RSS feed of the last releases <a href="releases.rss"><img src="images/rss.png"/></a></p>
           <table>
             <tr>
               <th>Project name</th>
diff --git a/multichanges/src/plugin-resources/releases2rss.jsl b/multichanges/src/plugin-resources/releases2rss.jsl
new file mode 100644
index 00000000..00e5ec84
--- /dev/null
+++ b/multichanges/src/plugin-resources/releases2rss.jsl
@@ -0,0 +1,48 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ * ========================================================================
+ * 
+ * Copyright 2006 The Apache Software Foundation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ * 
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ * 
+ * ========================================================================
+-->
+<jsl:stylesheet select="$doc" xmlns:jsl="jelly:jsl" xmlns:x="jelly:xml" xmlns:j="jelly:core" xmlns="dummy" trim="false">
+  <!-- This needs to be instantiated here to be available in the template matches -->
+  <j:useBean var="rssDateFormatter" class="org.apache.maven.plugin.multichanges.util.RssDateFormatter"/>
+  <jsl:template match="releases">
+    <rss version="2.0">
+      <channel>
+        <title>${pom.name} releases</title>
+        <link>${pom.url}</link>
+        <description>${pom.name} releases</description>
+        <lastBuildDate>${currentDate}</lastBuildDate>
+        <language>en-us</language>
+        <copyright>Copyright ${currentYear} ${pom.organization.name}</copyright>
+        <x:set var="projects" sort="@date" descending="true" select="project[not(@date = 'Not released') and not(@date = 'No information available')]"/>
+        <j:forEach var="project" items="${projects}">
+          <j:set var="baseUrl"><x:expr select="$project/@url"/></j:set>
+          <j:set var="version"><x:expr select="$project/@version"/></j:set>
+          <j:set var="date"><x:expr select="$project/@date"/></j:set>
+        <item>
+          <title><x:expr select="$project/@name"/> <x:expr select="$project/@version"/> released.</title>
+          <link>${baseUrl}/announcements/announcement-${version}.txt</link>
+          <guid>${baseUrl}/announcements/announcement-${version}.txt</guid>
+    			<pubDate>${rssDateFormatter.convertDate(date)}</pubDate>
+        </item>
+        </j:forEach>
+      </channel>
+    </rss>
+  </jsl:template>
+</jsl:stylesheet>
\ No newline at end of file
diff --git a/multichanges/xdocs/changes.xml b/multichanges/xdocs/changes.xml
index 6c3cfd62..deaf6e6b 100644
--- a/multichanges/xdocs/changes.xml
+++ b/multichanges/xdocs/changes.xml
@@ -24,6 +24,7 @@
   </properties>
   <body>
     <release version="1.3-SNAPSHOT" date="In SVN">
+      <action dev="aheritier" type="add">New RSS feed for releases.</action>
       <action dev="aheritier" type="update">Remove usage of the deprecated dependency-handle tag.</action>
     </release>
     <release version="1.2" date="2006-01-07">