Cannot download files with an apostrophe < ' > in path using file.read()

[le-codeur-rapide]

Hi I was using the library to download some files from sharepoint using file.read()

`
for _, row in tqdm.tqdm(df.iterrows()):
file_url = row['Relative URL']
local_path = os.path.join(local_folder, row['Relative URL'].lstrip('/'))

    # Create the local directory if it doesn't exist
    os.makedirs(os.path.dirname(local_path), exist_ok=True)

    # Get the file from SharePoint
    file = ctx.web.get_file_by_server_relative_path(str(file_url))
    ctx.load(file)
    ctx.execute_query()

    # Save the file locally
    with open(local_path, 'wb') as local_file:
        file.read()  

`

I had issues with files that had an appostrophe ex: < macdonald's.pdf > because the "'" is not encoded in the final url

Replacing file.read() by file.download(local_file).execute_query() It is working fine.

Is it expected behaviour ? is file.read() not supposed to handle the appostrophe also ?

Thank you for your answer !

[CTPassion]

Faced this issue too - see my question #918

I fixed by encoding the relative URL myself.

[CTPassion]

The PR addressing this has been merged.

[office365-maintainer]

Thanks for the report, and thanks @CTPassion for the pointer.

This is fixed. File.open_binary/save_binary now escape embedded apostrophes in the OData DecodedUrl literal (' → ''), and the OData call syntax itself stays literal so the /$value suffix is preserved (#978). Regression tests: tests/unit/test_issue_regressions.py::TestFilePathQuoting::test_read_escapes_apostrophe and test_write_escapes_apostrophe.

Shipped in v3.1.0 (2026-09-13); present in v3.2.0. If you still hit it on 3.1.0+, please reopen with the failing path.