new: adbdgl refactor

[aMahanna]

Warrants a 3.0.0 release (the large diff is mostly due to the notebook updates)

See the new README

Closes #29

Note: For notebook testing purposes:

• Use !pip install git+https://github.com/arangoml/dgl-adapter.git@feature/adapter-refactor
• Use !git clone -b feature/adapter-refactor --single-branch https://github.com/arangoml/dgl-adapter.git

What's new

• Repo-wide refactor to reflect the behaviour of the ArangoDB-PyG adapter (up to Code Cleanup pyg-adapter#23) at the exception of:
  • The preserve_adb_keys logic (DGL does not support lists of strings as a property)
  • Ambiguity check for homogeneous graphs (DGL stores its node & edge data separately, even if the graph is homogeneous)
  • The strict parameter of Arangodb to PyG (for now)
• Official support for python 3.10 and 3.11

[joerg84]

Overall lgtm.
a) would this PR require a new major version release given backwards compatibility? Do we need a migration guide?
b) what are the resulting doc changes? Do we need to sync with the doc team?

[aMahanna]

Overall lgtm. a) would this PR require a new major version release given backwards compatibility? Do we need a migration guide? b) what are the resulting doc changes? Do we need to sync with the doc team?

a) No need for a migration guide since the API convention/usability remains the same, but this will warrant a major version release (from 2.1.0 to 3.0.0)

b) Right, the doc team would have to replace the contents of https://www.arangodb.com/docs/stable/data-science-dgl-adapter.html#quickstart with https://github.com/arangoml/dgl-adapter/tree/feature/adapter-refactor#quickstart

comments have been addressed via a40896b

[aMahanna]

@geenen124 @joerg84 any other thoughts on moving forward with this PR?

[geenen124]

It looks like the colab link is out of date w.r.t. the notebook on this branch?

[aMahanna]

re-requesting review after having merged #31

[aMahanna]

Sorry @geenen124 had to make another readme update, one last review when you get the chance