ruby-trello 2.3.1 → 3.0.0

data/lib/trello/organization.rb

@@ -11,13 +11,60 @@ module Trello
   #   @return [String]
   # @!attribute [r] url
   #   @return [String]
+  # @!attribute [r] team_type
+  #   @return [String]
+  # @!attribute [r] desc_data
+  #   @return [String]
+  # @!attribute [r] logo_hash
+  #   @return [String]
+  # @!attribute [r] logo_url
+  #   @return [String]
+  # @!attribute [r] power_ups
+  #   @return [Array]
+  # @!attribute [r] website
+  #   @return [String]
+  # @!attribute [w] google_app_domain
+  #   @return [String]
+  # @!attribute [w] google_app_version
+  #   @return [String]
+  # @!attribute [w] enable_add_external_members
+  #   @return [Boolean]
+  # @!attribute [w] private_board_creation_permission_level
+  #   @return [String]
+  # @!attribute [w] organization_visible_board_creation_permission_level
+  #   @return [String]
+  # @!attribute [w] public_board_creation_permission_level
+  #   @return [String]
+  # @!attribute [w] visibility_level
+  #   @return [String]
   class Organization < BasicData
-    register_attributes :id, :name, :display_name, :description, :url, :invited,
-      :website, :logo_hash, :billable_member_count, :active_billable_member_count,
-      :memberships,
-      readonly: [ :id, :name, :display_name, :description, :url, :invited,
-        :website, :logo_hash, :billable_member_count, :active_billable_member_count,
-        :memberships ]
+    schema do
+      # Readonly
+      attribute :id, readonly: true, primary_key: true
+      attribute :team_type, readonly: true, remote_key: 'teamType'
+      attribute :url, readonly: true
+      attribute :desc_data, readonly: true, remote_key: 'descData'
+      attribute :logo_hash, readonly: true, remote_key: 'logoHash'
+      attribute :logo_url, readonly: true, remote_key: 'logoUrl'
+      attribute :products, readonly: true
+      attribute :power_ups, readonly: true, remote_key: 'powerUps'
+
+      # Writable
+      attribute :name
+      attribute :display_name, remote_key: 'displayName'
+      attribute :description, remote_key: 'desc'
+      attribute :website
+
+      # Writable but update only
+      attribute :google_app_domain, update_only: true, remote_key: 'associatedDomain', class_name: 'BoardPref'
+      attribute :google_app_version, update_only: true, remote_key: 'googleAppsVersion ', class_name: 'BoardPref'
+      attribute :enable_add_external_members, update_only: true, remote_key: 'externalMembersDisabled', class_name: 'BoardPref'
+      attribute :private_board_creation_permission_level, update_only: true, remote_key: 'boardVisibilityRestrict/private', class_name: 'BoardPref'
+      attribute :organization_visible_board_creation_permission_level, update_only: true, remote_key: 'boardVisibilityRestrict/org', class_name: 'BoardPref'
+      attribute :public_board_creation_permission_level, update_only: true, remote_key: 'boardVisibilityRestrict/public', class_name: 'BoardPref'
+      attribute :visibility_level, update_only: true, remote_key: 'permissionLevel ', class_name: 'BoardPref'
+    end
+
     validates_presence_of :id, :name
 
     include HasActions
@@ -29,25 +76,6 @@ module Trello
       end
     end
 
-    # Update the fields of an organization.
-    #
-    # Supply a hash of string keyed data retrieved from the Trello API representing
-    # an Organization.
-    def update_fields(fields)
-      attributes[:id]                           = fields['id'] || attributes[:id]
-      attributes[:name]                         = fields['name'] || attributes[:name]
-      attributes[:display_name]                 = fields['displayName'] || attributes[:display_name]
-      attributes[:description]                  = fields['desc'] || attributes[:description]
-      attributes[:url]                          = fields['url'] || attributes[:url]
-      attributes[:invited]                      = fields['invited'] if fields.has_key?('invited')
-      attributes[:website]                      = fields['website'] || attributes[:website]
-      attributes[:logo_hash]                    = fields['logoHash'] || attributes[:logo_hash]
-      attributes[:billable_member_count]        = fields['billableMemberCount'] || attributes[:billable_member_count]
-      attributes[:active_billable_member_count] = fields['activeBillableMemberCount'] || attributes[:active_billable_member_count]
-      attributes[:memberships]                  = fields['memberships'] || attributes[:memberships]
-      self
-    end
-
     # Returns a list of boards under this organization.
     def boards
       boards = Board.from_response client.get("/organizations/#{id}/boards/all")

data/lib/trello/plugin_datum.rb

@@ -3,32 +3,27 @@ module Trello
   #
   # @!attribute id
   #   @return [String]
-  # @!attribute idPlugin
+  # @!attribute plugin_id
   #   @return [String]
   # @!attribute scope
   #   @return [String]
