researchable-freedcamp-api 0.1.4 → 0.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 628dfc362e3b0422af518b3f795d52e1f352ba3a5f598b290eefba123f113fae
-  data.tar.gz: 567d22064d71fc1de66ddf277cdc11c4a96477c30a7b068e5f6ce0d8d733938b
+  metadata.gz: 11f12801b1a72e9d12e6b00df889dcc75a94b1a4575faa8b50ec2930165ee1e6
+  data.tar.gz: 0bfd8c06d163eb9e5a4c822ad6dde5d06128ef76ec7b311cdbc0958c716a6331
 SHA512:
-  metadata.gz: 310a4dfd7749bd82b39d3c0d1a74e78437163ef7774107a5e85a74b50e0937decf9c8e3c393c370869eed30d65a2fde16518de876f8e0167f78218a04c1553f8
-  data.tar.gz: '08c08e707a1f4a6635396c5693375b84341724ad0d70279a2804873342da547bac9e688052341cdea84e3cba2556cd151ccd4b9d3c5c452b3bb5a7f743117725'
+  metadata.gz: 0c80ecb8f21cc98e516c2df31be6183cfb317f732a6ce711ac286118e092b7b1083795bafdcd203494489e3b08c0828c94386bbfd20fd6b982bfbae95ce3f451
+  data.tar.gz: 155b549f426c4fce1e0f2d56208361f5488082a6b3d07196b169a8ad09ec7c79aa51c357fae40abd9b41d0e65aedb5db761572ce739477a08231432442ef0e4e

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_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
-          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.4"
+    VERSION = "0.1.7"
   end
 end

data/lib/researchable/freedcamp_api.rb

@@ -3,14 +3,24 @@
 
 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_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.4
+  version: 0.1.7
 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,15 @@ 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_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