python-google-sheets 0.1.0__tar.gz → 0.1.2__tar.gz

python_google_sheets-0.1.2/PKG-INFO

@@ -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.2/README.md

@@ -0,0 +1,37 @@
+# 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 → python_google_sheets-0.1.2}/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.0 → python_google_sheets-0.1.2}/pyproject.toml

@@ -4,9 +4,9 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-google-sheets"
-description = "The most efficient Google Sheets API wrapper in Python"
+description = "The most efficient Python wrapper for Google Sheets API"
 authors = [{ name = "Timofey Egorov", email = "timegorr@gmail.com" }]
-version = "0.1.0"
+version = "0.1.2"
 readme = "README.md"
 requires-python = ">=3.11"
 classifiers = [

python_google_sheets-0.1.2/python_google_sheets.egg-info/PKG-INFO

@@ -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/PKG-INFO

@@ -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
-```

python_google_sheets-0.1.0/README.md

@@ -1,4 +0,0 @@
-### Установка
-```bash
-pip install git+https://github.com/Timofey28/google-sheets.git
-```

python_google_sheets-0.1.0/python_google_sheets.egg-info/PKG-INFO

@@ -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
-```