Implement decorators in pyiron_base

[jan-janssen]

First implementation with decorator arguments:

from pyiron_base import pyiron_job, Project

pr = Project("test")

@pyiron_job(project=pr, cores=2)
def my_function(a, b=8):
    return a + b

c = my_function(a=1, b=2)
d = my_function(a=c, b=3)
d.pull()
>>> 6

The disadvantage of this approach is that the decorator requires the () even without parameters:

@pyiron_job()
def my_function(a, b=8):
    return a + b

To address this limitation I created a second implementation:

from pyiron_base import pyiron_job_simple, Project

@pyiron_job_simple
def my_function(a, b=8):
    return a + b

pr = Project("test")
c = my_function(a=1, b=2, project=pr)
d = my_function(a=c, b=3, project=pr, resource_dict={"cores": 2})
d.pull()
>>> 6

[samwaseda]

@jan-janssen I unified pyiron_job_simple and pyiron_job so that pyiron_job works with or without parentheses. If you don't like it you can revert it.

[jan-janssen]

@jan-janssen I unified pyiron_job_simple and pyiron_job so that pyiron_job works with or without parentheses. If you don't like it you can revert it.

Nice catch - I really like the suggestion. From my perspective it is ready to be merged.

[samwaseda]

Can you copy and paste your first comment in this PR in the doc string?

[jan-janssen]

I updated the pull request based on the feedback from the pyiron meeting today.

[jan-janssen]

Can you copy and paste your first comment in this PR in the doc string?

@samwaseda I added the doc strings as requested.

[jan-janssen]

For future reference, the decorators in pyiron_base are inspired by the decorators in desk with the added ability to control the computing resources assigned to a given function https://docs.dask.org/en/stable/delayed.html#decorator .