Added function to update rows

[bleonard314]

Added function to update rows based on the Smartsheet API documents. This function has the ability to match dataframe column names with Smartsheet column ids which may be useful for other functions. I also added '.Renviron' to the '.gitignore' to store project specific API keys (for dev only).

[cole-johanson]

@bleonard314 I'm a fan of this change! I like that you can update specific cells without having to specify the whole row. This actually makes me think this might be better named as ss_update_sheet() to coincide with ss_replace_sheet()? Or ss_update_cells()?

I do see a couple issues that need fixing:

1. I wasn't able to run your example because length(row_numbers) != nrow(data). row_numbers = NULL by default, so this will abort the function. I think the solution is just to use if(!is.null(row_numbers) && length(row_numbers) != nrow(data)).
2. row_offset does not have an effect with row_numbers. I think there are two solutions here. You could a) document this or b) remove row_offset and provide an example of how the user would accomplish this. Personally I prefer b. It would simply be setting row_numbers = row_offset:nrow(data), right? It seems simple enough that it does not require an additional argument.

Also, I prefer to use rlang::abort() instead of stop(), if you wouldn't mind updating that. Thanks!

[bleonard314]

Thank you for the prompt review. I've implemented the suggested changes and enhanced the function with additional error checking for improved robustness. Additionally, the documentation now includes an example demonstrating the use of row_numbers for specifying an offset, aligning with your suggestion to minimize optional arguments. Really good idea!

Regarding the function naming, I've aligned it with the corresponding API method, "Update Rows". This decision is based on its direct interaction with the rows path, distinct from the sheets path. You can refer to the Smartsheet API documentation here for more details: Update Rows API.

Although there is an update method for sheets, it primarily addresses updates to an individual user's sheet settings, not the content itself. Hence, I believe renaming the function to ss_update_sheet() could lead to confusion. The alternative, ss_update_cells(), is a consideration, but maintaining consistency with the API's method names, as documented in the Smartsheet API and used in official repositories like the Smartsheet Python SDK, seems more intuitive and user-friendly. Here's the link to the SDK for reference: Smartsheet Python SDK.

I'm open to further suggestions or discussions on this matter.

[cole-johanson]

@bleonard314 thank you! This looks great. I am putting this in the develop branch. I have another change I hope to release this month.