feat: to TensorFlow RaggedTensor

[maxymnaumchyk]

No description provided.

[codecov]

Codecov Report

Attention: Patch coverage is 30.50847% with 41 lines in your changes missing coverage. Please review.

Project coverage is 82.24%. Comparing base (b749e49) to head (6e2fd3f).
Report is 144 commits behind head on main.

Files	Patch %	Lines
src/awkward/operations/ak_to_raggedtensor.py	26.66%	22 Missing ⚠️
src/awkward/operations/ak_from_raggedtensor.py	29.62%	19 Missing ⚠️

Additional details and impacted files

Files	Coverage Δ
src/awkward/operations/__init__.py	100.00% <100.00%> (ø)
src/awkward/operations/ak_from_raggedtensor.py	29.62% <29.62%> (ø)
src/awkward/operations/ak_to_raggedtensor.py	26.66% <26.66%> (ø)

... and 102 files with indirect coverage changes

[ianna]

@maxymnaumchyk - good start! Please, run pre-commit run —all locally before pushing.

[ianna]

@maxymnaumchyk - Great job! The implementation is fine. However, the tests do not run in the CI because pytest expects the test names starting with test_. Please, check the suggestions.

[ianna]

@maxymnaumchyk - Great, thanks! All tests pass:

tests/test_3210_to_raggedtensor_from_raggedtensor.py::test_convert_to_raggedtensor PASSED [ 99%]
tests/test_3210_to_raggedtensor_from_raggedtensor.py::test_convert_from_raggedtensor PASSED [100%]

@jpivarski - if you don't have any objections I'll merge it. Thanks!

[jpivarski]

It looks good! It's well implemented and well tested. I made two suggestions.

[jpivarski]

@all-contributors please add @maxymnaumchyk for code

[allcontributors]

@jpivarski

I've put up a pull request to add @maxymnaumchyk! 🎉

[jpivarski]

Just a note: we'll need to get these new functions into the documentation. It needs to go into https://github.com/scikit-hep/awkward/blob/main/docs/reference/toctree.txt, as a new section

.. toctree::
    :caption: Converting ragged arrays

    generated/ak.from_raggedtensor
    generated/ak.to_raggedtensor

under the "Converting rectangular arrays" section and above the "Reading and writing files" section.

That can be a quick little PR, and when the documentation-generating Action is done, there should be a "View Deployment" button that will let you see what the new documentation looks like. You should find the new documentation on the left side-bar of https://awkward-array.org/doc/main/reference/index.html .