google-data-utils 0.1.0__tar.gz

google_data_utils-0.1.0/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/PKG-INFO

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

@@ -0,0 +1,108 @@
+# 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/pyproject.toml

@@ -0,0 +1,31 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "google-data-utils"
+version = "0.1.0"
+description = "Load public Google Sheets, CSV, and Excel files into pandas"
+readme = "README.md"
+requires-python = ">=3.8"
+license = {text = "MIT"}
+authors = [
+    {name = "Zomi Learner"}
+]
+dependencies = [
+    "pandas>=1.5",
+    "openpyxl>=3.0"
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8"
+]
+
+
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[project.urls]
+Homepage = "https://github.com/ZomiLearner/google-data-utils"

google_data_utils-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

google_data_utils-0.1.0/src/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-0.1.0/src/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-0.1.0/src/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/src/google_data_utils.egg-info/PKG-INFO

@@ -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/src/google_data_utils.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+LICENSE
+README.md
+pyproject.toml
+src/google_data_utils/__init__.py
+src/google_data_utils/public.py
+src/google_data_utils/validators.py
+src/google_data_utils.egg-info/PKG-INFO
+src/google_data_utils.egg-info/SOURCES.txt
+src/google_data_utils.egg-info/dependency_links.txt
+src/google_data_utils.egg-info/requires.txt
+src/google_data_utils.egg-info/top_level.txt
+tests/test_drive.py
+tests/test_sheet.py
+tests/test_validators.py

google_data_utils-0.1.0/src/google_data_utils.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

google_data_utils-0.1.0/src/google_data_utils.egg-info/requires.txt

@@ -0,0 +1,5 @@
+pandas>=1.5
+openpyxl>=3.0
+
+[dev]
+pytest>=8

google_data_utils-0.1.0/src/google_data_utils.egg-info/top_level.txt

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

google_data_utils-0.1.0/tests/test_drive.py

@@ -0,0 +1,69 @@
+import pytest
+
+from google_data_utils.validators import (
+    InvalidGoogleUrl,
+    extract_drive_file_id,
+    is_google_drive_url,
+    drive_download_url,
+)
+
+
+def test_extract_drive_file_id():
+    url = (
+        "https://drive.google.com/file/d/"
+        "ABC123_XYZ/view?usp=sharing"
+    )
+
+    assert extract_drive_file_id(url) == "ABC123_XYZ"
+
+
+def test_extract_drive_file_id_invalid_domain():
+    url = (
+        "https://example.com/file/d/"
+        "ABC123/view"
+    )
+
+    with pytest.raises(InvalidGoogleUrl):
+        extract_drive_file_id(url)
+
+
+def test_extract_drive_file_id_invalid_path():
+    url = "https://drive.google.com/"
+
+    with pytest.raises(InvalidGoogleUrl):
+        extract_drive_file_id(url)
+
+
+def test_is_google_drive_url_valid():
+    url = (
+        "https://drive.google.com/file/d/"
+        "ABC123/view"
+    )
+
+    assert is_google_drive_url(url) is True
+
+
+def test_is_google_drive_url_invalid_domain():
+    url = (
+        "https://example.com/file/d/"
+        "ABC123/view"
+    )
+
+    assert is_google_drive_url(url) is False
+
+
+def test_is_google_drive_url_invalid_path():
+    url = "https://drive.google.com"
+
+    assert is_google_drive_url(url) is False
+    
+
+def test_drive_download_url():
+    url = (
+        "https://drive.google.com/file/d/"
+        "ABC123/view"
+    )
+    assert (
+        drive_download_url(url)
+        == "https://drive.google.com/uc?id=ABC123"
+    )

google_data_utils-0.1.0/tests/test_sheet.py

@@ -0,0 +1,77 @@
+# tests/test_sheet.py
+
+import pytest
+
+from google_data_utils.validators import (
+    InvalidGoogleUrl,
+    extract_sheet_id,
+    is_google_sheet_url,
+)
+
+
+def test_extract_sheet_id():
+    url = (
+        "https://docs.google.com/spreadsheets/d/"
+        "ABC123_XYZ/edit#gid=0"
+    )
+
+    assert extract_sheet_id(url) == "ABC123_XYZ"
+
+
+def test_extract_sheet_id_export_url():
+    url = (
+        "https://docs.google.com/spreadsheets/d/"
+        "ABC123_XYZ/export?format=csv"
+    )
+
+    assert extract_sheet_id(url) == "ABC123_XYZ"
+
+
+def test_extract_sheet_id_invalid_domain():
+    url = (
+        "https://example.com/spreadsheets/d/"
+        "ABC123/edit"
+    )
+
+    with pytest.raises(InvalidGoogleUrl):
+        extract_sheet_id(url)
+
+
+def test_extract_sheet_id_invalid_path():
+    url = "https://docs.google.com/spreadsheets"
+
+    with pytest.raises(InvalidGoogleUrl):
+        extract_sheet_id(url)
+
+
+def test_is_google_sheet_url_valid_edit():
+    url = (
+        "https://docs.google.com/spreadsheets/d/"
+        "ABC123/edit"
+    )
+
+    assert is_google_sheet_url(url) is True
+
+
+def test_is_google_sheet_url_valid_export():
+    url = (
+        "https://docs.google.com/spreadsheets/d/"
+        "ABC123/export?format=csv"
+    )
+
+    assert is_google_sheet_url(url) is True
+
+
+def test_is_google_sheet_url_invalid_domain():
+    url = (
+        "https://example.com/spreadsheets/d/"
+        "ABC123/edit"
+    )
+
+    assert is_google_sheet_url(url) is False
+
+
+def test_is_google_sheet_url_invalid_path():
+    url = "https://docs.google.com/spreadsheets"
+
+    assert is_google_sheet_url(url) is False

google_data_utils-0.1.0/tests/test_validators.py

@@ -0,0 +1,10 @@
+from google_data_utils.validators import extract_drive_file_id
+
+
+def test_extract_drive_file_id():
+    url = (
+        "https://drive.google.com/file/d/"
+        "ABC123/view?usp=sharing"
+    )
+
+    assert extract_drive_file_id(url) == "ABC123"