pingera-cli 0.1.0__py3-none-any.whl

pingera_cli/utils/config.py

@@ -0,0 +1,187 @@
+"""
+Configuration management utilities
+"""
+
+import os
+import json
+from pathlib import Path
+from typing import Dict, Any, Optional
+
+from .console import console, error_console
+
+
+def get_config_path() -> Path:
+    """
+    Get the path to the configuration file
+
+    Returns:
+        Path: Path to the config file
+    """
+    # Use XDG_CONFIG_HOME if available, otherwise use ~/.config
+    config_dir = os.getenv('XDG_CONFIG_HOME')
+    if config_dir:
+        config_path = Path(config_dir) / 'pingera-cli'
+    else:
+        config_path = Path.home() / '.config' / 'pingera-cli'
+
+    try:
+        config_path.mkdir(parents=True, exist_ok=True)
+    except (OSError, PermissionError):
+        # If we can't create the directory, use a temp location for tests
+        import tempfile
+        temp_dir = Path(tempfile.gettempdir()) / 'pingera-cli'
+        temp_dir.mkdir(parents=True, exist_ok=True)
+        config_path = temp_dir
+
+    return config_path / 'config.json'
+
+
+def get_config() -> Dict[str, Any]:
+    """
+    Load configuration from file or return default configuration
+
+    Returns:
+        Dict[str, Any]: Configuration dictionary
+    """
+    default_config = {
+        'base_url': 'https://api.pingera.ru',
+        'output_format': 'table',
+        'verbose': False,
+        'color': True,
+        'timeout': 30.0,
+        'retries': 3,
+        'config_path': str(get_config_path()),
+    }
+
+    config_path = get_config_path()
+
+    if not config_path.exists():
+        return default_config
+
+    try:
+        with open(config_path, 'r') as f:
+            config = json.load(f)
+
+        # Merge with defaults to ensure all keys are present
+        merged_config = default_config.copy()
+        merged_config.update(config)
+        return merged_config
+
+    except (json.JSONDecodeError, IOError) as e:
+        error_console.print(f"[danger]Error reading config file: {e}[/danger]")
+        return default_config
+
+
+def save_config(config: Dict[str, Any]) -> bool:
+    """
+    Save configuration to file
+
+    Args:
+        config: Configuration dictionary to save
+
+    Returns:
+        bool: True if saved successfully, False otherwise
+    """
+    config_path = get_config_path()
+
+    try:
+        with open(config_path, 'w') as f:
+            json.dump(config, f, indent=2)
+        return True
+
+    except IOError as e:
+        error_console.print(f"[danger]Error saving config file: {e}[/danger]")
+        return False
+
+
+def get_api_key() -> Optional[str]:
+    """
+    Get API key from environment or config
+
+    Returns:
+        Optional[str]: API key if found, None otherwise
+    """
+    # First try environment variable
+    api_key = os.getenv('PINGERA_API_KEY')
+    if api_key:
+        return api_key
+
+    # Then try config file
+    config = get_config()
+    return config.get('api_key')
+
+
+def set_api_key(api_key: str) -> bool:
+    """
+    Set API key in configuration file
+
+    Args:
+        api_key: API key to save
+
+    Returns:
+        bool: True if saved successfully, False otherwise
+    """
+    if not api_key or not api_key.strip():
+        return False
+
+    config = get_config()
+    config['api_key'] = api_key.strip()
+    return save_config(config)
+
+
+def set_output_format(output_format: str) -> bool:
+    """
+    Set output format in configuration file
+
+    Args:
+        output_format: Output format (table, json, yaml)
+
+    Returns:
+        bool: True if saved successfully, False otherwise
+    """
+    if output_format not in ['table', 'json', 'yaml']:
+        return False
+
+    config = get_config()
+    config['output_format'] = output_format
+    return save_config(config)
+
+
+def get_output_format() -> str:
+    """
+    Get output format from configuration
+
+    Returns:
+        str: Output format (default: table)
+    """
+    config = get_config()
+    return config.get('output_format', 'table')
+
+
+def validate_config() -> Dict[str, bool]:
+    """
+    Validate current configuration
+
+    Returns:
+        Dict[str, bool]: Validation results
+    """
+    results = {
+        'api_key_set': bool(get_api_key()),
+        'config_file_exists': get_config_path().exists(),
+        'config_file_readable': True,
+        'pingera_sdk_available': True,
+    }
+
+    # Test config file readability
+    try:
+        get_config()
+    except Exception:
+        results['config_file_readable'] = False
+
+    # Test Pingera SDK availability
+    try:
+        from pingera import ApiClient
+    except ImportError:
+        results['pingera_sdk_available'] = False
+
+    return results

