[PLAT-4257] - return results from committing a transaction

[noahgorstein]

Adds a response to the commit method. There is some helpful information in that response like the number of triples added/removed in that transaction.

Example usage:

    result = conn.commit()

    print(f"Triples added: {result["added"]}")
    print(f"Triples removed: {result["removed"]}")

[scardena]

should we put this on a try block? I know we don't do this for a majority of the code, but I just ran into that thought. what if the request fails, and resp no longer has the .json() method?

[noahgorstein]

I think if the request fails, a StardogException should be raised iiuc. client.post:

pystardog/stardog/http/client.py

Lines 52 to 53 in 8229d14

	def post(self, path, **kwargs):
	return self.__wrap(self.session.post(self.url + path, **kwargs))

returns the result from client.__wrap which should check if the request failed and raise an exception:

pystardog/stardog/http/client.py

Line 67 in 8229d14

def __wrap(self, request):

I think that's the order of execution but I might be misunderstanding/missing something.

[ctffarley]

yes, I believe Noah is right. __wrap should handle a failed request and then throwing the exception

[scardena]

right, I forgot about it.

[scardena]

looks good, just added one question

[ctffarley]

yes, I believe Noah is right. __wrap should handle a failed request and then throwing the exception