bicho 0.0.13 → 0.0.14

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 2760edd7531e71e8047f5043ca304271d784185e
-  data.tar.gz: c99dbcd06578f5dbde10fd773cb32652a113877d
+  metadata.gz: 172cfd9dd28c9a8c0dd94951efbe06e25e2cfd2f
+  data.tar.gz: 56d024d2854f96455254aca4ea729d4c40859d58
 SHA512:
-  metadata.gz: 962b69c57522a18ab23ab6245f100f9d3f66ab227c5537232ef5ee1d0b861ee959bd05528ffdb6604075c0057f3dd074a56fe7ef6d9b04dba24d87b7b3a11377
-  data.tar.gz: 5b5b087d28f2fd5a467d4bac125ed41d192f2c0fc40cae050d6f583baa8a2426494117da9a4b9463b9ad7dc11bd5ef959b20dbae253694f6b9ef942fb189a4c3
+  metadata.gz: aa19193f97f8fbc740a7d1182786697000a290a0d6c85651689ef9d875542e2161cc6ce552c4c2b1185b577aebae7715699b191cc546f9c04aa76a53c6703b24
+  data.tar.gz: 0a6015ada50404b051a83b40fda44349d80206f10f0f2e972a06ef8f76bf479290c63c38955a39166287cae2474726bc194f4a1a7b3096c59306d09ea6386f22

data/README.md