pingera_cli/utils/console.py

@@ -0,0 +1,87 @@
+"""
+Console utilities for rich output formatting
+"""
+
+from rich.console import Console
+from rich.theme import Theme
+
+# Define custom theme for consistent styling
+custom_theme = Theme({
+    "info": "dim cyan",
+    "warning": "magenta",
+    "danger": "bold red",
+    "success": "bold green",
+    "error": "bold red on white",
+    "highlight": "bold yellow",
+    "primary": "bold blue",
+    "secondary": "dim white",
+})
+
+# Main console for standard output
+console = Console(
+    theme=custom_theme,
+    highlight=True,
+    markup=True,
+    emoji=True,
+    width=None,  # Auto-detect terminal width
+)
+
+# Error console for error messages
+error_console = Console(
+    stderr=True,
+    theme=custom_theme,
+    highlight=True,
+    markup=True,
+    emoji=True,
+    width=None,
+)
+
+def print_banner():
+    """
+    Print a welcome banner for PingeraCLI
+    """
+    banner = """
+[bold blue]
+██████╗ ██╗███╗   ██╗ ██████╗ ███████╗██████╗  █████╗      ██████╗██╗     ██╗
+██╔══██╗██║████╗  ██║██╔════╝ ██╔════╝██╔══██╗██╔══██╗    ██╔════╝██║     ██║
+██████╔╝██║██╔██╗ ██║██║  ███╗█████╗  ██████╔╝███████║    ██║     ██║     ██║
+██╔═══╝ ██║██║╚██╗██║██║   ██║██╔══╝  ██╔══██╗██╔══██║    ██║     ██║     ██║
+██║     ██║██║ ╚████║╚██████╔╝███████╗██║  ██║██║  ██║    ╚██████╗███████╗██║
+╚═╝     ╚═╝╚═╝  ╚═══╝ ╚═════╝ ╚══════╝╚═╝  ╚═╝╚═╝  ╚═╝     ╚═════╝╚══════╝╚═╝
+[/bold blue]
+    """
+    console.print(banner)
+    console.print("[dim]A beautiful CLI tool for Pingera Platform[/dim]\n")
+
+
+def print_separator(char: str = "─", length: int = 50, style: str = "dim"):
+    """
+    Print a separator line
+    
+    Args:
+        char: Character to use for separator
+        length: Length of the separator
+        style: Rich style to apply
+    """
+    separator = char * length
+    console.print(f"[{style}]{separator}[/{style}]")
+
+
+def print_status(message: str, status: str = "info"):
+    """
+    Print a status message with appropriate styling
+    
+    Args:
+        message: The message to print
+        status: Status type (info, warning, danger, success, error)
+    """
+    status_icons = {
+        "info": "ℹ️",
+        "warning": "⚠️",
+        "danger": "🚨",
+        "success": "✅",
+        "error": "❌",
+    }
+    
+    icon = status_icons.get(status, "•")
+    console.print(f"[{status}]{icon} {message}[/{status}]")

