Quick start

Submit

Run an OAR job that prints “Hello world” (only “command” is a required argument):

from oarpy.oarjob import submit

job = submit(command='echo "Hello word"', name='quickstart',
             project='oarpy', core=1, gpu=False, walltime={'hours':2})
print(job)
job.wait()

if job.exit_code:
    print('Failed:\n{}'.format(job.stderr))
elif job.exit_code is None:
    print('Interrupted:\n{}'.format(job.stdout))
else:
    print('Succes:\n{}'.format(job.stdout))

job.remove_logs()

Job(1131384)
 name = quickstart
 project = oarpy
 state = Waiting
 owner = denolf
 runtime = 0:00:00
..............
Succes:
Hello word

Search

Find the job started above in case you know the job ID:

from oarpy.oarjob import Job
job = Job(1131384)
print(job)

Job(1131384)
 name = quickstart
 project = oarpy
 state = Terminated
 owner = denolf
 runtime = 0:00:07

Find the job started above in case you do not know the job ID (not all arguments are necessary):

from oarpy.oarjob import search
from oarpy import timeutils
import os

owner = os.getlogin()
start = timeutils.add(timeutils.now(), minutes=-3)
jobs = search(owner=owner, start=start, name='quickstart',
              project='oarpy', state='Terminated')
print(jobs)

[Job(1131384)]