SNOW-3031353: Documentation: describe extras

[tvoipio]

What is the current behavior?

Documentation of the Python package (especially README.md) does not list or describe the extras available for installation, except pandas and modin. E.g. secure-local-storage needs to be dug from setup.py or from very deep in the Snowflake product documentation.

No open issues were found in the tracker using query is:issue state:open extras.

What is the desired behavior?

README.md lists available extras and the behavior their installation enables, at least with references to other Snowflake documentation.

How would this improve snowflake-snowpark-python?

This would make information faster to find, hence make the package easier to use. Some behavior, e.g. credential caching enabled by secure-local-storage, is not easy to discover from product documentation, so making it visible here would make the behavior easier to discover.

References, Other Background

N/A

[sfc-gh-sghosh]

Hello @tvoipio ,

Thanks for raising this.

You are correct that the README today only explicitly documents the pandas and modin extras, and that other extras (such as secure-local-storage) are only discoverable from setup.py or via deeper product documentation.

We will update the documentation to udpate about package
secure-local-storage, development, modin-development etc