Что такое SpeedTab и как им пользоватся
В прошлой публикации я показывал как сделать токен для Google API и упомянул свою библиотеку как пример, где такой токен нужен. Вот прямая ссылка.
SpeedTab это обертка на API от гугла, который позволяет работать и редактировать гугл таблицы. Библиотека также включает минимальный функционал для работы с гугл диском.
В этой публикации я покажу как использовать библиотеку SpeedTab на нескольких примерах.
import speedtab as st
with st.Client('token2.json') as user:
table1 = user.create_spreadsheet(title='My test Spreadsheet', sheets=['One', 'Two'], hide_grid_lines=False)
Для начала создадим пустую таблицу.
import speedtab as st
with st.Client('token2.json') as user:
# table1 = user.create_spreadsheet(title='My test Spreadsheet', sheets=['One', 'Two'], hide_grid_lines=False)
table1 = user.get_spreadsheet('{spreadsheet_id}')
table1.sheet('One').clear().cell_range((2, 1, 21, 2)).set_borders()
(table1.sheet('One').cell_range('B3').write_range([[1, 2, 3], ['Text1', 'Text2', 'Text3']])
.cell_range('B3:D3').set_background_color(st.DefaultColors.DARK_BLUE2).set_borders()
.set_text_format(text_color=st.Color((255, 255, 255)), bold=True,
vertical_alignment=st.VerticalAlignment.TOP,
horizontal_alignment=st.HorizontalAlignment.CENTER)
.cell_range((2, 1, 2, 1)).set_num_format(st.ReadyFormats.DECIMAL_PERCENT)
.cell_range((2, 2, 2, 2)).set_num_format(st.Dollar('$#,##0.00'))
.cell_range((3, 1, 4, 2)).set_background_color(st.Color('#ffd966'))
.set_text_format(italic=True, font_size=16, font_family='Lexend')
.set_borders(border_style=st.BorderStyle.DOUBLE, border_sides=st.BorderSides.OUTER_BORDERS, color=st.Color((55, 145, 200)))
)
В результате этого блока кода мы получим это:
Детально расписывать каждую строку не будем, остановлюсь на главных моментах. На уровне юзер мы можем работать с файловой системой в гугл диске (подробнее далее). На уровне таблицы, мы можем делать практически все с текстом и ячейками. Чтобы открыть таблицу нужно записать ее индикатор ('{spreadsheet_id}'), который находится в ссылке между spreadsheets/d/ и /edit#gid=...
При выборе страницы мы автоматически выбираем все строки и все столбцы. Для выделения области поменьше мы можем использовать стандартное текстовое выделение 'B3: C', либо использовать список из четырех чисел («строка», «столбец», «строка», «столбец»), где None будет выступать последней строкой или столбцом.
Все точные параметры так или иначе уже вписаны в библиотеку, чтобы узнать какой объект вам нужен, можно просто перейти к функцие и посмотреть тип данных. Пример:
Теперь создадим табличку и запишем ее в гугл таблицу
import speedtab as st
import pandas as pd
import random
df = pd.DataFrame({'month': range(202301, 202311),
'amount': random.sample(range(500, 2000), 10),
'percent': [random.uniform(0, 0.5) for _ in range(10)]})
with st.Client('token2.json') as user:
table1 = user.get_spreadsheet('{spreadsheet_id}')
(table1.sheet('Two')
.cell_range((2, 2, 2, df.shape[1] + 1)).write_dataframe(df, index=False).set_borders()
.set_text_format(text_color=st.Color((255, 255, 255)), font_size=18)
.set_background_color(color=st.Color('#765252'))
.cell_range((2, 2, 2 + df.shape[0], df.shape[1] + 1))
.set_borders(border_sides=[st.BorderSides.OUTER_BORDERS, st.BorderSides.VERTICAL_BORDER])
.cell_range('D:D').set_num_format(st.ReadyFormats.PRETTY_DOLLAR)
.cell_range('E:E').set_num_format(st.ReadyFormats.DECIMAL_PERCENT)
)
Теперь нарисуем графики
with st.Client('token2.json') as user:
table1 = user.get_spreadsheet('{spreadsheet_id}')
(table1.sheet('Two').cell_range('B16')
.add_chart(columns=[1], chart_type=st.ChartType.COLUMN, title='Income', data_start='C3')
.cell_range('H3')
.add_chart(columns=[2], target_axis=st.AxisPosition.RIGHT_AXIS,
chart_type=st.ChartType.LINE, title='New Customers', data_start=(3, 3))
)
И еще один комбинированный
with st.Client('token2.json') as user:
table1 = user.get_spreadsheet('1NFLoAyy52HaNyBv6V7P_OOag_1fsKmQ5xY2p6K_4uQY')
(table1.sheet('One').cell_range('G3')
.add_combo_chart(
left_columns=[1], right_columns=[2], chart_type_left=st.ChartType.COLUMN,
chart_type_right=st.ChartType.LINE, title='Overall', legend_position=st.LegendPosition.RIGHT_LEGEND,
data_sheet_name='Two', data_start='C3')
)
Теперь создадим папку и поместим туда наш файл
with st.Client('token2.json') as user:
folder_id = user.create_folder('My reports')
table1 = user.get_spreadsheet('1NFLoAyy52HaNyBv6V7P_OOag_1fsKmQ5xY2p6K_4uQY')
user.move_spreadsheet_to_folder(table1, folder_id)
Если папка уже создана, тогда folder_id будет идентификатором, который находится в ссылке после https://drive.google.com/drive/folders/
Отлично. мы создали, отредактировали и переместили гугл таблицу используя библиотеку обертку SpeedTab.
