Changes between Version 8 and Version 9 of HudsonTracPlugin

Timestamp:

Oct 13, 2009, 4:27:09 AM (15 years ago)

Author:

roadrunner

Comment:

Updated for 0.3

HudsonTracPlugin

@@ -8 +8 @@
 This plugin works very similar to the LuntbuildTracIntegration plugin and the
 [http://dev.rectang.com/projects/continutrac Trac Continuum] plugin. The build
-results are obtained from one of the RSS feeds Hudson provides.
-
-== Dependencies ==
-
-This plugin requires that the [http://www.feedparser.org/ python-feedparser]
-library is installed on your system.
+results are obtained from the Hudson remote API.
 
 == Configuration ==
@@ -20 +15 @@
 `[hudson]` (if you have the IniAdminPlugin installed they will show up
 under `hudson`):
- feed_url::
-   The url of the hudson rss feed containing the build statuses.
-   Example: `http://localhost/hudson/rssAll`
+ job_url::
+   The url of the top-level hudson page if you want to display all
+   jobs in the timeline, or a job or module url if you want only
+   display builds from a single job or module.
+   Examples: `http://localhost/hudson/` (for builds from all jobs),
+   `http://localhost/hudson/job/build_foo/` (for builds from the
+   `build_foo` job only).
  username::
-   The username to use when accessing hudson (both the feed itself
-   as well as the job descriptions); leave empty if no authentication
-   is needed.
+   The username to use when accessing hudson; leave empty if no
+   authentication is needed.
  password::
    The password to use when accessing hudson; leave empty if no
    authentication is needed.
- display_subprojects::
-   If set to `true` then display subprojects in the timeline too;
-   otherwise only top-level projects are displayed.
+ display_modules::
+   If set to `true` then display the builds of individual modules in
+   the timeline too; otherwise only builds of jobs are displayed.
  main_page::
    The url of the hudson page to link to from the trac mainnav; if
@@ -47 +45 @@
    the canned "Build finished successfully" etc messages.
 
+Furthermore, make sure you assign users the `BUILD_VIEW` permission in
+order for them to be able to see the builds in the timeline.
+
 
 == Bugs/Feature Requests == 
@@ -59 +60 @@
 Download the [download:hudsontracplugin zipped source], check out [/svn/hudsontracplugin using Subversion], or [source:hudsontracplugin browse the source] with Trac.
 
+== Upgrade Notes ==
+
+If you are upgrading from version 0.2 of this plugin (pre r6683) then
+you will need to make the following changes:
+ * the `feed_url` option has been replaced by the `job_url` option;
+   the latter points to the top-level hudson page or to a job page,
+   not an RSS feed anymore.
+ * the `display_subprojects` has been renamed `display_modules`
+ * you must assign users the `BUILD_VIEW` permission in order for them
+   to see the builds
+ * The [http://www.feedparser.org/ python-feedparser] library is no
+   longer required.
+
 == Recent Changes ==