pingera_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,199 @@
+Metadata-Version: 2.4
+Name: pingera-cli
+Version: 0.1.0
+Summary: A beautiful Python CLI tool built with typer and rich, distributed via pip and based on Pingera SDK
+Home-page: https://github.com/pingera/pingera-cli
+Author: PingeraCLI Team
+Author-email: Pingera Team <privet@pingera.ru>
+Maintainer-email: Pingera Team <privet@pingera.ru>
+License: MIT
+Project-URL: Homepage, https://github.com/pingera/pingera-cli
+Project-URL: Documentation, https://docs.pingera.com/cli
+Project-URL: Repository, https://github.com/pingera/pingera-cli
+Project-URL: Bug Tracker, https://github.com/pingera/pingera-cli/issues
+Keywords: cli,pingera,network,monitoring,typer,rich,terminal
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: System :: Networking
+Classifier: Topic :: Utilities
+Classifier: Environment :: Console
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer[all]>=0.9.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: pingera-sdk
+Requires-Dist: click>=8.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=6.0; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Requires-Dist: flake8; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+
+# Pingera Platform CLI 🚀
+
+A beautiful Python CLI tool for the [Pingera Platform](https://pingera.ru) - built with typer and rich, distributed via pip and based on Pingera SDK.
+
+[![PyPI version](https://badge.fury.io/py/pingera-cli.svg)](https://badge.fury.io/py/pingera-cli)
+[![Python Support](https://img.shields.io/pypi/pyversions/pingera-cli.svg)](https://pypi.org/project/pingera-cli/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## ✨ Features
+
+- **Beautiful Terminal Output**: Powered by Rich library for colorful, formatted output
+- **Modern CLI Interface**: Built with Typer for intuitive command-line interactions  
+- **Pingera Platform Integration**: Seamlessly integrates with Pingera SDK for network monitoring
+- **Cross-Platform**: Works on Windows, macOS, and Linux
+- **Easy Installation**: Simple pip install with all dependencies managed
+- **Configuration Management**: Flexible configuration with environment variables and config files
+
+## 🚀 Installation
+
+Install Pingera Platform CLI using pip:
+
+```bash
+pip install pingera-cli
+```
+
+## 🔐 Authentication
+
+Before using the CLI, you need to authenticate with the Pingera Platform:
+
+1. **Get your API key**: Visit [app.pingera.ru](https://app.pingera.ru) and create an API token in your account settings
+2. **Login to the CLI**:
+   ```bash
+   pngr auth login --api-key your-api-key-here
+   ```
+3. **Verify authentication**:
+   ```bash
+   pngr auth status
+   ```
+
+Alternatively, you can set the API key as an environment variable:
+```bash
+export PINGERA_API_KEY=your-api-key-here
+```
+
+## 📖 Basic Usage
+
+### List all monitoring checks
+```bash
+pngr checks list
+```
+
+### Get details of a specific check
+```bash
+pngr checks get <check-id>
+```
+
+### Create a new web check
+```bash
+pngr checks create \
+  --name "My Website" \
+  --type web \
+  --url https://example.com \
+  --interval 300
+```
+
+### Get check results
+```bash
+pngr checks results <check-id>
+```
+
+### Run an on-demand check
+```bash
+pngr checks run custom \
+  --type web \
+  --url https://example.com \
+  --name "Quick Test"
+```
+
+### List available regions
+```bash
+pngr checks list-regions
+```
+
+### Filter regions by check type
+```bash
+pngr checks list-regions --check-type web
+```
+
+## 🔧 Configuration
+
+The CLI stores configuration in `~/.config/pingera-cli/config.json`. You can manage settings with:
+
+```bash
+# Show current configuration
+pngr config show
+
+# Set default output format
+pngr config set output_format json
+```
+
+## 📊 Output Formats
+
+The CLI supports multiple output formats:
+
+- **table** (default): Human-readable tables
+- **json**: JSON format for scripting
+- **yaml**: YAML format
+
+```bash
+# JSON output
+pngr checks list --output json
+
+# YAML output  
+pngr checks list --output yaml
+```
+
+## 🌐 Platform Links
+
+- **Pingera Platform**: [https://pingera.ru](https://pingera.ru)
+- **Web Application**: [https://app.pingera.ru](https://app.pingera.ru)
+- **Documentation**: [https://docs.pingera.ru](https://docs.pingera.ru)
+
+## 🛠️ Development
+
+```bash
+# Clone the repository
+git clone https://github.com/pingera/pingera-cli.git
+cd pingera-cli
+
+# Install in development mode
+pip install -e .
+
+# Test the CLI (after installation)
+pngr --help
+
+# Run tests
+python -m pytest tests/
+```
+
+## 📝 License
+
+This project is licensed under the MIT License - see the LICENSE file for details.
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## 📞 Support
+
+- **Issues**: [GitHub Issues](https://github.com/pingera/pingera-cli/issues)
+- **Documentation**: [Pingera CLI Docs](https://docs.pingera.ru/devs/cli)
+- **Platform Support**: [app.pingera.ru](https://app.pingera.ru)

pingera_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,25 @@
+pingera_cli/__init__.py,sha256=3KY4WOVAHRoLw6fapxhL8JOs8vE_-EpdgN3ZyUlnP8c,294
+pingera_cli/__main__.py,sha256=_yI6Ujgf0MXLSziFmPceqOhrqh9G7LlSW0SoHSpEu9k,154
+pingera_cli/main.py,sha256=NqFfsHlCmIoQPzhZH8YclwnqK8hGBGwt5hV2dAxzKwk,6580
+pingera_cli/commands/__init__.py,sha256=SROYrwAX2ycbGb9N627suPR0zb76QX89h_zLvmNX3ng,149
+pingera_cli/commands/auth.py,sha256=671Q1-LBgGATJrZog0CWyLhTNM3j3SNs_9MnL5NbkWI,7744
+pingera_cli/commands/base.py,sha256=VQNJNhALdDjUTKDrP6XqciuLyeb98885RP-nnUPNXKk,8183
+pingera_cli/commands/checks.py,sha256=XvQr63xYjzwj2JLYNJQSv-CeZJZ-F6ivtBSLlp6l2UA,50163
+pingera_cli/commands/on_demand_checks.py,sha256=nCOh6ugB715Y0TOv4hjxP40fh-FWb_XJRwG0oGjLFdE,32342
+pingera_cli/formatters/__init__.py,sha256=Zsm4o27fYm1DB5eijkvwDSS8Z91cVZmZ7rALZKJXNHw,455
+pingera_cli/formatters/base_formatter.py,sha256=R459DnNlP_-ocB5g_McVdkY2CADBlGgzP8Y0t7DQ8CE,1369
+pingera_cli/formatters/generic_formatter.py,sha256=dwMTaH6sKHBIDQHg1Ln7X1pqrs0iWofg_KzoIj6yH0Y,1871
+pingera_cli/formatters/multistep_formatter.py,sha256=Z0aa35IeGlqm-XLb5X_GYFNKkbaP-KCzZUsBH-Zv5pQ,5840
+pingera_cli/formatters/registry.py,sha256=OgEKwNgU2jozj_7rFrNDjyjx2SbbGcbI5zV-zhPWh24,1290
+pingera_cli/formatters/ssl_formatter.py,sha256=20-TuuBT_uK8Ka2rrNUysnI04mPMuvuR428BbqiMmJs,4777
+pingera_cli/formatters/synthetic_formatter.py,sha256=02CNEvY9evxRsUpOoQfAuI2VvI9VIXIGQS9Yrn2qEfI,14615
+pingera_cli/formatters/web_formatter.py,sha256=DtzCPqjdC-7y3DnE7F-aoQ_AgkPmJA3vQkMWSC_FfjE,3123
+pingera_cli/utils/__init__.py,sha256=_Qf6IIB5nYse67eQx1kBGJeaIpUpSiYIGEMr47eDSNU,198
+pingera_cli/utils/config.py,sha256=mk6ebcxywMep3xk1Bb6jNLn9P-eqXcvf9IiCnAn7q5s,4491
+pingera_cli/utils/console.py,sha256=DrBu0hN76UVaEbMY_HJBXT_m3ISDk9AywFrBqbqx9pg,3041
+pingera_cli-0.1.0.dist-info/licenses/LICENSE,sha256=CGqfM1VE8cez-_paPyIzeNqzf4CqmabV-O2GDCgCwQs,1070
+pingera_cli-0.1.0.dist-info/METADATA,sha256=98Fn2QS8h_c0jj8vl-_ZF1-iXHF2EMdXB2E-XQ3-HtY,5544
+pingera_cli-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+pingera_cli-0.1.0.dist-info/entry_points.txt,sha256=0hXkvXTj1u19n4RzZPh8ijsaSiVJ7t-pth6TnnrUeGQ,58
+pingera_cli-0.1.0.dist-info/top_level.txt,sha256=mSBLX-_HqQ1DBSOKhzfj7L-YgeM5OWGW6wVYTVHveTg,12
+pingera_cli-0.1.0.dist-info/RECORD,,

pingera_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

pingera_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+pngr = pingera_cli.main:cli_entry_point

pingera_cli-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,22 @@
+
+MIT License
+
+Copyright (c) 2025 Pingera Team
+
+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.

pingera_cli-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+pingera_cli