-  # @!attribute idModel
+  # @!attribute model_id
   #   @return [String]
   # @!attribute value
   #   @return [String]
   # @!attribute access
   #   @return [String]
-    class PluginDatum < BasicData
-    # Update the fields of a plugin.
-    register_attributes :id, :idPlugin, :scope, :idModel, :value, :access
+  class PluginDatum < BasicData
 
-
-    # Supply a hash of stringkeyed data retrieved from the Trello API representing
-    # an attachment.
-    def update_fields(fields)
-      attributes[:id]        = fields['id'] || attributes[:id]
-      attributes[:idPlugin]  = fields['idPlugin'] || attributes[:idPlugin]
-      attributes[:scope]     = fields['scope'] || attributes[:scope]
-      attributes[:value]     = JSON.parse(fields['value']).presence if fields.has_key?('value')
-      attributes[:idModel]   = fields['idModel'] || attributes[:idModel]
-      attributes[:access]    = fields['access'] || attributes[:access]
-      self
+    schema do
+      attribute :id, readonly: true
+      attribute :plugin_id, readonly: true, remote_key: 'idPlugin'
+      attribute :scope, readonly: true
+      attribute :model_id, readonly: true, remote_key: 'idModel'
+      attribute :value, readonly: true, remote_key: 'value'
+      attribute :access, readonly: true
     end
+
   end
 
 end

data/lib/trello/schema.rb

@@ -0,0 +1,31 @@
+module Trello
+  class Schema
+    module Attribute
+      autoload :Base, 'trello/schema/attribute/base'
+      autoload :Default, 'trello/schema/attribute/default'
+      autoload :BoardPref, 'trello/schema/attribute/board_pref'
+      autoload :CustomFieldDisplay, 'trello/schema/attribute/custom_field_display'
+    end
+
+    module Serializer
+      autoload :Default, 'trello/schema/serializer/default'
+      autoload :Time, 'trello/schema/serializer/time'
+      autoload :Labels, 'trello/schema/serializer/labels'
+      autoload :Webhooks, 'trello/schema/serializer/webhooks'
+    end
+
+    autoload :AttributeBuilder, 'trello/schema/attribute_builder'
+    autoload :AttributeRegistration, 'trello/schema/attribute_registration'
+
+    attr_reader :attrs
+
+    def initialize
+      @attrs = ActiveSupport::HashWithIndifferentAccess.new
+    end
+
+    def attribute(name, options={})
+      @attrs[name] = AttributeBuilder.build(name, options)
+      self
+    end
+  end
+end

data/lib/trello/schema/attribute/base.rb

@@ -0,0 +1,79 @@
+module Trello
+  class Schema
+    module Attribute
+      class Base
+
+        attr_reader :name, :options, :serializer
+
+        def initialize(name:, options:, serializer:)
+          @name = name.to_sym
+          @options = options || {}
+          @serializer = serializer
+        end
+
+        def build_attributes(params, attributes)
+          raise 'Need override'
+        end
+
+        def build_pending_update_attributes(params, attributes)
+          params = params.with_indifferent_access
+
+          return attributes unless params.key?(remote_key) || params.key?(name)
+
+          build_attributes(params, attributes)
+        end
+
+        def build_payload_for_create(attributes, payload)
+          raise 'Need override'
+        end
+
+        def build_payload_for_update(attributes, payload)
+          raise 'Need override'
+        end
+
+        def readonly?
+          options[:readonly] == true
+        end
+
+        def update_only?
+          options[:update_only] == true
+        end
+
+        def create_only?
+          options[:create_only] == true
+        end
+
+        def primary_key?
+          return false unless options.key?(:primary_key)
+
+          options[:primary_key] 
+        end
+
+        def for_action?(action)
+          case action
+          when :create
+            create_only? || (!update_only? && !readonly? && !primary_key?)
+          when :update
+            update_only? || primary_key? || (!create_only? && !readonly?)
+          else
+            false
+          end
+        end
+
+        def remote_key
+          (options[:remote_key] || name).to_s
+        end
+
+        def default
+          return nil unless options.key?(:default)
+
+          options[:default]
+        end
+
+        def register(model_klass)
+          AttributeRegistration.register(model_klass, self)
+        end
+      end
+    end
+  end
+end

data/lib/trello/schema/attribute/board_pref.rb

@@ -0,0 +1,45 @@
+module Trello
+  class Schema
+    module Attribute
+      class BoardPref < Base
+
+        def build_attributes(params, attributes)
+          attrs = attributes.with_indifferent_access
+          params = params.with_indifferent_access
+
+          value = if params.key?(:prefs)
+                    params[:prefs][remote_key]
+                  else
+                    params[name]
+                  end
+
+          attrs[name] = serializer.deserialize(value, default)
+          attrs
+        end
+
+        def build_payload_for_create(attributes, payload)
+          payload ||= {}
+          return payload unless for_action?(:create)
+          return payload unless attributes.key?(name)
+
+          value = attributes[name]
+          return payload if value.nil?
+
+          payload["prefs_#{remote_key}"] = serializer.serialize(value)
+          payload
+        end
+
+        def build_payload_for_update(attributes, payload)
+          payload ||= {}
+          return payload unless for_action?(:update)
+          return payload unless attributes.key?(name)
+
+          value = attributes[name]
+          payload["prefs/#{remote_key}"] = serializer.serialize(value)
+          payload
+        end
+
+      end
+    end
+  end
+end

