plugin: add accessor for release date time string in plugin description

API: gst_plugin_get_release_date_string()

diff --git a/docs/gst/gstreamer-sections.txt b/docs/gst/gstreamer-sections.txt
index 1904a6bb7c21a6b30de5c1a01e99ba0ff47b1384..152dcc9de5db94e77ac4cbedfa4cd38ab7587014 100644 (file)
--- a/docs/gst/gstreamer-sections.txt
+++ b/docs/gst/gstreamer-sections.txt
@@ -1994,6 +1994,7 @@ gst_plugin_get_package
 gst_plugin_get_origin
 gst_plugin_get_source
 gst_plugin_get_version
+gst_plugin_get_release_date_string
 gst_plugin_get_module
 gst_plugin_is_loaded
 gst_plugin_get_cache_data

diff --git a/gst/gstplugin.c b/gst/gstplugin.c
index 413ffd75c3bcc5afe59b2ed75b25f991940d79ff..625022ba27864835a65603fcd8f20e6afc0110b8 100644 (file)
--- a/gst/gstplugin.c
+++ b/gst/gstplugin.c
@@ -992,6 +992,29 @@ gst_plugin_get_origin (GstPlugin * plugin)
   return plugin->desc.origin;
 }
 
+/**
+ * gst_plugin_get_release_date_string:
+ * @plugin: plugin to get the release date of
+ *
+ * Get the release date (and possibly time) in form of a string, if available.
+ *
+ * For normal GStreamer plugin releases this will usually just be a date in
+ * the form of "YYYY-MM-DD", while pre-releases and builds from git may contain
+ * a time component after the date as well, in which case the string will be
+ * formatted like "YYYY-MM-DDTHH:MMZ" (e.g. "2012-04-30T09:30Z").
+ *
+ * There may be plugins that do not have a valid release date set on them.
+ *
+ * Returns: the date string of the plugin, or %NULL if not available.
+ */
+const gchar *
+gst_plugin_get_release_date_string (GstPlugin * plugin)
+{
+  g_return_val_if_fail (plugin != NULL, NULL);
+
+  return plugin->desc.release_datetime;
+}
+
 /**
  * gst_plugin_get_module:
  * @plugin: plugin to query

diff --git a/gst/gstplugin.h b/gst/gstplugin.h
index f1be63bd6f85b2ab3076aa4e2857fc16e107a001..f4aa55e7f87aef08b9953691f77474c4029c0f51 100644 (file)
--- a/gst/gstplugin.h
+++ b/gst/gstplugin.h
@@ -329,6 +329,7 @@ const gchar*                gst_plugin_get_license          (GstPlugin *plugin);
 const gchar*           gst_plugin_get_source           (GstPlugin *plugin);
 const gchar*           gst_plugin_get_package          (GstPlugin *plugin);
 const gchar*           gst_plugin_get_origin           (GstPlugin *plugin);
+const gchar*           gst_plugin_get_release_date_string (GstPlugin *plugin);
 const GstStructure*    gst_plugin_get_cache_data       (GstPlugin * plugin);
 void                   gst_plugin_set_cache_data       (GstPlugin * plugin, GstStructure *cache_data);
 

diff --git a/win32/common/libgstreamer.def b/win32/common/libgstreamer.def
index bfddc3726704e6b494738b4cf16f66279d7069b2..5a6c4198d1663f7923a90c002ee5ffd29d73ec18 100644 (file)
--- a/win32/common/libgstreamer.def
+++ b/win32/common/libgstreamer.def
@@ -765,6 +765,7 @@ EXPORTS
        gst_plugin_get_name
        gst_plugin_get_origin
        gst_plugin_get_package
+       gst_plugin_get_release_date_string
        gst_plugin_get_source
        gst_plugin_get_type
        gst_plugin_get_version