ruby-trello 2.0.1 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 77b35b3b765d1056e69ec92a4d403439849c66edfdb01747d590d79026b7ac67
-  data.tar.gz: 35173e15c5deb8a4c8404831c2cb524e3b8283cc60ac69d0d9519b9b9b22d66c
+  metadata.gz: 2971d7fb189328ae318b068c480ccb94824c8c85dbefed703a1837d839790144
+  data.tar.gz: ffdf9a6dac2e3adc9d69306d70c7a8b784cd1809e0ebab2a3bb4dd394d25a732
 SHA512:
-  metadata.gz: 155bdc62579174c62bf3ade75dd2921cdfb29aa5ced74176d90ea62a94fa279f0e164a54cd0970392296fa04dec7d53a293d45bb188f9eeac3f662d23109f309
-  data.tar.gz: d4e75692b37cd6d1befa4d14dff5bce2acdca231a90287e898af1cadcaec4d5f006e8fb6ed05aeeb6982ab741a1f93e003bda3b8f3aa1eb9974fcdff9a6fd920
+  metadata.gz: 4c7b7da985552a94069f359ea7e80200305e60ae1642f50541d28a412e8fe83b9dd8ca77594556435b0b7aac827eecf83d6ee5b8da378cbdfac635a42146694e
+  data.tar.gz: 230297498d5a1847802cc5a1a0a273222e75b2204554f2caed1b41549bf2942cedda5633156f414d108c384dfaaac8fa865d8520a7f16545105c6ee9adcc8aa9

data/lib/trello.rb

@@ -50,6 +50,9 @@ module Trello
   autoload :Checklist,         'trello/checklist'
   autoload :Client,            'trello/client'
   autoload :Configuration,     'trello/configuration'
+  autoload :CustomField,       'trello/custom_field'
+  autoload :CustomFieldItem,   'trello/custom_field_item'
+  autoload :CustomFieldOption, 'trello/custom_field_option'
   autoload :HasActions,        'trello/has_actions'
   autoload :Item,              'trello/item'
   autoload :CheckItemState,    'trello/item_state'

data/lib/trello/basic_data.rb

@@ -122,7 +122,15 @@ module Trello
 
     # Two objects are equal if their _id_ methods are equal.
     def ==(other)
-      id == other.id
+      self.class == other.class && id == other.id
+    end
+
+    # Alias hash equality to equality
+    alias eql? ==
+
+    # Delegate hash key computation to class and id pair
+    def hash
+      [self.class, id].hash
     end
 
     def client

data/lib/trello/board.rb

@@ -167,6 +167,9 @@ module Trello
     # Returns a list of plugins associated with the board
     many :plugin_data, path: "pluginData"
 
+    # Returns custom fields activated on this board
+    many :custom_fields, path: "customFields"
+
     def labels(params = {})
       # Set the limit to as high as possible given there is no pagination in this API.
       params[:limit] = 1000 unless params[:limit]

data/lib/trello/card.rb

@@ -210,6 +210,9 @@ module Trello
     # Returns a list of plugins associated with the card
     many :plugin_data, path: "pluginData"
 
+    # List of custom field values on the card, only the ones that have been set
+    many :custom_field_items, path: 'customFieldItems'
+
     def check_item_states
       states = CheckItemState.from_response client.get("/cards/#{self.id}/checkItemStates")
       MultiAssociation.new(self, states).proxy

data/lib/trello/custom_field.rb