data/lib/trello/schema/attribute/custom_field_display.rb

@@ -0,0 +1,45 @@
+module Trello
+  class Schema
+    module Attribute
+      class CustomFieldDisplay < Base
+
+        def build_attributes(params, attributes)
+          attrs = attributes.with_indifferent_access
+          params = params.with_indifferent_access
+
+          value = if params.key?(:display)
+                    params[:display][remote_key]
+                  else
+                    params[name]
+                  end
+
+          attrs[name] = serializer.deserialize(value, default)
+          attrs
+        end
+
+        def build_payload_for_create(attributes, payload)
+          payload ||= {}
+          return payload unless for_action?(:create)
+          return payload unless attributes.key?(name)
+
+          value = attributes[name]
+          return payload if value.nil?
+
+          payload["display_#{remote_key}"] = serializer.serialize(value)
+          payload
+        end
+
+        def build_payload_for_update(attributes, payload)
+          payload ||= {}
+          return payload unless for_action?(:update)
+          return payload unless attributes.key?(name)
+
+          value = attributes[name]
+          payload["display/#{remote_key}"] = serializer.serialize(value)
+          payload
+        end
+
+      end
+    end
+  end
+end

data/lib/trello/schema/attribute/default.rb

@@ -0,0 +1,45 @@
+module Trello
+  class Schema
+    module Attribute
+      class Default < Base
+
+        def build_attributes(params, attributes)
+          attrs = attributes.with_indifferent_access
+          params = params.with_indifferent_access
+
+          value = if params.key?(remote_key)
+                    params[remote_key]
+                  else
+                    params[name]
+                  end
+
+          attrs[name] = serializer.deserialize(value, default)
+          attrs
+        end
+
+        def build_payload_for_create(attributes, payload)
+          payload ||= {}
+          return payload unless for_action?(:create)
+          return payload unless attributes.key?(name)
+
+          value = attributes[name]
+          return payload if value.nil?
+
+          payload[remote_key] = serializer.serialize(value)
+          payload
+        end
+
+        def build_payload_for_update(attributes, payload)
+          payload ||= {}
+          return payload unless for_action?(:update)
+          return payload unless attributes.key?(name)
+
+          value = attributes[name]
+          payload[remote_key] = serializer.serialize(value)
+          payload
+        end
+
+      end
+    end
+  end
+end

data/lib/trello/schema/attribute_builder.rb

@@ -0,0 +1,42 @@
+module Trello
+  class Schema
+    class AttributeBuilder
+      class << self
+        def build(name, options = {})
+          new(name, options).build
+        end
+      end
+
+      attr_reader :name, :options
+
+      def initialize(name, options)
+        @name = name
+        @options = options
+      end
+
+      def build
+        attribute_class.new(
+          name: name,
+          options: options,
+          serializer: serializer
+        )
+      end
+
+      private
+
+      def attribute_class
+        class_name = options.delete(:class_name)
+        return Schema::Attribute::Default unless class_name
+
+        "Trello::Schema::Attribute::#{class_name}".constantize
+      end
+
+      def serializer
+        serializer_class_name = options.delete(:serializer)
+        return Schema::Serializer::Default unless serializer_class_name
+
+        "Trello::Schema::Serializer::#{serializer_class_name}".constantize
+      end
+    end
+  end
+end

data/lib/trello/schema/attribute_registration.rb

@@ -0,0 +1,47 @@
+module Trello
+  class Schema
+    class AttributeRegistration
+      class << self
+        def register(klass, attribute)
+          new(klass, attribute).register
+        end
+      end
+
+      attr_reader :klass, :attribute
+
+      def initialize(klass, attribute)
+        @klass = klass
+        @attribute = attribute
+      end
+
+      def register
+        define_getter
+        define_setter
+      end
+
+      private
+
+      def define_getter
+        attribute_name = attribute.name
+
+        klass.class_eval do
+          define_method(attribute_name) { @__attributes[attribute_name] }
+        end
+      end
+
+      def define_setter
+        return if attribute.readonly?
+
+        attribute_name = attribute.name
+
+        klass.class_eval do
+          define_method("#{attribute_name}=") do |value|
+            send("#{attribute_name}_will_change!") if value != @__attributes[attribute_name]
+            @__attributes[attribute_name] = value
+          end
+        end
+      end
+
+    end
+  end
+end