Merge pull request #28 from aserto-dev/get-graph

Add find_objects and find_subjects to Directory client.

Author: ronenh

README.md

@@ -248,6 +248,36 @@ allowed = ds.check(
 )
 ```
 
+#### `find_subjects`
+
+Find subjects that have a given relation to or permission on a specified object.
+
+```py
+reponse = ds.find_subjects(
+    object_type="folder",
+    object_id="/path/to/folder",
+    relation="can_delete",
+    subject_type="user"
+)
+
+assert ObjectIdentifier("user", "euang@acmecorp.com") in response.results
+```
+
+#### `find_objects`
+
+Find objects that a given subject has a specified relation to or permission on.
+
+```py
+reponse = ds.find_objects(
+    object_type="folder",
+    relation="can_delete",
+    subject_type="user"
+    subjecct_id="euang@acmecorp.com"
+)
+
+assert ObjectIdentifier("folder", "/path/to/folder") in response.results
+```
+
 #### `get_manifest `
 
 Download the directory manifest.

poetry.lock

@@ -33,7 +33,7 @@ aiohttp = "^3.8.0"
 grpcio = "^1.49.0"
 protobuf = "^4.21.0"
 aserto-authorizer = "^0.20.2"
-aserto-directory = "^0.31.0"
+aserto-directory = "^0.31.3"
 
 [tool.poetry.dev-dependencies]
 black = "^23.0"