diff --git a/docs/community.rst b/docs/community.rst new file mode 100644 index 00000000..fb06af91 --- /dev/null +++ b/docs/community.rst @@ -0,0 +1,30 @@ +Community Extensions +==================== + +.. _gspread-formating-label: + +gspread-formating +~~~~~~~~~~~~~~~~~ + +`gspread-formatting `_ offers extensive functionality to help you when you go beyond basic format +provided by ``gspread``. + + +.. _gspread-pandas-label: + +Using gspread with pandas +~~~~~~~~~~~~~~~~~~~~~~~~~ + +You can find the below libraries to use gsrpead with pandas: + + * `gspread-pandas `_ + * `gspread-dataframe `_ + +.. _gspread-orm-label: + +Object Relational Mappers (ORMs) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The `gspread-models `_ package provides a straightforward and intuitive model-based +query interface, making it easy to interact with Google Sheets as if it were more like a database. + diff --git a/docs/index.rst b/docs/index.rst index 9485e31c..809d41e6 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -70,6 +70,14 @@ Advanced advanced +Community extensions +-------------------- + +.. toctree:: + :maxdepth: 2 + + community + API Documentation --------------------------- diff --git a/docs/user-guide.rst b/docs/user-guide.rst index 97879e84..cc459965 100644 --- a/docs/user-guide.rst +++ b/docs/user-guide.rst @@ -390,7 +390,7 @@ Color the background of **A2:B2** cell range in black, change horizontal alignme The second argument to :meth:`~gspread.models.Worksheet.format` is a dictionary containing the fields to update. A full specification of format options is available at `CellFormat `_ in Sheet API Reference. .. Tip:: - `gspread-formatting `_ offers extensive functionality to help you when you go beyond basics. + for more complex formatting see :ref:`gspread-formating-label`. Using gspread with pandas @@ -412,10 +412,7 @@ Here's a basic example for writing a dataframe to a sheet. With :meth:`~gspread. worksheet.update([dataframe.columns.values.tolist()] + dataframe.values.tolist()) -For advanced pandas use cases check out these libraries: - - * `gspread-pandas `_ - * `gspread-dataframe `_ +For advanced pandas use cases check out community section :ref:`gspread-pandas-label` Using gspread with NumPy ~~~~~~~~~~~~~~~~~~~~~~~~