gravi-cli 0.1.1__tar.gz

gravi_cli-0.1.1/.bumpversion.toml

@@ -0,0 +1,27 @@
+[tool.bumpversion]
+current_version = "0.1.1"
+parse = "(?P<major>\\d+)\\.(?P<minor>\\d+)\\.(?P<patch>\\d+)"
+serialize = ["{major}.{minor}.{patch}"]
+search = "{current_version}"
+replace = "{new_version}"
+regex = false
+ignore_missing_version = false
+ignore_missing_files = false
+tag = false
+sign_tags = false
+tag_name = "v{new_version}"
+tag_message = "Bump version: {current_version} → {new_version}"
+allow_dirty = false
+commit = false
+message = "Bump version: {current_version} → {new_version}"
+commit_args = ""
+
+[[tool.bumpversion.files]]
+filename = "pyproject.toml"
+search = 'version = "{current_version}"'
+replace = 'version = "{new_version}"'
+
+[[tool.bumpversion.files]]
+filename = "gravi_cli/__init__.py"
+search = '__version__ = "{current_version}"'
+replace = '__version__ = "{new_version}"'

gravi_cli-0.1.1/.gitignore

@@ -0,0 +1,46 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+venv/
+env/
+ENV/
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Config (sensitive)
+config.json

gravi_cli-0.1.1/LICENSE

@@ -0,0 +1,31 @@
+Proprietary License
+
+Copyright (c) 2025 Gravitate
+
+All rights reserved.
+
+This software and associated documentation files (the "Software") are proprietary
+and confidential to Gravitate.
+
+The source code is made available for inspection and review purposes only.
+
+RESTRICTIONS:
+
+1. You may NOT use, copy, modify, merge, publish, distribute, sublicense, and/or
+   sell copies of the Software without explicit written permission from Gravitate.
+
+2. You may NOT create derivative works based on the Software.
+
+3. You may NOT reverse engineer, decompile, or disassemble the Software.
+
+4. You may view the source code for informational purposes only.
+
+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.
+
+For licensing inquiries, please contact: Gravitate

gravi_cli-0.1.1/PKG-INFO

