jirarest2 0.0.12 → 0.0.13

data/History.txt

@@ -1,3 +1,21 @@
+=== 0.0.13 / 2012-09-18
+
+* 1 major enhancement:
+
+  * Field types are now somewhat mirrored from the server - This should enable working with different fieldtypes without the "expected an object" error. Hopefu
+
+* 2 minor enhancements:
+
+  * Added feature to see if we are really authenticated. Had to change credentials around a bit for that.
+  * Added fieldtypes for the known fields with support for allowed values
+
+* 4 unknowns:
+
+  * Added reading of values for fields from the json results
+  * Fixed a bug with authentication but found a new bug that is not fixed yet ( #25 )
+  * Some minor work on tests and warnings
+  * Some work on documentation
+
 === 0.0.12 / 2012-08-07
 
 * 1 major enhancement:

data/Manifest.txt

@@ -14,7 +14,9 @@ lib/jirarest2/connect.rb
 lib/jirarest2/cookie_credentials.rb
 lib/jirarest2/credentials.rb
 lib/jirarest2/exceptions.rb
+lib/jirarest2/field.rb
 lib/jirarest2/issue.rb
+lib/jirarest2/issuetype.rb
 lib/jirarest2/madbitconfig.rb
 lib/jirarest2/newissue.rb
 lib/jirarest2/password_credentials.rb
@@ -26,6 +28,7 @@ lib/jirarest2/services/issuelinktype.rb
 lib/jirarest2/services/watcher.rb
 lib/jirarest2bin.rb
 test/data/cookiejar
+test/data/createmeta
 test/data/get-comments.txt
 test/data/issuespec.txt
 test/data/test.config.data
@@ -37,9 +40,12 @@ test/test_comment.rb
 test/test_connect.rb
 test/test_cookie_credentials.rb
 test/test_credentials.rb
+test/test_fieldcreatemeta.rb
+test/test_fields.rb
 test/test_issue.rb
 test/test_issuelink.rb
 test/test_issuelinktype.rb
+test/test_issuetype.rb
 test/test_madbitconfig.rb
 test/test_newissue.rb
 test/test_password_credentials.rb

data/bin/jira_create_issue

@@ -130,7 +130,7 @@ end # class ParseOptions
 
 
 def no_issue(type,issue)
-  puts "The #{type}type you entered (\"#{issue}\")  does no exist."
+  puts "The #{type}type you entered (\"#{issue}\")  does not exist."
     puts "Maybe you entered the wrong type or made a typo? (Case is relevant!)"
     exit 1
 end
@@ -148,9 +148,9 @@ def open_issue
     end
     @connection,issue =  Jirarest2Bin::command(@scriptopts,@connection,:issue,@issueopts.project,@issueopts.issue)
   rescue Jirarest2::WrongProjectException => e
-    no_issue("project",e)
+    no_issue("project",@issueopts.project)
   rescue Jirarest2::WrongIssuetypeException => e
-    no_issue("project",e)
+    no_issue("issue",@issueopts.issue)
   end
   return issue
 end
@@ -172,6 +172,7 @@ def show_scheme
 end
 
 # Split the content from the command line parameter "-c"
+# TODO coupling is way to strong here. Fucks up.
 def split_content(issue)
   fields = Hash.new
   @issueopts.content.each { |value|
@@ -224,8 +225,7 @@ def prepare_new_ticket
   rescue Jirarest2::WrongFieldnameException => e
     no_issue("field",e)
   rescue Jirarest2::ValueNotAllowedException => e
-    puts "Value #{e} not allowed for field #{e.fieldname}."
-    puts "Please use one of: \"" + e.allowed.join("\", \"") + "\""
+    puts "Problem with #{e.fieldname}: Value #{e}"
     valueNotAllowedRaised = true
   end
 

data/lib/jirarest2.rb

@@ -17,7 +17,9 @@
 #    along with this program.  If not, see <http://www.gnu.org/licenses/>.
 #
 
-VERSION = "0.0.12"
+# Version Parameter all CAPS
+VERSION = "0.0.13"
+# Version Parameter 
 Version = VERSION
 
 require_relative "jirarest2/connect"

data/lib/jirarest2/connect.rb

@@ -40,6 +40,14 @@ class Connect
   # @param [String, "Get", "Post", "Delete", "Put"] operation HTTP method:  GET, POST, DELETE, PUT
   # @param [String] uritail The last part of the REST URI
   # @param [Hash] data Data to be sent.
+  # @raise [Jirarest2::BadRequestError] Raised if the servers returns statuscode 400 (bad request)
+  # @raise [Jirarest2::PasswordAuthenticationError] Raised if authentication failed (status code 401) and the credentials were username/password based
+  # @raise [Jirarest2::CookieAuthenticationError] Raised if authentication failed (status code 401) and the credentials were cookie based
+  # @raise [Jirarest2::AuthenticationError] Raised if authentication failed (status code 401) and the credentials were neither cookie or username/password based
+  # @raise [Jirarest2::AuthentificationCaptchaError] Raised if the server sends a forbidden status (status code 403) and an login url which means the user needs to answer a captcha
+  # @raise [Jirarest2::ForbiddenError] Raised if the server sends a forbidden status (status code 403) and no login url
+  # @raise [Jirarest2::NotFoundError] Raised if the server returns statuscode 404 (Not found)
+  # @raise [Jirarest2::MethodNotAllowedError] Raised if the server returns statuscode 405 (Method not allowed)
   # @return [Jirarest2::Result]
   def execute(operation,uritail,data)
     uri = nil
@@ -112,7 +120,7 @@ class Connect
   # @return [Boolean] 
   def check_uri
     begin
-      ret = (execute("Get","dashboard","").code == "200")
+      return execute("Get","dashboard","").code == "200"
       # TODO is the 404 really possible?
     rescue Jirarest2::NotFoundError 
       return false
@@ -141,7 +149,8 @@ class Connect
 
 
   # try to fix the connecturl of this instance 
-  # @return [String,Jirarest2::CouldNotHealURIError] Fixed URL or Exception
+  # @raise [Jirarest2::CouldNotHealURIError] Raised if the url can not be healed automatically
+  # @return [String] Fixed URL 
  def heal_uri!
    if ! check_uri then
      @credentials.connecturl = heal_uri(@credentials.connecturl)
@@ -157,7 +166,7 @@ class Connect
  # @return [Boolean] true if the authentication seems to be valid (actually it checks if there is a session)
  def verify_auth
    ret =   execute("Get","auth/latest/session","") 
-   store_cookiejar if @credentials.instance_of?(CookieCredentials) && @credentials.autosave
+   @credentials.store_cookiejar if @credentials.instance_of?(CookieCredentials) && @credentials.autosave
    return ret.code == "200" 
  end
 

data/lib/jirarest2/cookie_credentials.rb

@@ -25,9 +25,12 @@ require "pstore"
 class CookieCredentials < Credentials
 
   # Location of the file the cookie is persited on a harddrive. Default is "~/.jirarest2.cookie
+  # @return [String] Location of the cookie on the harddrive
   attr_accessor :cookiestore
+  attr_reader :autosave
 
-  # @param [String] url URL to JIRA(tm) instance
+  # @param [String] connecturl URL to JIRA(tm) instance
+  # @param [String] username Username to connect to the server
   # @param [Boolean] autosave Save the cookie on the harddisk whenever something happens?
   def initialize(connecturl, username, autosave = false )
     super(connecturl,username)

data/lib/jirarest2/credentials.rb

@@ -29,6 +29,8 @@ class Credentials
   attr_reader :baseurl
 
   # @param [String] url URL to JIRA(tm) instance
+  # @param [String] username Username of the user who connects to jira
+  # @raise [Jirarest2::NotAnURLError] Raised if the given URL is not recogniced as an url
   def initialize(url,username)
     uri = URI(url)
     if uri.instance_of?(URI::HTTP) || uri.instance_of?(URI::HTTPS) then
@@ -40,8 +42,9 @@ class Credentials
     end
   end
 
-  # Throws an Jirarest2::NotAnURLError if the given String is not an URI.
+  # Set the connect url a later date in the life of the instance
   # @param [String] url
+  # @raise [Jirarest2::NotAnURLError] Raised if the given URL is not recogniced as an url
   def connecturl=(url)
     uri = URI(url)
     if uri.instance_of?(URI::HTTP) || uri.instance_of?(URI::HTTPS) then

data/lib/jirarest2/exceptions.rb

@@ -67,4 +67,9 @@ module Jirarest2
   # A field that is defined as "required" has not been given a value
   class RequiredFieldNotSetException < ArgumentError; end
 
+  #Could not determine the right fieldtype as this seems to be new
+  class CouldNotDetermineFieldtypeException < ArgumentError; end
+  #Hashfiels always have to have a key assigned to them
+  class HashKeyMissingException < ArgumentError; end
+
 end

data/lib/jirarest2/field.rb

@@ -0,0 +1,645 @@
+#    Copyright (C) 2012 Cyril Bitterich
+#
+#    This program is free software: you can redistribute it and/or modify
+#    it under the terms of the GNU General Public License as published by
+#    the Free Software Foundation, either version 3 of the License, or
+#    (at your option) any later version.
+#
+#    This program is distributed in the hope that it will be useful,
+#    but WITHOUT ANY WARRANTY; without even the implied warranty of
+#    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#    GNU General Public License for more details.
+#
+#    You should have received a copy of the GNU General Public License
+#    along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+
+require "jirarest2/exceptions"
+# All the fieldtypes in their own namespace (hopefully easier in the documentation)
+# @todo operations "add","set","remove" are ignored right now.
+module Jirarest2Field
+  # Superclass for all fields
+  class Field
+    # Is this field mandatory?
+    # @return [Boolean] Default: false. True if your field has to be set for the issuetype
+    attr_reader :required
+    # Is this field readonly?
+    # @return [Boolean] Default: false
+    attr_reader :readonly
+    # The field id in JIRA(tm)
+    # @return [String] The id in your JIRA(tm) instance
+    attr_reader :id
+    # The name given to the field (not unique in jira!)
+    # @return [String] The name in your JIRA(tm) instance
+    attr_reader :name
+    # The raw value
+    # @return [Hash] The value in it's raw form
+    attr_reader :raw_value 
+    # Allowed values for the fields
+    # @return [Array] The values allowed for this kind of field
+    attr_accessor :allowed_values
+
+    # @attr [String] id The fields identifier in JIRA(tm)
+    # @attr [String] name The fields name in JIRA(tm)
+    # @attr [Hash] args, :required if this is a mandatory field
+    def initialize(id,name,args)
+      @id = id
+      @name = name
+      if args[:required] then
+        @required = true
+      else
+        @required = false
+      end
+      @allowed_values = []
+      if args[:allowed_values] then
+        allowed_values = args[:allowed_values]
+      end
+      @value = nil
+      @readonly = false
+      if args[:createmeta] then
+        createmeta(args[:createmeta])
+      end
+    end
+    
+    # Get the value of the field
+    # @param [Boolean] raw true returns a date Object, false a String
+    # @return [String] if raw is false (default)
+    # @return [Object] if raw is true
+    def value(raw = false)
+      return @value
+    end
+
+    # Checks if the value is in the list of allowed values. If the list is empty every value is allowed
+    # @param [Object] value The value to check for
+    # @raise [Jirarest2::ValueNotAllowedException] Raised if the value is not allowed
+    # @return [Boolean] true if the value is allowed, false if not
+    def value_allowed?(value)
+      return true if @allowed_values  == [] # If there is no list get out of here fast
+      if @allowed_values.include?(value) then
+        return true
+      else
+        raise Jirarest2::ValueNotAllowedException.new(@name,@allowed_values), "#{value} is not a valid value. Please use one of #{@allowed_values.join("; ").to_s}"
+      end
+    end
+
+    # Set the value of the field
+    # @param [Object] content The value of this field
+    def value=(content)
+      @value = content if value_allowed?(content)
+    end
+    
+    # Representation to be used for json and jira
+    # @param [String,Hash] value the to be put into the representation.
+    # @return [Hash] if the value is set
+    # @return [Nil] if the value is not set
+    def to_j(value = @value)
+      if value.nil? then
+        return nil
+      else 
+        return {@id => value}
+      end
+    end
+    
+    #Interpret the result of createmeta for one field
+    # If there is only one value allowed this value will be set
+    # @attr [Hash] structure  The JSON result for one field
+    # @todo change @allowed_values here. -> suggestion has to go to and build the correct type
+    def createmeta(structure)
+      @readonly = true if structure["operations"] == []
+      if structure["allowedValues"] then
+        structure["allowedValues"].flatten!(1)
+        if ! structure["allowedValues"][0].nil? then
+          if structure["allowedValues"][0].has_key?("value") then 
+            @key = "value"
+          elsif structure["allowedValues"][0].has_key?("key") then
+            @key = "key"
+          elsif structure["allowedValues"][0].has_key?("name") then 
+            @key = "name"
+          else
+            @key = "id"
+          end
+          structure["allowedValues"].each{ |suggestion|
+            @allowed_values << suggestion[@key]
+          }
+          if structure["allowedValues"].size == 1 && !structure["allowedValues"][0].instance_of?(Array) then # If there is only one value allowed it might as well be set at the earliest convenience
+            @value = structure["allowedValues"][0][@key] 
+          end
+        else
+          @key = ""
+          @allowed_values == []
+        end
+      end
+    end
+
+    # Parse the value of this field as sent by the server
+    # @attr [String,Hash,Array] jvalue The part of the response that is connected to this instance
+    def parse_value(jvalue)
+      @rawvalue = jvalue
+      @value = jvalue
+    end
+
+protected
+    # Representation to be used for json and jira - don't return the fieldid
+    # @param [String,Hash] value the to be put into the representation.
+    # @return [String,Hash] if the value is set
+    # @return [Nil] if the value is not set
+    def to_j_inner(value = @value)
+      if value.nil? then
+        return nil
+      else 
+        return value
+      end
+    end
+
+  end # class Field
+  
+
+  
+  # A simple text field. JSON representation will be "Fieldid" : "Value"
+  class TextField < Field
+  end # TextField
+  
+  # A simple Date field. 
+  class DateField < Field
+    require "date"
+
+    # Set the value
+    # @param [String] content The date in a string representation (Either [YY]YY-[M]M-[D]D or [D]D.[M]M.YYYY or YY.[M]M.[D]D See Date.parse) 
+    def value=(content)
+      value = Date.parse(content)
+      @value = value if value_allowed?(value)
+    end
+
+    # Get the value 
+    # @param [Boolean] raw true returns a date Object, false a String
+    # @return [String] if raw is false (default)
+    # @return [Date] if raw is true
+    def value(raw = false)
+      if raw then
+        super
+      else
+        return @value.to_s
+      end
+    end
+    
+    # Representation to be used for json and jira
+    # @return [Hash]
+    def to_j(value = @value)
+      if value.nil? then
+        super(nil)
+      else
+        super(value.to_s)
+      end
+    end
+
+    # Parse the value of this field as sent by the server
+    # @attr [String] jvalue The part of the response that is connected to this instance
+    def parse_value(jvalue)
+      super
+      @value = Date.parse(jvalue)
+    end
+    
+    # Representation to be used for json and jira without the fieldId
+    # @return [Hash]
+    def to_j_inner
+      if @value.nil? then
+        super(nil)
+      else
+        super(@value.to_s)
+      end
+    end
+      
+  end # end class DateField
+
+  # A field resembling a DateTime
+  class DateTimeField < DateField
+#    require "date"
+
+    # Set the value
+    # @param [String] content The DateTime in a string representation (Use "YYYY-MM-DD HH:MM:SS" although others like "HH:MM:SS YYYY-MM-DD" or "HH:MM:SS DD.MM.YYYY" work too. See DateTime.parse )
+    def value=(content)
+      value = DateTime.parse(content)
+      @value = value if value_allowed?(value)
+    end
+
+    # Parse the value of this field as sent by the server
+    # @attr [String] jvalue The part of the response that is connected to this instance
+    def parse_value(jvalue)
+      super
+      @value = DateTime.parse(jvalue)
+    end
+    
+    # Representation to be used for json and JIRA(tm)
+    # JIRA(tm) expects certain format which we try to accomodate here
+    # @return [Hash]
+    def to_j(value = @value)
+      if value.nil? then
+        super(nil)
+      else
+        strvalue = value.strftime("%FT%T.%L%z")
+        super(strvalue)
+      end
+    end
+  end #class DateTimeField
+
+  # A field representing Numbers (not Strings with Numbers)
+  # @todo See to recognize allowed - might hide in schema
+  class NumberField < TextField
+    # Set the value
+    # @param [String,Fixnum] content A number
+    def value=(content)
+      if content.instance_of?(String) then
+        value = content.to_f 
+      else
+        value = content
+      end
+      @value = value if value_allowed?(value)
+    end
+  end # class NumberField
+  
+  # A Field that presents its value in an hash that has additional information ("name","id","key","value")
+  class HashField < TextField
+    # The key element for the answers - It should not be needed - but it's easer on the checks if it's exposed
+    # @return [String] The key element for the way to Jira
+    attr_reader :key
+
+    # @attr [String] id The fields identifier in JIRA(tm)
+    # @attr [String] name The fields name in JIRA(tm)
+    # @attr [Hash] args :key ist mandatory and a String,  :required (a Boolean if this is a mandatory field)
+    #   (key should be one of "id", "key", "name", "value" )
+    # @raise [Jirarest2::HashKeyMissingException] If the key determining the base value of this field in it's hash is not given.
+    def initialize(id,name,args)
+      @key ||= nil # Trying to initialize without overwriting something that might come from the subclass
+      @key = args[:key].downcase  if ( ! args[:createmeta] && args[:key])
+      super
+      raise Jirarest2::HashKeyMissingException, "HashTypes like in #{id} alway require a key!" if @key.nil? 
+    end
+    
+    # Representation to be used for json and jira
+    # @return [Hash] if value is set
+    def to_j(value = @value)
+      if value.nil? then
+        super(nil)
+      else
+        valuehash = {@key => value}
+        super(valuehash)
+      end
+    end
+    
+    # Parse the value of this field as sent by the server
+    # @attr [String,Hash,Array] jvalue The part of the response that is connected to this instance
+    def parse_value(jvalue)
+      super
+      if jvalue.nil? then 
+        @value = nil 
+      else
+        @value = jvalue[key] 
+      end
+    end
+
+    # Representation to be used for json and jira without the fieldID
+    # @return [Hash] if value is set
+    def to_j_inner(value = @value)
+      if value.nil? then
+        super(nil)
+      else
+        valuehash = {@key => value}
+        super(valuehash)
+      end
+    end
+
+  end # class HashField
+
+  # A field containing one or more other fields (usually only TextField or HashField)
+  class MultiField < Field
+    # @attr [String] id The fields identifier in JIRA(tm)
+    # @attr [String] name The fields name in JIRA(tm)
+    # @attr [Hash] args, :required if this is a mandatory field
+    def initialize(id,name,args)
+      super(id,name,args)
+      @value = []
+      @delete = false
+    end
+
+    # Checks if the value is in the list of allowed values. If the list is empty every value is allowed
+    # @param [Object] value The value to check for
+    # @raise [Jirarest2::ValueNotAllowedException] Raised if the value is not allowed
+    # @return [Boolean] true if the value is allowed, false if not
+    def value_allowed?(value)
+      return true if @allowed_values == [] # If there is no list get out of here fast
+      if value.instance_of?(Array) then
+        value.each { |entry|
+          value_allowed?(entry)
+        }
+      else
+        if @allowed_values.include?(value) then
+          return true
+        else
+          raise Jirarest2::ValueNotAllowedException.new(@name,@allowed_values), "#{value} is not a valid value. Please use one of #{@allowed_values.join("; ").to_s}"
+        end
+      end
+    end
+    
+    # Set the value of the field
+    # @attribute [w] value
+    #   @param [Object] content The value of this field
+    #   @return [Array] All the contained fields
+    def value=(content)
+      if ! content.instance_of?(Array) then
+        content = [content]
+      end
+      super(content)
+    end
+
+    
+    # Return for JSON representation
+    # if @value == [] or nil and @delete is false set super will return nil
+    def to_j(value = @value)
+      if ((value == [] || value.nil?) and ! @delete) then
+        super(nil)
+      else
+        value.compact!
+        fields = Array.new
+        if value[0].class  < Jirarest2Field::Field then
+          value.each {|field| 
+            fields << field.to_j_inner
+          }
+        else
+          fields = value
+        end
+        super(fields)
+      end
+    end
+
+    # Delete items
+    # @param [Object] object The object to delete (If the object is self it all fields and sets @delete)
+    # @return The deleted object
+    def delete(object)
+      if object == self then
+        @delete = true
+        @value = []
+      else
+        @value.delete(object)
+      end
+    end
+    
+    # Delete items based on their value attribute
+    # @param [Object] ovalue The value that defines the objects to delete from this MultiField
+    # @return [Array] The remaining Objects
+    def delete_by_value(ovalue)
+      @value.delete_if {|x| x.value == ovalue}
+    end
+
+    # Add another field to the MultiField
+    # @param [Field,String] content the content to add to the hash
+    def <<(content)
+      
+      if @value.length > 0  then
+        raise Jirarest2::ValueNotAllowedException.new(@name,@value[0].class), "#{@value[0].class} vs #{content.class}"  if @value[0].class != content.class 
+      end
+      
+      @value << content if value_allowed?(content)
+    end
+    
+    # One field from the MultiField
+    # @param [Integer] index Position of the field
+    def [](index)
+      @value[index]
+    end
+
+    # Set the content of one special field
+    # @param [Integer] index Position of the field
+    # @param [Object] content Value to put at the place marked by index
+    # @raise [Jirarest2::ValueNotAllowedException] Raised if Classes of the fields are to be mixed
+    def []=(index,content)
+      raise Jirarest2::ValueNotAllowedException.new(@name,@value[0].class), "#{@value[0].class} vs #{content.class}" if @value[0].class != content.class 
+      @value[index] = content if value_allowed?(content)
+    end
+  end # class MultiField
+
+  # The class to represent CascadingSelectFields
+  class CascadingField < Field
+    # The key element for the answers - It should not be needed - but it's easer on the checks if it's exposed
+    # @return [String] The key element for the way to Jira
+    attr_reader :key
+    # @!attribute [w] allowed_values
+    #   @attr [Hash<Array>] value The Hashes with the allowed values
+    def allowed_values=(value)
+      @allowed_values = value
+    end
+
+    # Checks if the value is in the list of allowed values. If the list is empty every value is allowed
+    # @param [Object] value The value to check for
+    # @raise [Jirarest2::ValueNotAllowedException] Raised if the value is not allowed
+    # @return [Boolean] true if the value is allowed, false if not
+    def value_allowed?(value)
+      return true if @allowed_values == []  # If there is no list get out of here fast
+      if @allowed_values[0].has_key?(value[0]) && @allowed_values[0][value[0]].include?(value[1]) then
+        return true
+      else
+        raise Jirarest2::ValueNotAllowedException.new(@name,@allowed_values), "#{value.to_s} is not a valid value. Please use one of #{@allowed_values}"
+      end
+    end    
+
+    # Set the value of the field
+    # @!attribute [w] value
+    #  @param [Array(String,String)] content The value of this field
+    #  @raise [Jirarest2::ValueNotAllowedException] Raised if Classes of the fields are to be mixed
+    def value=(content)
+      if ! content.instance_of?(Array) or content.size != 2 then
+        raise Jirarest2::ValueNotAllowedException.new(@name,"Array"), "needs to be an Array with exactly 2 parameters. Was #{content.class}." 
+      end
+      super
+    end
+    
+
+    # Representation to be used for json and jira
+    # @return [Hash] if the value is set
+    # @return [Nil] if the value is not set
+    def to_j
+      if @value.nil? then
+        super(nil)
+      else
+        super({"value" => @value[0], "child" => {"value" => @value[1]}})
+      end
+    end
+
+    # Parse the value of this field as sent by the server
+    # @attr [Array] jvalue The part of the response that is connected to this instance
+    def parse_value(jvalue)
+      super
+      @value = [jvalue["value"],jvalue["child"]["value"]]
+    end
+    
+    #Interpret the result of createmeta for one field
+    # @attr [Hash](structure)
+    # @note fills allowed_values with a straight list of allowed values
+    # @todo Nothing is done here yet!
+    def createmeta(structure)
+      @readonly = true if structure["operations"] == []
+      @key = "value"
+      if structure["allowedValues"] then
+        structure["allowedValues"].each{ |suggestion|
+          subentries = Array.new
+          suggestion["children"].each{ |entry|
+            subentries << entry["value"]
+          }
+          @allowed_values << {suggestion[@key] => subentries}
+        }
+      end
+    end
+  end # class CascadingField
+  
+  # At the moment it's only there to keep the HashField company
+  class MultiStringField < MultiField ; end
+
+  # Hash Fields are always somewhat different to normal fields
+  # @todo to_j is shot
+  class MultiHashField < MultiField 
+    # The key element for the answers - It should not be needed - but it's easer on the checks if it's exposed
+    # @return [String] The key element for the way to Jira
+    attr_reader :key
+
+    # @attr [String] id The fields identifier in JIRA(tm)
+    # @attr [String] name The fields name in JIRA(tm)
+    # @attr [Hash] args, :required if this is a mandatory field
+    # @raise [Jirarest2::HashKeyMissingException] If the key determining the base value of this field in it's hash is not given.
+    # @todo Test to not really work for to_j
+    # @todo Hash_identifier is not alway "name", we should have some "value" fields as well. Whole thing needs to be rewritten work with HashFields as parts
+    def initialize(id,name,args)
+      @key ||= nil # Trying to initialize without overwriting something that might come from the subclass
+      @key = args[:key].downcase  if ( ! args[:createmeta] && args[:key])
+      super
+      raise Jirarest2::HashKeyMissingException, "HashTypes like in #{id} always require a key!" if @key.nil? 
+    end
+    
+    # Parse the value of this field as sent by the server
+    # @attr [Array] jvalue The part of the response that is connected to this instance
+    def parse_value(jvalue)
+      @rawvalue = jvalue
+      jvalue.each{ |item|
+        @value << item[@key]
+      }
+    end
+
+    # Return for JSON representation
+    # if @value == [] or nil and @delete is false set super will return nil
+    def to_j(value = @value)
+      if ((value == [] || value.nil?) and ! @delete) then
+        super(nil)
+      else
+        value.compact!
+        fields = Array.new
+        if value[0].class  < Jirarest2Field::Field then # This is how it should be 
+          value.each {|field| 
+            fields << field.to_j_inner
+          }
+        else 
+          value.each{ |field|
+            f = HashField.new("10000a",field,{:createmeta => {"operations" => ["set"], "allowedValues" => [{@key => field}] } })
+            fields << f.to_j_inner
+          }
+        end
+        super(fields)
+      end
+    end
+
+    # Representation to be used for json and jira without the fieldID
+    # @return [Hash] if value is set
+    def to_j_inner(value = @value)
+      if value.nil? then
+        super(nil)
+      else
+        valuehash = {@key => value}
+        super(valuehash)
+      end
+    end
+
+  end
+
+  # Versions might behave in another way somewhere
+  class MultiVersionField < MultiHashField ; end 
+
+  # Unfortunately Users and Groups don't give us any clue as to how to set their "key" element. Therefore this own class
+  class MultiUserField < MultiHashField 
+    def initialize(id,name,args)
+      @key = "name"
+      super
+    end
+  end
+  
+  # Unfortunately Users and Groups don't give us any clue as to how to set their "key" element. Therefore this own class
+  class UserField < HashField
+    def initialize(id,name,args)
+      @key = "name"
+      super
+    end
+  end
+
+  class VersionField < HashField ;  end 
+
+  # Projects are a little bit special
+  class ProjectField < VersionField 
+=begin
+    def createmeta(structure)
+      super
+      if ! structure["allowedValues"][0].instance_of?(Array) then # If there is only one value allowed it might as well be set at the earliest convenience
+        @value = structure["allowedValues"][0]["key"] 
+      end
+    end
+=end
+  end
+
+  # Timetracking is very special
+  # @todo This class is not really doing anything usefull
+  class TimetrackingField < Field; end
+
+=begin
+  class CascadingSelect < CascadingField ;  end # Look for "custom" Key
+  class DateTime < DateTimeField ;  end
+  class GroupPicker < HashField ;  end
+  class ImportId ; end
+  class Labels < MultiStringField ; end 
+  class MultiGroupPicker < MultiHashField ; end
+  class MultiUserPicker < MultiHashField ; end
+  class ProjectPicker < HashField; end
+  class ReadOnlyTextField < TextField ; end
+  class SingleVersionPicker < HashField ; end
+  class URLField < TextField ; end
+  class VersionPicker < MultiHashField ; end
+  class DatePicker < DateField ; end
+  class FreeTextField < TextField ; end
+  class HiddenJobSwitch ; end
+  class JobCheckbox ; end
+  class MultiCheckboxes < MultiField ; end #unsure
+  class MultiSelect < MultiHashField ; end
+#  class NumberField < NumberField ; end
+  class RadioButtons < HashField ; end
+  class SelectList < HashField ; end
+#  class TextField < TextField ; end
+  class UserPicker < HashField ; end
+
+  class String < TextField ; end
+  class Progress ; end
+#  class Timetracking < TimeTrackingEntry ; end # "timetracking" : { "originalEstimate" : "1w2h", "remainingEstimate" : "3h23m" }
+  class Issuetype < HashField ; end
+  class Number < NumberField ; end
+  class User < UserPicker ; end
+#  class Datetime  ; end # See above
+  class Priority < TextField ; end # Not HashField?
+  class Date < DateField ; end
+  class Array < MultiField ; end # Never alone always with an items parameter
+  class Status ; end
+  class Project < HashField ; end 
+  class Component ; end
+  class Comment ; end
+  class Votes ; end
+  class Resolution < TextField ; end
+  class Version < HashField ; end
+  class Watches ; end
+  class Worklog ; end
+  class Attachment ; end # readonly
+=end
+end
+
+