google-analytics-cli 0.2.0__py3-none-any.whl → 0.2.2__py3-none-any.whl

ga_cli/__init__.py

@@ -3,6 +3,6 @@
 from importlib.metadata import PackageNotFoundError, version
 
 try:
-    __version__ = version("ga-cli")
+    __version__ = version("google-analytics-cli")
 except PackageNotFoundError:
     __version__ = "0.0.0-dev"

ga_cli/config/constants.py

@@ -1,10 +1,9 @@
 """Application constants and configuration paths."""
 
 import os
+import shutil
 from pathlib import Path
 
-from platformdirs import user_config_dir
-
 # App identity
 APP_NAME = "ga-cli"
 
@@ -21,14 +20,49 @@ OAUTH_SCOPES = [
 # 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 > platformdirs (XDG-compliant)
+# Priority: GA_CLI_CONFIG_DIR env var > ~/.config/ga-cli/ (all platforms)
 def get_config_dir() -> Path:
-    """Get the configuration directory 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)
-    return Path(user_config_dir(APP_NAME))  # ~/.config/ga-cli/ on Linux/macOS
+    config_dir = Path.home() / ".config" / APP_NAME
+    _migrate_legacy_macos_config(config_dir)
+    return config_dir
 
 
 def get_credentials_path() -> Path:

{google_analytics_cli-0.2.0.dist-info → google_analytics_cli-0.2.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: google-analytics-cli
-Version: 0.2.0
+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.0.dist-info → google_analytics_cli-0.2.2.dist-info}/RECORD

@@ -1,4 +1,4 @@
-ga_cli/__init__.py,sha256=u1fUfOShfVMGpKVw01qh843uLrdZ6cArcFt-6I99WK0,227
+ga_cli/__init__.py,sha256=EVdY_GaBSodKq6rMkyKBcUzQLGOHaPDoyFqcDzlnTnY,241
 ga_cli/main.py,sha256=QB_s_-Tq3uxmKbEduMtOQ6hFwo4T_0WDOpHuJLdbUwA,4562
 ga_cli/api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 ga_cli/api/client.py,sha256=GM53azK0cT0a_T9AYGmJfQZdCPanlXTnLXhKXUfLkWA,4375
@@ -36,7 +36,7 @@ ga_cli/commands/property_settings.py,sha256=TJbpmSZBUJ9NIYmaVprYIqw8X3-Lp8AC7t1V
 ga_cli/commands/reports.py,sha256=QE6hVHnv0maz-0Bt4owdlBvVe9Hp4C0dVslo-aMRViA,39198
 ga_cli/commands/upgrade_cmd.py,sha256=RSYEz97sNKibVwiINsdX4j6TrEhNrg2cd9BWMGPNYJA,4876
 ga_cli/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-ga_cli/config/constants.py,sha256=Oo_gg1R8WVNColi3wFLCKQkVH_DiCPL_07HQFt9HgL4,1651
+ga_cli/config/constants.py,sha256=p-1l8q7vv2FEbOGsi0NKJEEbuZprTlXSpU6h614KVHY,2926
 ga_cli/config/store.py,sha256=fqB3AV3DcAz94sq2qXNEI8d6MBfXA945QFaYq25NraU,3294
 ga_cli/utils/__init__.py,sha256=iGF_XKuesFSCPmC-AA7WByxZeQutN6dQqlO_BG4_u3Q,1356
 ga_cli/utils/describe.py,sha256=QtCXB4Nm3DKb9BBxDEQbHv6UbDL3bo7WRYRucIEWaXs,3999
@@ -45,7 +45,7 @@ ga_cli/utils/errors.py,sha256=l0Iwjmj1QqzLU032QAiVUnIbfntkxoIAZqyQCfgACCE,4465
 ga_cli/utils/filters.py,sha256=tYtajCWC5CGPtrlpT95KA19y86a6cg0ejQXXjzguheg,8378
 ga_cli/utils/output.py,sha256=0ihWQi7-kGSkNb-0OTFv_12ZmqVUjpZQLEGjvNrxUeE,6092
 ga_cli/utils/pagination.py,sha256=w6_To6luCR54M04Uk_WFFydvProG2yGxN-CzkzSk9c4,2380
-google_analytics_cli-0.2.0.dist-info/METADATA,sha256=ls6gjqxYIhTYjUOWqJAuMJtK5F-niZobisqYk8_dgns,11904
-google_analytics_cli-0.2.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
-google_analytics_cli-0.2.0.dist-info/entry_points.txt,sha256=J1Jvi1IZo4YujxqhyipvHz4NAepNhxZo7g_WyQIIOz0,39
-google_analytics_cli-0.2.0.dist-info/RECORD,,
+google_analytics_cli-0.2.2.dist-info/METADATA,sha256=SYDIzjG8dtMtttGgRndffEUCOeWL61CXhBS1udcUM_E,12870
+google_analytics_cli-0.2.2.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+google_analytics_cli-0.2.2.dist-info/entry_points.txt,sha256=J1Jvi1IZo4YujxqhyipvHz4NAepNhxZo7g_WyQIIOz0,39
+google_analytics_cli-0.2.2.dist-info/RECORD,,