Export only one worksheet by it's Id from all document added

[ShevchenkoVadim]

Added the ability to export one page from the entire document by ID

[alifeee]

you can run these commands to check that the workflow will pass :)

pip install -r lint-requirements.txt
tox -e lint
# optionally but you have not changed tests/docs
pip install -r docs/requirements.txt
pip install -r test-requirements.txt
tox -e doc # build docs
tox -e py # run tests

is this a feature that you think is possible to add a test for, or not?

[lavigne958]

the list of possible formats are slightly different from the export format from the DriveAPI.
I suggest we create a new Enum list with the appropriate Names and Values.

I am not too keen on introducing this feature for one reason:

• in any error scenario we receive an HTML error page.
• the whole API is made to handle JSON response in all error scenarios, so here we fail to read the JSON error response, because its HTML format.
• This is because the URL we use is originally made for humans to use on a web browser.

@alifeee what do you think of this detail ?

[lavigne958]

if the default value is PDf, then you don't have to check if it's PDF in format

[lavigne958]

this one does not work.
as well as you don't handle the value: OPEN_OFFICE_SHEET which results as PDF due to default value set at the start of the ifs here.

[alifeee]

@alifeee what do you think of this detail ?

I'm not fully sure why this feature is desired. What can gspread currently do, and what is missing?

Could someone provide a (pseudo)code snippet example of what is desired with this function?

[lavigne958]

@alifeee what do you think of this detail ?

I'm not fully sure why this feature is desired. What can gspread currently do, and what is missing?

I believe it's desired when you wish to export (to PDF, to CSV, ...) a single sheet instead of a the whole spreadsheet (which creates multiple pages PDF for example).

Could someone provide a (pseudo)code snippet example of what is desired with this function?

sure, I tried it, here it is 🙃

client = gspread.service_account()
file = client.open("xxxxxxxx")
res = file.sheet1.export(gspread.utils.ExportFormat.PDF)
with open("result.pdf", "wb") as fp:
    fp.write(res)

My major concerns are:

1. the error handling, which returns HTML code, and not a JSON
2. the exported format that are not fully covered in this MR. (this is easily fixed with a new Enum)