pingera-cli 0.1.5__tar.gz → 0.1.7__tar.gz

{pingera_cli-0.1.5/pingera_cli.egg-info → pingera_cli-0.1.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pingera-cli
-Version: 0.1.5
+Version: 0.1.7
 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

{pingera_cli-0.1.5 → pingera_cli-0.1.7}/docs/cli-commands.md

@@ -9,7 +9,7 @@ The `pngr` CLI provides a comprehensive interface to the Pingera monitoring plat
 These options are available for all commands:
 
 ```
---api-key <key>         API key for authentication (can also use PINGERA_API_KEY env var)
+--api-key <key>         API key for authentication (can also be used PINGERA_API_KEY env var)
 --base-url <url>        API base URL (default: https://api.pingera.ru)
 --output <format>       Output format: table, json, yaml (default: table)
 --page-id <id>          Default page ID for status page operations (can also use PINGERA_PAGE_ID env var)
@@ -183,7 +183,7 @@ pngr heartbeats get <heartbeat-id>
 pngr heartbeats create --name <name> --interval <seconds> [--grace-period <seconds>]
 
 # Update heartbeat
-pngr heartbeats update <heartbeat-id> [--name <name>] [--interval <seconds>]
+pngr heartbeats update <heartbeat-id> --name <name> --interval <seconds>
 
 # Delete heartbeat
 pngr heartbeats delete <heartbeat-id> [--confirm]
@@ -211,7 +211,7 @@ pngr pages get <page-id>
 pngr pages create --name <name> [--description <desc>] [--subdomain <sub>] [--theme <theme>]
 
 # Update status page
-pngr pages update <page-id> [--name <name>] [--description <desc>] [--theme <theme>]
+pngr pages update <page-id> --name <name> --description <desc> --theme <theme>
 
 # Delete status page
 pngr pages delete <page-id> [--confirm]
@@ -231,7 +231,7 @@ pngr components get <component-id> [--page-id <id>]
 pngr components create --name <name> [--description <desc>] [--status <status>] [--page-id <id>]
 
 # Update component
-pngr components update <component-id> [--name <name>] [--description <desc>] [--page-id <id>]
+pngr components update <component-id> --name <name> --description <desc> --page-id <id>
 
 # Delete component
 pngr components delete <component-id> [--page-id <id>] [--confirm]
@@ -260,7 +260,7 @@ pngr incidents get <incident-id> [--page-id <id>]
 pngr incidents create --name <name> --body <text> --status <status> --impact <impact> [--page-id <id>]
 
 # Update incident
-pngr incidents update <incident-id> [--name <name>] [--body <text>] [--status <status>] [--page-id <id>]
+pngr incidents update <incident-id> --name <name> --body <text> --status <status> --page-id <id>
 
 # Delete incident
 pngr incidents delete <incident-id> [--page-id <id>] [--confirm]
@@ -273,7 +273,93 @@ pngr incidents updates update <incident-id> <update-id> --body <text> [--page-id
 pngr incidents updates delete <incident-id> <update-id> [--page-id <id>] [--confirm]
 ```
 
-## Secrets Management
+## 📄 Check Configuration Files
+
+You can create checks from JSON or YAML configuration files using the `--from-file` option:
+
+### JSON Format
+```json
+{
+  "name": "My API Check",
+  "type": "api",
+  "url": "https://api.example.com/health",
+  "interval": 300,
+  "timeout": 30,
+  "parameters": {
+    "regions": ["US", "EU"],
+    "http_request": {
+      "method": "POST",
+      "headers": {
+        "Authorization": "Bearer token123",
+        "Content-Type": "application/json"
+      },
+      "body": "{\"check\": \"health\"}"
+    }
+  }
+}
+```
+
+### YAML Format
+```yaml
+name: "My Synthetic Check"
+type: "synthetic"
+interval: 600
+timeout: 60
+parameters:
+  regions:
+    - "US"
+    - "EU"
+  pw_script: |
+    const { test, expect } = require('@playwright/test');
+    test('login test', async ({ page }) => {
+      await page.goto('https://example.com/login');
+      await page.fill('#username', 'testuser');
+      await page.fill('#password', 'password');
+      await page.click('button[type="submit"]');
+      await expect(page).toHaveURL(/dashboard/);
+    });
+# Marketplace fields (ignored by CLI, used by web interface)
+marketplace:
+  tags: ["authentication", "login"]
+  description: "Tests user login functionality"
+  category: "user-flows"
+```
+
+### Field Priority
+When using `--from-file` with command line options:
+- Command line options override file values
+- File provides defaults for unspecified options
+- Required validations still apply
+- Non-SDK fields (like `marketplace`, custom fields) are ignored and not sent to the API
+- CLI-specific fields like `pw_script_file` are processed but not sent to the SDK
+
+### Create a new check
+```bash
+# From command line options
+pngr checks create --name "My Website" --type web --url "https://example.com"
+
+# From configuration file
+pngr checks create --from-file check-config.json
+pngr checks create --from-file check-config.yaml
+
+# Combine file and command line (command line options override file values)
+pngr checks create --from-file check-config.json --name "Override Name"
+```
+
+### Run on-demand checks
+```bash
+# From command line options
+pngr checks run custom --url https://example.com --type web --wait-for-result
+
+# From configuration file
+pngr checks run custom --from-file check-config.json --wait-for-result
+pngr checks run custom --from-file check-config.yaml --wait-for-result
+
+# Combine file and command line (command line options override file values)
+pngr checks run custom --from-file check-config.json --name "Override Name" --wait-for-result
+```
+
+## 🔐 Secrets Management
 
 Manage organization secrets for use in monitoring checks:
 
@@ -400,7 +486,7 @@ pngr config set defaults.page_id your-page-id
 pngr checks list --status active
 
 # Create a web check
-pngr checks create --name "API Health" --type web --url https://api.example.com --interval 300
+pngr checks create --name "My Website" --type web --url "https://example.com"
 
 # Create a TCP check
 pngr checks create --name "Database Connection" --type tcp --host db.example.com --port 5432

pingera_cli-0.1.7/docs/example-check.yaml

@@ -0,0 +1,21 @@
+
+name: "Example Synthetic Check"
+type: "synthetic"
+interval: 600
+timeout: 60
+parameters:
+  regions:
+    - "US"
+    - "EU"
+  pw_script: |
+    const { test, expect } = require('@playwright/test');
+    
+    test('example test', async ({ page }) => {
+      await page.goto('https://example.com');
+      await expect(page).toHaveTitle(/Example/);
+      await page.click('text=Login');
+      await page.fill('input[name="username"]', 'testuser');
+      await page.fill('input[name="password"]', 'testpass');
+      await page.click('button[type="submit"]');
+      await expect(page).toHaveURL(/dashboard/);
+    });

pingera_cli-0.1.7/docs/example-synthetic-screenshot.json

@@ -0,0 +1,21 @@
+{
+  "name": "Website Screenshot Monitor",
+  "type": "synthetic",
+  "interval": 1800,
+  "timeout": 30,
+  "parameters": {
+    "regions": [
+      "RU, Moscow"
+    ],
+    "pw_script": "const { test, expect } = require('@playwright/test');\n\ntest('website screenshot test', async ({ page }) => {\n  // Navigate to the website\n  await page.goto('https://pingera.ru');\n  \n  // Wait for the page to fully load\n  await page.waitForLoadState('load');\n  \n  // Additional wait to ensure all dynamic content is loaded\n  await page.waitForTimeout(2000);\n  \n  // Take a full page screenshot\n  await page.screenshot({ \n    path: 'website-screenshot.png', \n    fullPage: true \n  });\n  \n  // Verify the page loaded successfully\n  await expect(page).toHaveTitle(/Pingera - платформа мониторинга/);\n  \n  // Check for key elements on the page\n  await expect(page.locator('h1')).toBeVisible();\n  \n  console.log('Screenshot captured and page verified successfully');\n});"
+  },
+  "marketplace": {
+    "tags": [
+      "screenshot",
+      "visual-monitoring",
+      "website-monitoring"
+    ],
+    "name": "Website Screenshot Monitor",
+    "description": "Captures full-page screenshots of websites and verifies page loading"
+  }
+}

{pingera_cli-0.1.5 → pingera_cli-0.1.7}/pingera_cli/__init__.py

@@ -2,7 +2,7 @@
 Pingera CLI - A beautiful CLI tool for Pingera Platform
 """
 
-__version__ = "0.1.5"
+__version__ = "0.1.7"
 __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.5 → pingera_cli-0.1.7}/pingera_cli/commands/checks.py

@@ -389,20 +389,124 @@ class ChecksCommand(BaseCommand):
             self.display_error(f"Failed to get check: {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):
+    def _parse_check_file(self, file_path: str) -> dict:
+        """Parse check configuration from JSON or YAML file"""
+        import json
+        import os
+        
+        if not os.path.exists(file_path):
+            self.display_error(f"Check file not found: {file_path}")
+            raise typer.Exit(1)
+        
+        try:
+            with open(file_path, 'r', encoding='utf-8') as f:
+                content = f.read().strip()
+            
+            if not content:
+                self.display_error(f"Check file is empty: {file_path}")
+                raise typer.Exit(1)
+            
+            # Try to determine format from file extension or content
+            file_ext = os.path.splitext(file_path)[1].lower()
+            
+            if file_ext in ['.yaml', '.yml']:
+                try:
+                    import yaml
+                    return yaml.safe_load(content)
+                except ImportError:
+                    self.display_error("YAML support not available. Install with: pip install pyyaml")
+                    raise typer.Exit(1)
+                except yaml.YAMLError as e:
+                    self.display_error(f"Invalid YAML in file {file_path}: {str(e)}")
+                    raise typer.Exit(1)
+            else:
+                # Default to JSON
+                try:
+                    return json.loads(content)
+                except json.JSONDecodeError as e:
+                    self.display_error(f"Invalid JSON in file {file_path}: {str(e)}")
+                    raise typer.Exit(1)
+                    
+        except IOError as e:
+            self.display_error(f"Failed to read check file: {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):
         """Create a new monitoring check"""
         try:
             import json
             import os
             checks_api = self.get_client()
 
-            # Build check data
-            check_data = {
-                "name": name,
-                "type": check_type,
-                "interval": interval,
-                "timeout": timeout
-            }
+            # If creating from file, parse file and merge with command line options
+            if from_file:
+                file_data = self._parse_check_file(from_file)
+                
+                # Filter only SDK-recognized fields from file data
+                # This ignores marketplace-specific fields and other extensions
+                sdk_fields = ["name", "type", "url", "host", "port", "interval", "timeout", "parameters", "active"]
+                filtered_file_data = {k: v for k, v in file_data.items() if k in sdk_fields}
+                
+                # Command line options take precedence over file data
+                check_data = {
+                    "name": filtered_file_data.get("name", name),
+                    "type": filtered_file_data.get("type", check_type),
+                    "interval": filtered_file_data.get("interval", interval),
+                    "timeout": filtered_file_data.get("timeout", timeout)
+                }
+                
+                # Override with command line values if provided (but only if they were explicitly changed from defaults)
+                # We need to be more careful about when to override file values
+                # For now, just use file values and let user override with explicit CLI options
+                if interval != 300:  # Only override if interval was explicitly provided
+                    check_data["interval"] = interval
+                if timeout != 30:  # Only override if timeout was explicitly provided
+                    check_data["timeout"] = timeout
+                
+                # Handle URL from file
+                if url is None and filtered_file_data.get("url"):
+                    url = filtered_file_data["url"]
+                elif url is not None:
+                    # Command line URL takes precedence
+                    pass
+                
+                # Handle host/port from file
+                if host is None and filtered_file_data.get("host"):
+                    host = filtered_file_data["host"]
+                elif host is not None:
+                    # Command line host takes precedence
+                    pass
+                    
+                if port is None and filtered_file_data.get("port"):
+                    port = filtered_file_data["port"]
+                elif port is not None:
+                    # Command line port takes precedence
+                    pass
+                
+                # Handle parameters from file
+                file_parameters = filtered_file_data.get("parameters")
+                if file_parameters and parameters is None:
+                    # Use file parameters if no command line parameters
+                    parameters = json.dumps(file_parameters) if isinstance(file_parameters, dict) else file_parameters
+                
+                # Handle pw_script_file from file (this is CLI-specific, not sent to SDK)
+                if pw_script_file is None and file_data.get("pw_script_file"):
+                    pw_script_file = file_data["pw_script_file"]
+                
+                # Show info about ignored fields if any
+                ignored_fields = [k for k in file_data.keys() if k not in sdk_fields and k != "pw_script_file"]
+                if ignored_fields:
+                    self.display_info(f"Ignoring non-SDK fields from file: {', '.join(ignored_fields)}")
+                
+                self.display_info(f"Creating check from file: {from_file}")
+            else:
+                # Build check data normally
+                check_data = {
+                    "name": name,
+                    "type": check_type,
+                    "interval": interval,
+                    "timeout": timeout
+                }
 
             # Add URL if provided (required for web, api, ssl checks)
             if url is not None:
@@ -451,28 +555,31 @@ class ChecksCommand(BaseCommand):
             if params_dict:
                 check_data["parameters"] = params_dict
 
-            # Validation based on check type
-            if check_type in ['web', 'api'] and not url:
-                self.display_error(f"URL is required for {check_type} checks")
+            # Validation based on check type - use the actual type from check_data
+            actual_check_type = check_data.get("type", check_type)
+            if actual_check_type in ['web', 'api'] and not url:
+                self.display_error(f"URL is required for {actual_check_type} checks")
                 raise typer.Exit(1)
 
-            if check_type in ['tcp'] and not host:
-                self.display_error(f"Host is required for {check_type} checks")
+            if actual_check_type in ['tcp'] and not host:
+                self.display_error(f"Host is required for {actual_check_type} checks")
                 raise typer.Exit(1)
 
-            if check_type in ['ssl'] and not (url or host):
-                self.display_error(f"Either URL or host is required for {check_type} checks")
+            if actual_check_type in ['ssl'] and not (url or host):
+                self.display_error(f"Either URL or host is required for {actual_check_type} checks")
                 raise typer.Exit(1)
 
-            if check_type in ['synthetic', 'multistep'] and not params_dict.get('pw_script'):
-                self.display_error(f"Playwright script is required for {check_type} checks. Use --pw-script-file or --parameters with pw_script")
+            if actual_check_type in ['synthetic', 'multistep'] and not params_dict.get('pw_script'):
+                self.display_error(f"Playwright script is required for {actual_check_type} checks. Use --pw-script-file or --parameters with pw_script")
                 raise typer.Exit(1)
 
             # Use the actual SDK method
             check = checks_api.v1_checks_post(monitor_check=check_data)
 
-            # Build success message
-            success_details = [f"ID: {check.id}", f"Type: {check_type}"]
+            # Build success message - use the actual name from check_data, not the parameter
+            actual_name = check_data.get("name", name)
+            actual_type = check_data.get("type", check_type)
+            success_details = [f"ID: {check.id}", f"Type: {actual_type}"]
             if url:
                 success_details.append(f"URL: {url}")
             if host:
@@ -483,7 +590,7 @@ class ChecksCommand(BaseCommand):
                 success_details.append(f"Script: loaded from {pw_script_file}")
 
             self.display_success(
-                f"Check '{name}' created successfully!\n" + "\n".join(success_details),
+                f"Check '{actual_name}' created successfully!\n" + "\n".join(success_details),
                 "✅ Check Created"
             )
 
@@ -1075,23 +1182,36 @@ def get_check(
 
 @app.command("create")
 def create_check(
-    name: str = typer.Option(..., "--name", "-n", help="Check name"),
-    check_type: str = typer.Option(..., "--type", "-t", help="Check type (web, api, tcp, ssl, synthetic, multistep)"),
+    name: str = typer.Option("", "--name", "-n", help="Check name (required if not using --from-file)"),
+    check_type: str = typer.Option("web", "--type", "-t", help="Check type (web, api, tcp, ssl, synthetic, multistep)"),
     url: Optional[str] = typer.Option(None, "--url", "-u", help="URL to monitor (required for web, api, ssl checks)"),
     host: Optional[str] = typer.Option(None, "--host", help="Hostname/IP for TCP/SSL checks (max 255 characters)"),
     port: Optional[int] = typer.Option(None, "--port", help="Port number for TCP checks (1-65535)"),
     interval: int = typer.Option(300, "--interval", "-i", help="Check interval in seconds"),
     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")
+    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", help="Path to JSON or YAML file containing check configuration")
 ):
-    """Create a new monitoring check. Parameters vary by check type:
+    """Create a new monitoring check. Can be created from command line options or from a JSON/YAML file.
+    
+    When using --from-file:
+    - Command line options override file values
+    - File should contain check configuration in JSON or YAML format
+    
+    Parameters vary by check type:
     - web/api: --url required
     - tcp: --host required, --port optional
     - ssl: --url or --host required
     - synthetic/multistep: --pw-script-file or --parameters with pw_script required"""
+    
+    # Validate that we have either from_file or required parameters
+    if not from_file and not name:
+        typer.echo("Error: --name is required when not using --from-file", 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)
+    checks_cmd.create_check(name, check_type, url, host, port, interval, timeout, parameters, pw_script_file, from_file)
 
 
 @app.command("update")

{pingera_cli-0.1.5 → pingera_cli-0.1.7}/pingera_cli/commands/on_demand_checks.py

@@ -21,6 +21,48 @@ class OnDemandChecksCommand(BaseCommand):
     
     def __init__(self, output_format: Optional[str] = None):
         super().__init__(output_format)
+    
+    def _parse_check_file(self, file_path: str) -> dict:
+        """Parse check configuration from JSON or YAML file"""
+        import json
+        import os
+        
+        if not os.path.exists(file_path):
+            self.display_error(f"Check file not found: {file_path}")
+            raise typer.Exit(1)
+        
+        try:
+            with open(file_path, 'r', encoding='utf-8') as f:
+                content = f.read().strip()
+            
+            if not content:
+                self.display_error(f"Check file is empty: {file_path}")
+                raise typer.Exit(1)
+            
+            # Try to determine format from file extension or content
+            file_ext = os.path.splitext(file_path)[1].lower()
+            
+            if file_ext in ['.yaml', '.yml']:
+                try:
+                    import yaml
+                    return yaml.safe_load(content)
+                except ImportError:
+                    self.display_error("YAML support not available. Install with: pip install pyyaml")
+                    raise typer.Exit(1)
+                except yaml.YAMLError as e:
+                    self.display_error(f"Invalid YAML in file {file_path}: {str(e)}")
+                    raise typer.Exit(1)
+            else:
+                # Default to JSON
+                try:
+                    return json.loads(content)
+                except json.JSONDecodeError as e:
+                    self.display_error(f"Invalid JSON in file {file_path}: {str(e)}")
+                    raise typer.Exit(1)
+                    
+        except IOError as e:
+            self.display_error(f"Failed to read check file: {str(e)}")
+            raise typer.Exit(1)
         
     def get_client(self):
         """Get Pingera SDK client with authentication for on-demand checks"""
@@ -48,7 +90,7 @@ class OnDemandChecksCommand(BaseCommand):
             self.display_error(f"Failed to initialize client: {str(e)}")
             raise typer.Exit(1)
 
-    def execute_custom_check(self, url: Optional[str] = None, check_type: str = "web", host: Optional[str] = None, port: Optional[int] = None, timeout: int = 30, name: str = "On-demand check", parameters: Optional[str] = None, pw_script_file: Optional[str] = None, wait_for_result: bool = False):
+    def execute_custom_check(self, url: Optional[str] = None, check_type: str = "web", host: Optional[str] = None, port: Optional[int] = None, timeout: int = 30, name: str = "On-demand check", parameters: Optional[str] = None, pw_script_file: Optional[str] = None, from_file: Optional[str] = None, wait_for_result: bool = False):
         """Execute custom on-demand check"""
         try:
             import json
@@ -58,12 +100,73 @@ class OnDemandChecksCommand(BaseCommand):
             # Import the SDK models
             from pingera.models import ExecuteCustomCheckRequest
             
-            # Build check data
-            check_data = {
-                "name": name,
-                "type": check_type,
-                "timeout": timeout
-            }
+            # If creating from file, parse file and merge with command line options
+            if from_file:
+                file_data = self._parse_check_file(from_file)
+                
+                # Filter only SDK-recognized fields from file data
+                # This ignores marketplace-specific fields and other extensions
+                sdk_fields = ["name", "type", "url", "host", "port", "timeout", "parameters"]
+                filtered_file_data = {k: v for k, v in file_data.items() if k in sdk_fields}
+                
+                # Command line options take precedence over file data
+                check_data = {
+                    "name": filtered_file_data.get("name", name),
+                    "type": filtered_file_data.get("type", check_type),
+                    "timeout": filtered_file_data.get("timeout", timeout)
+                }
+                
+                # Override with command line values if provided
+                if name != "On-demand check":  # Only override if name was explicitly provided
+                    check_data["name"] = name
+                if check_type != "web":  # Only override if type was explicitly provided
+                    check_data["type"] = check_type
+                if timeout != 30:  # Only override if timeout was explicitly provided
+                    check_data["timeout"] = timeout
+                
+                # Handle URL from file
+                if url is None and filtered_file_data.get("url"):
+                    url = filtered_file_data["url"]
+                elif url is not None:
+                    # Command line URL takes precedence
+                    pass
+                
+                # Handle host/port from file
+                if host is None and filtered_file_data.get("host"):
+                    host = filtered_file_data["host"]
+                elif host is not None:
+                    # Command line host takes precedence
+                    pass
+                    
+                if port is None and filtered_file_data.get("port"):
+                    port = filtered_file_data["port"]
+                elif port is not None:
+                    # Command line port takes precedence
+                    pass
+                
+                # Handle parameters from file
+                file_parameters = filtered_file_data.get("parameters")
+                if file_parameters and parameters is None:
+                    # Use file parameters if no command line parameters
+                    parameters = json.dumps(file_parameters) if isinstance(file_parameters, dict) else file_parameters
+                
+                # Handle pw_script_file from file (this is CLI-specific, not sent to SDK)
+                if pw_script_file is None and file_data.get("pw_script_file"):
+                    pw_script_file = file_data["pw_script_file"]
+                
+                # Show info about ignored fields if any
+                ignored_fields = [k for k in file_data.keys() if k not in sdk_fields and k != "pw_script_file"]
+                if ignored_fields:
+                    self.display_info(f"Ignoring non-SDK fields from file: {', '.join(ignored_fields)}")
+                
+                self.display_info(f"Creating on-demand check from file: {from_file}")
+            else:
+                # Build check data normally
+                check_data = {
+                    "name": name,
+                    "type": check_type,
+                    "timeout": timeout
+                }
             
             # Add URL if provided (required for web, api, ssl checks)
             if url is not None:
@@ -112,21 +215,22 @@ class OnDemandChecksCommand(BaseCommand):
             if params_dict:
                 check_data["parameters"] = params_dict
             
-            # Validation based on check type
-            if check_type in ['web', 'api'] and not url:
-                self.display_error(f"URL is required for {check_type} checks")
+            # Validation based on check type - use the actual type from check_data
+            actual_check_type = check_data.get("type", check_type)
+            if actual_check_type in ['web', 'api'] and not url:
+                self.display_error(f"URL is required for {actual_check_type} checks")
                 raise typer.Exit(1)
             
-            if check_type in ['tcp'] and not host:
-                self.display_error(f"Host is required for {check_type} checks")
+            if actual_check_type in ['tcp'] and not host:
+                self.display_error(f"Host is required for {actual_check_type} checks")
                 raise typer.Exit(1)
             
-            if check_type in ['ssl'] and not (url or host):
-                self.display_error(f"Either URL or host is required for {check_type} checks")
+            if actual_check_type in ['ssl'] and not (url or host):
+                self.display_error(f"Either URL or host is required for {actual_check_type} checks")
                 raise typer.Exit(1)
             
-            if check_type in ['synthetic', 'multistep'] and not params_dict.get('pw_script'):
-                self.display_error(f"Playwright script is required for {check_type} checks. Use --pw-script-file or --parameters with pw_script")
+            if actual_check_type in ['synthetic', 'multistep'] and not params_dict.get('pw_script'):
+                self.display_error(f"Playwright script is required for {actual_check_type} checks. Use --pw-script-file or --parameters with pw_script")
                 raise typer.Exit(1)
             
             # Create the request
@@ -606,15 +710,22 @@ def run_custom_check(
     name: str = typer.Option("On-demand check", "--name", "-n", help="Check name"),
     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", help="Path to JSON or YAML file containing check configuration"),
     wait_for_result: bool = typer.Option(False, "--wait-for-result", help="Wait for job completion and show result immediately (max 5 minutes)"),
 ):
-    """Execute custom on-demand check. Parameters vary by check type:
+    """Execute custom on-demand check. Can be executed from command line options or from a JSON/YAML file.
+    
+    When using --from-file:
+    - Command line options override file values
+    - File should contain check configuration in JSON or YAML format
+    
+    Parameters vary by check type:
     - web/api: --url required
     - tcp: --host required, --port optional  
     - ssl: --url or --host required
     - synthetic/multistep: --pw-script-file or --parameters with pw_script required"""
     on_demand_cmd = OnDemandChecksCommand(get_output_format())
-    on_demand_cmd.execute_custom_check(url, check_type, host, port, timeout, name, parameters, pw_script_file, wait_for_result)
+    on_demand_cmd.execute_custom_check(url, check_type, host, port, timeout, name, parameters, pw_script_file, from_file, wait_for_result)
 
 
 @run_app.command("existing")

{pingera_cli-0.1.5 → pingera_cli-0.1.7/pingera_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pingera-cli
-Version: 0.1.5
+Version: 0.1.7
 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

{pingera_cli-0.1.5 → pingera_cli-0.1.7}/pingera_cli.egg-info/SOURCES.txt

@@ -8,6 +8,8 @@ replit.md
 run_tests.py
 setup.py
 docs/cli-commands.md
+docs/example-check.yaml
+docs/example-synthetic-screenshot.json
 pingera_cli/__init__.py
 pingera_cli/__main__.py
 pingera_cli/main.py