goodoc 1.0.0__tar.gz

goodoc-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Igor Djachenko
+
+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.

goodoc-1.0.0/PKG-INFO

@@ -0,0 +1,139 @@
+Metadata-Version: 2.4
+Name: goodoc
+Version: 1.0.0
+Summary: Upload office files to Google Drive with auto-conversion to Docs/Sheets/Slides
+Author: Igor Djachenko
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/djachenko/goodoc
+Project-URL: Repository, https://github.com/djachenko/goodoc
+Project-URL: Issues, https://github.com/djachenko/goodoc/issues
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: google-auth>=2.0
+Requires-Dist: google-auth-oauthlib>=1.0
+Requires-Dist: google-api-python-client>=2.0
+Requires-Dist: typer>=0.9
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: ruff; extra == "test"
+Requires-Dist: mypy; extra == "test"
+Provides-Extra: release
+Requires-Dist: build; extra == "release"
+Requires-Dist: python-semantic-release; extra == "release"
+Dynamic: license-file
+
+# goodoc
+
+Upload `.docx`, `.xlsx`, and `.pptx` files to Google Drive with automatic conversion to native Google formats (Docs / Sheets / Slides). Integrates into macOS Finder as a right-click Quick Action.
+
+**Typical workflow:** got a file to review → right-click → opens in Google Docs. No Word, no drag-and-drop.
+
+---
+
+## Requirements
+
+- macOS
+- Python 3.10+
+- [pipx](https://pipx.pypa.io/)
+- A Google Cloud project with **Drive API** enabled and an OAuth 2.0 Desktop credentials file
+
+---
+
+## Installation
+
+```bash
+pipx install git+https://github.com/djachenko/goodoc.git
+```
+
+Or clone and install locally:
+
+```bash
+git clone https://github.com/djachenko/goodoc.git
+cd goodoc
+pipx install .
+```
+
+---
+
+## Google Cloud setup
+
+1. Go to [console.cloud.google.com](https://console.cloud.google.com) and create or select a project
+2. **APIs & Services → Library** → search for `Google Drive API` → **Enable**
+3. **APIs & Services → Credentials** → **Create Credentials → OAuth 2.0 Client ID**
+   - Application type: **Desktop app**
+   - Download the JSON file
+4. Place the file at `~/.goodoc/credentials.json`:
+
+```bash
+mkdir -p ~/.goodoc
+mv ~/Downloads/client_secret_*.json ~/.goodoc/credentials.json
+```
+
+On first run, a browser window will open for Google authorization. The token is saved to `~/.goodoc/token.json` — subsequent runs are silent.
+
+---
+
+## Usage
+
+```bash
+goodoc file.docx           # upload and open in browser
+goodoc file.xlsx --no-open # upload without opening
+```
+
+Supported formats:
+
+| Extension | Converts to |
+|---|---|
+| `.docx` | Google Docs |
+| `.xlsx` | Google Sheets |
+| `.pptx` | Google Slides |
+
+---
+
+## Finder integration (macOS Quick Action)
+
+1. Open **Automator** → **New Document** → **Quick Action**
+2. Set **Workflow receives current**: `files or folders` in `Finder`
+3. Add a **Run Shell Script** action, set **Pass input**: `as arguments`
+4. Paste the script:
+
+```bash
+for f in "$@"; do
+    "$(which goodoc)" "$f"
+done
+```
+
+5. **File → Save** → name it `Open in Google Docs`
+
+Right-click any `.docx`, `.xlsx`, or `.pptx` in Finder → **Quick Actions → Open in Google Docs**.
+
+> If `which goodoc` doesn't work in Automator, replace it with the full path from `which goodoc` in your terminal (e.g. `/Users/you/.local/bin/goodoc`).
+
+> If the action doesn't appear in the menu: Finder → **Finder menu → Services → Services Preferences…** → find `Open in Google Docs` and enable it.
+
+---
+
+## Revoking access
+
+To re-authorize, delete the token:
+
+```bash
+rm ~/.goodoc/token.json
+```
+
+---
+
+## License
+
+MIT

goodoc-1.0.0/README.md

@@ -0,0 +1,104 @@
+# goodoc
+
+Upload `.docx`, `.xlsx`, and `.pptx` files to Google Drive with automatic conversion to native Google formats (Docs / Sheets / Slides). Integrates into macOS Finder as a right-click Quick Action.
+
+**Typical workflow:** got a file to review → right-click → opens in Google Docs. No Word, no drag-and-drop.
+
+---
+
+## Requirements
+
+- macOS
+- Python 3.10+
+- [pipx](https://pipx.pypa.io/)
+- A Google Cloud project with **Drive API** enabled and an OAuth 2.0 Desktop credentials file
+
+---
+
+## Installation
+
+```bash
+pipx install git+https://github.com/djachenko/goodoc.git
+```
+
+Or clone and install locally:
+
+```bash
+git clone https://github.com/djachenko/goodoc.git
+cd goodoc
+pipx install .
+```
+
+---
+
+## Google Cloud setup
+
+1. Go to [console.cloud.google.com](https://console.cloud.google.com) and create or select a project
+2. **APIs & Services → Library** → search for `Google Drive API` → **Enable**
+3. **APIs & Services → Credentials** → **Create Credentials → OAuth 2.0 Client ID**
+   - Application type: **Desktop app**
+   - Download the JSON file
+4. Place the file at `~/.goodoc/credentials.json`:
+
+```bash
+mkdir -p ~/.goodoc
+mv ~/Downloads/client_secret_*.json ~/.goodoc/credentials.json
+```
+
+On first run, a browser window will open for Google authorization. The token is saved to `~/.goodoc/token.json` — subsequent runs are silent.
+
+---
+
+## Usage
+
+```bash
+goodoc file.docx           # upload and open in browser
+goodoc file.xlsx --no-open # upload without opening
+```
+
+Supported formats:
+
+| Extension | Converts to |
+|---|---|
+| `.docx` | Google Docs |
+| `.xlsx` | Google Sheets |
+| `.pptx` | Google Slides |
+
+---
+
+## Finder integration (macOS Quick Action)
+
+1. Open **Automator** → **New Document** → **Quick Action**
+2. Set **Workflow receives current**: `files or folders` in `Finder`
+3. Add a **Run Shell Script** action, set **Pass input**: `as arguments`
+4. Paste the script:
+
+```bash
+for f in "$@"; do
+    "$(which goodoc)" "$f"
+done
+```
+
+5. **File → Save** → name it `Open in Google Docs`
+
+Right-click any `.docx`, `.xlsx`, or `.pptx` in Finder → **Quick Actions → Open in Google Docs**.
+
+> If `which goodoc` doesn't work in Automator, replace it with the full path from `which goodoc` in your terminal (e.g. `/Users/you/.local/bin/goodoc`).
+
+> If the action doesn't appear in the menu: Finder → **Finder menu → Services → Services Preferences…** → find `Open in Google Docs` and enable it.
+
+---
+
+## Revoking access
+
+To re-authorize, delete the token:
+
+```bash
+rm ~/.goodoc/token.json
+```
+
+---
+
+## License
+
+MIT

goodoc-1.0.0/pyproject.toml

@@ -0,0 +1,56 @@
+[build-system]
+requires = ["setuptools>=77.0.3"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "goodoc"
+version = "1.0.0"
+description = "Upload office files to Google Drive with auto-conversion to Docs/Sheets/Slides"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Igor Djachenko" }]
+requires-python = ">=3.10"
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: End Users/Desktop",
+    "Operating System :: MacOS",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "google-auth>=2.0",
+    "google-auth-oauthlib>=1.0",
+    "google-api-python-client>=2.0",
+    "typer>=0.9",
+]
+
+[project.optional-dependencies]
+test = ["pytest", "ruff", "mypy"]
+release = ["build", "python-semantic-release"]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[project.urls]
+Homepage = "https://github.com/djachenko/goodoc"
+Repository = "https://github.com/djachenko/goodoc"
+Issues = "https://github.com/djachenko/goodoc/issues"
+
+[project.scripts]
+goodoc = "goodoc.main:app"
+
+[tool.mypy]
+ignore_missing_imports = true
+
+[tool.semantic_release]
+version_toml = ["pyproject.toml:project.version"]
+branch = "master"
+build_command = "pip install build && python -m build"
+changelog_file = "CHANGELOG.md"
+commit_message = "chore(release): v{version} [skip ci]"

goodoc-1.0.0/setup.cfg

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

goodoc-1.0.0/src/goodoc/main.py

@@ -0,0 +1,129 @@
+#!/usr/bin/env python3
+"""
+goodoc — uploads office files to Google Drive with conversion, opens in browser.
+
+Supported formats:
+    .docx  → Google Docs
+    .xlsx  → Google Sheets
+    .pptx  → Google Slides
+
+Credentials: ~/.goodoc/credentials.json
+Token: ~/.goodoc/token.json
+
+Usage:
+    goodoc file.docx
+    goodoc file.xlsx --no-open
+"""
+
+from pathlib import Path
+
+import typer
+import webbrowser
+from google.auth.transport.requests import Request
+from google.oauth2.credentials import Credentials
+from google_auth_oauthlib.flow import InstalledAppFlow
+from googleapiclient.discovery import build
+from googleapiclient.http import MediaFileUpload
+
+SCOPES = ["https://www.googleapis.com/auth/drive.file"]
+
+GOODOC_DIR = Path.home() / ".goodoc"
+CREDENTIALS_PATH = GOODOC_DIR / "credentials.json"
+TOKEN_PATH = GOODOC_DIR / "token.json"
+
+MIME_MAP = {
+    ".docx": (
+        "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+        "application/vnd.google-apps.document",
+    ),
+    ".xlsx": (
+        "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+        "application/vnd.google-apps.spreadsheet",
+    ),
+    ".pptx": (
+        "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+        "application/vnd.google-apps.presentation",
+    ),
+}
+
+app = typer.Typer(add_completion=False)
+
+
+def get_credentials() -> Credentials:
+    if not CREDENTIALS_PATH.exists():
+        typer.echo(f"credentials.json not found: {CREDENTIALS_PATH}", err=True)
+        typer.echo("Place your OAuth credentials from Google Cloud Console at ~/.goodoc/credentials.json", err=True)
+
+        raise typer.Exit(1)
+
+    TOKEN_PATH.parent.mkdir(parents=True, exist_ok=True)
+
+    creds = None
+
+    if TOKEN_PATH.exists():
+        creds = Credentials.from_authorized_user_file(str(TOKEN_PATH), SCOPES)
+
+    if not creds or not creds.valid:
+        if creds and creds.expired and creds.refresh_token:
+            creds.refresh(Request())
+        else:
+            flow = InstalledAppFlow.from_client_secrets_file(str(CREDENTIALS_PATH), SCOPES)
+            creds = flow.run_local_server(port=0)
+
+        with TOKEN_PATH.open("w") as f:
+            f.write(creds.to_json())
+
+    return creds
+
+
+def upload(path: Path, creds: Credentials) -> str:
+    suffix = path.suffix.lower()
+
+    if suffix not in MIME_MAP:
+        supported = ", ".join(MIME_MAP)
+        typer.echo(f"Unsupported format: {suffix}. Supported: {supported}", err=True)
+
+        raise typer.Exit(1)
+
+    source_mime, target_mime = MIME_MAP[suffix]
+
+    service = build("drive", "v3", credentials=creds)
+
+    media = MediaFileUpload(str(path), mimetype=source_mime, resumable=False)
+
+    result = (
+        service.files()
+        .create(
+            body={"name": path.stem, "mimeType": target_mime},
+            media_body=media,
+            fields="id,webViewLink",
+        )
+        .execute()
+    )
+
+    return result["webViewLink"]
+
+
+@app.command()
+def main(
+    file: Path = typer.Argument(..., help="Path to file (.docx / .xlsx / .pptx)"),
+    no_open: bool = typer.Option(False, "--no-open", help="Do not open in browser"),
+) -> None:
+    if not file.exists():
+        typer.echo(f"File not found: {file}", err=True)
+
+        raise typer.Exit(1)
+
+    typer.echo(f"Uploading {file.name}...")
+
+    creds = get_credentials()
+    url = upload(file, creds)
+
+    typer.echo(url)
+
+    if not no_open:
+        webbrowser.open(url)
+
+
+if __name__ == "__main__":
+    app()

goodoc-1.0.0/src/goodoc.egg-info/PKG-INFO

@@ -0,0 +1,139 @@
+Metadata-Version: 2.4
+Name: goodoc
+Version: 1.0.0
+Summary: Upload office files to Google Drive with auto-conversion to Docs/Sheets/Slides
+Author: Igor Djachenko
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/djachenko/goodoc
+Project-URL: Repository, https://github.com/djachenko/goodoc
+Project-URL: Issues, https://github.com/djachenko/goodoc/issues
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: google-auth>=2.0
+Requires-Dist: google-auth-oauthlib>=1.0
+Requires-Dist: google-api-python-client>=2.0
+Requires-Dist: typer>=0.9
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: ruff; extra == "test"
+Requires-Dist: mypy; extra == "test"
+Provides-Extra: release
+Requires-Dist: build; extra == "release"
+Requires-Dist: python-semantic-release; extra == "release"
+Dynamic: license-file
+
+# goodoc
+
+Upload `.docx`, `.xlsx`, and `.pptx` files to Google Drive with automatic conversion to native Google formats (Docs / Sheets / Slides). Integrates into macOS Finder as a right-click Quick Action.
+
+**Typical workflow:** got a file to review → right-click → opens in Google Docs. No Word, no drag-and-drop.
+
+---
+
+## Requirements
+
+- macOS
+- Python 3.10+
+- [pipx](https://pipx.pypa.io/)
+- A Google Cloud project with **Drive API** enabled and an OAuth 2.0 Desktop credentials file
+
+---
+
+## Installation
+
+```bash
+pipx install git+https://github.com/djachenko/goodoc.git
+```
+
+Or clone and install locally:
+
+```bash
+git clone https://github.com/djachenko/goodoc.git
+cd goodoc
+pipx install .
+```
+
+---
+
+## Google Cloud setup
+
+1. Go to [console.cloud.google.com](https://console.cloud.google.com) and create or select a project
+2. **APIs & Services → Library** → search for `Google Drive API` → **Enable**
+3. **APIs & Services → Credentials** → **Create Credentials → OAuth 2.0 Client ID**
+   - Application type: **Desktop app**
+   - Download the JSON file
+4. Place the file at `~/.goodoc/credentials.json`:
+
+```bash
+mkdir -p ~/.goodoc
+mv ~/Downloads/client_secret_*.json ~/.goodoc/credentials.json
+```
+
+On first run, a browser window will open for Google authorization. The token is saved to `~/.goodoc/token.json` — subsequent runs are silent.
+
+---
+
+## Usage
+
+```bash
+goodoc file.docx           # upload and open in browser
+goodoc file.xlsx --no-open # upload without opening
+```
+
+Supported formats:
+
+| Extension | Converts to |
+|---|---|
+| `.docx` | Google Docs |
+| `.xlsx` | Google Sheets |
+| `.pptx` | Google Slides |
+
+---
+
+## Finder integration (macOS Quick Action)
+
+1. Open **Automator** → **New Document** → **Quick Action**
+2. Set **Workflow receives current**: `files or folders` in `Finder`
+3. Add a **Run Shell Script** action, set **Pass input**: `as arguments`
+4. Paste the script:
+
+```bash
+for f in "$@"; do
+    "$(which goodoc)" "$f"
+done
+```
+
+5. **File → Save** → name it `Open in Google Docs`
+
+Right-click any `.docx`, `.xlsx`, or `.pptx` in Finder → **Quick Actions → Open in Google Docs**.
+
+> If `which goodoc` doesn't work in Automator, replace it with the full path from `which goodoc` in your terminal (e.g. `/Users/you/.local/bin/goodoc`).
+
+> If the action doesn't appear in the menu: Finder → **Finder menu → Services → Services Preferences…** → find `Open in Google Docs` and enable it.
+
+---
+
+## Revoking access
+
+To re-authorize, delete the token:
+
+```bash
+rm ~/.goodoc/token.json
+```
+
+---
+
+## License
+
+MIT

goodoc-1.0.0/src/goodoc.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+pyproject.toml
+src/goodoc/__init__.py
+src/goodoc/main.py
+src/goodoc.egg-info/PKG-INFO
+src/goodoc.egg-info/SOURCES.txt
+src/goodoc.egg-info/dependency_links.txt
+src/goodoc.egg-info/entry_points.txt
+src/goodoc.egg-info/requires.txt
+src/goodoc.egg-info/top_level.txt

goodoc-1.0.0/src/goodoc.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

goodoc-1.0.0/src/goodoc.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+goodoc = goodoc.main:app

goodoc-1.0.0/src/goodoc.egg-info/requires.txt

@@ -0,0 +1,13 @@
+google-auth>=2.0
+google-auth-oauthlib>=1.0
+google-api-python-client>=2.0
+typer>=0.9
+
+[release]
+build
+python-semantic-release
+
+[test]
+pytest
+ruff
+mypy

goodoc-1.0.0/src/goodoc.egg-info/top_level.txt

@@ -0,0 +1 @@
+goodoc