@@ -3,7 +3,7 @@
 * http://github.com/dmacvicar/bicho
 
 ![stable](https://img.shields.io/badge/stability-stable-green.svg)
-![maintained](https://img.shields.io/maintenance/yes/2016.svg)
+![maintained](https://img.shields.io/maintenance/yes/2017.svg)
 [![Build Status](https://travis-ci.org/dmacvicar/bicho.svg?branch=master)](https://travis-ci.org/dmacvicar/bicho)
 
 ## Introduction
@@ -110,11 +110,11 @@ default: mysite
 Plugins are classes in the module Bicho::Plugins. They can implement hooks that are
 called at different points of execution.
 
-* default_site_url_hook
+* `default_site_url_hook`
 
   If no site url is provided the last one provided by a plugin will be used.
 
-* transform_site_url_hook
+* `transform_site_url_hook`
 
   This hook is called to modify the main site url (eg: http://bugzilla.suse.com).
   Use it when a plugin wants to provide an alternative url to a well-known bugzilla or
@@ -122,11 +122,15 @@ called at different points of execution.
   Plugin order is not defined so make sure your plugin focuses in one type of shortcut
   as another plugin can also change your returned value in their hooks.
 
-* transform_api_url_hook
+* `transform_api_url_hook`
 
   The API url is derived from the site url, however some bugzilla installations may have
   different servers or endpoints.
 
+* `transform_xmlrpc_client_hook`
+
+  This hook allows to modify the `XMLRPC::Client` object.
+
 ### Commands
 
 See the +Command+ class to implement more commands.

data/bicho.gemspec

@@ -20,7 +20,7 @@ Gem::Specification.new do |s|
   s.add_development_dependency('rake')
   s.add_development_dependency('minitest')
   s.add_development_dependency('minitest-reporters')
-  s.add_development_dependency('rubocop')
+  s.add_development_dependency('rubocop', '= 0.41.2')
 
   s.rubyforge_project = 'bicho'
 

data/lib/bicho.rb

@@ -28,6 +28,8 @@ require 'bicho/version'
 require 'bicho/logging'
 require 'bicho/client'
 require 'bicho/bug'
+require 'bicho/reports'
+require 'bicho/export'
 
 # All classes of the Bicho library belong to this module.
 module Bicho

data/lib/bicho/bug.rb

@@ -58,7 +58,7 @@ module Bicho
 
     def method_missing(method_name, *_args)
       return super unless @data.key?(method_name.to_s)
-      @data[method_name.to_s]
+      self[method_name]
     end
 
     def respond_to_missing?(method_name, _include_private = false)
@@ -76,9 +76,13 @@ module Bicho
     end
 
     def [](name, subname = nil)
-      v = @data[name.to_s]
-      v = v[subname.to_s] if subname # for 'internals' properties
-      v
+      value = @data[name.to_s]
+      value = value[subname.to_s] if subname # for 'internals' properties
+      if value.is_a?(XMLRPC::DateTime)
+        value.to_time
+      else
+        value
+      end
     end
 
     # URL where the bug can be viewed
@@ -97,10 +101,23 @@ module Bicho
       @client.get_attachments(id)
     end
 
+    # Add an attachment to the bug
+    # For the params description, see the Client.add_attachment method.
+    #
+    # @return [ID] of the new attachment
+    def add_attachment(summary, file, **kwargs)
+      @client.add_attachment(summary, file, id, **kwargs).first
+    end
+
     # @param format_string For Kernel#sprintf; named params supplied by the bug
     def format(format_string)
       sym_data = Hash[@data.to_a.map { |k, v| [k.to_sym, v] }]
       Kernel.format(format_string, sym_data)
     end
+
+    # @return [Hash]
+    def to_h
+      Hash[@data.to_a.map { |k, _| [k.to_sym, self[k.to_sym]] }]
+    end
   end
 end

data/lib/bicho/client.rb

@@ -131,6 +131,12 @@ module Bicho
 
       @client = XMLRPC::Client.new_from_uri(@api_url.to_s, nil, 900)
       @client.set_debug
+      @plugins.each do |pl_instance|
+        # Modify API url
+        if pl_instance.respond_to?(:transform_xmlrpc_client_hook)
+          pl_instance.transform_xmlrpc_client_hook(@client, logger)
+        end
+      end
 
       # User.login sets the credentials cookie for subsequent calls
       if @client.user && @client.password
@@ -180,6 +186,27 @@ module Bicho
       ret['version']
     end
 
+    # Create a bug
+    #
+    # @param product - the name of the product the bug is being filed against
+    # @param component - the name of a component in the product above.
+    # @param summary - a brief description of the bug being filed.
+    # @param version - version of the product above; the version the bug was found in.
+    # @param **kwargs - keyword-args containing optional/defaulted params
+    #
+    # Return the new bug ID
+    def create_bug(product, component, summary, version, **kwargs)
+      params = {}
+      params = params.merge(kwargs)
+      params[:product] = product
+      params[:component] = component
+      params[:summary] = summary
+      params[:version] = version
+      ret = @client.call('Bug.create', params)
+      handle_faults(ret)
+      ret['id']
+    end
+
     # Search for a bug
     #
     # +query+ has to be either a +Query+ object or
@@ -319,5 +346,36 @@ module Bicho
         end
       end.flatten
     end
+
+    # Add an attachment to bugs with given ids
+    #
+    # Params:
+    # @param summary - a short string describing the attachment
+    # @param file - [File] object to attach
+    # @param *ids - a list of bug ids to which the attachment will be added
+    # @param **kwargs - optional keyword-args that may contain:
+    #  - content_type - content type of the attachment (if ommited,
+    #  'application/octet-stream' will be used)
+    #  - file_name - name of the file (if ommited, the base name of the
+    #  provided file will be used)
+    #  - patch? - flag saying that the attachment is a patch
+    #  - private? - flag saying that the attachment is private
+    #  - comment
+    #
+    # @return [Array<ID>] a list of the attachment id(s) created.
+    def add_attachment(summary, file, *ids, **kwargs)
+      params = {}
+      params[:ids] = ids
+      params[:summary] = summary
+      params[:content_type] = kwargs.fetch(:content_type, 'application/octet-stream')
+      params[:file_name] = kwargs.fetch(:file_name, File.basename(file))
+      params[:is_patch] = kwargs[:patch?] if kwargs[:patch?]
+      params[:is_private] = kwargs[:private?] if kwargs[:private?]
+      params[:comment] = kwargs[:comment] if kwargs[:comment]
+      params[:data] = XMLRPC::Base64.new(file.read)
+      ret = @client.call('Bug.add_attachment', params)
+      handle_faults(ret)
+      ret['ids']
+    end
   end
 end

data/lib/bicho/export.rb

@@ -0,0 +1,15 @@
+require 'json'
+
+module Bicho
+  # Utility methods for exporting bugs to other systems
+  module Export
+    # Exports full data of a bug to json, including some extended
+    # calculated attributes.
+    def self.to_json(bug)
+      bug_h = bug.to_h
+      bug_h['history'] = bug.history.changesets.map(&:to_h)
+      bug_h['resolution_time'] = Bicho::Reports.resolution_time(bug)
+      JSON.generate(bug_h)
+    end
+  end
+end

data/lib/bicho/history.rb

@@ -52,6 +52,10 @@ module Bicho
       @client = client
       @data = data
     end
+
+    def to_h
+      @data
+    end
   end
 
   # A collection of related changes.
@@ -67,7 +71,7 @@ module Bicho
 
     # return [Date] The date the bug activity/change happened.
     def timestamp
-      @data['when'].to_date
+      @data['when'].to_time
     end
 
     # @return [String] The login name of the user who performed the bug change
@@ -89,12 +93,16 @@ module Bicho
 
     def to_s
       buffer = StringIO.new
-      buffer << "#{date}- #{who}\n"
+      buffer << "#{timestamp}- #{who}\n"
       changes.each do |diff|
         buffer << "#{diff}\n"
       end
       buffer.string
     end
+
+    def to_h
+      { who: who, timestamp: timestamp, changes: changes.map(&:to_h) }
+    end
   end
 
   # A collection of Changesets associated with a bug

data/lib/bicho/plugins/novell.rb

@@ -39,6 +39,8 @@ module Bicho
     class Novell
       OSCRC_CREDENTIALS = 'https://api.opensuse.org'.freeze unless defined? OSCRC_CREDENTIALS
       DEFAULT_OSCRC_PATH = File.join(ENV['HOME'], '.oscrc') unless defined? DEFAULT_OSCRC_PATH
+      DOMAINS = ['bugzilla.novell.com', 'bugzilla.suse.com'].freeze
+      XMLRPC_DOMAINS = ['apibugzilla.novell.com', 'apibugzilla.suse.com'].freeze
 
       class << self
         attr_writer :oscrc_path
@@ -75,25 +77,31 @@ module Bicho
       end
 
       def transform_api_url_hook(url, logger)
-        domains = ['bugzilla.novell.com', 'bugzilla.suse.com']
-        return url unless domains.map { |domain| url.host.include?(domain) }.any?
+        return url unless DOMAINS.map { |domain| url.host.include?(domain) }.any?
 
         begin
-          auth = Novell.oscrc_credentials
-
           url = url.clone
-          url.user = auth[:user]
-          url.password = auth[:password]
           url.host = url.host.gsub(/bugzilla\.novell.com/, 'apibugzilla.novell.com')
           url.host = url.host.gsub(/bugzilla\.suse.com/, 'apibugzilla.suse.com')
           url.scheme = 'https'
 
-          logger.debug("#{self} : Rewrote url to '#{url.to_s.gsub(/#{url.user}:#{url.password}/, 'USER:PASS')}'")
+          logger.debug("#{self} : Rewrote url to '#{url}'")
         rescue StandardError => e
           logger.warn e
         end
         url
       end
+
+      def transform_xmlrpc_client_hook(client, logger)
+        return unless XMLRPC_DOMAINS.map { |domain| client.http.address.include?(domain) }.any?
+
+        auth = Novell.oscrc_credentials
+        client.user = auth[:user]
+        client.password = auth[:password]
+        logger.debug("#{self} : updated XMLRPC client with oscrc auth information")
+      rescue StandardError => e
+        logger.error e
+      end
     end
   end
 end

data/lib/bicho/query.rb

@@ -76,9 +76,9 @@ module Bicho
       Bicho::SEARCH_FIELDS.map(&:first).include?(method_name) || super
     end
 
-    # Shortcut equivalent to status new, assigned, needinfo and reopened
+    # Shortcut equivalent to status new, assigned, needinfo, reopened, confirmed, and in_progress
     def open
-      status(:new).status(:assigned).status(:needinfo).status(:reopened)
+      status(:new).status(:assigned).status(:needinfo).status(:reopened).status(:confirmed).status(:in_progress)
     end
 
     # Shortcut, equivalent to

data/lib/bicho/reports.rb

@@ -0,0 +1,39 @@
+module Bicho
+  # Utility methods for reporting on bugs
+  module Reports
+    # When was the bug finally set to a resolved state
+    #
+    # Resolution time is nil if the bug is not resolved yet.
+    def self.resolution_time(bug)
+      t = nil
+      bug.history.sort_by(&:timestamp).each do |cs|
+        cs.changes.each do |c|
+          t = cs.timestamp if c.field_name == 'status' &&
+                              c.added == 'RESOLVED'
+        end
+      end
+      t
+    end
+
+    # returns the ranges a bug is with statuses
+    def self.ranges_with_statuses(bug, *statuses)
+      ranges = []
+      current_start = bug.creation_time
+      current_status = nil
+      bug.history.sort_by(&:timestamp).each do |cs|
+        cs.changes.each do |c|
+          next unless c.field_name == 'status'
+
+          current_status = c.removed if current_status.nil?
+          ranges.push(current_start..cs.timestamp) if statuses.include?(c.removed)
+
+          current_start = cs.timestamp
+          current_status = c.added
+        end
+      end
+      # last status is still valid
+      ranges.push(current_start..Time.now) if statuses.include?(current_status)
+      ranges
+    end
+  end
+end

data/lib/bicho/version.rb

@@ -1,3 +1,3 @@
 module Bicho
-  VERSION = '0.0.13'.freeze
+  VERSION = '0.0.14'.freeze
 end

data/test/test_export.rb

@@ -0,0 +1,155 @@
+require_relative 'helper'
+
+BUG_ES_EXPORT = <<-EOF.freeze
+{
+  "priority": "Normal",
+  "blocks": [
+
+  ],
+  "creator": "kekun.plazas@laposte.net",
+  "last_change_time": "2017-02-22 20:48:43 UTC",
+  "is_cc_accessible": true,
+  "keywords": [
+
+  ],
+  "cc": [
+    "kekun.plazas@laposte.net",
+    "mcatanzaro@gnome.org"
+  ],
+  "url": "",
+  "assigned_to": "gnome-games-maint@gnome.bugs",
+  "see_also": [
+
+  ],
+  "groups": [
+
+  ],
+  "id": 777777,
+  "creation_time": "2017-01-26 08:46:00 UTC",
+  "whiteboard": "",
+  "qa_contact": "gnome-games-maint@gnome.bugs",
+  "depends_on": [
+
+  ],
+  "resolution": "FIXED",
+  "classification": "Core",
+  "op_sys": "Linux",
+  "status": "RESOLVED",
+  "cf_gnome_target": "---",
+  "cf_gnome_version": "---",
+  "summary": "Game Boy games not detected",
+  "is_open": false,
+  "platform": "Other",
+  "severity": "normal",
+  "flags": [
+
+  ],
+  "version": "unspecified",
+  "component": "general",
+  "is_creator_accessible": true,
+  "product": "gnome-games",
+  "is_confirmed": true,
+  "target_milestone": "---",
+  "history": [
+    {
+      "who": "kekun.plazas@laposte.net",
+      "timestamp": "2017-01-26 09:03:10 UTC",
+      "changes": [
+        {
+          "removed": "",
+          "added": "kekun.plazas@laposte.net",
+          "field_name": "cc"
+        }
+      ]
+    },
+    {
+      "who": "kekun.plazas@laposte.net",
+      "timestamp": "2017-01-26 09:05:34 UTC",
+      "changes": [
+        {
+          "attachment_id": 344292,
+          "removed": "0",
+          "added": "1",
+          "field_name": "attachments.isobsolete"
+        }
+      ]
+    },
+    {
+      "who": "kekun.plazas@laposte.net",
+      "timestamp": "2017-01-26 09:06:09 UTC",
+      "changes": [
+        {
+          "removed": "NEW",
+          "added": "RESOLVED",
+          "field_name": "status"
+        },
+        {
+          "removed": "",
+          "added": "FIXED",
+          "field_name": "resolution"
+        }
+      ]
+    },
+    {
+      "who": "kekun.plazas@laposte.net",
+      "timestamp": "2017-01-26 09:06:13 UTC",
+      "changes": [
+        {
+          "attachment_id": 344293,
+          "removed": "none",
+          "added": "committed",
+          "field_name": "attachments.gnome_attachment_status"
+        }
+      ]
+    },
+    {
+      "who": "kekun.plazas@laposte.net",
+      "timestamp": "2017-01-26 09:06:16 UTC",
+      "changes": [
+        {
+          "attachment_id": 344294,
+          "removed": "none",
+          "added": "committed",
+          "field_name": "attachments.gnome_attachment_status"
+        }
+      ]
+    },
+    {
+      "who": "kekun.plazas@laposte.net",
+      "timestamp": "2017-01-26 11:06:35 UTC",
+      "changes": [
+        {
+          "attachment_id": 344303,
+          "removed": "none",
+          "added": "committed",
+          "field_name": "attachments.gnome_attachment_status"
+        }
+      ]
+    },
+    {
+      "who": "mcatanzaro@gnome.org",
+      "timestamp": "2017-02-22 20:40:19 UTC",
+      "changes": [
+        {
+          "removed": "",
+          "added": "mcatanzaro@gnome.org",
+          "field_name": "cc"
+        }
+      ]
+    }
+  ],
+  "resolution_time": "2017-01-26 09:06:09 UTC"
+}
+EOF
+
+# Test small utilities
+class ExportTest < Minitest::Test
+  def test_to_json
+    Bicho.client = Bicho::Client.new('https://bugzilla.gnome.org')
+    bug = Bicho.client.get_bug(777777)
+    assert_equal(
+      JSON.dump(JSON.load(BUG_ES_EXPORT)),
+      Bicho::Export.to_json(bug)
+    )
+  end
+end

data/test/test_novell_plugin.rb

@@ -5,22 +5,42 @@ require 'logger'
 # Test for the plugin supporting the Novell/SUSE bugzilla authentication
 class NovellPluginTest < Minitest::Test
   def test_url_replacement
-    r, w = IO.pipe
-    log = Logger.new(w)
+    creds = { user: 'test', password: 'test' }
     %w(novell suse).each do |domain|
-      creds = { user: 'test', password: 'test' }
+      r, w = IO.pipe
+      log = Logger.new(w)
       Bicho::Plugins::Novell.stub :oscrc_credentials, creds do
         plugin = Bicho::Plugins::Novell.new
         url = URI.parse("http://bugzilla.#{domain}.com")
         site_url = plugin.transform_site_url_hook(url, log)
         api_url = plugin.transform_api_url_hook(url, log)
         assert_equal(site_url.to_s, "http://bugzilla.#{domain}.com")
-        assert_equal(api_url.to_s, "https://test:test@apibugzilla.#{domain}.com")
+        assert_equal(api_url.to_s, "https://apibugzilla.#{domain}.com")
         assert_match(/Rewrote url/, r.gets)
       end
     end
   end
 
+  def test_xmlrpcclient_replacement
+    creds = { user: 'test', password: 'test' }
+    %w(novell suse).each do |domain|
+      Bicho::Plugins::Novell.stub :oscrc_credentials, creds do
+        r, w = IO.pipe
+        log = Logger.new(w)
+
+        plugin = Bicho::Plugins::Novell.new
+        url = URI.parse("http://bugzilla.#{domain}.com")
+        api_url = plugin.transform_api_url_hook(url, log)
+        client = XMLRPC::Client.new_from_uri(api_url.to_s, nil, 900)
+        plugin.transform_xmlrpc_client_hook(client, log)
+        w.close
+        assert_equal('test', client.user, 'xmlrpc client username should be set')
+        assert_equal('test', client.password, 'xmlrpc client password should be set')
+        assert_match(/updated XMLRPC client with oscrc auth information/, r.read)
+      end
+    end
+  end
+
   def test_oscrc_parsing
     oscrc = <<EOS
 [https://api.opensuse.org]

data/test/test_query.rb

@@ -2,6 +2,10 @@ require_relative 'helper'
 
 # Test query DSL
 class QueryTest < Minitest::Test
+  def setup
+    Bicho.client = nil
+  end
+
   def test_active_record_style
     # No client set yet
     assert_raises RuntimeError do
@@ -23,7 +27,7 @@ class QueryTest < Minitest::Test
 
   def test_query_shortcuts
     ret = Bicho::Query.new.open
-    assert_equal({ 'status' => [:new, :assigned, :needinfo, :reopened] }, ret.query_map)
+    assert_equal({ 'status' => [:new, :assigned, :needinfo, :reopened, :confirmed, :in_progress] }, ret.query_map)
   end
 
   def teardown

data/test/test_reports.rb

@@ -0,0 +1,25 @@
+require_relative 'helper'
+
+# Test reports on bugs
+class ReportsTest < Minitest::Test
+  def test_resolution_date
+    Bicho.client = Bicho::Client.new('https://bugzilla.gnome.org')
+    bug = Bicho.client.get_bug(777777)
+    ts = Bicho::Reports.resolution_time(bug)
+    assert_equal(Time.parse('2017-01-26 09:06:09 UTC'), ts)
+  end
+
+  def test_ranges_with_statuses
+    Bicho.client = Bicho::Client.new('https://bugzilla.gnome.org')
+    bug = Bicho.client.get_bug(312619)
+    ranges = Bicho::Reports.ranges_with_statuses(bug, 'NEEDINFO')
+    assert_equal(
+      [Time.parse('2005-12-31 21:56:36 UTC')..Time.parse('2006-04-11 19:22:41 UTC')], ranges
+    )
+
+    ranges = Bicho::Reports.ranges_with_statuses(bug, 'NEEDINFO', 'RESOLVED')
+    assert_equal(Time.parse('2005-12-31 21:56:36 UTC')..Time.parse('2006-04-11 19:22:41 UTC'), ranges[0])
+    assert_equal(Time.parse('2006-04-11 19:22:41 UTC'), ranges[1].begin)
+    assert(Time.now - ranges[1].end < 60)
+  end
+end

data/test/test_version.rb

@@ -11,7 +11,7 @@ class VersionTest < Minitest::Test
   end
 
   def test_version_suse
-    Bicho.client = Bicho::Client.new('https://bugzilla.suse.com')
+    Bicho.client = Bicho::Client.new('https://bugzilla.opensuse.org')
 
     ret = Bicho.client.version
     # https://bugzilla.suse.com is at 4.4.6 as of Jan/2015

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bicho
 version: !ruby/object:Gem::Version
-  version: 0.0.13
+  version: 0.0.14
 platform: ruby
 authors:
 - Duncan Mac-Vicar P.
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-09-03 00:00:00.000000000 Z
+date: 2017-10-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: inifile
@@ -112,16 +112,16 @@ dependencies:
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - '='
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.41.2
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - '='
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.41.2
 description: Library to access bugzilla
 email:
 - dmacvicar@suse.de
@@ -150,6 +150,7 @@ files:
 - lib/bicho/cli/commands/version.rb
 - lib/bicho/client.rb
 - lib/bicho/common_client.rb
+- lib/bicho/export.rb
 - lib/bicho/ext/logger_colors.rb
 - lib/bicho/history.rb
 - lib/bicho/logging.rb
@@ -157,12 +158,15 @@ files:
 - lib/bicho/plugins/novell.rb
 - lib/bicho/plugins/user.rb
 - lib/bicho/query.rb
+- lib/bicho/reports.rb
 - lib/bicho/version.rb
 - test/helper.rb
 - test/test_attachments.rb
+- test/test_export.rb
 - test/test_history.rb
 - test/test_novell_plugin.rb
 - test/test_query.rb
+- test/test_reports.rb
 - test/test_user_plugin.rb
 - test/test_version.rb
 homepage: http://github.com/dmacvicar/bicho
@@ -185,16 +189,17 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: bicho
-rubygems_version: 2.4.5
+rubygems_version: 2.6.11
 signing_key: 
 specification_version: 4
 summary: Library to access bugzilla
 test_files:
 - test/helper.rb
 - test/test_attachments.rb
+- test/test_export.rb
 - test/test_history.rb
 - test/test_novell_plugin.rb
 - test/test_query.rb
+- test/test_reports.rb
 - test/test_user_plugin.rb
 - test/test_version.rb
-has_rdoc: