researchable-freedcamp-api 0.1.5 → 0.1.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2d6398adf94a5758f1c681b5caf7d3c248c633b168fc87c1a88482bfdd50c342
-  data.tar.gz: 8c4373be602047f6b7b1598d72874ae17a56c868925af170fa27fe3012bb8cba
+  metadata.gz: 77bb6dfffc6fce9c8d4a7636182781955b49b11f1507d0d50dc8974eb88ba7fa
+  data.tar.gz: 7a0fbb253039d096f2bc282e5363ba53f433132b02dec6f555891cdc9067ab4e
 SHA512:
-  metadata.gz: 7bd7e119a09f433a96fbc6088ecd42d6a9d0f6da48697f89ac3aa7f176725d46ffbf318dde386b0ee602d1d6f7378c3884a645cb239fd49b58e544352493a56c
-  data.tar.gz: f7c3a264ad3587c419e63232480c2ec74556bf8b8d8d07118761511fbe7eaa0933dbb669520b7d773b5477bbbd80226c79d7dd101401d2650ec2a1b719cf4469
+  metadata.gz: 34ff2ec76464026a977b6dedb4cbf5b99b8f411ce5fcd504cb89c4de5d5ddbc1017210dbd93cdbe6a87d7340f897c9d812031f8026fd2fcd2ceb181c990363ce
+  data.tar.gz: '09bcc82ef7455a191b7cc20dc8ee5fba4c0acac1285e4ff918606466de3dad4595d167610ca52588d893043d53dd64e2d71a2e17611952c0a4ed1eefd6f1e25c'

data/lib/researchable/freedcamp_api/constants.rb

@@ -0,0 +1,33 @@
+# typed: strict
+# frozen_string_literal: true
+
+module Researchable
+  module FreedcampApi
+    APP_WALL = 1
+    APP_TODOS = 2
+    APP_DISCUSSIONS = 3
+    APP_MILESTONES = 4
+    APP_TIME = 5
+    APP_FILES = 6
+    APP_INVOICES = 7
+    APP_BUGTRACKER = 13
+    APP_WIKI = 14
+    APP_CRM = 16
+    APP_PASSMAN = 17
+    APP_TASKY = 18
+    APP_CALENDAR = 19
+    APP_INVOICESPLUS = 20
+    MODULE_GDOCS = 21
+    MODULE_PROJ_CLONING = 22
+
+    PROGRESS_NO_PROGRESS = 0
+    PROGRESS_IN_PROGRESS = 2
+    PROGRESS_COMPLETED = 1
+
+    STATUS_NOT_STARTED = 0
+    STATUS_COMPLETED = 1
+    STATUS_IN_PROGRESS = 2
+    STATUS_INVALID = 3
+    STATUS_REVIEW = 4
+  end
+end

data/lib/researchable/freedcamp_api/endpoint.rb

@@ -23,7 +23,7 @@ module Researchable
 
         while has_more
           temp = yield limit, offset
-          has_more = T.let(temp.dig('data', 'meta', 'has_more') == 'true', T::Boolean)
+          has_more = T.let(temp.dig('data', 'meta', 'has_more') == true, T::Boolean)
           result += temp['data'][keyword]
           offset += limit
         end

data/lib/researchable/freedcamp_api/get_user.rb

@@ -0,0 +1,20 @@
+# typed: false
+module Researchable
+  module FreedcampApi
+    class GetUser < Endpoint
+      string :user_id, default: 'current'
+      # @api private
+      def execute
+        get_user(user_id)
+      end
+
+      #sig do
+        #params().returns(
+        #)
+      #end
+      def get_user(task_id)
+        session.get("/users/#{task_id}")['data']
+      end
+    end
+  end
+end

data/lib/researchable/freedcamp_api/list_discussions.rb

@@ -0,0 +1,28 @@
+# typed: false
+module Researchable
+  module FreedcampApi
+    class ListDiscussions < Endpoint
+      integer :discussion_id, default: nil
+      integer :project_id, default: nil
+
+      def execute
+        list_discussions(discussion_id)
+      end
+
+      # sig do
+      # params(
+      # task_id: T.nilable(Integer)
+      # ).returns(
+      # T::Array[Researchable::FreedcampApi::Structs::Task]
+      # )
+      # end
+      def list_discussions(discussion_id)
+        discussion_query = discussion_id ? "/#{discussion_id}" : '/'
+        project_query = project_id ? "?project_id=#{project_id}" : ''
+        url = "/discussions#{discussion_query}
+                  #{project_query}"
+        session.get(url)
+      end
+    end
+  end
+end

data/lib/researchable/freedcamp_api/list_lists.rb

@@ -0,0 +1,37 @@
+# typed: false
+module Researchable
+  module FreedcampApi
+    class ListLists < Endpoint
+      string :project_id, default: nil
+      integer :app_id, default: Researchable::FreedcampApi::APP_TODOS
+      # @api private
+      def execute
+        check_app_id(app_id)
+        list_lists(app_id, project_id)
+      end
+
+      private
+
+      def check_app_id(app_id)
+        return if allowed_apps.include? app_id
+
+        raise "app_id not allowed: #{app_id} not in #{allowed_apps}"
+      end
+
+      def allowed_apps
+        [APP_TODOS, APP_FILES, APP_DISCUSSIONS, APP_WIKI, APP_PASSMAN]
+      end
+
+      def list_lists(app_id, project_id)
+        project_id_query = project_id ? "&project_id=#{project_id}" : ''
+        fetch_all('lists') do |limit, offset|
+          url = "/lists/#{app_id}
+                  ?limit=#{limit}
+                  &offset=#{offset}
+                   #{project_id_query}"
+          session.get(url)
+        end
+      end
+    end
+  end
+end

data/lib/researchable/freedcamp_api/list_milestones.rb

@@ -1 +1,34 @@
-# typed: strict
+# typed: false
+module Researchable
+  module FreedcampApi
+    class ListMilestones < Endpoint
+      integer :milestone_id, default: nil
+      integer :project_id, default: nil
+      integer :f_cf, default: 1
+
+      def execute
+        list_milestones(milestone_id)
+      end
+
+      # sig do
+      # params(
+      # task_id: T.nilable(Integer)
+      # ).returns(
+      # T::Array[Researchable::FreedcampApi::Structs::Task]
+      # )
+      # end
+      def list_milestones(milestone_id)
+        milestone_query = milestone_id ? "/#{milestone_id}" : '/'
+        project_query = project_id ? "&project_id=#{project_id}" : ''
+        custom_fields_query = f_cf.nil? ? '' : "&f_cf=#{f_cf}"
+        fetch_all('milestones') do |limit, offset|
+          url = "/milestones#{milestone_query}?limit=#{limit}
+                  #{project_query}
+                  #{custom_fields_query}
+                   &offset=#{offset}"
+          session.get(url)
+        end
+      end
+    end
+  end
+end

data/lib/researchable/freedcamp_api/list_projects.rb

