python-google-sheets 0.1.0__py3-none-any.whl → 0.1.2__py3-none-any.whl

google_sheets/google_sheets.py

@@ -1,20 +1,17 @@
-from typing import TYPE_CHECKING
-
 from google.oauth2.service_account import Credentials
 from googleapiclient.discovery import build
 from googleapiclient.errors import HttpError
 
 from .spreadsheet_requests import Spreadsheet, SheetProperties
 
-if TYPE_CHECKING:
-    from googleapiclient.discovery import Resource  # noqa
+SimpleType = str | int | float | bool
 
 DEFAULT_PATH_TO_CREDS = 'service_account.json'
 
 
 class GoogleSheets:
     @staticmethod
-    def build_service(path_to_creds: str = DEFAULT_PATH_TO_CREDS) -> 'Resource':
+    def build_service(path_to_creds: str = DEFAULT_PATH_TO_CREDS):
         SCOPES = ['https://www.googleapis.com/auth/spreadsheets']
         try:
             credentials = Credentials.from_service_account_file(path_to_creds, scopes=SCOPES)
@@ -125,7 +122,7 @@ class GoogleSheets:
         return Spreadsheet.model_validate(service.spreadsheets().get(spreadsheetId=spreadsheet_id).execute(num_retries=5))
 
     @staticmethod
