dor-services-client 15.13.0 → 15.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 565b25455d31d878a49e800e34b6b3b096322762300a7042ae677ed650ff21a5
-  data.tar.gz: 8c9f6acc0a76f4ac7da4b3190a3e1d4e5e349ccc9678d487f23fa3ee237e3d65
+  metadata.gz: bd62911db328e4acec57538baa18003ff2525c02929f2f96adbd9df74ba43e30
+  data.tar.gz: 9591c4c8977d9a81cffbf46a300e04778a60330c0ce9d9743232cc72bcca56e8
 SHA512:
-  metadata.gz: 94e719800898ca73d2028dd144a184e7ca98b5958b421846a8380bd176b7f5eef64e921e0cc3f973ed62b7607e29e801dfa64fc771d19d995cb7d00dec01f84a
-  data.tar.gz: 337a076d2a17c2eb7201fc7f038f53018582f26c22fdbbfd61caf05268e382e8911e6aafaa8f20aaa9c64aafcf3681fc84ce0efbb2dc31174b89c9c5ad10ec23
+  metadata.gz: 8fa6acadd9432a53789fd3d33ab07bafca9d1078544536c80e2bfa661490921201a781c84e1b0a1898264c62e5d5a7d19ac95316409f894b074f88de917d91ea
+  data.tar.gz: 359df5ae75ca8e63aa4cc5d3fd56e13ce716e3ec67d3e74c4535906f573f4419c041683b1008cd563d098d0fbcf8750b698fe497ad85d825efd9d56528a6a379

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    dor-services-client (15.13.0)
+    dor-services-client (15.14.0)
       activesupport (>= 7.0.0)
       cocina-models (~> 0.104.1)
       deprecation

data/README.md

@@ -158,6 +158,13 @@ object_client.workflows
 object_client.workflow('accessionWF').find
 # Create workflow
 object_client.workflow('etdSubmitWF').create(version: 2)
+# Skip all workflow steps
+object_client.workflow('accessionWF').skip_all(note: 'Cleaning up')
+
+# Update workflow processes
+object_client.workflow('accessionWF').process('shelve').update(status: 'completed')
+object_client.workflow('accessionWF').process('shelve').update_error(error_msg: 'Something went wrong', error_text: 'Detailed error message')
+
 
 # List milestones
 object_client.milestones.list

data/lib/dor/services/client/object_workflow.rb

@@ -13,12 +13,19 @@ module Dor
           @workflow_name = workflow_name
         end
 
+        # @return [Dor::Services::Client::Process]
+        def process(process)
+          @process ||= Process.new(connection: connection, version: api_version, object_identifier: object_identifier,
+                                   workflow_name: workflow_name, process: process)
+        end
+
         # @return [Workflow::Response::Workflow]
         def find
           resp = connection.get do |req|
             req.url "#{api_version}/objects/#{object_identifier}/workflows/#{workflow_name}"
             req.headers['Accept'] = 'application/xml'
           end
+
           raise_exception_based_on_response!(resp) unless resp.success?
 
           Dor::Services::Response::Workflow.new(xml: Nokogiri::XML(resp.body))
@@ -37,6 +44,18 @@ module Dor
             req.headers['Content-Type'] = 'application/json'
             req.body = { context: context }.to_json if context
           end
+
+          raise_exception_based_on_response!(resp) unless resp.success?
+        end
+
+        # Skips all steps in a workflow.
+        # @param note [String] a note to be added to the skipped steps
+        def skip_all(note:)
+          resp = connection.post do |req|
+            req.url "#{api_version}/objects/#{object_identifier}/workflows/#{workflow_name}/skip_all"
+            req.params['note'] = note
+          end
+
           raise_exception_based_on_response!(resp) unless resp.success?
         end
 