@@ -0,0 +1,113 @@
+module Trello
+  # A Custom Field can be activated on a board. Values are stored at the card level.
+  #
+  # @!attribute id
+  #   @return [String]
+  # @!attribute model_id
+  #   @return [String]
+  # @!attribute model_type
+  #   @return [String]
+  # @!attribute field_group
+  #   @return [String]
+  # @!attribute name
+  #   @return [String]
+  # @!attribute pos
+  #   @return [Float]
+  # @!attribute type
+  #   @return [String]
+  # @!attribute options
+  #   @return [Array<Hash>]
+  class CustomField < BasicData
+    register_attributes :id, :model_id, :model_type, :field_group, :name, :pos, :type
+    validates_presence_of :id, :model_id, :model_type, :name, :type, :pos
+
+    SYMBOL_TO_STRING = {
+      id:          'id',
+      name:        'name',
+      model_id:    'idModel',
+      model_type:  'modelType',
+      field_group: 'fieldGroup',
+      type:        'type',
+      pos:         'pos'
+    }
+
+    class << self
+      # Find a custom field by its id.
+      def find(id, params = {})
+        client.find('customFields', id, params)
+      end
+
+      # Create a new custom field and save it on Trello.
+      def create(options)
+        client.create('customFields',
+          'name'       => options[:name],
+          'idModel'    => options[:model_id],
+          'modelType'  => options[:model_type],
+          'fieldGroup' => options[:field_group],
+          'type'       => options[:type],
+          'pos'        => options[:pos]
+        )
+      end
+    end
+
+    # References Board where this custom field is located
+    # Currently, model_type will always be "board" at the customFields endpoint
+    one :board, path: :boards, using: :model_id
+
+    # If type == 'list'
+    many :custom_field_options, path: 'options'
+
+    def update_fields(fields)
+      attributes[:id]          = fields[SYMBOL_TO_STRING[:id]] || fields[:id] || attributes[:id]
+      attributes[:name]        = fields[SYMBOL_TO_STRING[:name]] || fields[:name] || attributes[:name]
+      attributes[:model_id]    = fields[SYMBOL_TO_STRING[:model_id]] || fields[:model_id] || attributes[:model_id]
+      attributes[:model_type]  = fields[SYMBOL_TO_STRING[:model_type]] || fields[:model_type] || attributes[:model_type]
+      attributes[:field_group] = fields[SYMBOL_TO_STRING[:field_group]] || fields[:field_group] || attributes[:field_group]
+      attributes[:type]        = fields[SYMBOL_TO_STRING[:type]] || fields[:type] || attributes[:type]
+      attributes[:pos]         = fields[SYMBOL_TO_STRING[:pos]] || fields[:pos] || attributes[:pos]
+      self
+    end
+
+    # Saves a record.
+    def save
+      # If we have an id, just update our fields.
+      return update! if id
+
+      from_response client.post("/customFields", {
+        name:       name,
+        idModel:    model_id,
+        modelType:  model_type,
+        type:       type,
+        pos:        pos,
+        fieldGroup: field_group
+      })
+    end
+
+    # Update an existing custom field.
+    def update!
+      @previously_changed = changes
+      # extract only new values to build payload
+      payload = Hash[changes.map { |key, values| [SYMBOL_TO_STRING[key.to_sym].to_sym, values[1]] }]
+      @changed_attributes.clear
+
+      client.put("/customFields/#{id}", payload)
+    end
+
+    # Delete this custom field
+    # Also deletes all associated values across all cards
+    def delete
+      client.delete("/customFields/#{id}")
+    end
+
+    # If type == 'list', create a new option and add to this Custom Field
+    def create_new_option(value)
+      payload = { value: value }
+      client.post("/customFields/#{id}/options", payload)
+    end
+
+    # Will also clear it from individual cards that have this option selected
+    def delete_option(option_id)
+      client.delete("/customFields/#{id}/options/#{option_id}")
+    end
+  end
+end

data/lib/trello/custom_field_item.rb

