ga4-cli 0.1.1__tar.gz

ga4_cli-0.1.1/LICENSE

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

ga4_cli-0.1.1/PKG-INFO

@@ -0,0 +1,308 @@
+Metadata-Version: 2.4
+Name: ga4-cli
+Version: 0.1.1
+Summary: Command-line interface for Google Analytics 4
+Home-page: https://github.com/sulimanbenhalim/ga-cli
+Author: Suliman Ben Halim
+Author-email: suliman.benhalim@binary.ly
+License: MIT
+Project-URL: Bug Reports, https://github.com/sulimanbenhalim/ga-cli/issues
+Project-URL: Source, https://github.com/sulimanbenhalim/ga-cli
+Project-URL: Documentation, https://github.com/sulimanbenhalim/ga-cli#readme
+Keywords: google-analytics ga4 cli command-line
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click<9.0.0,>=8.0.0
+Requires-Dist: google-analytics-admin<1.0.0,>=0.27.0
+Requires-Dist: google-auth<3.0.0,>=2.0.0
+Requires-Dist: rich<14.0.0,>=13.0.0
+Requires-Dist: pytz>=2023.3
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# GA CLI - Google Analytics Command Line Interface
+
+A command-line interface tool for managing Google Analytics 4 properties, accounts, and data streams.
+
+**Note**: The package is published as `ga4-cli` on PyPI, but the command is `ga-cli`.
+
+## Features
+
+- List and manage Google Analytics accounts
+- Create and manage GA4 properties
+- Manage data streams and retrieve measurement IDs
+- Beautiful table output with Rich
+- JSON output support
+- Authentication via service account credentials
+
+## Installation
+
+### Using pip
+
+```bash
+pip install ga4-cli
+```
+
+After installation, the command is available as `ga-cli`:
+
+```bash
+ga-cli --version
+ga-cli --help
+```
+
+### Using Homebrew (macOS/Linux)
+
+```bash
+# Add the tap
+brew tap sulimanbenhalim/ga-cli
+
+# Install
+brew install ga-cli
+
+# Use it
+ga-cli --version
+```
+
+### Using Docker
+
+```bash
+# Pull from Docker Hub
+docker pull sulimanbenhalim/ga-cli:latest
+
+# Or build locally
+docker build -t ga-cli .
+
+# Run with credentials mounted
+docker run -v /path/to/credentials.json:/credentials.json \
+  -v ~/.ga-cli:/root/.ga-cli \
+  ga-cli accounts list --credentials /credentials.json
+```
+
+### Download Binary (No Python Required)
+
+Download standalone binaries from [GitHub Releases](https://github.com/sulimanbenhalim/ga-cli/releases):
+
+**Linux/macOS:**
+```bash
+# Download and extract
+curl -L -o ga-cli.tar.gz https://github.com/sulimanbenhalim/ga-cli/releases/latest/download/ga-cli-linux-amd64.tar.gz
+tar -xzf ga-cli.tar.gz
+chmod +x ga-cli
+sudo mv ga-cli /usr/local/bin/
+```
+
+**Windows:**
+Download `ga-cli-windows-amd64.exe.zip` from the releases page, extract, and run.
+
+### From source
+
+```bash
+git clone https://github.com/sulimanbenhalim/ga-cli.git
+cd ga-cli
+pip install -e .
+```
+
+## Setup
+
+### 1. Get Google Service Account Credentials
+
+1. Go to [Google Cloud Console](https://console.cloud.google.com/)
+2. Create or select a project
+3. Enable the Google Analytics Admin API
+4. Create a service account with Analytics Admin permissions
+5. Download the JSON credentials file
+
+### 2. Initialize GA CLI
+
+```bash
+ga-cli config init
+```
+
+This will prompt you for the path to your service account JSON file and test the credentials.
+
+Alternatively, set the environment variable:
+
+```bash
+export GOOGLE_APPLICATION_CREDENTIALS=/path/to/credentials.json
+```
+
+## Usage
+
+### Configuration
+
+```bash
+# Initialize with credentials
+ga-cli config init
+
+# Show current configuration
+ga-cli config show
+```
+
+### Accounts
+
+```bash
+# List all accounts
+ga-cli accounts list
+
+# Get account details
+ga-cli accounts get <account-id>
+
+# Output as JSON
+ga-cli accounts list --format json
+```
+
+### Properties
+
+```bash
+# List properties for an account
+ga-cli properties list <account-id>
+
+# Get property details
+ga-cli properties get <property-id>
+
+# Create a new property
+ga-cli properties create <account-id> --name "My Website" --timezone "America/New_York" --currency "USD"
+
+# Delete a property
+ga-cli properties delete <property-id>
+```
+
+### Data Streams
+
+```bash
+# List data streams for a property
+ga-cli datastreams list <property-id>
+
+# Get data stream details (including measurement ID)
+ga-cli datastreams get <property-id> <stream-id>
+
+# Create a new web data stream
+ga-cli datastreams create <property-id> --name "Main Website" --url "https://example.com"
+```
+
+## Examples
+
+### Quick workflow to create a new GA4 property
+
+```bash
+# 1. List your accounts to get the account ID
+ga-cli accounts list
+
+# 2. Create a new property
+ga-cli properties create 123456789 --name "BOTCHA" --timezone "Africa/Tripoli"
+
+# 3. Create a web data stream
+ga-cli datastreams create 987654321 --name "BOTCHA Website" --url "https://botcha.example.com"
+
+# 4. Get the measurement ID
+ga-cli datastreams get 987654321 111222333
+```
+
+### Get measurement ID quickly
+
+```bash
+# If you know your property and stream IDs
+ga-cli datastreams get <property-id> <stream-id> | grep "Measurement ID"
+```
+
+## Command Reference
+
+### Global Options
+
+- `--credentials PATH` - Path to service account credentials file
+- `--version` - Show version
+- `--help` - Show help message
+
+### Output Formats
+
+Most list and get commands support:
+- `--format table` (default) - Beautiful table output
+- `--format json` - JSON output
+
+## Development
+
+### Setup development environment
+
+```bash
+# Clone the repository
+git clone https://github.com/sulimanbenhalim/ga-cli.git
+cd ga-cli
+
+# Create virtual environment
+python -m venv venv
+source venv/bin/activate  # On Windows: venv\Scripts\activate
+
+# Install in development mode
+pip install -e .
+```
+
+### Run tests
+
+```bash
+pytest tests/ -v
+```
+
+## Project Structure
+
+```
+ga-cli/
+├── ga_cli/
+│   ├── __init__.py
+│   ├── cli.py              # Main CLI entry point
+│   ├── auth.py             # Authentication manager
+│   ├── config.py           # Configuration manager
+│   ├── commands/
+│   │   ├── accounts.py     # Account commands
+│   │   ├── properties.py   # Property commands
+│   │   ├── datastreams.py  # Data stream commands
+│   │   └── config.py       # Config commands
+│   └── formatters/
+│       ├── table.py        # Table formatter
+│       └── json.py         # JSON formatter
+├── tests/
+├── setup.py
+├── requirements.txt
+└── README.md
+```
+
+## Requirements
+
+- Python 3.8+
+- Click 8.0+
+- google-analytics-admin 0.27.0+
+- google-auth 2.0+
+- rich 13.0+
+- pytz 2023.3+
+
+## License
+
+MIT License
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## Support
+
+For issues and questions, please open an issue on GitHub.

ga4_cli-0.1.1/README.md

@@ -0,0 +1,265 @@
+# GA CLI - Google Analytics Command Line Interface
+
+A command-line interface tool for managing Google Analytics 4 properties, accounts, and data streams.
+
+**Note**: The package is published as `ga4-cli` on PyPI, but the command is `ga-cli`.
+
+## Features
+
+- List and manage Google Analytics accounts
+- Create and manage GA4 properties
+- Manage data streams and retrieve measurement IDs
+- Beautiful table output with Rich
+- JSON output support
+- Authentication via service account credentials
+
+## Installation
+
+### Using pip
+
+```bash
+pip install ga4-cli
+```
+
+After installation, the command is available as `ga-cli`:
+
+```bash
+ga-cli --version
+ga-cli --help
+```
+
+### Using Homebrew (macOS/Linux)
+
+```bash
+# Add the tap
+brew tap sulimanbenhalim/ga-cli
+
+# Install
+brew install ga-cli
+
+# Use it
+ga-cli --version
+```
+
+### Using Docker
+
+```bash
+# Pull from Docker Hub
+docker pull sulimanbenhalim/ga-cli:latest
+
+# Or build locally
+docker build -t ga-cli .
+
+# Run with credentials mounted
+docker run -v /path/to/credentials.json:/credentials.json \
+  -v ~/.ga-cli:/root/.ga-cli \
+  ga-cli accounts list --credentials /credentials.json
+```
+
+### Download Binary (No Python Required)
+
+Download standalone binaries from [GitHub Releases](https://github.com/sulimanbenhalim/ga-cli/releases):
+
+**Linux/macOS:**
+```bash
+# Download and extract
+curl -L -o ga-cli.tar.gz https://github.com/sulimanbenhalim/ga-cli/releases/latest/download/ga-cli-linux-amd64.tar.gz
+tar -xzf ga-cli.tar.gz
+chmod +x ga-cli
+sudo mv ga-cli /usr/local/bin/
+```
+
+**Windows:**
+Download `ga-cli-windows-amd64.exe.zip` from the releases page, extract, and run.
+
+### From source
+
+```bash
+git clone https://github.com/sulimanbenhalim/ga-cli.git
+cd ga-cli
+pip install -e .
+```
+
+## Setup
+
+### 1. Get Google Service Account Credentials
+
+1. Go to [Google Cloud Console](https://console.cloud.google.com/)
+2. Create or select a project
+3. Enable the Google Analytics Admin API
+4. Create a service account with Analytics Admin permissions
+5. Download the JSON credentials file
+
+### 2. Initialize GA CLI
+
+```bash
+ga-cli config init
+```
+
+This will prompt you for the path to your service account JSON file and test the credentials.
+
+Alternatively, set the environment variable:
+
+```bash
+export GOOGLE_APPLICATION_CREDENTIALS=/path/to/credentials.json
+```
+
+## Usage
+
+### Configuration
+
+```bash
+# Initialize with credentials
+ga-cli config init
+
+# Show current configuration
+ga-cli config show
+```
+
+### Accounts
+
+```bash
+# List all accounts
+ga-cli accounts list
+
+# Get account details
+ga-cli accounts get <account-id>
+
+# Output as JSON
+ga-cli accounts list --format json
+```
+
+### Properties
+
+```bash
+# List properties for an account
+ga-cli properties list <account-id>
+
+# Get property details
+ga-cli properties get <property-id>
+
+# Create a new property
+ga-cli properties create <account-id> --name "My Website" --timezone "America/New_York" --currency "USD"
+
+# Delete a property
+ga-cli properties delete <property-id>
+```
+
+### Data Streams
+
+```bash
+# List data streams for a property
+ga-cli datastreams list <property-id>
+
+# Get data stream details (including measurement ID)
+ga-cli datastreams get <property-id> <stream-id>
+
+# Create a new web data stream
+ga-cli datastreams create <property-id> --name "Main Website" --url "https://example.com"
+```
+
+## Examples
+
+### Quick workflow to create a new GA4 property
+
+```bash
+# 1. List your accounts to get the account ID
+ga-cli accounts list
+
+# 2. Create a new property
+ga-cli properties create 123456789 --name "BOTCHA" --timezone "Africa/Tripoli"
+
+# 3. Create a web data stream
+ga-cli datastreams create 987654321 --name "BOTCHA Website" --url "https://botcha.example.com"
+
+# 4. Get the measurement ID
+ga-cli datastreams get 987654321 111222333
+```
+
+### Get measurement ID quickly
+
+```bash
+# If you know your property and stream IDs
+ga-cli datastreams get <property-id> <stream-id> | grep "Measurement ID"
+```
+
+## Command Reference
+
+### Global Options
+
+- `--credentials PATH` - Path to service account credentials file
+- `--version` - Show version
+- `--help` - Show help message
+
+### Output Formats
+
+Most list and get commands support:
+- `--format table` (default) - Beautiful table output
+- `--format json` - JSON output
+
+## Development
+
+### Setup development environment
+
+```bash
+# Clone the repository
+git clone https://github.com/sulimanbenhalim/ga-cli.git
+cd ga-cli
+
+# Create virtual environment
+python -m venv venv
+source venv/bin/activate  # On Windows: venv\Scripts\activate
+
+# Install in development mode
+pip install -e .
+```
+
+### Run tests
+
+```bash
+pytest tests/ -v
+```
+
+## Project Structure
+
+```
+ga-cli/
+├── ga_cli/
+│   ├── __init__.py
+│   ├── cli.py              # Main CLI entry point
+│   ├── auth.py             # Authentication manager
+│   ├── config.py           # Configuration manager
+│   ├── commands/
+│   │   ├── accounts.py     # Account commands
+│   │   ├── properties.py   # Property commands
+│   │   ├── datastreams.py  # Data stream commands
+│   │   └── config.py       # Config commands
+│   └── formatters/
+│       ├── table.py        # Table formatter
+│       └── json.py         # JSON formatter
+├── tests/
+├── setup.py
+├── requirements.txt
+└── README.md
+```
+
+## Requirements
+
+- Python 3.8+
+- Click 8.0+
+- google-analytics-admin 0.27.0+
+- google-auth 2.0+
+- rich 13.0+
+- pytz 2023.3+
+
+## License
+
+MIT License
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## Support
+
+For issues and questions, please open an issue on GitHub.