Machine Elf

An elf is an agent that perfoms tasks and share information on the mycelium. All elves must inherit from the MachineElf class.

Machine Elf

class blumycelium.machine_elf.Job(task, run_job_id, worker_elf, parameters, start_date, completion_date, status, mycelium, return_placeholder, dependencies)

a Job for an elf

commit()

save the job to the mycelium

class blumycelium.machine_elf.MachineElf(uid, mycelium)

An elf that runs tasks

find_tasks()

find all function whose name starts by task_

get_jobs()

retuen the list of jobs for an elf

inspect_self()

inspect the elf to get the source code etc…

register(store_source=False)

register the elf to the mycelium

run_task(job_id: str, task_name: str, parameters: dict, store_failures: bool, raise_exceptions: bool)

run a task for an elf

start_jobs(store_failures=True, raise_exceptions=True)

start a job for an elf

class blumycelium.machine_elf.Task(machine_elf, function, name)

Represent a task for an elf

inspect_function()

inspect the function of a task

run(job_id, *args, **kwargs)

run the task

wrap(*args, **kwargs)

wrap the function inside a new function that creates a Job

class blumycelium.machine_elf.TaskParameters(fct, run_job_id, worker_elf)

Parameters of a task

classmethod develop(mycelium, dct_params: dict)

compute the value of parameters

find_placeholders_in_key_value_iterrator(iterator)

find placeholders in dicts lists etc…

get_job_dependencies()

return the dependencies of a job (jobs that must run before) based on the parameters received

get_parameter_dict()

return a dictionary of parameters

validate()

returns placeholders

class blumycelium.machine_elf.TaskReturnPlaceHolder(worker_elf, task_function, run_job_id)

A place for the return of a task. Works as a dict, where each value is a key

get_result_id(name)

return the result_id for value in the placeholder

make_placeholder()

make and validate the placeholder

class blumycelium.machine_elf.ValuePlaceholder(*args, **kwargs)

A placeholder for a value return by a task

set_origin(result_id)

set the result id represented by the placeholder