GH-45758 [Python] Add AzureFileSystem documentation

[jabbera]

Rationale for this change

Missing documentation on AzureFileSystem

What changes are included in this PR?

Added ArrowFileSystem documentation

Are these changes tested?

Not yet

Are there any user-facing changes?

Documentation

• GitHub Issue: [Python] Documentation missing on AzureFileSystem #45758

[jabbera]

@github-actions crossbow submit preview-docs

[github-actions]

⚠️ GitHub issue #45758 has been automatically assigned in GitHub to PR creator.

[github-actions]

Only contributors can submit requests to this bot. Please ask someone from the community for help with getting the first commit in.
The Archery job run can be found at: https://github.com/apache/arrow/actions/runs/13826670914

[jabbera]

@kou, can you poke the bot please to build the sample docs? This is mostly github copilot generated but it's not a bad starting point.

[kou]

@github-actions crossbow submit preview-docs

[github-actions]

Revision: 4f656a6

Submitted crossbow builds: ursacomputing/crossbow @ actions-6df96eacef

Task	Status
preview-docs

[jabbera]

@kou linting errors are all set, first scan of the doc preview looks good to me.

[jabbera]

Hopefully this bumps the pyarrow results when you google/bing/duckduckgo: azure storage pyarrow. The initial results are incredibly slow from a performance perspective.

[amoeba]

Thanks for this. I made a few small suggestions and noticed one thing I think we should change: In the docs preview, instances of AzureFileSystem aren't automatically links as they should be. I think we need to add AzureFileSystem to the list in https://github.com/apache/arrow/blob/main/docs/source/python/api/filesystems.rst. Can you do that and see if it's fixed?

[jabbera]

@amoeba all set. I did notice SubTreeFileSystem in the new file you linked:

arrow/docs/source/python/api/filesystems.rst

Line 45 in 6b66c84

SubTreeFileSystem

It doesn't seem to exist in the main content file. I left it because it's unrelated to my change, but I'm unsure if it will cause an issue.

[kou]

@github-actions crossbow submit preview-docs

[github-actions]

Revision: 13eae3e

Submitted crossbow builds: ursacomputing/crossbow @ actions-8735425042

Task	Status
preview-docs

[amoeba]

This looks good now. +1 @kou do you have any edits?

The issues with the links not showing up right in the CI-built docs is due to the fact we don't enable Azure in that build. I'll file a follow-up PR to fix that.

Thanks for the PR!

Edit: Docs for Azure are already tracked in #41496.

[kou]

+1

[conbench-apache-arrow]

After merging your PR, Conbench analyzed the 4 benchmarking runs that have been run so far on merge-commit 69682cd.

There were no benchmark performance regressions. 🎉

The full Conbench report has more details. It also includes information about 13 possible false positives for unstable benchmarks that are known to sometimes produce them.