google-data-utils 0.1.0__py3-none-any.whl

google_data_utils/__init__.py

@@ -0,0 +1,22 @@
+from .public import (
+    google_csv_to_df,
+    google_excel_to_df,
+    google_sheet_to_df,
+)
+
+from .validators import (
+    extract_drive_file_id,
+    extract_sheet_id,
+    is_google_drive_url,
+    is_google_sheet_url,
+)
+
+__all__ = [
+    "google_csv_to_df",
+    "google_excel_to_df",
+    "google_sheet_to_df",
+    "extract_drive_file_id",
+    "extract_sheet_id",
+    "is_google_drive_url",
+    "is_google_sheet_url",
+]

google_data_utils/public.py

@@ -0,0 +1,38 @@
+# public.py
+
+import pandas as pd
+
+from .validators import (
+    extract_drive_file_id,
+    extract_sheet_id,
+)
+
+
+    
+def google_csv_to_df(url, **kwargs):
+    file_id = extract_drive_file_id(url)
+
+    return pd.read_csv(
+        f"https://drive.google.com/uc?id={file_id}",
+        **kwargs,
+    )
+
+
+def google_excel_to_df(url, **kwargs):
+    file_id = extract_drive_file_id(url)
+
+    return pd.read_excel(
+        f"https://drive.google.com/uc?id={file_id}",
+        **kwargs,
+    )
+
+
+def google_sheet_to_df(url, **kwargs):
+    sheet_id = extract_sheet_id(url)
+
+    csv_url = (
+        f"https://docs.google.com/spreadsheets/d/"
+        f"{sheet_id}/export?format=csv"
+    )
+
+    return pd.read_csv(csv_url, **kwargs)

google_data_utils/validators.py

@@ -0,0 +1,87 @@
+# validators.py
+
+from urllib.parse import urlparse
+import re
+
+class InvalidGoogleUrl(ValueError):
+    pass
+
+
+_DRIVE_FILE_RE = re.compile(
+    r"^/file/d/([a-zA-Z0-9_-]+)"
+)
+
+_SHEET_RE = re.compile(
+    r"^/spreadsheets/d/([a-zA-Z0-9_-]+)"
+)
+
+def is_google_drive_url(url: str) -> bool:
+    try:
+        extract_drive_file_id(url)
+        return True
+    except InvalidGoogleUrl:
+        return False
+
+
+def is_google_sheet_url(url: str) -> bool:
+    try:
+        extract_sheet_id(url)
+        return True
+    except InvalidGoogleUrl:
+        return False
+    
+def extract_drive_file_id(url: str) -> str:
+    """
+    Accepts:
+      https://drive.google.com/file/d/FILE_ID/view
+    """
+
+    parsed = urlparse(url)
+
+    if parsed.netloc != "drive.google.com":
+        raise InvalidGoogleUrl(
+            "Expected a drive.google.com URL"
+        )
+
+    match = _DRIVE_FILE_RE.match(parsed.path)
+
+    if not match:
+        raise InvalidGoogleUrl(
+            "Could not extract Drive file ID"
+        )
+
+    return match.group(1)
+
+
+def extract_sheet_id(url: str) -> str:
+    """
+    Accepts:
+      https://docs.google.com/spreadsheets/d/SHEET_ID/edit
+    """
+
+    parsed = urlparse(url)
+
+    if parsed.netloc != "docs.google.com":
+        raise InvalidGoogleUrl(
+            "Expected a docs.google.com URL"
+        )
+
+    match = _SHEET_RE.match(parsed.path)
+
+    if not match:
+        raise InvalidGoogleUrl(
+            "Could not extract Sheet ID"
+        )
+
+    return match.group(1)
+
+def drive_download_url(url: str) -> str:
+    file_id = extract_drive_file_id(url)
+    return f"https://drive.google.com/uc?id={file_id}"
+
+def sheet_csv_url(url: str) -> str:
+    sheet_id = extract_sheet_id(url)
+    return (
+        f"https://docs.google.com/spreadsheets/d/"
+        f"{sheet_id}/export?format=csv"
+    )

google_data_utils-0.1.0.dist-info/METADATA

