Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update documentation for nanoarrow refactor, deprecate helpers #685

Merged
merged 4 commits into from Apr 1, 2024

Conversation

eddelbuettel
Copy link
Member

@eddelbuettel eddelbuettel commented Mar 30, 2024

In #682 (yesterday, building on #663 last month) use of nanoarrow was expanded in a refactoring. This a) removed the need for four helper functions and b) lead to one variable renaming for which roxygen docs needed to be updated. This PR addresses both points.

Removing user-callable functions is an API change. These four were arguably internal but if the feeling is we should preserve them with deprecation I can add four empty shells. On balance, and in this use case, this seems overkill but then again API consistency is important. The functions remain, but are marked deprecated. They are not used by any package code, but can remain until a suitable deprecation time has passed.

Copy link

@eddelbuettel
Copy link
Member Author

Better to properly deprecate the four redundant function and replace them with nanoarrow equivalents restoring the same previous API surface. Behavior is now standard R deprecation notice i.e.

> library(tiledb)
TileDB R 0.25.0.6 with TileDB Embedded 2.22.0 on Ubuntu 23.10.
See https://tiledb.com for more information about TileDB.
> aa <- tiledb_arrow_array_ptr()
Warning message:
tiledb_arrow_array_ptr() is deprecated, please use nanoarrow::nanoarrow_allocate_array() instead. 
> 

@eddelbuettel eddelbuettel changed the title Update documentation for nanoarrow refactor, remove helpers Update documentation for nanoarrow refactor, deprecate helpers Mar 31, 2024
@eddelbuettel eddelbuettel merged commit 5463a7b into master Apr 1, 2024
8 checks passed
@eddelbuettel eddelbuettel deleted the de/sc-44257/update_docs_re_nanoarrow branch April 1, 2024 15:58
@eddelbuettel eddelbuettel mentioned this pull request Apr 16, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants