monday_ruby 0.4.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6f0e71a61ef39a418ca03c8151a357e3623f9c4a030c74cee613e4cefc8d684a
-  data.tar.gz: 2ab39c2856f63b1e72a9395630c43b92fd589b1790954b36791ed105f6e52362
+  metadata.gz: 9976cfcde08608cfe4106783b717d0c3fcc4c7b9851a3f994a3c7bd33493c437
+  data.tar.gz: bbaa8b1e58c3c1e2a73e50a797040c5828000a79e5efac05e43471109a26a51c
 SHA512:
-  metadata.gz: 65ad4b3eec9937e42fe5a2a811f7ccdc2caf3c17e4b38ede2b10a7be148519ec6a7e75d5b272fb86c33667be7309b2c51858f7e97563f147ca1f35d9adca1ac9
-  data.tar.gz: 41c14a6bd4c846d25701a19a7dadb775e379ac2a45b1967b3d97025301dfb1ccdbc5983c4efa6d78769f9daedfb9d3a9773fa976140816017d97308f128b4814
+  metadata.gz: 7a023ba0076f5cfebd1ca6e4708942afe37b7f75001ecab2126e676fa2338fce6e5ce232d3ab5ab5109301cba5fae1a0dfcd504c1db9a6de99b96587dacb7d17
+  data.tar.gz: 46f345126e55080fe842bfda28d0dc349848640fda23f4323832b973170534c41345410852d330ba3731f8f011fd65c6a5b4b975410313a3717973be343c12c5

data/.simplecov

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+SimpleCov.minimum_coverage 97

data/CHANGELOG.md

@@ -1,3 +1,26 @@
+## v0.6.0 (October 9, 2023)
+
+### Added
+
+- Support for working with subitems:
+  - Listing subitems
+  - Creating a subitem
+
+- Support for working with updates:
+  - Create an Update
+  - Like an Update
+  - Clear an item's updates
+  - Delete an update
+
+## v0.5.0 (September 21, 2023)
+
+### Added
+
+- Support for working with board groups:
+  - Reading, Creating, Deleting
+  - Archiving, Duplicating
+  - Moving an item to a group
+
 ## v0.4.0 (September 15, 2023)
 
 ### Added

data/lib/monday/error.rb

@@ -79,9 +79,9 @@ module Monday
   #
   # It is also raised when the body returns the following error_codes:
   #   InvalidUserIdException, InvalidVersionException, InvalidColumnIdException
-  #   InvalidItemIdException, InvalidBoardIdException, InvalidArgumentException
+  #   InvalidItemIdException, InvalidSubitemIdException, InvalidBoardIdException, InvalidArgumentException
   #   CreateBoardException, ItemsLimitationException, ItemNameTooLongException
-  #   ColumnValueException, CorrectedValueException
+  #   ColumnValueException, CorrectedValueException, InvalidGroupIdException
   class InvalidRequestError < Error
   end
 