@@ -0,0 +1,77 @@
+module Trello
+  # A custom field item contains the value for a custom field on a particular card.
+  #
+  class CustomFieldItem < BasicData
+    register_attributes :id, :model_id, :model_type, :custom_field_id, :value, :option_id,
+                        readonly: [ :id, :custom_field_id, :model_id, :model_type, :option_id ]
+    validates_presence_of :id, :model_id, :custom_field_id
+
+    # References the card with this custom field value
+    one :card, path: :cards, using: :model_id
+
+    # References the parent custom field that this item is an instance of
+    one :custom_field, path: 'customFields', using: :custom_field_id
+
+    # Update the fields of a custom field item.
+    #
+    # Supply a hash of string keyed data retrieved from the Trello API representing
+    # an item state.
+    def update_fields(fields)
+      attributes[:id]               = fields['id'] || fields[:id] || attributes[:id]
+      attributes[:model_id]         = fields['idModel'] || fields[:model_id] || attributes[:model_id]
+      attributes[:custom_field_id]  = fields['idCustomField'] || fields[:custom_field_id] || attributes[:custom_field_id]
+      attributes[:model_type]       = fields['modelType'] || fields[:model_type] || attributes[:model_type]
+      # Dropdown custom field items do not have a value, they have an ID that maps to
+      # a different endpoint to get the value
+      attributes[:option_id]       = fields['idValue'] if fields.has_key?('idValue')
+      # value format: { "text": "hello world" }
+      attributes[:value]            = fields['value'] if fields.has_key?('value')
+      self
+    end
+
+    def update!
+      @previously_changed = changes
+      # extract only new values to build payload
+      payload = Hash[changes.map { |key, values| [key.to_sym, values[1]] }]
+      @changed_attributes.clear
+
+      client.put("/card/#{model_id}/customField/#{custom_field_id}/item", payload)
+    end
+
+    # Saves a record.
+    #
+    # @raise [Trello::Error] if the card could not be saved
+    #
+    # @return [String] The JSON representation of the saved custom field item returned by
+    # the Trello API.
+    def save
+      # If we have an id, just update our fields.
+      return update! if id
+
+      from_response client.post("/card/#{model_id}/customField/#{custom_field_id}/item", {
+        value: value
+      })
+    end
+
+    # You can't "delete" a custom field item, you can only clear the value
+    def remove
+      params = { value: {} }
+      client.put("/card/#{model_id}/customField/#{custom_field_id}/item", params)
+    end
+
+    # Type is saved at the CustomField level
+    # Can equally be derived from :value, with a little parsing work: {"number": 42}
+    def type
+      custom_field.type
+    end
+
+    # Need to make another call to get the actual value if the custom field type == 'list'
+    def option_value
+      if option_id
+        option_endpoint = "/customFields/#{custom_field_id}/options/#{option_id}"
+        option = CustomFieldOption.from_response client.get(option_endpoint)
+        option.value
+      end
+    end
+  end
+end

data/lib/trello/custom_field_option.rb

@@ -0,0 +1,22 @@
+module Trello
+  # A custom field option contains the individual items in a custom field dropdown menu.
+  #
+  class CustomFieldOption < BasicData
+    register_attributes :id, :value, :pos, :color,
+                        readonly: [:id]
+    validates_presence_of :id, :value
+
+    # Update the fields of a custom field option.
+    #
+    # Supply a hash of string keyed data retrieved from the Trello API representing
+    # an item state.
+    def update_fields(fields)
+      attributes[:id]               = fields['_id'] || fields[:id] || attributes[:id]
+      attributes[:color]            = fields['color'] || fields[:color] || attributes[:color]
+      attributes[:pos]              = fields['pos'] || fields[:pos] || attributes[:pos]
+      # value format: { "text": "hello world" }
+      attributes[:value]            = fields['value'] || fields[:value] || attributes[:value]
+      self
+    end
+  end
+end

data/lib/trello/label.rb

@@ -9,7 +9,7 @@ module Trello
   class Label < BasicData
     register_attributes :id, :name, :board_id, :uses,
       readonly: [ :id, :uses, :board_id ]
