ecoportal-api-v2 0.8.5 → 0.8.9

data/lib/ecoportal/api/v2/page/component/selection_field.rb

@@ -4,11 +4,22 @@ module Ecoportal
       class Page
         class Component
           class SelectionField < Page::Component
-            passthrough :multiple, :flat
-            passthrough :other, :other_desc
+            passboolean :multiple, :flat, :other
+            passthrough :other_desc
+            passthrough :data_type
 
             embeds_many :options, klass: "Ecoportal::API::V2::Page::Component::SelectionOption", order_key: :weight
 
+            def numeric!(&block)
+              ordered_options.each {|opt| opt.numeric!(&block)}
+              self.data_type = "num"
+            end
+
+            def text!(&block)
+              ordered_options.each {|opt| opt.text!(&block)}
+              self.data_type = "str"
+            end
+
             def select(value)
               opt = options.find {|opt| opt.value == value}
               sel = selected
@@ -33,8 +44,8 @@ module Ecoportal
               end
             end
 
-            def add_option(name:, value:, pos: NOT_USED, before: NOT_USED, after: NOT_USED)
-              opt_doc = options.items_class.new_doc              
+            def add_option(value:, name: nil, pos: NOT_USED, before: NOT_USED, after: NOT_USED)
+              opt_doc = options.items_class.new_doc
               options.upsert!(opt_doc, pos: pos, before: before, after: after) do |option|
                 option.name  = name
                 option.value = value
@@ -52,8 +63,64 @@ module Ecoportal
               end.map(&:first)
             end
 
+            # Quick config helper
+            # @param conf [Symbol, Array<Symbol>]
+            #   - `:flat` to display in flat mode
+            #   - `:multiple` to allow multiple selection
+            #   - `:single` to set to singular selection
+            #   - `:other` to enable `other` button
+            #   - `:options` to add options (`Hash<value, name>`)
+            #   - `:type` to define the type
+            #     - `:num`
+            #     - `:str`
+            def configure(*conf)
+              conf.each_with_object([]) do |cnf, unused|
+                case cnf
+                when :flat
+                  self.flat  = true
+                when :multiple
+                  self.multiple = true
+                when :single
+                  self.multiple = false
+                when :other
+                  self.other = true
+                when Hash
+                  supported = [:flat, :options, :type]
+                  unless (rest = hash_except(cnf.dup, *supported)).empty?
+                    unused.push(rest)
+                  end
+
+                  if cnf.key?(:flat) then self.flat = cnf[:flat] end
+                  if cnf.key?(:options)
+                    if opts = cnf[:options]
+                      configure_options opts
+                    end
+                  end
+                  if cnf.key?(:type)
+                    if cnf[:type] == :str
+                      self.text!
+                    elsif cnf[:type] == :num
+                      self.numeric!
+                    else
+                      # Unknown type
+                    end
+                  end
+                else
+                  unused.push(cnf)
+                end
+              end.yield_self do |unused|
+                super(*unused)
+              end
+            end
+
             private
 
+            def configure_options(opts)
+              opts.each do |val, nm|
+                add_option(value: val, name: nm)
+              end
+            end
+
             def fix_option_weights!
               ordered_options.each_with_index do |option, index|
                 option.weight = index

data/lib/ecoportal/api/v2/page/component/selection_option.rb

@@ -4,7 +4,7 @@ module Ecoportal
       class Page
         class Component
           class SelectionOption < Common::Content::DoubleModel