@@ -0,0 +1,345 @@
+Metadata-Version: 2.4
+Name: gravi-cli
+Version: 0.1.1
+Summary: CLI tool for Gravitate infrastructure management
+Project-URL: Homepage, https://github.com/gravitate/mom
+Project-URL: Documentation, https://github.com/gravitate/mom/tree/main/cli
+Project-URL: Repository, https://github.com/gravitate/mom
+Author-email: Gravitate Engineering <engineering@gravitate.com>
+License: Proprietary
+License-File: LICENSE
+Keywords: cli,devops,gravitate,infrastructure
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: Other/Proprietary License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Requires-Dist: click>=8.1.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: requests>=2.31.0
+Provides-Extra: test
+Requires-Dist: pytest-cov>=4.1.0; extra == 'test'
+Requires-Dist: pytest-mock>=3.11.0; extra == 'test'
+Requires-Dist: pytest>=7.4.0; extra == 'test'
+Requires-Dist: responses>=0.24.0; extra == 'test'
+Description-Content-Type: text/markdown
+
+# Gravi CLI
+
+Command-line tool for Gravitate infrastructure management. Provides CLI access to mom infrastructure, allowing developers to authenticate, manage tokens, and access instance configurations and credentials.
+
+## Features
+
+- **OAuth-style device authorization** - Secure browser-based authentication
+- **Automatic token refresh** - Tokens auto-renew when <7 days remaining
+- **Token management** - List, revoke, and manage CLI tokens
+- **Instance access** - Get configurations and credentials for Gravitate instances
+- **Python library API** - Use programmatically in scripts and applications
+- **CI/CD support** - Environment variable-based authentication
+
+## Installation
+
+### From Source (Development)
+
+Using `uv` (recommended):
+
+```bash
+cd /home/jvogel/src/work/tools/mom/cli
+uv pip install -e ".[test]"
+```
+
+Or with traditional pip:
+
+```bash
+cd /home/jvogel/src/work/tools/mom/cli
+pip install -e ".[test]"
+```
+
+### From PyPI (Future)
+
+```bash
+pip install gravi-cli
+# or
+uv pip install gravi-cli
+```
+
+## Quick Start
+
+**Note:** If you installed with `uv pip install -e .`, you can run the CLI using `uvx --from . gravi` or just `gravi` if it's in your PATH.
+
+### 1. Login
+
+```bash
+gravi login
+# or with uvx:
+uvx --from . gravi login
+```
+
+This will:
+1. Open your browser to mom authorization page
+2. Display a user code (e.g., `ABCD-1234`)
+3. Wait for you to authorize in the browser
+4. Save credentials to `~/.config/gravi/config.json`
+
+### 2. Check Status
+
+```bash
+gravi status
+```
+
+Shows:
+- Current user email
+- Mom URL
+- Device name
+- Token ID
+- Token expiry
+
+### 3. Get Instance Configuration
+
+```bash
+# Get config as JSON
+gravi config dev
+
+# Get config as environment variables
+gravi config prod --format=env
+```
+
+### 4. Logout
+
+```bash
+gravi logout
+```
+
+Revokes token on server and clears local credentials.
+
+## CLI Commands
+
+### Authentication
+
+```bash
+gravi login                          # Authenticate via browser
+gravi logout                         # Clear credentials and revoke token
+gravi status                         # Show login status and token expiry
+gravi whoami                         # Show current user info
+```
+
+### Token Management
+
+```bash
+gravi tokens list                    # List all CLI tokens
+gravi tokens revoke <token_id>       # Revoke a specific token
+gravi tokens revoke --all            # Revoke all tokens
+```
+
+### Instance Access
+
+```bash
+gravi config <instance_key>          # Get instance configuration
+gravi config <instance_key> --format=env    # Get as environment variables
+```
+
+## Python Library API
+
+Use gravi_cli programmatically in Python scripts:
+
+```python
+from gravi_cli.api import get_instance_config, get_instance_token
+
+# Get database credentials
+config = get_instance_config("prod")
+db_url = config["config"]["database_url"]
+
+# Get ServiceNow access token
+token_response = get_instance_token("dev")
+sn_token = token_response["access_token"]
+
+# Get mom access token directly
+from gravi_cli.api import get_mom_token
+mom_token = get_mom_token()  # Auto-refreshes if needed
+```
+
+### Example: Database Connection
+
+```python
+from gravi_cli.api import get_instance_config
+import psycopg2
+
+# Get prod database credentials
+config = get_instance_config("prod")
+conn = psycopg2.connect(config["config"]["database_url"])
+
+# Use database
+cursor = conn.cursor()
+cursor.execute("SELECT * FROM users LIMIT 10")
+```
+
+### Example: ServiceNow API
+
+```python
+from gravi_cli.api import get_instance_config, get_instance_token
+import requests
+
+# Get ServiceNow config and token
+config = get_instance_config("dev")
+token_response = get_instance_token("dev")
+
+# Make ServiceNow API call
+response = requests.get(
+    f"{config['api_url']}/api/now/table/incident",
+    headers={"Authorization": f"Bearer {token_response['access_token']}"}
+)
+incidents = response.json()
+```
+
+## CI/CD Usage
+
+For automated scripts and CI/CD pipelines:
+
+```bash
+# Set refresh token as environment variable
+export GRAVI_REFRESH_TOKEN="your_refresh_token_here"
+
+# Commands will automatically use the env var
+gravi config prod
+```
+
+**Getting a CI/CD token:**
+1. Run `gravi login` on your local machine
+2. Run `gravi tokens list` to see your token ID
+3. Copy the refresh token from `~/.config/gravi/config.json`
+4. Set as `GRAVI_REFRESH_TOKEN` in your CI/CD system
+
+**Security Note:** Treat `GRAVI_REFRESH_TOKEN` like a password. Use secret management systems (GitHub Secrets, AWS Secrets Manager, etc.) to store it securely.
+
+## Configuration
+
+### Config File Location
+
+`~/.config/gravi/config.json`
+
+### Config File Format
+
+```json
+{
+  "version": 1,
+  "user_email": "john.doe@gravitate.com",
+  "refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
+  "refresh_token_expires_at": "2025-11-09T10:30:00Z",
+  "token_id": "507f1f77bcf86cd799439011",
+  "device_name": "John's MacBook"
+}
+```
+
+### Environment Variables
+
+- `GRAVI_MOM_URL` - Override mom API URL (default: `https://mom.gravitate.energy`)
+- `GRAVI_REFRESH_TOKEN` - CI/CD refresh token (bypasses config file)
+
+### File Permissions
+
+Config file is automatically set to `0600` (owner read/write only) for security.
+
+## Token Auto-Renewal
+
+Refresh tokens are automatically renewed when <7 days remaining:
+- CLI checks expiry on each use
+- If <7 days: requests new 14-day token
+- Config file updated automatically
+- Seamless for users - no re-login needed
+
+## Development
+
+### Setup
+
+```bash
+cd /home/jvogel/src/work/tools/mom/cli
+pip install -e ".[test]"
+```
+
+### Run Tests
+
+```bash
+# All tests
+pytest
+
+# With coverage
+pytest --cov=gravi_cli --cov-report=term-missing
+
+# Specific test file
+pytest tests/test_config.py
+
+# Verbose
+pytest -v
+```
+
+### Project Structure
+
+```
+cli/
+├── gravi_cli/
+│   ├── __init__.py          # Package metadata
+│   ├── api.py               # Public Python API
+│   ├── auth.py              # Token refresh and auth logic
+│   ├── cli.py               # CLI commands (Click)
+│   ├── client.py            # Mom API client
+│   ├── config.py            # Config file management
+│   └── exceptions.py        # Custom exceptions
+├── tests/
+│   ├── conftest.py          # Pytest fixtures
+│   ├── test_config.py       # Config tests
+│   └── test_client.py       # API client tests
+├── pyproject.toml           # Package configuration
+└── README.md                # This file
+```
+
+## Troubleshooting
+
+### "Not logged in" Error
+
+```bash
+gravi login
+```
+
+### "Token expired" Error
+
+Tokens auto-renew, but if expired:
+
+```bash
+gravi login
+```
+
+### Rate Limiting
+
+If you hit rate limits, wait and retry. Rate limits reset every minute.
+
+### Mom URL Override (Development)
+
+```bash
+# Temporary override
+GRAVI_MOM_URL=https://mom.dev gravi login
+
+# Or with flag
+gravi login --mom-url=https://mom.dev
+```
+
+## Security
+
+- **Refresh tokens** stored in config file with `0600` permissions
+- **Access tokens** never persisted (in-memory only)
+- **No tokens in CLI arguments** (prevents shell history exposure)
+- **HTTPS only** for all API calls
+- **Audit logging** - All token operations logged in mom
+
+## Support
+
+For issues or questions:
+- GitHub Issues: https://github.com/gravitate/mom/issues
+- Internal Slack: #engineering
+
+## License
+
+MIT