Class: Smplkit::Jobs::RunsClient

Inherits:
Object
  • Object
show all
Defined in:
lib/smplkit/jobs/client.rb

Overview

client.jobs.runs.* — read-only run history plus the cancel / rerun run actions.

Instance Method Summary collapse

Constructor Details

#initialize(api) ⇒ RunsClient

Returns a new instance of RunsClient.



22
23
24
 
# File 'lib/smplkit/jobs/client.rb', line 22

def initialize(api)
  @api = api
end

Instance Method Details

#cancel(run_id) ⇒ Smplkit::Jobs::Run

Cancel a run that has not finished yet.

Parameters:

  • run_id (String) —

    Identifier of the run to cancel.

Returns:



61
62
63
64
 
# File 'lib/smplkit/jobs/client.rb', line 61

def cancel(run_id)
  resp = Jobs.call_api { @api.cancel_run(run_id) }
  Run.from_resource(resp.data)
end

#get(run_id) ⇒ Smplkit::Jobs::Run

Fetch a single run by its id.

Parameters:

  • run_id (String) —

    Identifier of the run to fetch.

Returns:

Raises:



52
53
54
55
 
# File 'lib/smplkit/jobs/client.rb', line 52

def get(run_id)
  resp = Jobs.call_api { @api.get_run(run_id) }
  Run.from_resource(resp.data)
end

#list(job: nil, page_size: nil, after: nil) ⇒ Array<Smplkit::Jobs::Run>

List past runs, most recent first. Cursor paginated: pass page_size and the after cursor from the prior page. Pass job to scope to a single job’s history.

Parameters:

  • job (String, nil) (defaults to: nil) —

    Return only runs of the job with this id. nil lists runs across all jobs in the account.

  • page_size (Integer, nil) (defaults to: nil) —

    Maximum number of runs to return in this page. nil uses the server default.

  • after (String, nil) (defaults to: nil) —

    Opaque cursor from a previous page; returns the runs that follow it. nil starts from the first page.

Returns:



37
38
39
40
41
42
43
44
45
 
# File 'lib/smplkit/jobs/client.rb', line 37

def list(job: nil, page_size: nil, after: nil)
  opts = {}
  opts[:filter_job] = job unless job.nil?
  opts[:page_size] = page_size unless page_size.nil?
  opts[:page_after] = after unless after.nil?

  resp = Jobs.call_api { @api.list_runs(opts) }
  (resp.data || []).map { |r| Run.from_resource(r) }
end

#rerun(run_id) ⇒ Smplkit::Jobs::Run

Start a new run that repeats a previous one.

Parameters:

  • run_id (String) —

    Identifier of the run to repeat.

Returns:



71
72
73
74
 
# File 'lib/smplkit/jobs/client.rb', line 71

def rerun(run_id)
  resp = Jobs.call_api { @api.rerun_run(run_id) }
  Run.from_resource(resp.data)
end