google-analytics-cli 0.2.1__tar.gz → 0.2.2__tar.gz

{google_analytics_cli-0.2.1 → google_analytics_cli-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: google-analytics-cli
-Version: 0.2.1
+Version: 0.2.2
 Summary: Command-line interface for Google Analytics 4
 Project-URL: Homepage, https://github.com/daidalytics/google-analytics-cli
 Project-URL: Repository, https://github.com/daidalytics/google-analytics-cli
@@ -24,7 +24,6 @@ Requires-Dist: google-api-python-client>=2.0
 Requires-Dist: google-auth-oauthlib>=1.0
 Requires-Dist: google-auth>=2.0
 Requires-Dist: packaging>=23.0
-Requires-Dist: platformdirs>=4.0
 Requires-Dist: questionary>=2.0
 Requires-Dist: rich>=13.0
 Requires-Dist: shellingham>=1.3.0
@@ -298,6 +297,20 @@ jobs:
           rm /tmp/sa-key.json
 ```
 
+## Troubleshooting
+
+**`ga` runs `git add` instead of GA CLI.** You have a shell alias shadowing the command — commonly `alias ga='git add'` in `~/.gitconfig`-style setups or `~/.zshrc`/`~/.bashrc`. Run `type ga` to confirm, then `unalias ga` (or remove the alias from your shell config) and restart your shell.
+
+**`ga: command not found` after install.** Your Python user bin directory isn't on `PATH`. For `pip install --user`, `pipx`, or `uv tool install`, the binary lives in `~/.local/bin` on Linux/macOS. Add it to your shell config:
+
+```bash
+echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc  # or ~/.bashrc
+```
+
+Then restart your shell. `pipx ensurepath` and `uv tool update-shell` can do this automatically.
+
+**Upgrading from 0.2.1 or earlier on macOS.** Older versions stored config at `~/Library/Application Support/ga-cli/`. GA CLI now uses `~/.config/ga-cli/` on all platforms and will migrate the directory automatically the first time you run any command. No action required.
+
 ## Privacy
 
 GA CLI stores authentication credentials locally on your machine. No data is sent to any third party — all communication is directly between your machine and Google's APIs.

{google_analytics_cli-0.2.1 → google_analytics_cli-0.2.2}/README.md

@@ -265,6 +265,20 @@ jobs:
           rm /tmp/sa-key.json
 ```
 
+## Troubleshooting
+
+**`ga` runs `git add` instead of GA CLI.** You have a shell alias shadowing the command — commonly `alias ga='git add'` in `~/.gitconfig`-style setups or `~/.zshrc`/`~/.bashrc`. Run `type ga` to confirm, then `unalias ga` (or remove the alias from your shell config) and restart your shell.
+
+**`ga: command not found` after install.** Your Python user bin directory isn't on `PATH`. For `pip install --user`, `pipx`, or `uv tool install`, the binary lives in `~/.local/bin` on Linux/macOS. Add it to your shell config:
+
+```bash
+echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc  # or ~/.bashrc
+```
+
+Then restart your shell. `pipx ensurepath` and `uv tool update-shell` can do this automatically.
+
+**Upgrading from 0.2.1 or earlier on macOS.** Older versions stored config at `~/Library/Application Support/ga-cli/`. GA CLI now uses `~/.config/ga-cli/` on all platforms and will migrate the directory automatically the first time you run any command. No action required.
+
 ## Privacy
 
 GA CLI stores authentication credentials locally on your machine. No data is sent to any third party — all communication is directly between your machine and Google's APIs.

{google_analytics_cli-0.2.1 → google_analytics_cli-0.2.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "google-analytics-cli"
-version = "0.2.1"
+version = "0.2.2"
 description = "Command-line interface for Google Analytics 4"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -28,7 +28,6 @@ dependencies = [
     "google-auth>=2.0",
     "rich>=13.0",
     "questionary>=2.0",
-    "platformdirs>=4.0",
     "packaging>=23.0",
 ]
 

google_analytics_cli-0.2.2/src/ga_cli/config/constants.py

@@ -0,0 +1,95 @@
+"""Application constants and configuration paths."""
+
+import os
+import shutil
+from pathlib import Path
+
+# App identity
+APP_NAME = "ga-cli"
+
+# OAuth 2.0 scopes
+OAUTH_SCOPES = [
+    "openid",
+    "https://www.googleapis.com/auth/analytics.readonly",
+    "https://www.googleapis.com/auth/analytics.edit",
+    "https://www.googleapis.com/auth/analytics.manage.users",
+    "https://www.googleapis.com/auth/userinfo.email",
+    "https://www.googleapis.com/auth/userinfo.profile",
+]
+
+# OAuth callback server
+OAUTH_CALLBACK_PORT = 8085
+
+# Track whether we've already attempted the legacy macOS migration this process.
+_legacy_migration_attempted = False
+
+
+def _migrate_legacy_macos_config(new_dir: Path) -> None:
+    """Move config from the legacy macOS path to the new XDG-style path.
+
+    Versions <=0.2.1 used ``platformdirs``, which on macOS resolves to
+    ``~/Library/Application Support/ga-cli/``. We now standardize on
+    ``~/.config/ga-cli/`` across all platforms. If the legacy directory exists
+    and the new one doesn't, move it. Runs at most once per process.
+    """
+    global _legacy_migration_attempted
+    if _legacy_migration_attempted:
+        return
+    _legacy_migration_attempted = True
+
+    legacy_dir = Path.home() / "Library" / "Application Support" / APP_NAME
+    if legacy_dir.is_dir() and not new_dir.exists():
+        try:
+            new_dir.parent.mkdir(parents=True, exist_ok=True)
+            shutil.move(str(legacy_dir), str(new_dir))
+        except OSError:
+            # Migration is best-effort; fall through and let callers create
+            # the new directory themselves if needed.
+            pass
+
+
+# Configuration directory
+# Priority: GA_CLI_CONFIG_DIR env var > ~/.config/ga-cli/ (all platforms)
+def get_config_dir() -> Path:
+    """Get the configuration directory path.
+
+    Resolution order:
+      1. ``GA_CLI_CONFIG_DIR`` environment variable (used in tests too).
+      2. ``~/.config/ga-cli/`` on all platforms.
+    """
+    env_dir = os.environ.get("GA_CLI_CONFIG_DIR")
+    if env_dir:
+        return Path(env_dir)
+    config_dir = Path.home() / ".config" / APP_NAME
+    _migrate_legacy_macos_config(config_dir)
+    return config_dir
+
+
+def get_credentials_path() -> Path:
+    """Path to stored OAuth credentials."""
+    return get_config_dir() / "credentials.json"
+
+
+def get_config_path() -> Path:
+    """Path to user configuration file."""
+    return get_config_dir() / "config.json"
+
+
+def get_auth_method_path() -> Path:
+    """Path to auth method tracking file."""
+    return get_config_dir() / "auth-method.json"
+
+
+def get_client_secret_path() -> Path:
+    """Path to OAuth client secret file (alternative to env vars)."""
+    return get_config_dir() / "client_secret.json"
+
+
+def get_update_check_path() -> Path:
+    """Path to update-check timestamp file."""
+    return get_config_dir() / "update-check.json"
+
+
+# Pagination defaults
+DEFAULT_PAGE_SIZE = 50
+MAX_PAGE_SIZE = 200

{google_analytics_cli-0.2.1 → google_analytics_cli-0.2.2}/uv.lock

@@ -306,7 +306,7 @@ wheels = [
 
 [[package]]
 name = "google-analytics-cli"
-version = "0.1.4"
+version = "0.2.1"
 source = { editable = "." }
 dependencies = [
     { name = "click" },
@@ -314,7 +314,6 @@ dependencies = [
     { name = "google-auth" },
     { name = "google-auth-oauthlib" },
     { name = "packaging" },
-    { name = "platformdirs" },
     { name = "questionary" },
     { name = "rich" },
     { name = "shellingham" },
@@ -334,7 +333,6 @@ requires-dist = [
     { name = "google-auth", specifier = ">=2.0" },
     { name = "google-auth-oauthlib", specifier = ">=1.0" },
     { name = "packaging", specifier = ">=23.0" },
-    { name = "platformdirs", specifier = ">=4.0" },
     { name = "questionary", specifier = ">=2.0" },
     { name = "rich", specifier = ">=13.0" },
     { name = "shellingham", specifier = ">=1.3.0" },
@@ -499,15 +497,6 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/b7/b9/c538f279a4e237a006a2c98387d081e9eb060d203d8ed34467cc0f0b9b53/packaging-26.0-py3-none-any.whl", hash = "sha256:b36f1fef9334a5588b4166f8bcd26a14e521f2b55e6b9de3aaa80d3ff7a37529", size = 74366, upload-time = "2026-01-21T20:50:37.788Z" },
 ]
 
-[[package]]
-name = "platformdirs"
-version = "4.9.4"
-source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/19/56/8d4c30c8a1d07013911a8fdbd8f89440ef9f08d07a1b50ab8ca8be5a20f9/platformdirs-4.9.4.tar.gz", hash = "sha256:1ec356301b7dc906d83f371c8f487070e99d3ccf9e501686456394622a01a934", size = 28737, upload-time = "2026-03-05T18:34:13.271Z" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/63/d7/97f7e3a6abb67d8080dd406fd4df842c2be0efaf712d1c899c32a075027c/platformdirs-4.9.4-py3-none-any.whl", hash = "sha256:68a9a4619a666ea6439f2ff250c12a853cd1cbd5158d258bd824a7df6be2f868", size = 21216, upload-time = "2026-03-05T18:34:12.172Z" },
-]
-
 [[package]]
 name = "pluggy"
 version = "1.6.0"

google_analytics_cli-0.2.1/src/ga_cli/config/constants.py

@@ -1,61 +0,0 @@
-"""Application constants and configuration paths."""
-
-import os
-from pathlib import Path
-
-from platformdirs import user_config_dir
-
-# App identity
-APP_NAME = "ga-cli"
-
-# OAuth 2.0 scopes
-OAUTH_SCOPES = [
-    "openid",
-    "https://www.googleapis.com/auth/analytics.readonly",
-    "https://www.googleapis.com/auth/analytics.edit",
-    "https://www.googleapis.com/auth/analytics.manage.users",
-    "https://www.googleapis.com/auth/userinfo.email",
-    "https://www.googleapis.com/auth/userinfo.profile",
-]
-
-# OAuth callback server
-OAUTH_CALLBACK_PORT = 8085
-
-# Configuration directory
-# Priority: GA_CLI_CONFIG_DIR env var > platformdirs (XDG-compliant)
-def get_config_dir() -> Path:
-    """Get the configuration directory path."""
-    env_dir = os.environ.get("GA_CLI_CONFIG_DIR")
-    if env_dir:
-        return Path(env_dir)
-    return Path(user_config_dir(APP_NAME))  # ~/.config/ga-cli/ on Linux/macOS
-
-
-def get_credentials_path() -> Path:
-    """Path to stored OAuth credentials."""
-    return get_config_dir() / "credentials.json"
-
-
-def get_config_path() -> Path:
-    """Path to user configuration file."""
-    return get_config_dir() / "config.json"
-
-
-def get_auth_method_path() -> Path:
-    """Path to auth method tracking file."""
-    return get_config_dir() / "auth-method.json"
-
-
-def get_client_secret_path() -> Path:
-    """Path to OAuth client secret file (alternative to env vars)."""
-    return get_config_dir() / "client_secret.json"
-
-
-def get_update_check_path() -> Path:
-    """Path to update-check timestamp file."""
-    return get_config_dir() / "update-check.json"
-
-
-# Pagination defaults
-DEFAULT_PAGE_SIZE = 50
-MAX_PAGE_SIZE = 200