pingera-cli 0.1.14__tar.gz → 0.1.16__tar.gz

{pingera_cli-0.1.14/pingera_cli.egg-info → pingera_cli-0.1.16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pingera-cli
-Version: 0.1.14
+Version: 0.1.16
 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
@@ -31,7 +31,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>=1.0.11
+Requires-Dist: pingera-sdk>=1.0.15
 Requires-Dist: click>=8.0.0
 Provides-Extra: dev
 Requires-Dist: pytest>=6.0; extra == "dev"

{pingera_cli-0.1.14 → pingera_cli-0.1.16}/docs/cli-commands.md

@@ -195,7 +195,7 @@ pngr heartbeats ping <heartbeat-id>
 pngr heartbeats logs <heartbeat-id> [--from <date>] [--to <date>] [--page <num>]
 ```
 
-## Status Pages Commands (soon)
+## Status Pages Commands
 
 ### `pngr pages`
 Manage status pages.
@@ -207,43 +207,40 @@ pngr pages list [--page <num>] [--page-size <size>]
 # Get specific status page
 pngr pages get <page-id>
 
-# Create status page
-pngr pages create --name <name> [--description <desc>] [--subdomain <sub>] [--theme <theme>]
+# Create a new status page
+pngr pages create --name "My Status Page" [--subdomain <sub>] [--description <desc>] [--headline <text>] [--url <url>] [--private] [--timezone <tz>]
 
-# Update status page
-pngr pages update <page-id> --name <name> --description <desc> --theme <theme>
+# Update an existing status page
+pngr pages update <page-id> [--name <name>] [--subdomain <sub>] [--description <desc>] [--headline <text>] [--url <url>] [--public/--private] [--timezone <tz>]
 
-# Delete status page
+# Delete a status page
 pngr pages delete <page-id> [--confirm]
 ```
 
-### `pngr components`
-Manage status page components.
+### `pngr pages components`
+Manage status page components (nested under pages).
 
 ```bash
-# List components
-pngr components list [--page-id <id>] [--page <num>] [--page-size <size>]
+# List components for a page
+pngr pages components list --page-id <page-id>
 
 # Get specific component
-pngr components get <component-id> [--page-id <id>]
+pngr pages components get <component-id> --page-id <page-id>
 
 # Create component
-pngr components create --name <name> [--description <desc>] [--status <status>] [--page-id <id>]
+pngr pages components create --name <name> --page-id <page-id> [--description <desc>] [--status <status>] [--group-id <id>] [--position <num>] [--showcase] [--only-if-degraded] [--start-date <YYYY-MM-DD>]
 
 # Update component
-pngr components update <component-id> --name <name> --description <desc> --page-id <id>
+pngr pages components update <component-id> --page-id <page-id> [--name <name>] [--description <desc>] [--status <status>] [--group-id <id>] [--position <num>] [--showcase/--no-showcase] [--only-if-degraded/--always-show]
 
 # Delete component
-pngr components delete <component-id> [--page-id <id>] [--confirm]
-
-# Update component status
-pngr components status <component-id> --status <status> [--page-id <id>]
+pngr pages components delete <component-id> --page-id <page-id> [--confirm]
 
 # Get component uptime
-pngr components uptime <component-id> [--page-id <id>] [--from <date>] [--to <date>]
+pngr pages components uptime <component-id> --page-id <page-id> [--start <date>] [--end <date>]
 
-# Bulk update component uptime
-pngr components uptime-bulk --file <json-file> [--page-id <id>]
+# Get uptime for all components (bulk)
+pngr pages components uptime-bulk --page-id <page-id> [--start <date>] [--end <date>]
 ```
 
 ### `pngr incidents`
@@ -515,11 +512,32 @@ pngr checks run custom --url https://example.com --type ssl --name "SSL Certific
 # Execute existing check and wait for result
 pngr checks run existing check_123 --wait-for-result
 
+# Update a status page
+pngr pages update page_123 --name "Updated Name" --description "New description"
+
+# Make a page public
+pngr pages update page_123 --public
+
+# Update page timezone and language
+pngr pages update page_123 --timezone "America/New_York" --language "en"
+
 # Create an incident
 pngr incidents create --name "Database Issues" --body "Investigating connectivity" --status investigating --impact major
 
 # Update component status  
-pngr components status comp_123 --status degraded_performance
+pngr pages components update comp_123 --page-id page_123 --status degraded_performance
+
+# Get uptime for a specific component
+pngr pages components uptime comp_123 --page-id page_123
+
+# Get uptime for a specific component with date range
+pngr pages components uptime comp_123 --page-id page_123 --start 2024-01-01 --end 2024-01-31
+
+# Get uptime for all components on a page
+pngr pages components uptime-bulk --page-id page_123
+
+# Get uptime for all components with date range
+pngr pages components uptime-bulk --page-id page_123 --start 2024-01-01 --end 2024-01-31
 
 # Update check with custom parameters (Playwright script and regions)
 pngr checks update check_123 --parameters '{"pw_script": "const { test, expect } = require(\"@playwright/test\"); test(\"example\", async ({ page }) => { await page.goto(\"https://example.com\"); await expect(page).toHaveTitle(/Example/); });", "regions": ["US", "EU"]}'

{pingera_cli-0.1.14 → pingera_cli-0.1.16}/pingera_cli/__init__.py

@@ -2,7 +2,7 @@
 Pingera CLI - A beautiful CLI tool for Pingera Platform
 """
 
-__version__ = "0.1.14"
+__version__ = "0.1.16"
 __author__ = "Pingera Team"
 __description__ = "A beautiful Python CLI tool built with typer and rich, distributed via pip and based on Pingera SDK"
 

{pingera_cli-0.1.14 → pingera_cli-0.1.16}/pingera_cli/commands/checks.py

@@ -14,6 +14,9 @@ from rich.prompt import Confirm
 from .base import BaseCommand
 from ..utils.config import get_api_key
 
+# Supported check types
+SUPPORTED_CHECK_TYPES = ["web", "api", "tcp", "ssl", "dns", "icmp", "portscan", "synthetic", "multistep"]
+
 
 class ChecksCommand(BaseCommand):
     """
@@ -412,7 +415,7 @@ class ChecksCommand(BaseCommand):
             self.display_error(str(e))
             raise typer.Exit(1)
 
-    def create_check(self, name: str, check_type: str, url: Optional[str] = None, host: Optional[str] = None, port: Optional[int] = None, interval: int = 300, timeout: int = 30, parameters: Optional[str] = None, pw_script_file: Optional[str] = None, from_file: Optional[str] = None):
+    def create_check(self, name: str, check_type: str, url: Optional[str] = None, host: Optional[str] = None, port: Optional[int] = None, interval: int = 300, timeout: int = 30, parameters: Optional[str] = None, pw_script_file: Optional[str] = None, from_file: Optional[str] = None, regions: Optional[str] = None):
         """Create a new monitoring check"""
         try:
             import json
@@ -525,7 +528,14 @@ class ChecksCommand(BaseCommand):
                     self.display_error(f"Failed to read Playwright script file: {str(e)}")
                     raise typer.Exit(1)
 
-            # Parse parameters JSON if provided
+            # Handle regions parameter - add to params_dict if provided and not in parameters
+            if regions is not None and parameters is None:
+                # Parse comma-separated regions into a list
+                regions_list = [r.strip() for r in regions.split(',') if r.strip()]
+                if regions_list:
+                    params_dict["regions"] = regions_list
+
+            # Parse parameters JSON if provided (this takes precedence over --regions)
             if parameters is not None:
                 try:
                     parsed_params = json.loads(parameters)
@@ -583,7 +593,7 @@ class ChecksCommand(BaseCommand):
             self.display_error(f"Failed to create check: {str(e)}")
             raise typer.Exit(1)
 
-    def update_check(self, check_id: str, name: Optional[str] = None, url: Optional[str] = None, host: Optional[str] = None, port: Optional[int] = None, interval: Optional[int] = None, timeout: Optional[int] = None, active: Optional[bool] = None, parameters: Optional[str] = None, pw_script_file: Optional[str] = None):
+    def update_check(self, check_id: str, name: Optional[str] = None, url: Optional[str] = None, host: Optional[str] = None, port: Optional[int] = None, interval: Optional[int] = None, timeout: Optional[int] = None, active: Optional[bool] = None, parameters: Optional[str] = None, pw_script_file: Optional[str] = None, regions: Optional[str] = None):
         """Update an existing check"""
         try:
             import json
@@ -629,7 +639,14 @@ class ChecksCommand(BaseCommand):
                     self.display_error(f"Failed to read Playwright script file: {str(e)}")
                     raise typer.Exit(1)
 
-            # Parse parameters JSON if provided
+            # Handle regions parameter - add to params_dict if provided and not in parameters
+            if regions is not None and parameters is None:
+                # Parse comma-separated regions into a list
+                regions_list = [r.strip() for r in regions.split(',') if r.strip()]
+                if regions_list:
+                    params_dict["regions"] = regions_list
+
+            # Parse parameters JSON if provided (this takes precedence over --regions)
             if parameters is not None:
                 try:
                     parsed_params = json.loads(parameters)
@@ -749,7 +766,7 @@ class ChecksCommand(BaseCommand):
             # If result_id was specified, we're fetching a single result - display it with full formatting
             if result_id and len(response.results) == 1:
                 result = response.results[0]
-                
+
                 if self.output_format in ['json', 'yaml']:
                     result_dict = {
                         "id": str(result.id) if hasattr(result, 'id') and result.id else None,
@@ -901,10 +918,8 @@ class ChecksCommand(BaseCommand):
 
                 # Provide helpful hints based on context
                 hints = []
-                if check_id:
-                    hints.append(f"Use 'pngr checks result {check_id} <result-id>' for detailed result info")
-                else:
-                    hints.append("Use 'pngr checks results --result-id <result-id>' for detailed result info")
+                hints.append("Use 'pngr checks result <result-id>' for detailed result info")
+                if not check_id:
                     hints.append("Use 'pngr checks list' to see all available checks and their IDs")
                     hints.append("Filter results: --type <type>, --status <status>, --region <region>")
 
@@ -935,16 +950,19 @@ class ChecksCommand(BaseCommand):
             self.display_error(f"Failed to get result details: {str(e)}")
             raise typer.Exit(1)
 
-    def get_check_result_detailed(self, check_id: str, result_id: str, verbose: bool = False):
-        """Get detailed information for a specific check result using check_id and result_id"""
+    def get_check_result_detailed(self, result_id: str, verbose: bool = False):
+        """Get detailed information for a specific check result using result_id"""
         try:
-            checks_api = self.get_client()
+            unified_api = self.get_unified_results_client()
 
-            # Use the actual SDK method
-            result = checks_api.v1_checks_check_id_results_check_result_id_get(
-                check_id=check_id,
-                check_result_id=result_id
-            )
+            # Use the unified results API with result_id filter
+            response = unified_api.v1_checks_all_results_get(result_id=result_id)
+
+            if not hasattr(response, 'results') or not response.results or len(response.results) == 0:
+                self.display_error(f"Result {result_id} not found")
+                raise typer.Exit(1)
+
+            result = response.results[0]
 
             if self.output_format in ['json', 'yaml']:
                 # Full result data for JSON/YAML
@@ -979,7 +997,7 @@ class ChecksCommand(BaseCommand):
                 response_time_display = f"{result.response_time}ms"
         else:
             response_time_display = 'N/A'
-        
+
         basic_info = f"""[bold cyan]Basic Information:[/bold cyan]
 • Result ID: [white]{result.id}[/white]
 • Check ID: [white]{result.check_id}[/white]
@@ -1058,6 +1076,7 @@ class ChecksCommand(BaseCommand):
                     region_dict = {
                         "id": str(region.id) if hasattr(region, 'id') and region.id else None,
                         "display_name": region.display_name if hasattr(region, 'display_name') and region.display_name else None,
+                        "aliases": region.aliases if hasattr(region, 'aliases') and region.aliases else None,
                         "available_check_types": region.available_check_types if hasattr(region, 'available_check_types') and region.available_check_types else None
                     }
                     regions_data.append(region_dict)
@@ -1073,6 +1092,7 @@ class ChecksCommand(BaseCommand):
                 table = Table(title=table_title)
                 table.add_column("Region ID", style="cyan", min_width=15)
                 table.add_column("Display Name", style="green", min_width=25)
+                table.add_column("Aliases", style="yellow", min_width=20)
                 table.add_column("Available Check Types", style="white")
 
                 for region in response.regions:
@@ -1080,6 +1100,14 @@ class ChecksCommand(BaseCommand):
                     region_id = str(region.id) if hasattr(region, 'id') and region.id else "-"
                     display_name = region.display_name if hasattr(region, 'display_name') and region.display_name else "-"
 
+                    # Handle aliases
+                    aliases_display = "-"
+                    if hasattr(region, 'aliases') and region.aliases:
+                        if isinstance(region.aliases, list):
+                            aliases_display = ", ".join(region.aliases)
+                        else:
+                            aliases_display = str(region.aliases)
+
                     # Handle available check types
                     available_types = "-"
                     if hasattr(region, 'available_check_types') and region.available_check_types:
@@ -1091,6 +1119,7 @@ class ChecksCommand(BaseCommand):
                     table.add_row(
                         region_id,
                         display_name,
+                        aliases_display,
                         available_types
                     )
 
@@ -1169,15 +1198,15 @@ def list_checks(
 ):
     """List monitoring checks with advanced filtering options"""
     from ..utils.config import get_output_format
-    
+
     # Validate name length
     if name and len(name) > 100:
         typer.echo("Error: Name filter cannot exceed 100 characters", err=True)
         raise typer.Exit(1)
 
     # Validate check type
-    if check_type and check_type not in ["web", "api", "ssl", "tcp", "icmp", "dns", "synthetic", "multistep"]:
-        typer.echo("Error: Invalid check type. Must be one of: web, api, ssl, tcp, icmp, dns, synthetic, multistep", err=True)
+    if check_type and check_type not in SUPPORTED_CHECK_TYPES:
+        typer.echo(f"Error: Invalid check type '{check_type}'. Must be one of: {', '.join(SUPPORTED_CHECK_TYPES)}", err=True)
         raise typer.Exit(1)
 
     # Validate status values if provided
@@ -1214,7 +1243,8 @@ def create_check(
     timeout: int = typer.Option(30, "--timeout", help="Timeout in seconds"),
     parameters: Optional[str] = typer.Option(None, "--parameters", help="JSON string with check parameters (e.g., '{\"regions\": [\"US\", \"EU\"]}')"),
     pw_script_file: Optional[str] = typer.Option(None, "--pw-script-file", help="Path to file containing Playwright script for synthetic/multistep checks"),
-    from_file: Optional[str] = typer.Option(None, "--from-file", "-f", help="Path to JSON or YAML file containing check configuration")
+    from_file: Optional[str] = typer.Option(None, "--from-file", "-f", help="Path to JSON or YAML file containing check configuration"),
+    regions: Optional[str] = typer.Option(None, "--regions", help="Comma-separated list of regions (e.g., 'ru-central1,eu-west1')"),
 ):
     """Create a new monitoring check. Can be created from command line options or from a JSON/YAML file.
 
@@ -1236,8 +1266,13 @@ def create_check(
         typer.echo("Error: --name is required when not using --from-file", err=True)
         raise typer.Exit(1)
 
+    # Validate check type
+    if check_type not in SUPPORTED_CHECK_TYPES:
+        typer.echo(f"Error: Invalid check type '{check_type}'. Must be one of: {', '.join(SUPPORTED_CHECK_TYPES)}", err=True)
+        raise typer.Exit(1)
+
     checks_cmd = ChecksCommand(get_output_format())
-    checks_cmd.create_check(name, check_type, url, host, port, interval, timeout, parameters, pw_script_file, from_file)
+    checks_cmd.create_check(name, check_type, url, host, port, interval, timeout, parameters, pw_script_file, from_file, regions)
 
 
 @app.command("update")
@@ -1251,12 +1286,13 @@ def update_check(
     timeout: Optional[int] = typer.Option(None, "--timeout", help="New timeout in seconds"),
     active: bool = typer.Option(None, "--active/--inactive", help="Enable or disable the check"),
     parameters: Optional[str] = typer.Option(None, "--parameters", help="JSON string with check parameters (e.g., '{\"pw_script\": \"...\", \"regions\": [\"US\", \"EU\"]}')"),
-    pw_script_file: Optional[str] = typer.Option(None, "--pw-script-file", help="Path to file containing Playwright script for synthetic/multistep checks")
+    pw_script_file: Optional[str] = typer.Option(None, "--pw-script-file", help="Path to file containing Playwright script for synthetic/multistep checks"),
+    regions: Optional[str] = typer.Option(None, "--regions", help="Comma-separated list of regions (e.g., 'ru-central1,eu-west1')"),
 ):
     """Update an existing check. Use --parameters to provide complex parameters like Playwright scripts, regions, etc."""
     from ..utils.config import get_output_format
     checks_cmd = ChecksCommand(get_output_format())
-    checks_cmd.update_check(check_id, name, url, host, port, interval, timeout, active, parameters, pw_script_file)
+    checks_cmd.update_check(check_id, name, url, host, port, interval, timeout, active, parameters, pw_script_file, regions)
 
 
 @app.command("delete")
@@ -1284,20 +1320,25 @@ def get_results(
 ):
     """Get check results with advanced filtering. If no check_id is provided, returns unified results across all checks. Use --result-id to fetch a specific result."""
     from ..utils.config import get_output_format
+
+    # Validate check type
+    if check_type and check_type not in SUPPORTED_CHECK_TYPES:
+        typer.echo(f"Error: Invalid check type '{check_type}'. Must be one of: {', '.join(SUPPORTED_CHECK_TYPES)}", err=True)
+        raise typer.Exit(1)
+
     checks_cmd = ChecksCommand(get_output_format())
     checks_cmd.get_check_results(check_id, from_date, to_date, page, page_size, status, check_type, region, result_id)
 
 
 @app.command("result")
 def get_result(
-    check_id: str = typer.Argument(..., help="Check ID"),
     result_id: str = typer.Argument(..., help="Result ID to retrieve detailed information for"),
     verbose: bool = typer.Option(False, "--verbose", "-v", help="Show full detailed information including network requests"),
 ):
     """Get detailed information for a specific check result"""
     from ..utils.config import get_output_format
     checks_cmd = ChecksCommand(get_output_format())
-    checks_cmd.get_check_result_detailed(check_id, result_id, verbose)
+    checks_cmd.get_check_result_detailed(result_id, verbose)
 
 
 @app.command("list-regions")
@@ -1306,6 +1347,12 @@ def list_regions(
 ):
     """List available regions for monitoring checks"""
     from ..utils.config import get_output_format
+
+    # Validate check type
+    if check_type and check_type not in SUPPORTED_CHECK_TYPES:
+        typer.echo(f"Error: Invalid check type '{check_type}'. Must be one of: {', '.join(SUPPORTED_CHECK_TYPES)}", err=True)
+        raise typer.Exit(1)
+
     checks_cmd = ChecksCommand(get_output_format())
     checks_cmd.list_regions(check_type)