-            
+
             class << self
               def new_doc
                 {
@@ -16,7 +16,17 @@ module Ecoportal
 
             passkey     :id
             passthrough :patch_ver, :name, :value
-            passthrough :weight, :selected
+            passthrough :weight
+            passboolean :selected
+
+            def numeric!
+              self.value = block_given?? yield(value) : value.to_i
+            end
+
+            def text!
+              self.value = block_given?? yield(value) : value.to_s
+            end
+
           end
         end
       end

data/lib/ecoportal/api/v2/page/component/tag_field.rb

@@ -4,8 +4,38 @@ module Ecoportal
       class Page
         class Component
           class TagField < Page::Component
-            passthrough :single_select, :use_defaults
+            passboolean :single_select, :use_defaults
             passthrough :tag_tree_id, :button_text
+
+            # Quick config helper
+            # @param conf [Symbol, Array<Symbol>]
+            #   - `:multiple` to allow multiple selection
+            #   - `:single` to set to singular selection
+            #   - `:default_tag` to prepopulate using users's `default_tag`
+            #   - `:button_text` to define the button description
+            def configure(*conf)
+              conf.each_with_object([]) do |cnf, unused|
+                case cnf
+                when :single
+                  self.single_select = true
+                when :multiple
+                  self.single_select = false
+                when :default_tag
+                  self.use_defaults = true
+                when Hash
+                  supported = [:button_text]
+                  unless (rest = hash_except(cnf.dup, *supported)).empty?
+                    unused.push(rest)
+                  end
+                  if cnf.key?(:button_text) then self.button_text = cnf[:button_text] end
+                else
+                  unused.push(cnf)
+                end
+              end.yield_self do |unused|
+                super(*unused)
+              end
+            end
+
           end
         end
       end

data/lib/ecoportal/api/v2/page/components.rb

@@ -13,6 +13,12 @@ module Ecoportal
 
           order_matters = true
 
+          def get_by_id(id)
+            self.find do |comp|
+              comp.id == id
+            end
+          end
+
           def get_by_type(type)
             self.select do |comp|
               comp.type.downcase == type.to_s.strip.downcase
@@ -21,10 +27,9 @@ module Ecoportal
 
           def get_by_name(name, type: nil)
             pool = type ? get_by_type(type) : self
-
             pool.select do |comp|
-              comp.label.to_s.strip.downcase == name.to_s.strip.downcase
-            end.first
+              same_string?(comp.label, name)
+            end
           end
 
           def add(label:, type:)

data/lib/ecoportal/api/v2/page/permission_flags.rb

@@ -0,0 +1,67 @@
+module Ecoportal
+  module API
+    class V2
+      class Page
+        class PermissionFlags < Common::Content::DoubleModel
+          class << self
+            def new_doc
+              {
+                "can_restructure"          => false,
+                "can_configure"            => false,
+                "can_permission"           => false,
+                "can_create_actions"       => false,
+                "can_administrate_actions" => false,
+                "subscribed"               => false,
+                "subscribed_to_tasks"      => false
+              }
+            end
+          end
+
+          passboolean :can_restructure, :can_configure
+          passboolean :can_permission, :can_create_actions, :can_administrate_actions
+          passboolean :subscribed, :subscribed_to_tasks
+
+          def reset!
+            doc.merge!(self.class.new_doc)
+          end
+
+          # Quick config helper
+          # @param conf [Symbol, Array<Symbol>]
+          #   - `:restructure`
+          #   - `:configure`
+          #   - `:can_permission`
+          #   - `:create_actions`
+          #   - `:admin_actions`
+          #   - `:subscribed`
+          #   - `:subscribed_to_tasks`
+          def configure(*conf)
+            conf.each_with_object([]) do |cnf, unused|
+              case cnf
+              when :restructure
+                self.can_restructure = true
+              when :configure
+                self.can_configure  = true
+              when :can_permission
+                self.can_permission = true
+              when :create_actions
+                self.can_create_actions = true
+              when :admin_actions
+                self.can_administrate_actions = true
+              when :subscribed
+                self.subscribed = true
+              when :subscribed_to_tasks
+                self.subscribed_to_tasks = true
+              else
+                unused.push(cnf)
+              end
+            end.yield_self do |unused|
+              raise "Unknown configuaration options #{unused}" unless unused.empty?
+            end
+
+          end
+
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/v2/page/permit.rb

@@ -0,0 +1,14 @@
+module Ecoportal
+  module API
+    class V2
+      class Page
+        class Permit < Common::Content::DoubleModel
+          passkey     :id
+          passthrough :patch_ver
+          passthrough :user_id, :user_name
+          passthrough :editable, :flags
+        end
+      end
+    end
+  end
+end

data/lib/ecoportal/api/v2/page/section.rb

@@ -8,7 +8,7 @@ module Ecoportal
               {
                 "id"     => new_uuid,
                 "type"   => split ? "split" : "content",
-                "weight" => 9999
+                "weight" => 800
               }.tap do |out|
                 component_ids = if split
                     {
@@ -44,10 +44,70 @@ module Ecoportal
             all_component_ids.include?(id)
           end
 
-          def components
-            fld_ids = all_component_ids
-            root.components.values_at(*fld_ids).select.with_index do |fld, i|
-              puts "Warning: field #{id} points to missing field #{fld_ids[i]}" if !fld
+          def components(side: nil)
+            case side
+            when :right
+              components_right
+            when :left
+              components_left
+            when NilClass
+              components_by_id(*all_component_ids)
+            else
+              raise "Side should be one of [nil, :right, :left]. Given: #{side}"
+            end
+          end
+
+          def components_left
+            raise "You are trying to retrieve side components in a Split Section" unless split?
+            components_by_id(*left_component_ids)
+          end
+
+          def components_right
+            raise "You are trying to retrieve side components in a Split Section" unless split?
+            components_by_id(*right_component_ids)
+          end
+
+          # Adds `field` to the section
+          # @note
+          #   - To the specified `side`, when split section (default `:left`)
+          #   - To the end if `after` is not specified
+          #   - If `after` is specified, it searches field
+          #     - On the specific `side`, if specified (and split section)
+          #     - And adds the `field` after it, when found, or at the end if `after` is not found
+          # @param field [Ecoportal::API::V2::Page::Component] the field to be added.
+          def add_component(field, after: nil, side: nil)
+            raise "field should be a Ecoportal::API::V2::Page::Component. Given: #{field.class}" unless field.is_a?(Ecoportal::API::V2::Page::Component)
+            if field.section == self
+              raise "Field with id '#{field.id}' already belongs to this section"
+            elsif sec = field.section
+              # Field belongs to another section
+              raise "Field with id '#{field.id}' belongs to section '#{sec.heading || "Unnamed"}' (id: '#{sec.id}')"
+            end
+
+            if split?
+              ids_ary = side == :right ? right_component_ids : left_component_ids
+              fields  = components(side: side || :left)
+            else
+              ids_ary = component_ids
+              fields  = components
+            end
+            if after
+              after_fld = fields.find do |fld|
+                found   = nil
+                found ||= !!after if after.is_a?(Ecoportal::API::V2::Page::Component)
+                found ||= fld.id == after
+                found ||= same_string?(fld.label, after)
+              end
+            end
+            ids_ary.insert_one(field.id, after: after_fld&.id)
+            self
+          end
+
+          private
+
+          def components_by_id(*ids)
+            root.components.values_at(*ids).select.with_index do |fld, i|
+              puts "Warning: field id #{ids[i]} points to missing field" if !fld
               fld && (!block_given? || yield(fld))
             end
           end

data/lib/ecoportal/api/v2/page/sections.rb

@@ -7,26 +7,84 @@ module Ecoportal
 
           self.klass = :section_class
 
+          # Creates a new `section`
           def add(name: nil, split: false, pos: NOT_USED, before: NOT_USED, after: NOT_USED)
             sec_doc = section_class.new_doc(split: split)
-            upsert!(sec_doc, pos: pos, before: before, after: after) do |section|
+            upsert!(sec_doc) do |section| #, pos: pos, before: before, after: after) do |section|
               section.heading  = name
-              if prev = previous_section(section)
-                section.weight = prev.weight
+              if weight = scope_weight(pos: pos, before: before, after: after)
+                section.weight = weight
               end
+              fix_weights!
               yield(section) if block_given?
-              #fix_weights! # a server bug prevents to set the weight of existing sections
             end
           end
 
+          def get_by_type(type)
+            ordered.select do |sec|
+              sec.type == type
+            end
+          end
+
+          def get_by_heading(heading)
+            ordered.select do |sec|
+              value = heading == :unnamed ? nil : heading
+              same_string?(sec.heading, value)
+            end
+          end
+
+          # Gets all the sections between `sec1` and `sec2`
+          def between(sec1, sec2, included: false)
+            sorted_secs = ordered
+            pos1 = (sec1 = to_section(sec1)) && sorted_secs.index(sec1)
+            pos2 = (sec2 = to_section(sec2)) && sorted_secs.index(sec2)
+            if included
+              pos1 = pos1 ? pos1 : 0
+              pos2 = pos2 ? pos2 : -1
+            else
+              pos1 = pos1 ? (pos1 + 1) : 0
+              pos2 = pos2 ? (pos2 - 1) : -1
+            end
+            sorted_secs[pos1..pos2]
+          end
+
+          # Gets the sections ordered by `weight` (as they appear in the page)
           def ordered
-            each_with_index.sort_by do |section, index|
+            self.sort_by.with_index do |section, index|
               (section.weight >= 9999) ? [index, index] : [section.weight, index]
-            end.map(&:first)
+            end
           end
 
           private
 
+          def scope_weight(pos: NOT_USED, before: NOT_USED, after: NOT_USED)
+            case
+            when used_param?(pos)
+              if pos    = to_section(pos)
+                pos.weight - 1
+              end
+            when used_param?(before)
+              if before = to_section(before)
+                before.weight - 1
+              end
+            when used_param?(after)
+              if after  = to_section(after)
+                after.weight
+              end
+            end
+          end
+
+          def to_section(value)
+            case value
+            when Ecoportal::API::V2::Page::Section
+              value
+            when Numeric
+              ordered[value]
+            else
+              get_by_heading(value).first
+            end
+          end
+
           def fix_weights!
             ordered.each_with_index do |section, index|
               section.weight = index