Access project from job (#808)

* First pass

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* Initialize job

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* Update tests/test_job.py

* Add test for custom Project subclass.

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* Fix test.

* Update changelog and contributors

* Formatting

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: Hardik Ojha <44747868+kidrahahjo@users.noreply.github.com>
Co-authored-by: Bradley Dice <bdice@bradleydice.com>

changelog.txt

@@ -12,7 +12,9 @@ Version 2
 
 Added
 +++++
+
  - ``H5Store`` related errors are now included in the public API (#775).
+ - Users can now access the project which a job belongs to from the job object.
 
 Changed
 +++++++

contributors.yaml

@@ -123,4 +123,8 @@ contributors:
     family-names: Takada
     given-names: Kody
     affiliation: "University of Michigan"
+  -
+    family-names: Kadar
+    given-names: Alain
+    affiliation: "University of Michigan"
 ...

doc/api.rst

@@ -90,6 +90,7 @@ The Job class
     Job.move
     Job.open
     Job.path
+    Job.project
     Job.remove
     Job.reset
     Job.sp

signac/contrib/job.py

@@ -606,6 +606,17 @@ def data(self, new_data):
         """
         self.stores[self.KEY_DATA] = new_data
 
+    @property
+    def project(self):
+        """Get the project that contains this job.
+
+        Returns
+        -------
+        signac.Project
+            Returns the project containing this job.
+        """
+        return self._project
+
     def init(self, force=False):
         """Initialize the job's workspace directory.
 

tests/test_job.py

@@ -238,6 +238,23 @@ def test_deepcopy(self):
         copied_job.sp.a = 3
         assert copied_job in self.project
 
+    def test_project_access_from_job(self):
+        job = self.project.open_job({"a": 0}).init()
+        assert isinstance(job.project, signac.Project)
+        assert job in job.project
+        assert job.project.path == self._tmp_pr
+
+    def test_custom_project_access_from_job(self):
+        # Test a custom project subclass to ensure compatibility with signac-flow's FlowProject
+        class CustomProject(signac.Project):
+            pass
+
+        custom_project = CustomProject.get_project(self._tmp_pr)
+        job = custom_project.open_job({"a": 0}).init()
+        assert isinstance(job.project, CustomProject)
+        assert job in job.project
+        assert job.project.path == self._tmp_pr
+
 
 class TestJobSpInterface(TestJobBase):
     def test_interface_read_only(self):