data/lib/monday/resources/group.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+module Monday
+  module Resources
+    # Represents Monday.com's group resource.
+    module Group
+      DEFAULT_SELECT = %w[id title].freeze
+
+      # Retrieves all the groups.
+      #
+      # Allows filtering groups using the args option.
+      # Allows customizing the values to retrieve using the select option.
+      # By default, ID and title fields are retrieved.
+      def groups(args: {}, select: DEFAULT_SELECT)
+        query = "query { boards(#{Util.format_args(args)}) { groups{#{Util.format_select(select)}}}}"
+
+        make_request(query)
+      end
+
+      # Creates a new group.
+      #
+      # Allows customizing creating a group using the args option.
+      # Allows customizing the values to retrieve using the select option.
+      # By default, ID and title fields are retrieved.
+      def create_group(args: {}, select: DEFAULT_SELECT)
+        query = "mutation { create_group(#{Util.format_args(args)}) {#{Util.format_select(select)}}}"
+
+        make_request(query)
+      end
+
+      # Updates a group.
+      #
+      # Allows customizing updating the group using the args option.
+      # By default, returns the ID of the updated group.
+      def update_group(args: {}, select: ["id"])
+        query = "mutation { update_group(#{Util.format_args(args)}) {#{Util.format_select(select)}}}"
+
+        make_request(query)
+      end
+
+      # Deletes a group.
+      #
+      # Requires board_id and group_id in args option to delete the group.
+      # Allows customizing the values to retrieve using the select option.
+      # By default, returns the ID of the group deleted.
+      def delete_group(args: {}, select: ["id"])
+        query = "mutation { delete_group(#{Util.format_args(args)}) {#{Util.format_select(select)}}}"
+
+        make_request(query)
+      end
+
+      # Archives a group.
+      #
+      # Requires board_id and group_id in args option to archive the group.
+      # Allows customizing the values to retrieve using the select option.
+      # By default, returns the ID of the group archived.
+      def archive_group(args: {}, select: ["id"])
+        query = "mutation { archive_group(#{Util.format_args(args)}) {#{Util.format_select(select)}}}"
+
+        make_request(query)
+      end
+
+      # Duplicates a group.
+      #
+      # Requires board_id and group_id in args option to duplicate the group.
+      # Allows customizing the values to retrieve using the select option.
+      # By default, ID and title fields are retrieved.
+      def duplicate_group(args: {}, select: DEFAULT_SELECT)
+        query = "mutation { duplicate_group(#{Util.format_args(args)}) {#{Util.format_select(select)}}}"
+
+        make_request(query)
+      end
+
+      # Move item to group.
+      #
+      # Requires item_id and group_id in args option to move an item to a group.
+      # Allows customizing the values to retrieve using the select option.
+      # By default, ID and title fields are retrieved.
+      def move_item_to_group(args: {}, select: ["id"])
+        query = "mutation { move_item_to_group(#{Util.format_args(args)}) {#{Util.format_select(select)}}}"
+
+        make_request(query)
+      end
+    end
+  end
+end

data/lib/monday/resources/subitem.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Monday
+  module Resources
+    # Represents Monday.com's subitem resource.
+    module Subitem
+      DEFAULT_SELECT = %w[id name created_at].freeze
+
+      # Retrieves all the subitems for the item.
+      #
+      # Allows filtering subitems using the args option.
+      # Allows customizing the values to retrieve using the select option.
+      # By default, ID, name and created_at fields are retrieved.
+      def subitems(args: {}, select: DEFAULT_SELECT)
+        query = "query { items(#{Util.format_args(args)}) { subitems{#{Util.format_select(select)}}}}"
+
+        make_request(query)
+      end
+
+      # Creates a new subitem.
+      #
+      # Allows customizing the subitem creation using the args option.
+      # Allows customizing the values to retrieve using the select option.
+      # By default, ID, name and created_at fields are retrieved.
+      def create_subitem(args: {}, select: DEFAULT_SELECT)
+        query = "mutation { create_subitem(#{Util.format_args(args)}) {#{Util.format_select(select)}}}"
+
+        make_request(query)
+      end
+    end
+  end
+end