@@ -0,0 +1,124 @@
+Metadata-Version: 2.4
+Name: google-data-utils
+Version: 0.1.0
+Summary: Load public Google Sheets, CSV, and Excel files into pandas
+Author: Zomi Learner
+License: MIT
+Project-URL: Homepage, https://github.com/ZomiLearner/google-data-utils
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pandas>=1.5
+Requires-Dist: openpyxl>=3.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Dynamic: license-file
+
+# google-data-utils
+
+Simple utilities for loading public Google Drive CSV files, Excel files, and Google Sheets into pandas DataFrames.
+
+> **Note**
+>
+> This package only supports publicly accessible Google Drive files and Google Sheets. Authentication, OAuth, and Google API credentials are not required.
+
+## Features
+
+- Read public Google Drive CSV files into a DataFrame
+- Read public Google Drive Excel files into a DataFrame
+- Read public Google Sheets into a DataFrame
+- Validate Google Drive and Google Sheets URLs
+- Extract Google Drive file IDs and Google Sheets IDs
+- No API keys required
+- No OAuth required
+- No Google Cloud setup required
+
+## Installation
+
+```bash
+pip install google-data-utils
+```
+
+## Usage
+
+### Google Drive CSV
+
+```bash
+from google_data_utils import google_csv_to_df
+
+df = google_csv_to_df(
+    "https://drive.google.com/file/d/FILE_ID/view?usp=sharing"
+)
+```
+
+### Google Drive Excel
+
+```bash
+from google_data_utils import google_excel_to_df
+
+df = google_excel_to_df(
+    "https://drive.google.com/file/d/FILE_ID/view?usp=sharing"
+)
+```
+
+### Google Sheets
+
+```bash
+from google_data_utils import google_sheet_to_df
+
+df = google_sheet_to_df(
+    "https://docs.google.com/spreadsheets/d/SHEET_ID/edit#gid=0"
+)
+```
+
+### URL Validation
+
+```bash
+from google_data_utils import (
+    is_google_drive_url,
+    is_google_sheet_url,
+)
+
+is_google_drive_url(
+    "https://drive.google.com/file/d/FILE_ID/view"
+)
+# True
+
+is_google_sheet_url(
+    "https://docs.google.com/spreadsheets/d/SHEET_ID/edit"
+)
+# True
+```
+
+### Extract IDs
+
+```bash
+from google_data_utils import (
+    extract_drive_file_id,
+    extract_sheet_id,
+)
+
+extract_drive_file_id(
+    "https://drive.google.com/file/d/FILE_ID/view"
+)
+# FILE_ID
+
+extract_sheet_id(
+    "https://docs.google.com/spreadsheets/d/SHEET_ID/edit"
+)
+# SHEET_ID
+```
+
+### Requirements
+
+```text
+Python 3.8+
+pandas
+openpyxl
+```
+
+### License
+
+```text
+MIT License
+```

google_data_utils-0.1.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+google_data_utils/__init__.py,sha256=tGV5F-zuEx8ABvY7coUsMZHAvB9eymxgyGy7agOAem8,440
+google_data_utils/public.py,sha256=IBn6XtSgGKkS95jq4OsOkw5IUGGGdGxKMw6237uqz5M,755
+google_data_utils/validators.py,sha256=U_SS-XL_klXxDeI8gnf1MwFX2yKF1WfLJLPJQsl2qoE,1890
+google_data_utils-0.1.0.dist-info/licenses/LICENSE,sha256=d6T_o-Df7Rq3BHyQwe9ErjlGSMk5e59UvthELwFInC8,1090
+google_data_utils-0.1.0.dist-info/METADATA,sha256=IXjv3LLCmgovyXCVaG79tcfFk4USSsmw7UcPm7Od6fs,2381
+google_data_utils-0.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+google_data_utils-0.1.0.dist-info/top_level.txt,sha256=FvV4kRXkGM0e4MacZ7_PyfWlyE7IAJ57V0MyrH_XI54,18
+google_data_utils-0.1.0.dist-info/RECORD,,

google_data_utils-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

google_data_utils-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zomi Learner
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

google_data_utils-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+google_data_utils