-    validates_presence_of :id, :uses, :board_id, :name
+    validates_presence_of :id, :board_id, :name
     validates_length_of   :name,        in: 1..16384
 
     SYMBOL_TO_STRING = {
@@ -23,7 +23,7 @@ module Trello
     class << self
       VALID_LABEL_COLOURS = %w{green yellow orange red purple blue sky lime pink black} << ''
 
-      # Find a specific card by its id.
+      # Find a specific label by its id.
       def find(id, params = {})
         client.find(:label, id, params)
       end

data/spec/basic_data_spec.rb

@@ -0,0 +1,58 @@
+require 'spec_helper'
+
+module Trello
+  describe BasicData do
+    describe "equality" do
+      specify "two objects of the same type are equal if their id values are equal" do
+        data_object = Card.new('id' => 'abc123')
+        other_data_object = Card.new('id' => 'abc123')
+
+        expect(data_object).to eq(other_data_object)
+      end
+
+      specify "two object of the samy type are not equal if their id values are different" do
+        data_object = Card.new('id' => 'abc123')
+        other_data_object = Card.new('id' => 'def456')
+
+        expect(data_object).not_to eq(other_data_object)
+      end
+
+      specify "two object of different types are not equal even if their id values are equal" do
+        card = Card.new('id' => 'abc123')
+        list = List.new('id' => 'abc123')
+
+        expect(card.id).to eq(list.id)
+        expect(card).to_not eq(list)
+      end
+    end
+
+    describe "hash equality" do
+      specify "two objects of the same type point to the same hash key" do
+        data_object = Card.new('id' => 'abc123')
+        other_data_object = Card.new('id' => 'abc123')
+
+        hash = {data_object => 'one'}
+
+        expect(hash[other_data_object]).to eq('one')
+      end
+
+      specify "two object of the same type with different ids do not point to the same hash key" do
+        data_object = Card.new('id' => 'abc123')
+        other_data_object = Card.new('id' => 'def456')
+
+        hash = {data_object => 'one'}
+
+        expect(hash[other_data_object]).to be_nil
+      end
+
+      specify "two object of different types with same ids do not point to the same hash key" do
+        card = Card.new('id' => 'abc123')
+        list = List.new('id' => 'abc123')
+
+        hash = {card => 'one'}
+
+        expect(hash[list]).to be_nil
+      end
+    end
+  end
+end

data/spec/board_spec.rb

@@ -251,6 +251,19 @@ module Trello
       end
     end
 
+    context "custom fields" do
+      before do
+        allow(client)
+          .to receive(:get)
+          .with("/boards/abcdef123456789123456789/customFields", {})
+          .and_return JSON.generate([custom_fields_details.first])
+      end
+
+      it "has custom fields" do
+        expect(board.custom_fields.count).to be > 0
+      end
+    end
+
     it "is not closed" do
       expect(board).not_to be_closed
     end

data/spec/card_spec.rb

@@ -257,7 +257,6 @@ module Trello
         expect(card.pos).to_not be_nil
       end
 
-
       it 'gets its creation time' do
         expect(card.created_at).to be_kind_of Time
       end
@@ -338,6 +337,41 @@ module Trello
       end
     end
 
+    context "custom field items" do
+      before do
+        allow(client)
+          .to receive(:get)
+          .with("/cards/abcdef123456789123456789/customFieldItems", {})
+          .and_return JSON.generate([custom_field_item_details])
+      end
+
+      it "has a list of custom field items" do
+        expect(card.custom_field_items.count).to be > 0
+      end
+
+      it "clears the custom field value on a card" do
+        params = { value: {} }
+
+        expect(client)
+          .to receive(:put)
+          .with("/card/abcdef123456789123456789/customField/abcdef123456789123456789/item", params)
+
+        card.custom_field_items.last.remove
+      end
+
+      it "updates a custom field value" do
+        payload = { value: { text: 'Test Text' } }
+
+        expect(client)
+          .to receive(:put)
+          .with("/card/abcdef123456789123456789/customField/abcdef123456789123456789/item", payload)
+
+        text_custom_field = card.custom_field_items.last
+        text_custom_field.value = { text: 'Test Text' }
+        text_custom_field.save
+      end
+    end
+
     context "list" do
       before do
         allow(client)
@@ -345,6 +379,7 @@ module Trello
           .with("/lists/abcdef123456789123456789", {})
           .and_return JSON.generate(lists_details.first)
       end
+
       it 'has a list' do
         expect(card.list).to_not be_nil
       end
@@ -556,7 +591,6 @@ module Trello
       end
     end
 
-
     context "comments" do
       it "posts a comment" do
         expect(client)

data/spec/custom_field_item_spec.rb

@@ -0,0 +1,118 @@
+require 'spec_helper'
+
+module Trello
+  describe CustomFieldItem do
+    include Helpers
+
+    let(:text_field_details) {
+      {
+        'id'   => 'abcdefgh12345678',
+        'value' => {"text" => "Low Priority"},
+        'idValue' => nil,
+        'idModel' => 'abc123',
+        'idCustomField' => 'abcd1234',
+        'modelType' => 'card'
+      }
+    }
+
+    let(:list_item_details) {
+      {
+        'id'   => 'abcdefgh12345678',
+        'value' => nil,
+        'idValue' => 'abcde12345',
+        'idModel' => 'abc123',
+        'idCustomField' => 'abcd1234',
+        'modelType' => 'card'
+      }
+    }
+
+    let(:client) { Client.new }
+    let(:text_item) { CustomFieldItem.new(text_field_details) }
+    let(:list_item) { CustomFieldItem.new(list_item_details) }
+
+    it 'validates presence of id, model ID and custom field ID' do
+      invalid_item = CustomFieldItem.new
+
+      expect(invalid_item).to be_invalid
+      expect(invalid_item.errors).to include(:id)
+      expect(invalid_item.errors).to include(:model_id)
+      expect(invalid_item.errors).to include(:custom_field_id)
+    end
+
+    describe 'retrieve item fields' do
+      it 'gets its id' do
+        expect(text_item.id).to eq text_field_details['id']
+      end
+
+      it 'gets its value' do
+        expect(text_item.value).to eq text_field_details['value']
+      end
+
+      it 'gets its model type' do
+        expect(text_item.model_type).to eq text_field_details['modelType']
+      end
+
+      it 'gets its model ID' do
+        expect(text_item.model_id).to eq text_field_details['idModel']
+      end
+
+      it 'gets its custom field ID' do
+        expect(text_item.custom_field_id).to eq text_field_details['idCustomField']
+      end
+
+      it 'has a value ID for list option' do
+        expect(list_item.option_id).to eq list_item_details['idValue']
+      end
+    end
+
+    describe 'list option' do
+      let(:client) { Trello.client }
+
+      before do
+        allow(client)
+          .to receive(:get)
+          .with("/customFields/#{list_item.custom_field_id}/options/#{list_item.option_id}")
+          .and_return JSON.generate(custom_field_option_details)
+      end
+
+      it 'gets the value' do
+        expect(list_item.option_value).to_not be_nil
+      end
+    end
+
+    describe 'custom field' do
+      let(:client) { Trello.client }
+
+      before do
+        allow(client)
+          .to receive(:get)
+          .with("/customFields/abcd1234", {})
+          .and_return JSON.generate(custom_fields_details.first)
+      end
+
+      it 'has a custom field' do
+        expect(text_item.custom_field).to be_a CustomField
+        expect(text_item.custom_field.name).to eq('Priority')
+      end
+
+      it 'returns the custom field type' do
+        expect(text_item.type).to eq 'checkbox'
+      end
+    end
+
+    describe 'card' do
+      let(:client) { Trello.client }
+
+      before do
+        allow(client)
+          .to receive(:get)
+          .with("/cards/abc123", {})
+          .and_return JSON.generate(cards_details.first)
+      end
+
+      it 'has a card' do
+        expect(text_item.card).to be_a Card
+      end
+    end
+  end
+end

data/spec/custom_field_option_spec.rb

@@ -0,0 +1,49 @@
+require 'spec_helper'
+
+module Trello
+  describe CustomFieldOption do
+    include Helpers
+
+    let(:option) { CustomFieldOption.new(custom_field_option_details) }
+
+    it 'validates presence of value and id' do
+      invalid_option = CustomFieldOption.new
+
+      expect(invalid_option).to be_invalid
+      expect(invalid_option.errors).to include(:value)
+      expect(invalid_option.errors).to include(:id)
+    end
+
+    describe 'retrieve option fields' do
+      it 'gets its id' do
+        expect(option.id).to eq custom_field_option_details['_id']
+      end
+
+      it 'gets its color' do
+        expect(option.color).to eq custom_field_option_details['color']
+      end
+
+      it 'knows its value' do
+        expect(option.value).to eq custom_field_option_details['value']
+      end
+
+      it 'gets its pos' do
+        expect(option.pos).to eq custom_field_option_details['pos']
+      end
+    end
+
+    describe 'update fields' do
+      it 'allows fields to be updated' do
+        updated = {
+          color: "purple",
+          value: { "text" => "Medium Priority" }
+        }
+
+        option.update_fields(updated)
+
+        expect(option.color).to eq "purple"
+        expect(option.value).to eq({"text" => "Medium Priority"})
+      end
+    end
+  end
+end

data/spec/custom_field_spec.rb

@@ -0,0 +1,185 @@
+require 'spec_helper'
+
+module Trello
+  describe CustomField do
+    include Helpers
+
+    let(:custom_field) { client.find('customFields', 'abcdef123456789123456789') }
+    let(:client) { Client.new }
+
+    before do
+      allow(client)
+        .to receive(:get)
+        .with('/customFields/abcdef123456789123456789', {})
+        .and_return custom_fields_payload
+    end
+
+    context 'creating' do
+      let(:client) { Trello.client }
+
+      it 'creates a new CustomField record' do
+        custom_fields_details.each do |details|
+          custom_field = CustomField.new(details)
+          expect(custom_field).to be_valid
+        end
+      end
+
+      it 'properly initializes all fields from response-like formatted hash' do
+        custom_field_details = custom_fields_details.first
+        custom_field = CustomField.new(custom_field_details)
+        expect(custom_field.id).to          eq(custom_field_details['id'])
+        expect(custom_field.name).to        eq(custom_field_details['name'])
+        expect(custom_field.type).to        eq(custom_field_details['type'])
+        expect(custom_field.pos).to         eq(custom_field_details['pos'])
+        expect(custom_field.model_id).to    eq(custom_field_details['idModel'])
+        expect(custom_field.model_type).to  eq(custom_field_details['modelType'])
+      end
+
+      it 'properly initializes all fields from options-like formatted hash' do
+        custom_field_details = custom_fields_details[1]
+        custom_field = CustomField.new(custom_field_details)
+        expect(custom_field.id).to          eq(custom_field_details[:id])
+        expect(custom_field.name).to        eq(custom_field_details[:name])
+        expect(custom_field.type).to        eq(custom_field_details[:type])
+        expect(custom_field.pos).to         eq(custom_field_details[:pos])
+        expect(custom_field.model_id).to    eq(custom_field_details[:model_id])
+        expect(custom_field.model_type).to  eq(custom_field_details[:model_type])
+      end
+
+      it 'validates presence of id, name, model id, model type, type, and position' do
+        custom_field = CustomField.new
+        expect(custom_field).to_not be_valid
+        expect(custom_field.errors.count).to eq(6)
+        expect(custom_field.errors).to include(:name)
+        expect(custom_field.errors).to include(:id)
+        expect(custom_field.errors).to include(:model_id)
+        expect(custom_field.errors).to include(:model_type)
+        expect(custom_field.errors).to include(:pos)
+        expect(custom_field.errors).to include(:type)
+      end
+
+      it 'creates a new record and saves it on Trello', refactor: true do
+        test_payload = {
+          name: 'Test Custom Field'
+        }
+
+        result = JSON.generate(custom_fields_details.first.merge(test_payload))
+        expected_payload = {name: 'Test Custom Field', type: 'checkbox', idModel: 'abc123',
+                            modelType: 'board', pos: 123, fieldGroup: nil}
+
+        expect(client)
+          .to receive(:post)
+          .with('/customFields', expected_payload)
+          .and_return result
+
+        custom_field = CustomField.create(custom_fields_details[1].merge(test_payload))
+        expect(custom_field).to be_a CustomField
+      end
+    end
+
+    context 'finding' do
+      let(:client) { Trello.client }
+
+      before do
+        allow(client)
+          .to receive(:find)
+      end
+
+      it 'delegates to Trello.client#find' do
+        expect(client)
+          .to receive(:find)
+          .with('customFields', 'abcdef123456789123456789', {})
+
+        CustomField.find('abcdef123456789123456789')
+      end
+
+      it 'is equivalent to client#find' do
+        expect(CustomField.find('abcdef123456789123456789')).to eq(custom_field)
+      end
+    end
+
+    context 'updating' do
+      it 'correctly updates custom field name' do
+        expected_new_name = 'Test Name'
+
+        payload = { name: expected_new_name }
+
+        expect(client)
+          .to receive(:put).once
+          .with('/customFields/abcdef123456789123456789', payload)
+
+        custom_field.name = expected_new_name
+        custom_field.save
+      end
+    end
+
+    context 'fields' do
+      it 'gets its id' do
+        expect(custom_field.id).to_not be_nil
+      end
+
+      it 'gets its name' do
+        expect(custom_field.name).to_not be_nil
+      end
+
+      it 'gets the model id' do
+        expect(custom_field.model_id).to_not be_nil
+      end
+
+      it 'gets the model type' do
+        expect(custom_field.model_type).to_not be_nil
+      end
+
+      it 'gets its type' do
+        expect(custom_field.type).to_not be_nil
+      end
+
+      it 'gets its position' do
+        expect(custom_field.pos).to_not be_nil
+      end
+    end
+
+    context 'boards' do
+      before do
+        allow(client)
+          .to receive(:get)
+          .with('/boards/abc123', {})
+          .and_return JSON.generate(boards_details.first)
+      end
+
+      it 'has a board' do
+        expect(custom_field.board).to_not be_nil
+      end
+    end
+
+    context 'options' do
+      it 'creates a new option' do
+        payload = { :value => { "text" => "High Priority" } }
+
+        expect(client)
+          .to receive(:post)
+          .with('/customFields/abcdef123456789123456789/options', payload)
+
+        custom_field.create_new_option({"text" => "High Priority"})
+      end
+
+      it 'deletes option' do
+        expect(client)
+          .to receive(:delete)
+          .with('/customFields/abcdef123456789123456789/options/abc123')
+
+        custom_field.delete_option('abc123')
+      end
+    end
+
+    context 'deleting' do
+      it 'deletes the custom field' do
+        expect(client)
+          .to receive(:delete)
+          .with("/customFields/#{custom_field.id}")
+
+        custom_field.delete
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -425,6 +425,54 @@ module Helpers
     JSON.generate(label_name_details)
   end
 
+  def custom_fields_details
+    [
+      {
+        'id' => 'abcdef123456789123456789',
+        'name' => 'Priority',
+        'idModel' => 'abc123',
+        'type' => 'checkbox',
+        'pos' => 123,
+        'modelType' => 'board'
+      },
+      {
+        id: 'abcdef123456789123456789',
+        name: 'Priority',
+        model_id: 'abc123',
+        type: 'checkbox',
+        pos: 123,
+        model_type: 'board'
+      }
+    ]
+  end
+
+  def custom_fields_payload
+    JSON.generate(custom_fields_details.first)
+  end
+
+  def custom_field_option_details
+    {
+      '_id'   => 'abcdefgh12345678',
+      'value' => {'text' => 'Low Priority'},
+      'color' => 'green',
+      'pos' => 1
+    }
+  end
+
+  def custom_field_item_details
+    {
+      'id' => 'abcdefg1234567',
+      'value' => { 'text' => 'hello world' },
+      'idModel' => 'abcdef123456789123456789',
+      'idCustomField' => 'abcdef123456789123456789',
+      'modelType' => 'card'
+    }
+  end
+
+  def custom_field_items_payload
+    JSON.generate(custom_field_item_details)
+  end
+
   def webhooks_payload
     JSON.generate(webhooks_details)
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ruby-trello
 version: !ruby/object:Gem::Version
-  version: 2.0.1
+  version: 2.1.0
 platform: ruby
 authors:
 - Jeremy Tregunna
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-02-04 00:00:00.000000000 Z
+date: 2018-08-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activemodel
@@ -105,6 +105,9 @@ files:
 - lib/trello/core_ext/hash.rb
 - lib/trello/core_ext/string.rb
 - lib/trello/cover_image.rb
+- lib/trello/custom_field.rb
+- lib/trello/custom_field_item.rb
+- lib/trello/custom_field_option.rb
 - lib/trello/error.rb
 - lib/trello/has_actions.rb
 - lib/trello/item.rb
@@ -125,11 +128,15 @@ files:
 - spec/array_spec.rb
 - spec/association_spec.rb
 - spec/basic_auth_policy_spec.rb
+- spec/basic_data_spec.rb
 - spec/board_spec.rb
 - spec/card_spec.rb
 - spec/checklist_spec.rb
 - spec/client_spec.rb
 - spec/configuration_spec.rb
+- spec/custom_field_item_spec.rb
+- spec/custom_field_option_spec.rb
+- spec/custom_field_spec.rb
 - spec/hash_spec.rb
 - spec/integration/how_to_authorize_spec.rb
 - spec/integration/how_to_use_boards_spec.rb
@@ -168,7 +175,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: ruby-trello
-rubygems_version: 2.7.3
+rubygems_version: 2.7.7
 signing_key: 
 specification_version: 4
 summary: A wrapper around the trello.com API.
@@ -179,11 +186,13 @@ test_files:
 - spec/integration/how_to_use_boards_spec.rb
 - spec/integration/how_to_authorize_spec.rb
 - spec/integration/integration_test.rb
+- spec/custom_field_spec.rb
 - spec/card_spec.rb
 - spec/hash_spec.rb
 - spec/trello_spec.rb
 - spec/board_spec.rb
 - spec/member_spec.rb
+- spec/custom_field_option_spec.rb
 - spec/oauth_policy_spec.rb
 - spec/configuration_spec.rb
 - spec/json_utils_spec.rb
@@ -191,10 +200,12 @@ test_files:
 - spec/list_spec.rb
 - spec/webhook_spec.rb
 - spec/organization_spec.rb
+- spec/custom_field_item_spec.rb
 - spec/basic_auth_policy_spec.rb
 - spec/token_spec.rb
 - spec/string_spec.rb
 - spec/action_spec.rb
+- spec/basic_data_spec.rb
 - spec/array_spec.rb
 - spec/client_spec.rb
 - spec/item_spec.rb