data/lib/dor/services/client/process.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+module Dor
+  module Services
+    class Client
+      # API calls around workflow process for an object.
+      class Process < VersionedService
+        # @param object_identifier [String] the druid for the object
+        # @param [String] workflow_name The name of the workflow
+        # @param [String] process The name of the workflow step
+        def initialize(connection:, version:, object_identifier:, workflow_name:, process:)
+          super(connection: connection, version: version)
+          @object_identifier = object_identifier
+          @workflow_name = workflow_name
+          @process = process
+        end
+
+        # Updates the status of one step in a workflow.
+        # @param [String] status The status of the process.
+        # @param [Float] elapsed The number of seconds it took to complete this step. Can have a decimal.  Is set to 0 if not passed in.
+        # @param [String] lifecycle Bookeeping label for this particular workflow step.  Examples are: 'registered', 'shelved'
+        # @param [String] note Any kind of string annotation that you want to attach to the workflow
+        # @param [String] current_status Setting this string tells the workflow service to compare the current status to this value.
+        # @raise [Dor::Services::Client::ConflictResponse] if the current status does not match the value passed in current_status.
+        def update(status:, elapsed: 0, lifecycle: nil, note: nil, current_status: nil)
+          perform_update(status: status, elapsed: elapsed, lifecycle: lifecycle, note: note, current_status: current_status)
+          # resp = connection.get do |req|
+          #   req.url "#{api_version}/objects/#{object_identifier}/workflows/#{workflow_name}"
+          #   req.headers['Accept'] = 'application/xml'
+          # end
+
+          # raise_exception_based_on_response!(resp) unless resp.success?
+
+          # Dor::Services::Response::Workflow.new(xml: Nokogiri::XML(resp.body))
+        end
+
+        # Updates the status of one step in a workflow to error.
+        # @param [String] error_msg The error message.  Ideally, this is a brief message describing the error
+        # @param [String] error_text A slot to hold more information about the error, like a full stacktrace
+        def update_error(error_msg:, error_text: nil)
+          perform_update(status: 'error', error_msg: error_msg, error_text: error_text)
+        end
+
+        private
+
+        attr_reader :object_identifier, :workflow_name, :process
+
+        def perform_update(**payload)
+          resp = connection.put do |req|
+            req.url "#{api_version}/objects/#{object_identifier}/workflows/#{workflow_name}/processes/#{process}"
+            req.headers['Content-Type'] = 'application/json'
+            req.body = payload.compact.to_json
+          end
+
+          raise_exception_based_on_response!(resp) unless resp.success?
+        end
+      end
+    end
+  end
+end

data/lib/dor/services/client/version.rb

@@ -3,7 +3,7 @@
 module Dor
   module Services
     class Client
-      VERSION = '15.13.0'
+      VERSION = '15.14.0'
     end
   end
 end

metadata

@@ -1,11 +1,12 @@
 --- !ruby/object:Gem::Specification
 name: dor-services-client
 version: !ruby/object:Gem::Version
-  version: 15.13.0
+  version: 15.14.0
 platform: ruby
 authors:
 - Justin Coyne
 - Michael Giarlo
+autorequire:
 bindir: exe
 cert_chain: []
 date: 2025-06-26 00:00:00.000000000 Z
@@ -220,6 +221,7 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+description:
 email:
 - jcoyne@justincoyne.com
 - leftwing@alumni.rutgers.edu
@@ -258,6 +260,7 @@ files:
 - lib/dor/services/client/object_workflow.rb
 - lib/dor/services/client/object_workflows.rb
 - lib/dor/services/client/objects.rb
+- lib/dor/services/client/process.rb
 - lib/dor/services/client/release_tag.rb
 - lib/dor/services/client/release_tags.rb
 - lib/dor/services/client/response_error_formatter.rb
@@ -274,6 +277,7 @@ homepage: https://github.com/sul-dlss/dor-services-client
 licenses: []
 metadata:
   rubygems_mfa_required: 'true'
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -291,7 +295,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 3.5.11
+signing_key:
 specification_version: 4
 summary: A client for dor-services-app
 test_files: []