add analytics query command with metrics/dimensions registry

.github/workflows/ci.yml

@@ -3,6 +3,7 @@ name: CI
 on:
   push:
     branches: [main]
+    tags: ["v*"]
   pull_request:
     branches: [main]
 
@@ -14,10 +15,10 @@ jobs:
         python-version: ["3.12", "3.13"]
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v4
+        uses: astral-sh/setup-uv@v7
 
       - name: Set up Python ${{ matrix.python-version }}
         run: uv python install ${{ matrix.python-version }}
@@ -36,16 +37,17 @@ jobs:
   publish:
     needs: test
     runs-on: ubuntu-latest
-    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
+    if: startsWith(github.ref, 'refs/tags/v')
+    environment: pypi
 
     permissions:
       id-token: write
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v4
+        uses: astral-sh/setup-uv@v7
 
       - name: Build package
         run: uv build

README.md

@@ -1,20 +1,27 @@
-# ytstudio
+# YT Studio CLI
 
 [![CI](https://github.com/jdwit/ytstudio/actions/workflows/ci.yml/badge.svg)](https://github.com/jdwit/ytstudio/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/ytstudio-cli)](https://pypi.org/project/ytstudio-cli/)
+[![Python](https://img.shields.io/pypi/pyversions/ytstudio-cli)](https://pypi.org/project/ytstudio-cli/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-Manage and analyze your YouTube channel from the terminal. Ideal for agent workflows and automation.
+Manage and analyze your YouTube channel from the terminal. Ideal for automation and AI workflows.
+
+![demo](demo.gif)
 
 ## Motivation
 
-I built this tool to bulk update video titles on my channel, something YouTube Studio doesn't support. It uses the YouTube Data API for search-and-replace operations, plus analytics and other channel management features. Simple and scriptable for automating common tasks.
+I built this because I needed to bulk update video titles for a YouTube channel I manage with 300+ videos. YouTube 
+Studio does not support bulk search-replace operations, which made it a tedious manual process. This tool uses the 
+YouTube Data API to perform bulk operations on video metadata. Furthermore, it provides features for analytics and 
+comment moderation, all accesible from the command line.
 
 ## Installation
 
 I recommend the excellent [uv](https://uv.io/) tool for installation:
 
 ```bash
-uv tool install ytstudio
+uv tool install ytstudio-cli
 ```
 
 ## Setup
@@ -40,3 +47,8 @@ ytstudio login
 ```
 
 Credentials stored in `~/.config/ytstudio/`.
+
+## Disclaimer
+
+This project is not affiliated with or endorsed by Google. YouTube and YouTube Studio are trademarks of Google.
+All channel data is accessed exclusively through the official [YouTube Data API](https://developers.google.com/youtube/v3) and [YouTube Analytics API](https://developers.google.com/youtube/analytics).

src/ytstudio/auth.py → src/ytstudio/api.py

@@ -1,4 +1,5 @@
 import typer
+from google.auth.exceptions import RefreshError
 from google.auth.transport.requests import Request
 from google.oauth2.credentials import Credentials
 from google_auth_oauthlib.flow import InstalledAppFlow
@@ -25,11 +26,11 @@ def handle_api_error(error: HttpError) -> None:
                 "Quota resets at midnight Pacific Time (PT).\n"
                 "See: https://developers.google.com/youtube/v3/guides/quota_and_compliance_audits"
             )
-            raise SystemExit(1)
+            raise SystemExit(1) from None
 
         if reason == "forbidden":
             console.print("[red]Access denied. You may not have permission for this action.[/red]")
-            raise SystemExit(1)
+            raise SystemExit(1) from None
 
     # Re-raise for other errors
     raise error
@@ -45,6 +46,11 @@ def api(request):
         return request.execute()
     except HttpError as e:
         handle_api_error(e)
+    except RefreshError:
+        console.print(
+            "[red]Session expired or revoked.[/red] Run [bold]ytstudio login[/bold] to re-authenticate."
+        )
+        raise SystemExit(1) from None
 
 
 # YouTube API scopes
@@ -58,7 +64,7 @@ def api(request):
 def authenticate() -> None:
     if not CLIENT_SECRETS_FILE.exists():
         console.print("[red]No client secrets found. Run 'ytstudio init' first.[/red]")
-        raise SystemExit(1)
+        raise SystemExit(1) from None
 
     console.print("[bold]Authenticating with YouTube...[/bold]\n")
 
@@ -112,7 +118,13 @@ def get_credentials() -> Credentials | None:
     )
 
     if credentials.expired and credentials.refresh_token:
-        credentials.refresh(Request())
+        try:
+            credentials.refresh(Request())
+        except RefreshError:
+            console.print(
+                "[red]Session expired or revoked.[/red] Run [bold]ytstudio login[/bold] to re-authenticate."
+            )
+            raise SystemExit(1) from None
         # Save refreshed credentials
         creds_data["token"] = credentials.token
         save_credentials(creds_data)