Add rake task for importing annotations

[Mr0grog]

I was working on some other Ruby + Google Sheets code today, so I took a little extra time for this. We can use it to solve #61 (but that issue is about the work of running this script, not about the script itself).

Use the import_annotations_from_sheet rake task to import all the annotations an analyst has created in a given Google Sheet. This can be used to solve #61.

Arguments are:

1. Google sheet ID, e.g. 1-Rq-AclS2GI_yxLmkYVY7FvTfN21KoJtxXtOXXXXXX
2. E-mail of user to attribute the annotation to
3. (optional) Name of spreadsheet tabs to import (comma-separated). If unset, all tabs will be imported.
4. (optional) Row to start at (defaults to 7)
5. (optional) Row to end at. If unset, reads all rows.

When done, it'll output summary information of how many rows were added, skipped, or errored across how many tabs.

Example:

$ rake import_annotations_from_sheet['1-Rq-AclS2GI_yxLmkYVY7FvTfN21KoJtxXtOXXXXXX','[email protected]']
> Importing spreadsheet tab '1 EPA About OECA'
> Importing spreadsheet tab '1 HHS Climate & Env'
> 
> RESULTS:
> --------
> Created 253 annotations
> Skipped 0 rows
> Errored 0 rows
> In      2 spreadsheet tabs

If you set the VERBOSE environment variable (to any value) it'll print information about every row that produced an annotation.

[danielballan]

Name of spreadsheet tabs to import (comma-separated).

It looks like spreadsheet names can have commas, but they can't have colons. A comma is a more obvious choice for a separator. A colon is a technically safe one. Given that this is a tool to solve a temporary problem and that we don't have commas in our spreadsheet names, it seems reasonable to stick with a comma separately -- I was just curious so I thought I'd mention it.

[Mr0grog]

I think you’ve already thought about this more than I did! I’m not sure about the colons, though—I just tried using one as a tab title and it seemed to work. Maybe we’re talking about different things?

[danielballan]

I found that claim on this Microsoft support page:

Worksheet names cannot: [...] Contain any of the following characters: / \ ? * : [ ]

I guess Google Sheets went their own way on this one. Let's go with commas and assume we won't hit this bug during the finite period we will be using this feature.

[Mr0grog]

Oh, that is an interesting difference. I’ll go ahead and merge this, then.