-    def get_spreadsheet_range_values(spreadsheet_id: str, ranges: list[str], service=None) -> list[list[str] | list[list[str]]]:
+    def get_spreadsheet_range_values(spreadsheet_id: str, sheet: str | int, ranges: list[str], service=None) -> list[list[SimpleType] | list[list[SimpleType]]]:
         """
         Reads values from the specified ranges of the table.
         IMPORTANT: If the last cells in the range are empty, they will be omitted. If all cells are empty, an empty
@@ -134,6 +131,7 @@ class GoogleSheets:
 
         Args:
             spreadsheet_id (str): ID of the table
+            sheet (str | int): Name or ID of the sheet
             ranges (list[str]): List of ranges to read in A1 notation
             service (googleapiclient.discovery.Resource): Google Sheets service object
 
@@ -143,8 +141,23 @@ class GoogleSheets:
         if service is None:
             service = GoogleSheets.build_service()
 
+        if isinstance(sheet, int):
+            ss = GoogleSheets.get_spreadsheet(spreadsheet_id, service)
+            try:
+                sheet_name = next(sht.properties.title for sht in ss.sheets if sht.properties.sheet_id == sheet)
+            except StopIteration:
+                return []
+        else:
+             sheet_name = sheet
+        ranges = [f'{sheet_name}!{range_}' for range_ in ranges]
+
         try:
-            response = service.spreadsheets().values().batchGet(spreadsheetId=spreadsheet_id, ranges=ranges).execute(num_retries=5)
+            response = service.spreadsheets().values().batchGet(
+                spreadsheetId=spreadsheet_id,
+                ranges=ranges,
+                valueRenderOption='UNFORMATTED_VALUE',
+                dateTimeRenderOption='FORMATTED_STRING'
+            ).execute(num_retries=5)
         except HttpError as e:
             raise e
         else:

python_google_sheets-0.1.2.dist-info/METADATA

@@ -0,0 +1,53 @@
+Metadata-Version: 2.4
+Name: python-google-sheets
+Version: 0.1.2
+Summary: The most efficient Python wrapper for Google Sheets API
+Author-email: Timofey Egorov <timegorr@gmail.com>
+License-Expression: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: google-auth
+Requires-Dist: google-api-python-client
+Requires-Dist: pydantic>=2.0.0
+Dynamic: license-file
+
+# Google Sheets API Python wrapper
+
+Built for developers who want to interact with Google Sheets API in a little more simple way while maintaining peak efficiency.
+
+### Installation
+```bash
+pip install python-google-sheets
+```
+
+### Usage
+```python
+from google_sheets import GoogleSheets, ApiRequest, CellFormat, TextFormat, TextRotation, Color_
+
+SPREADSHEET_ID = 'your_spreadsheet_id'
+SHEET_ID = 0
+service = GoogleSheets.build_service(path_to_creds='your_service_account_creds.json')  # 'service_account.json' is used by default
+
+# Update data
+api_requests = [
+    ApiRequest.update_cells(SHEET_ID, range_='A1:B2', values=[['Bold', 'Italic'], ['Underlined', 'Rotated']]),
+    ApiRequest.update_cells(SHEET_ID, range_='A1:B2', cell_formats=[
+        [CellFormat(text_format=TextFormat(bold=True)), CellFormat(text_format=TextFormat(italic=True))],
+        [CellFormat(text_format=TextFormat(underline=True)), CellFormat(text_rotation=TextRotation(angle=10))],
+    ]),
+    ApiRequest.update_cells(SHEET_ID, range_='A4:C4', values=['Row', 'of', 'data']),
+    ApiRequest.update_cells(SHEET_ID, range_='B6:B8', values=['Column', 'of', 'data']),
+    ApiRequest.update_cells(SHEET_ID, range_='A10:C10', values=['This', 'text', 'is colored'], cell_formats=[
+        CellFormat(background_color_style=Color_.Basic.YELLOW),
+        CellFormat(background_color_style=Color_.Basic.DARK_ORANGE_2),
+        CellFormat(background_color_style=Color_.Basic.PLACE_2_10),
+    ])
+]
+GoogleSheets.update_spreadsheet(SPREADSHEET_ID, api_requests=api_requests, service=service)
+
+# Obtain data
+values = GoogleSheets.get_spreadsheet_range_values(SPREADSHEET_ID, sheet=SHEET_ID, ranges=['A1:C10'])
+```

{python_google_sheets-0.1.0.dist-info → python_google_sheets-0.1.2.dist-info}/RECORD

@@ -1,6 +1,6 @@
 google_sheets/__init__.py,sha256=n82JQthRRM_04DvQ55MI3-zESTmTsjxim39hwv-5d8M,518
 google_sheets/api_request.py,sha256=nQPci0yTZvjKHUrOFPqvCQD8QkDBuqO166zp_Rvk-uI,17409
-google_sheets/google_sheets.py,sha256=GjjQQI4yw8DljHFOxB9GEkHHk5DGvrECtaFzzFFEDsc,7299
+google_sheets/google_sheets.py,sha256=pds74uJR8qHsowTb1OnqtchIAsQENMVXwWsYN2kBLks,7878
 google_sheets/styles.py,sha256=301ddWLfpZQzr7eKFAvqmVD5n8tEGtrG2cs6N2RpUUo,12682
 google_sheets/utils.py,sha256=3HCCwrd_poMeEAJgamxN2NsyKYCIAsMcC-ZwCMU_pMU,1590
 google_sheets/spreadsheet_requests/__init__.py,sha256=pwkZTskPq4WLjI4uJiZ8C5OPCBU-grmjoSSu114jdjM,1191
@@ -11,8 +11,8 @@ google_sheets/spreadsheet_requests/merge_cells.py,sha256=Y7ChGjmb07jCCG1aP2Ws126
 google_sheets/spreadsheet_requests/spreadsheet.py,sha256=ZW9nzNR9hjibuNVsAJI8jssjjKCKeEuGhduh6ZkHjh4,3496
 google_sheets/spreadsheet_requests/update_cells.py,sha256=ncxmBpUQU19wHc-kBMa5K2NAVgJQMW4npyS5h5jqNA0,9117
 google_sheets/spreadsheet_requests/update_sheet_properties.py,sha256=TKFZHq6Du6wFMZgcf7YAavn_JrIsbxWqQqWKJiqgRMQ,1837
-python_google_sheets-0.1.0.dist-info/licenses/LICENSE,sha256=2PFWLbALHdUFzFd2QtLQvu7Ku4M6IO53Ns6b892nVvg,1090
-python_google_sheets-0.1.0.dist-info/METADATA,sha256=j1k_pi1AfvxOw3QTvWW96vyXhEjpVhgbKCS0H89tNyk,622
-python_google_sheets-0.1.0.dist-info/WHEEL,sha256=YCfwYGOYMi5Jhw2fU4yNgwErybb2IX5PEwBKV4ZbdBo,91
-python_google_sheets-0.1.0.dist-info/top_level.txt,sha256=AEiUl4h4VXrqsRO0AiL9C7ArYqmDhVuz--b035K3r34,14
-python_google_sheets-0.1.0.dist-info/RECORD,,
+python_google_sheets-0.1.2.dist-info/licenses/LICENSE,sha256=2PFWLbALHdUFzFd2QtLQvu7Ku4M6IO53Ns6b892nVvg,1090
+python_google_sheets-0.1.2.dist-info/METADATA,sha256=p2tW9oNM75gDNia2vEReNt8SP5t4aUrwC_oqSqKBTYA,2233
+python_google_sheets-0.1.2.dist-info/WHEEL,sha256=YCfwYGOYMi5Jhw2fU4yNgwErybb2IX5PEwBKV4ZbdBo,91
+python_google_sheets-0.1.2.dist-info/top_level.txt,sha256=AEiUl4h4VXrqsRO0AiL9C7ArYqmDhVuz--b035K3r34,14
+python_google_sheets-0.1.2.dist-info/RECORD,,

python_google_sheets-0.1.0.dist-info/METADATA

@@ -1,20 +0,0 @@
-Metadata-Version: 2.4
-Name: python-google-sheets
-Version: 0.1.0
-Summary: The most efficient Google Sheets API wrapper in Python
-Author-email: Timofey Egorov <timegorr@gmail.com>
-License-Expression: MIT
-Classifier: Programming Language :: Python :: 3
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.11
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: google-auth
-Requires-Dist: google-api-python-client
-Requires-Dist: pydantic>=2.0.0
-Dynamic: license-file
-
-### Установка
-```bash
-pip install git+https://github.com/Timofey28/google-sheets.git
-```