ggltasks 0.1.7__tar.gz

ggltasks-0.1.7/PKG-INFO

@@ -0,0 +1,102 @@
+Metadata-Version: 2.4
+Name: ggltasks
+Version: 0.1.7
+Summary: TUI for Google Tasks
+Author-email: Noble Alex <noblejosephalex@gmail.com>
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Environment :: Console :: Curses
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: google-api-python-client
+Requires-Dist: google-auth-oauthlib
+Requires-Dist: google-auth-httplib2
+Requires-Dist: uni-curses
+Requires-Dist: python-dateutil
+Dynamic: license-file
+
+# ggltasks
+
+A lightning-fast, robust TUI for Google Tasks, built for terminal power users.
+
+## Features
+
+* **Async UI**: Network requests are threaded. The app boots instantly and never freezes.
+* **Native Sync**: Moves, completions, and deletions flawlessly sync with the official Google backend.
+* **Smart Timestamps**: Due dates and "Last Updated" timestamps.
+* **Vim Navigation**: Navigate entirely using `h/j/k/l`.
+
+## Screenshots
+
+<img width="1365" height="742" alt="image" src="https://github.com/user-attachments/assets/4c51a8ba-eac3-4a02-ab62-060d91150941" />
+
+## Installation
+
+Google requires you to generate a personal "Client Secret" to access your data securely.
+
+### Step 1: Get Google API Credentials
+1. Go to the [Google Cloud Console](https://console.cloud.google.com/).
+2. Create a **New Project** (e.g., `ggltasks-cli`).
+3. Search for **Google Tasks API** and click **Enable**.
+4. Go to **APIs & Services → Credentials**.
+5. Click **+ CREATE CREDENTIALS** → **OAuth client ID**. *(Choose "Desktop app" as the Application type).*
+6. Download the JSON file and rename it exactly to `client_secrets.json`.
+
+### Step 2: Install the App
+1. Create a hidden config folder:
+   ```bash
+   mkdir ~/.ggltasks
+   ```
+2. Move your `client_secrets.json` file into `~/.ggltasks`.
+3. Install via pip:
+   ```bash
+   pip install ggltasks
+   ```
+4. Run the app:
+   ```bash
+   ggltasks
+   ```
+*Note: The first time you run it, a browser window will pop up asking you to log in to your Google Account. A local token is saved so you only have to do this once.*
+
+## Usage
+
+| Key            | Action                                      |
+| :------------- | :------------------------------------------ |
+| `q`            | Quit                                        |
+| `w`            | Force Sync                                  |
+| `↑` / `k`      | Navigate Up                                 |
+| `↓` / `j`      | Navigate Down                               |
+| `←` / `h`      | Back / Switch Panels                        |
+| `→` / `l`      | Enter Subtasks                              |
+| `Shift + K`    | Move Task Up                                |
+| `Shift + J`    | Move Task Down                              |
+| `o`            | Add new task/list                           |
+| `d`            | Delete item                                 |
+| `r`            | Rename item                                 |
+| `c`            | Toggle task completion                      |
+| `Shift + X`    | Clear Completed Tasks                       |
+| `a`            | Set Due Date                                |
+| `i`            | Edit Notes                                  |
+| `p`            | Paste deleted task                          |
+| `?`            | Toggle Help Menu                            |
+
+
+### Task Status Symbols
+
+* `[ ]` : Pending
+* `[X]` : Completed
+* `*` : Has text Note
+* `(N)` : Number of direct subtasks
+* `[Upd: MM-DD HH:MM]` : Local time the task was last updated
+
+## Known Limitations (Google Tasks API)
+
+These are inherit limitations of the official Google Tasks API backend, not this app:
+
+* **No Times on Due Dates**: The API strips specific hours/minutes off due dates, forcing them to midnight UTC. You can assign a day, but not a time.
+* **No Recurring Tasks**: The API does not allow 3rd party apps to create or manage recurring/repeating tasks.
+* **Subtask Display Limits**: The API allows infinitely deep subtasks (and this CLI app fully supports them). However, Google's official web/mobile apps will only display 1 level deep. 
+
+## License
+MIT License.

ggltasks-0.1.7/README.md

@@ -0,0 +1,84 @@
+# ggltasks
+
+A lightning-fast, robust TUI for Google Tasks, built for terminal power users.
+
+## Features
+
+* **Async UI**: Network requests are threaded. The app boots instantly and never freezes.
+* **Native Sync**: Moves, completions, and deletions flawlessly sync with the official Google backend.
+* **Smart Timestamps**: Due dates and "Last Updated" timestamps.
+* **Vim Navigation**: Navigate entirely using `h/j/k/l`.
+
+## Screenshots
+
+<img width="1365" height="742" alt="image" src="https://github.com/user-attachments/assets/4c51a8ba-eac3-4a02-ab62-060d91150941" />
+
+## Installation
+
+Google requires you to generate a personal "Client Secret" to access your data securely.
+
+### Step 1: Get Google API Credentials
+1. Go to the [Google Cloud Console](https://console.cloud.google.com/).
+2. Create a **New Project** (e.g., `ggltasks-cli`).
+3. Search for **Google Tasks API** and click **Enable**.
+4. Go to **APIs & Services → Credentials**.
+5. Click **+ CREATE CREDENTIALS** → **OAuth client ID**. *(Choose "Desktop app" as the Application type).*
+6. Download the JSON file and rename it exactly to `client_secrets.json`.
+
+### Step 2: Install the App
+1. Create a hidden config folder:
+   ```bash
+   mkdir ~/.ggltasks
+   ```
+2. Move your `client_secrets.json` file into `~/.ggltasks`.
+3. Install via pip:
+   ```bash
+   pip install ggltasks
+   ```
+4. Run the app:
+   ```bash
+   ggltasks
+   ```
+*Note: The first time you run it, a browser window will pop up asking you to log in to your Google Account. A local token is saved so you only have to do this once.*
+
+## Usage
+
+| Key            | Action                                      |
+| :------------- | :------------------------------------------ |
+| `q`            | Quit                                        |
+| `w`            | Force Sync                                  |
+| `↑` / `k`      | Navigate Up                                 |
+| `↓` / `j`      | Navigate Down                               |
+| `←` / `h`      | Back / Switch Panels                        |
+| `→` / `l`      | Enter Subtasks                              |
+| `Shift + K`    | Move Task Up                                |
+| `Shift + J`    | Move Task Down                              |
+| `o`            | Add new task/list                           |
+| `d`            | Delete item                                 |
+| `r`            | Rename item                                 |
+| `c`            | Toggle task completion                      |
+| `Shift + X`    | Clear Completed Tasks                       |
+| `a`            | Set Due Date                                |
+| `i`            | Edit Notes                                  |
+| `p`            | Paste deleted task                          |
+| `?`            | Toggle Help Menu                            |
+
+
+### Task Status Symbols
+
+* `[ ]` : Pending
+* `[X]` : Completed
+* `*` : Has text Note
+* `(N)` : Number of direct subtasks
+* `[Upd: MM-DD HH:MM]` : Local time the task was last updated
+
+## Known Limitations (Google Tasks API)
+
+These are inherit limitations of the official Google Tasks API backend, not this app:
+
+* **No Times on Due Dates**: The API strips specific hours/minutes off due dates, forcing them to midnight UTC. You can assign a day, but not a time.
+* **No Recurring Tasks**: The API does not allow 3rd party apps to create or manage recurring/repeating tasks.
+* **Subtask Display Limits**: The API allows infinitely deep subtasks (and this CLI app fully supports them). However, Google's official web/mobile apps will only display 1 level deep. 
+
+## License
+MIT License.

ggltasks-0.1.7/ggltasks/auth.py

@@ -0,0 +1,53 @@
+import os
+import google.oauth2.credentials
+from google_auth_oauthlib.flow import InstalledAppFlow
+from google.auth.transport.requests import Request
+
+SCOPES = ['https://www.googleapis.com/auth/tasks']
+HOME_DIR = os.path.expanduser('~')
+GGLTASKS_DIR = os.path.join(HOME_DIR, '.ggltasks')
+TOKEN_PATH = os.path.join(GGLTASKS_DIR, 'token.json')
+CLIENT_SECRETS_PATH = os.path.join(GGLTASKS_DIR, 'client_secrets.json')
+
+
+def _ensure_dir_exists():
+    os.makedirs(GGLTASKS_DIR, exist_ok=True)
+
+
+def get_credentials():
+    _ensure_dir_exists()
+
+    if not os.path.exists(CLIENT_SECRETS_PATH):
+        raise FileNotFoundError(
+            f"\n\n  Google API credentials not found!\n"
+            f"  Expected location: {CLIENT_SECRETS_PATH}\n\n"
+            f"  Steps to fix:\n"
+            f"  1. Go to https://console.cloud.google.com/\n"
+            f"  2. APIs & Services → Credentials → Create Credentials → OAuth 2.0 Client ID\n"
+            f"  3. Application type: Desktop App\n"
+            f"  4. Download the JSON file, rename it to 'client_secrets.json'\n"
+            f"  5. Move it to: {CLIENT_SECRETS_PATH}\n"
+        )
+
+    creds = None
+    if os.path.exists(TOKEN_PATH):
+        try:
+            creds = google.oauth2.credentials.Credentials.from_authorized_user_file(TOKEN_PATH, SCOPES)
+        except Exception as e:
+            print(f"Error loading token.json: {e}. Initiating full re-authentication.")
+            creds = None
+
+    if not creds or not creds.valid:
+        if creds and creds.expired and creds.refresh_token:
+            try:
+                creds.refresh(Request())
+            except Exception as e:
+                print(f"Token refresh failed: {e}. Initiating full re-authentication.")
+                creds = None
+        if not creds:
+            flow = InstalledAppFlow.from_client_secrets_file(CLIENT_SECRETS_PATH, SCOPES)
+            creds = flow.run_local_server(port=0)
+        with open(TOKEN_PATH, 'w') as token:
+            token.write(creds.to_json())
+
+    return creds

ggltasks-0.1.7/ggltasks/local_storage.py

@@ -0,0 +1,37 @@
+import os
+import json
+
+HOME_DIR = os.path.expanduser('~')
+GGLTASKS_DIR = os.path.join(HOME_DIR, '.ggltasks')
+STORAGE_FILE = os.path.join(GGLTASKS_DIR, 'local_tasks.json')
+
+
+def _ensure_dir_exists():
+    os.makedirs(GGLTASKS_DIR, exist_ok=True)
+
+
+def load_data():
+    _ensure_dir_exists()
+    if not os.path.exists(STORAGE_FILE):
+        return {'task_lists': [], 'tasks': {}}
+    try:
+        with open(STORAGE_FILE, 'r') as f:
+            return json.load(f)
+    except (json.JSONDecodeError, IOError):
+        return {'task_lists': [], 'tasks': {}}
+
+
+def save_data(data):
+    _ensure_dir_exists()
+    tmp_path = STORAGE_FILE + '.tmp'
+    try:
+        with open(tmp_path, 'w') as f:
+            json.dump(data, f, indent=4)
+        os.replace(tmp_path, STORAGE_FILE)
+        return True
+    except IOError:
+        try:
+            os.remove(tmp_path)
+        except OSError:
+            pass
+        return False