@@ -1 +1,33 @@
-# typed: strict
+# typed: false
+module Researchable
+  module FreedcampApi
+    class ListProjects < Endpoint
+      integer :project_id, default: nil
+      integer :f_with_archived, default: 1
+
+      # Accepts "active", "archived", "all" values. Omitting is equal to "active".
+      string :lists_status, default: 'active'
+      integer :f_cf, default: 1
+
+      # @api private
+      def execute
+        list_projects(project_id)
+      end
+
+      # sig do
+      # params(
+      # project_id: T.nilable(Integer)
+      # ).returns(
+      # T::Array[Researchable::FreedcampApi::Structs::Task]
+      # )
+      # end
+      def list_projects(project_id)
+        project_query = project_id ? "/#{project_id}" : '/'
+        fetch_all('projects') do |limit, offset|
+          session.get("/projects#{project_query}?limit=#{limit}
+                   &offset=#{offset}")
+        end
+      end
+    end
+  end
+end

data/lib/researchable/freedcamp_api/list_task_lists.rb

@@ -0,0 +1,40 @@
+# typed: false
+module Researchable
+  module FreedcampApi
+    class ListTasks < Endpoint
+      integer :project_id, default: nil
+      integer :f_with_archived, default: 1
+
+      # Accepts "active", "archived", "all" values. Omitting is equal to "active".
+      string :lists_status, default: 'active'
+      string :assigned_to_id, default: nil
+      integer :f_cf, default: 1
+
+      # @api private
+      def execute
+        list_tasks(task_id)
+      end
+
+      sig do
+        params(
+          task_id: T.nilable(Integer)
+        ).returns(
+          T::Array[Researchable::FreedcampApi::Structs::Task]
+        )
+      end
+      def list_tasks(task_id)
+        task_query = task_id ? "/#{task_id}" : '/'
+        assigned_to_id_query = assigned_to_id ? "&assigned_to_id[]=#{assigned_to_id}" : ''
+        fetch_all('tasks') do |limit, offset|
+          url = "/tasks#{task_query}?limit=#{limit}
+                   &offset=#{offset}
+                   #{assigned_to_id_query}
+                   &f_with_archived=#{f_with_archived}
+                   &f_cf=#{f_cf}
+                   &lists_status=#{lists_status}"
+          session.get(url)
+        end
+      end
+    end
+  end
+end

data/lib/researchable/freedcamp_api/list_tasks.rb

@@ -3,11 +3,14 @@ module Researchable
   module FreedcampApi
     class ListTasks < Endpoint
       integer :task_id, default: nil
-      integer :f_with_archived, default: 1
+      integer :f_with_archived, default: 0
+      array :status, default: []
 
       # Accepts "active", "archived", "all" values. Omitting is equal to "active".
       string :lists_status, default: 'active'
+      string :assigned_to_id, default: nil
       integer :f_cf, default: 1
+      boolean :include_subtasks, default: true
 
       # @api private
       def execute
@@ -23,13 +26,24 @@ module Researchable
       end
       def list_tasks(task_id)
         task_query = task_id ? "/#{task_id}" : '/'
-        fetch_all('tasks') do |limit, offset|
-          session.get("/tasks#{task_query}?limit=#{limit}
+        assigned_to_id_query = assigned_to_id ? "&assigned_to_id[]=#{assigned_to_id}" : ''
+        f_with_archived_query = f_with_archived ? "&f_with_archived=#{f_with_archived}" : ''
+        status_query = status.reduce('') { |tot, cur| "#{tot}&status[]=#{cur}" }
+        # status[]=&status[]=2
+        tasks = fetch_all('tasks') do |limit, offset|
+          url = "/tasks#{task_query}?limit=#{limit}
                    &offset=#{offset}
-                   &f_with_archived=#{f_with_archived}
+                   #{assigned_to_id_query}
+                   #{f_with_archived_query}
+                   #{status_query}
                    &f_cf=#{f_cf}
-                   &lists_status=#{lists_status}")
+                   &lists_status=#{lists_status}"
+          session.get(url)
         end
+
+        return tasks if include_subtasks
+
+        tasks.select { |task| task['h_top_id'].blank? }
       end
     end
   end

data/lib/researchable/freedcamp_api/sessions/signed_session.rb

@@ -23,16 +23,13 @@ module Researchable
         sig { returns(String) }
         attr_reader :secret_key
 
-        sig { returns(T::Boolean) }
-        attr_reader :use_cache
-
         # rubocop:enable Style/AccessorGrouping
 
-        sig { params(public_key: String, secret_key: String, use_cache: T::Boolean).void }
-        def initialize(public_key: ENV['PUBLIC_KEY'], secret_key: ENV['SECRET_KEY'], use_cache: ENV['USE_CACHE'])
+        sig { params(public_key: String, secret_key: String).void }
+        def initialize(public_key: ENV['PUBLIC_KEY'], secret_key: ENV['SECRET_KEY'])
           @public_key = public_key
           @secret_key = secret_key
-          @use_cache = use_cache == 'true'
+          @debug = false
         end
 
         sig { override.params(path: String).returns(T::Hash[T.untyped, T.untyped]) }
@@ -68,32 +65,21 @@ module Researchable
           ).returns(T::Hash[T.untyped, T.untyped])
         end
         def call_url(path, method, data = {})
-          cache_url = "output/#{Digest::SHA1.hexdigest(path + method.to_s)}"
-          content = if data == {} && File.exist?(cache_url) && @use_cache
-                      render_cache(cache_url)
-                    else
-                      render_call(path, method, data, cache_url)
-                    end
+          content = render_call(path, method, data)
 
           content = JSON.parse(content) if content
           content
         end
 
-        def render_cache(cache_url)
-          file = File.open(cache_url)
-          content = file.read
-        end
-
-        def render_call(path, method, data, cache_url)
+        def render_call(path, method, data)
           signature = generate_signature
           url = make_url(path, signature)
           data = serialize_data(data)
-          content = HTTParty.send(method,
-                                  url,
-                                  body: data,
-                                  headers: HEADERS).body
-          @use_cache && File.open(cache_url, 'w') { |f| f.write content }
-          content
+          puts url if @debug
+          HTTParty.send(method,
+                        url,
+                        body: data,
+                        headers: HEADERS).body
         end
 
         def serialize_data(data = {})
@@ -107,7 +93,10 @@ module Researchable
         def make_url(path, signature)
           result = BASE + path
           sep = result.include?('?') ? '&' : '?'
-          result + "#{sep}api_key=#{signature.api_key}&timestamp=#{signature.timestamp}&hash=#{signature.calculated_hash}"
+          result += "#{sep}api_key=#{signature.api_key}&timestamp=#{signature.timestamp}&hash=#{signature.calculated_hash}"
+          result = result.gsub(/\n\s+/, '')
+          puts result if @debug
+          result
         end
 
         sig { returns(Signature) }

data/lib/researchable/freedcamp_api/structs/task.rb

@@ -42,6 +42,9 @@ module Researchable
 
         const :status, T.nilable(Integer)
         const :status_title, T.nilable(String)
+
+        # Shows the top parent task id (so is equal to h_parent_id for subtasks with h_level=1, and differs for subtasks with h_level > 1). Is an empty string for top-level tasks.
+        const :h_top_id, T.nilable(String)
       end
     end
   end

data/lib/researchable/freedcamp_api/version.rb

@@ -3,6 +3,6 @@
 
 module Researchable
   module FreedcampApi
-    VERSION = "0.1.5"
+    VERSION = "0.1.8"
   end
 end

data/lib/researchable/freedcamp_api.rb

@@ -3,14 +3,25 @@
 
 require 'active_interaction'
 require_relative 'freedcamp_api/version'
+require_relative 'freedcamp_api/constants'
 require_relative 'freedcamp_api/structs'
 require_relative 'freedcamp_api/sessions'
 require_relative 'freedcamp_api/endpoint'
 
+require_relative 'freedcamp_api/list_projects'
+require_relative 'freedcamp_api/list_discussions'
+
+
 require_relative 'freedcamp_api/list_tasks'
 require_relative 'freedcamp_api/update_task'
 require_relative 'freedcamp_api/create_task'
 
+require_relative 'freedcamp_api/get_user'
+
+require_relative 'freedcamp_api/list_lists'
+
+require_relative 'freedcamp_api/list_milestones'
+
 require_relative 'freedcamp_api/create_comment'
 
 module Researchable

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: researchable-freedcamp-api
 version: !ruby/object:Gem::Version
-  version: 0.1.5
+  version: 0.1.8
 platform: ruby
 authors:
 - Frank Blaauw
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-01-28 00:00:00.000000000 Z
+date: 2022-02-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: active_interaction
@@ -126,11 +126,16 @@ files:
 - bin/setup
 - lib/researchable-freedcamp-api.rb
 - lib/researchable/freedcamp_api.rb
+- lib/researchable/freedcamp_api/constants.rb
 - lib/researchable/freedcamp_api/create_comment.rb
 - lib/researchable/freedcamp_api/create_task.rb
 - lib/researchable/freedcamp_api/endpoint.rb
+- lib/researchable/freedcamp_api/get_user.rb
+- lib/researchable/freedcamp_api/list_discussions.rb
+- lib/researchable/freedcamp_api/list_lists.rb
 - lib/researchable/freedcamp_api/list_milestones.rb
 - lib/researchable/freedcamp_api/list_projects.rb
+- lib/researchable/freedcamp_api/list_task_lists.rb
 - lib/researchable/freedcamp_api/list_tasks.rb
 - lib/researchable/freedcamp_api/sessions.rb
 - lib/researchable/freedcamp_api/sessions/session.rb