data/lib/monday/resources/update.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+module Monday
+  module Resources
+    # Represents Monday.com's update resource.
+    module Update
+      DEFAULT_SELECT = %w[id body created_at].freeze
+
+      # Retrieves all the updates.
+      #
+      # Allows filtering updates using the args option.
+      # Allows customizing the values to retrieve using the select option.
+      # By default, ID, body and created_at fields are retrieved.
+      def updates(args: {}, select: DEFAULT_SELECT)
+        query = "query { updates(#{Util.format_args(args)}) { #{Util.format_select(select)}}}"
+
+        make_request(query)
+      end
+
+      # Creates a new update.
+      #
+      # Allows customizing the update creation using the args option.
+      # Allows customizing the values to retrieve using the select option.
+      # By default, ID, body and created_at fields are retrieved.
+      def create_update(args: {}, select: DEFAULT_SELECT)
+        query = "mutation { create_update(#{Util.format_args(args)}) {#{Util.format_select(select)}}}"
+
+        make_request(query)
+      end
+
+      # Like an update.
+      #
+      # Allows customizing the update creation using the args option.
+      # Allows customizing the values to retrieve using the select option.
+      # By default, ID is retrieved.
+      def like_update(args: {}, select: %w[id])
+        query = "mutation { like_update(#{Util.format_args(args)}) {#{Util.format_select(select)}}}"
+
+        make_request(query)
+      end
+
+      # Clear an item's update
+      #
+      # Allows customizing the update creation using the args option.
+      # Allows customizing the values to retrieve using the select option.
+      # By default, ID is retrieved.
+      def clear_item_updates(args: {}, select: %w[id])
+        query = "mutation { clear_item_updates(#{Util.format_args(args)}) {#{Util.format_select(select)}}}"
+
+        make_request(query)
+      end
+
+      # Delete an update
+      #
+      # Allows customizing the update creation using the args option.
+      # Allows customizing the values to retrieve using the select option.
+      # By default, ID is retrieved.
+      def delete_update(args: {}, select: %w[id])
+        query = "mutation { delete_update(#{Util.format_args(args)}) {#{Util.format_select(select)}}}"
+
+        make_request(query)
+      end
+    end
+  end
+end

data/lib/monday/resources.rb

@@ -5,8 +5,11 @@ require_relative "resources/activity_log"
 require_relative "resources/board"
 require_relative "resources/board_view"
 require_relative "resources/column"
+require_relative "resources/group"
 require_relative "resources/item"
+require_relative "resources/subitem"
 require_relative "resources/workspace"
+require_relative "resources/update"
 
 module Monday
   module Resources
@@ -15,7 +18,10 @@ module Monday
     include Board
     include BoardView
     include Column
+    include Group
     include Item
+    include Subitem
     include Workspace
+    include Update
   end
 end

data/lib/monday/util.rb

@@ -45,7 +45,9 @@ module Monday
           "InvalidVersionException" => [InvalidRequestError, 400],
           "InvalidColumnIdException" => [InvalidRequestError, 400],
           "InvalidItemIdException" => [InvalidRequestError, 400],
+          "InvalidSubitemIdException" => [InvalidRequestError, 400],
           "InvalidBoardIdException" => [InvalidRequestError, 400],
+          "InvalidGroupIdException" => [InvalidRequestError, 400],
           "InvalidArgumentException" => [InvalidRequestError, 400],
           "CreateBoardException" => [InvalidRequestError, 400],
           "ItemsLimitationException" => [InvalidRequestError, 400],

data/lib/monday/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Monday
-  VERSION = "0.4.0"
+  VERSION = "0.6.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: monday_ruby
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Sanif Himani
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-09-18 00:00:00.000000000 Z
+date: 2023-10-18 00:00:00.000000000 Z
 dependencies: []
 description: A Gem to easily interact with monday.com API using native Ruby
 email:
@@ -22,6 +22,7 @@ files:
 - ".env"
 - ".rspec"
 - ".rubocop.yml"
+- ".simplecov"
 - ".vscode/settings.json"
 - CHANGELOG.md
 - CODE_OF_CONDUCT.md
@@ -78,7 +79,10 @@ files:
 - lib/monday/resources/board.rb
 - lib/monday/resources/board_view.rb
 - lib/monday/resources/column.rb
+- lib/monday/resources/group.rb
 - lib/monday/resources/item.rb
+- lib/monday/resources/subitem.rb
+- lib/monday/resources/update.rb
 - lib/monday/resources/workspace.rb
 - lib/monday/response.rb
 - lib/monday/util.rb
@@ -91,7 +95,7 @@ licenses:
 metadata:
   homepage_uri: https://github.com/sanifhimani/monday_ruby
   documentation_uri: https://monday-ruby.gitbook.io/docs/
-  changelog_uri: https://github.com/sanifhimani/monday_ruby/blob/v0.4.0/CHANGELOG.md
+  changelog_uri: https://github.com/sanifhimani/monday_ruby/blob/v0.6.0/CHANGELOG.md
   rubygems_mfa_required: 'true'
 post_install_message:
 rdoc_options: []