nachos 0.1.9__tar.gz

nachos-0.1.9/LICENSE

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

nachos-0.1.9/PKG-INFO

@@ -0,0 +1,230 @@
+Metadata-Version: 2.1
+Name: nachos
+Version: 0.1.9
+Summary: A CLI tool to manage Nagios Core via HTTP REST API
+Keywords: nagios,monitoring,cli,api,devops
+Author-Email: lduchosal <lduchosal@github.com>
+License: MIT
+Classifier: Development Status :: 4 - Beta
+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.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: System :: Monitoring
+Classifier: Topic :: System :: Systems Administration
+Project-URL: Homepage, https://github.com/lduchosal/nagioscli
+Project-URL: Bug Reports, https://github.com/lduchosal/nagioscli/issues
+Project-URL: Source, https://github.com/lduchosal/nagioscli
+Project-URL: Documentation, https://github.com/lduchosal/nagioscli/blob/main/README.md
+Requires-Python: >=3.10
+Requires-Dist: click<9.0,>=8.0
+Description-Content-Type: text/markdown
+
+# nagioscli
+
+[![Python Version](https://img.shields.io/badge/python-3.10+-blue.svg)](https://python.org)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A CLI tool to manage Nagios Core via HTTP REST API.
+
+## Features
+
+- Query host and service status
+- List all problems (warning, critical, unknown)
+- Force immediate checks
+- Acknowledge problems
+- List hosts and services
+- JSON output support
+- Password manager (`pass`) integration
+
+## Installation
+
+```bash
+# From PyPI
+pip install nagioscli
+
+# From source
+pip install git+https://github.com/lduchosal/nagioscli.git
+
+# Development
+git clone https://github.com/lduchosal/nagioscli.git
+cd nagioscli
+pdm install
+```
+
+## Quick Start
+
+### Configuration
+
+Create `nagioscli.ini` in the current directory or `~/.nagioscli.ini`:
+
+```ini
+[nagios]
+url = http://nagios.example.com/nagios
+username = nagiosadmin
+
+[auth]
+method = pass_path
+pass_path = nagios/admin
+
+[settings]
+timeout = 30
+```
+
+### Basic Usage
+
+```bash
+# List all problems
+nagioscli problems
+
+# Query service status
+nagioscli status service web01.example.com HTTP
+
+# Query host status
+nagioscli status host web01.example.com
+
+# Force service check
+nagioscli check web01.example.com HTTP
+
+# Acknowledge a problem
+nagioscli ack web01.example.com HTTP "Working on it"
+
+# List all hosts
+nagioscli hosts
+
+# List services for a host
+nagioscli services web01.example.com
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `problems` | List all services with problems |
+| `status service <host> <service>` | Query service status |
+| `status host <host>` | Query host status |
+| `check <host> <service>` | Force service check |
+| `check-host <host>` | Force host check |
+| `ack <host> <service> <comment>` | Acknowledge service problem |
+| `ack-host <host> <comment>` | Acknowledge host problem |
+| `hosts` | List all monitored hosts |
+| `services <host>` | List services for a host |
+
+## Output Options
+
+```bash
+# JSON output
+nagioscli problems --json
+
+# Quiet mode (exit codes only)
+nagioscli problems --quiet
+
+# Verbose debugging
+nagioscli problems -v
+nagioscli problems -vv
+nagioscli problems -vvv
+```
+
+## Configuration Options
+
+### Authentication Methods
+
+#### Password in config file
+```ini
+[nagios]
+url = http://nagios.example.com/nagios
+username = admin
+password = secret
+```
+
+#### Password from pass (password-store)
+```ini
+[nagios]
+url = http://nagios.example.com/nagios
+username = admin
+
+[auth]
+method = pass_path
+pass_path = nagios/admin
+```
+
+#### Password from environment variable
+```ini
+[nagios]
+url = http://nagios.example.com/nagios
+username = admin
+
+[auth]
+method = env_var
+env_var = NAGIOS_PASSWORD
+```
+
+## Exit Codes
+
+| Code | Meaning |
+|------|---------|
+| 0 | Success |
+| 1 | General error |
+| 2 | Configuration error |
+| 3 | Authentication error |
+| 4 | API error |
+| 5 | Not found |
+
+## Development
+
+```bash
+# Clone and setup
+git clone https://github.com/lduchosal/nagioscli.git
+cd nagioscli
+pdm install -G dev
+
+# Run tests
+pdm test
+
+# Lint and format
+pdm lint
+pdm format
+
+# Type check
+pdm typecheck
+
+# Build
+pdm build
+```
+
+## Architecture
+
+```
+nagioscli/
+├── cli/                    # Click CLI interface
+│   ├── commands/           # Individual commands
+│   ├── decorators.py       # Common CLI options
+│   └── handlers.py         # Error handlers
+├── core/                   # Core business logic
+│   ├── auth.py             # Authentication
+│   ├── client.py           # Nagios HTTP client
+│   ├── config.py           # Configuration
+│   ├── exceptions.py       # Custom exceptions
+│   └── models.py           # Data models
+└── services/               # Business services
+```
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Run tests and linting
+5. Submit a pull request
+
+## Related Projects
+
+- [check_msdefender](https://github.com/lduchosal/check_msdefender) - Nagios plugin for Microsoft Defender

nachos-0.1.9/README.md

@@ -0,0 +1,204 @@
+# nagioscli
+
+[![Python Version](https://img.shields.io/badge/python-3.10+-blue.svg)](https://python.org)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A CLI tool to manage Nagios Core via HTTP REST API.
+
+## Features
+
+- Query host and service status
+- List all problems (warning, critical, unknown)
+- Force immediate checks
+- Acknowledge problems
+- List hosts and services
+- JSON output support
+- Password manager (`pass`) integration
+
+## Installation
+
+```bash
+# From PyPI
+pip install nagioscli
+
+# From source
+pip install git+https://github.com/lduchosal/nagioscli.git
+
+# Development
+git clone https://github.com/lduchosal/nagioscli.git
+cd nagioscli
+pdm install
+```
+
+## Quick Start
+
+### Configuration
+
+Create `nagioscli.ini` in the current directory or `~/.nagioscli.ini`:
+
+```ini
+[nagios]
+url = http://nagios.example.com/nagios
+username = nagiosadmin
+
+[auth]
+method = pass_path
+pass_path = nagios/admin
+
+[settings]
+timeout = 30
+```
+
+### Basic Usage
+
+```bash
+# List all problems
+nagioscli problems
+
+# Query service status
+nagioscli status service web01.example.com HTTP
+
+# Query host status
+nagioscli status host web01.example.com
+
+# Force service check
+nagioscli check web01.example.com HTTP
+
+# Acknowledge a problem
+nagioscli ack web01.example.com HTTP "Working on it"
+
+# List all hosts
+nagioscli hosts
+
+# List services for a host
+nagioscli services web01.example.com
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `problems` | List all services with problems |
+| `status service <host> <service>` | Query service status |
+| `status host <host>` | Query host status |
+| `check <host> <service>` | Force service check |
+| `check-host <host>` | Force host check |
+| `ack <host> <service> <comment>` | Acknowledge service problem |
+| `ack-host <host> <comment>` | Acknowledge host problem |
+| `hosts` | List all monitored hosts |
+| `services <host>` | List services for a host |
+
+## Output Options
+
+```bash
+# JSON output
+nagioscli problems --json
+
+# Quiet mode (exit codes only)
+nagioscli problems --quiet
+
+# Verbose debugging
+nagioscli problems -v
+nagioscli problems -vv
+nagioscli problems -vvv
+```
+
+## Configuration Options
+
+### Authentication Methods
+
+#### Password in config file
+```ini
+[nagios]
+url = http://nagios.example.com/nagios
+username = admin
+password = secret
+```
+
+#### Password from pass (password-store)
+```ini
+[nagios]
+url = http://nagios.example.com/nagios
+username = admin
+
+[auth]
+method = pass_path
+pass_path = nagios/admin
+```
+
+#### Password from environment variable
+```ini
+[nagios]
+url = http://nagios.example.com/nagios
+username = admin
+
+[auth]
+method = env_var
+env_var = NAGIOS_PASSWORD
+```
+
+## Exit Codes
+
+| Code | Meaning |
+|------|---------|
+| 0 | Success |
+| 1 | General error |
+| 2 | Configuration error |
+| 3 | Authentication error |
+| 4 | API error |
+| 5 | Not found |
+
+## Development
+
+```bash
+# Clone and setup
+git clone https://github.com/lduchosal/nagioscli.git
+cd nagioscli
+pdm install -G dev
+
+# Run tests
+pdm test
+
+# Lint and format
+pdm lint
+pdm format
+
+# Type check
+pdm typecheck
+
+# Build
+pdm build
+```
+
+## Architecture
+
+```
+nagioscli/
+├── cli/                    # Click CLI interface
+│   ├── commands/           # Individual commands
+│   ├── decorators.py       # Common CLI options
+│   └── handlers.py         # Error handlers
+├── core/                   # Core business logic
+│   ├── auth.py             # Authentication
+│   ├── client.py           # Nagios HTTP client
+│   ├── config.py           # Configuration
+│   ├── exceptions.py       # Custom exceptions
+│   └── models.py           # Data models
+└── services/               # Business services
+```
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Run tests and linting
+5. Submit a pull request
+
+## Related Projects
+
+- [check_msdefender](https://github.com/lduchosal/check_msdefender) - Nagios plugin for Microsoft Defender

nachos-0.1.9/nagioscli/__init__.py

@@ -0,0 +1,5 @@
+"""nagioscli - A CLI tool to manage Nagios Core via HTTP REST API."""
+
+__version__ = "0.1.9"
+__author__ = "lduchosal"
+__email__ = "lduchosal@github.com"

nachos-0.1.9/nagioscli/__main__.py

@@ -0,0 +1,6 @@
+"""Main entry point for nagioscli."""
+
+from nagioscli.cli import main
+
+if __name__ == "__main__":
+    main()

nachos-0.1.9/nagioscli/cli/__init__.py

@@ -0,0 +1,16 @@
+"""CLI module for nagioscli."""
+
+import click
+
+from .commands import register_all_commands
+
+
+@click.group()
+@click.version_option()
+def main() -> None:
+    """Nagios CLI - Manage Nagios Core via HTTP REST API."""
+    pass
+
+
+# Register all commands
+register_all_commands(main)

nachos-0.1.9/nagioscli/cli/commands/__init__.py

@@ -0,0 +1,20 @@
+"""Commands package for CLI."""
+
+from typing import Any
+
+from .ack import register_ack_commands
+from .check import register_check_commands
+from .hosts import register_hosts_commands
+from .problems import register_problems_commands
+from .services import register_services_commands
+from .status import register_status_commands
+
+
+def register_all_commands(main_group: Any) -> None:
+    """Register all commands with the main CLI group."""
+    register_problems_commands(main_group)
+    register_status_commands(main_group)
+    register_check_commands(main_group)
+    register_hosts_commands(main_group)
+    register_services_commands(main_group)
+    register_ack_commands(main_group)

nachos-0.1.9/nagioscli/cli/commands/ack.py

@@ -0,0 +1,73 @@
+"""Acknowledge commands for CLI."""
+
+from typing import Any
+
+import click
+
+from nagioscli.core.client import NagiosClient
+from nagioscli.core.config import load_config
+
+from ..decorators import common_options
+from ..handlers import OutputFormatter, handle_error
+
+
+def register_ack_commands(main_group: Any) -> None:
+    """Register acknowledge commands with the main CLI group."""
+
+    @main_group.command("ack")
+    @click.argument("hostname")
+    @click.argument("service")
+    @click.argument("comment")
+    @common_options
+    def ack_cmd(
+        hostname: str,
+        service: str,
+        comment: str,
+        config: str,
+        verbose: int,
+    ) -> None:
+        """Acknowledge a service problem."""
+        try:
+            cfg = load_config(config)
+            client = NagiosClient(cfg, verbose=verbose)
+
+            OutputFormatter.format_verbose(
+                f"Acknowledging {hostname}/{service}", verbose
+            )
+
+            success = client.acknowledge_service(hostname, service, comment)
+
+            if success:
+                click.echo(f"Acknowledged {hostname}/{service}")
+            else:
+                click.echo(f"Failed to acknowledge {hostname}/{service}")
+
+        except Exception as e:
+            handle_error(e, verbose)
+
+    @main_group.command("ack-host")
+    @click.argument("hostname")
+    @click.argument("comment")
+    @common_options
+    def ack_host_cmd(
+        hostname: str,
+        comment: str,
+        config: str,
+        verbose: int,
+    ) -> None:
+        """Acknowledge a host problem."""
+        try:
+            cfg = load_config(config)
+            client = NagiosClient(cfg, verbose=verbose)
+
+            OutputFormatter.format_verbose(f"Acknowledging host {hostname}", verbose)
+
+            success = client.acknowledge_host(hostname, comment)
+
+            if success:
+                click.echo(f"Acknowledged host {hostname}")
+            else:
+                click.echo(f"Failed to acknowledge host {hostname}")
+
+        except Exception as e:
+            handle_error(e, verbose)

nachos-0.1.9/nagioscli/cli/commands/check.py

@@ -0,0 +1,69 @@
+"""Check commands for CLI."""
+
+from typing import Any
+
+import click
+
+from nagioscli.core.client import NagiosClient
+from nagioscli.core.config import load_config
+
+from ..decorators import common_options
+from ..handlers import OutputFormatter, handle_error
+
+
+def register_check_commands(main_group: Any) -> None:
+    """Register check commands with the main CLI group."""
+
+    @main_group.command("check")
+    @click.argument("hostname")
+    @click.argument("service")
+    @common_options
+    def check_cmd(
+        hostname: str,
+        service: str,
+        config: str,
+        verbose: int,
+    ) -> None:
+        """Force immediate service check."""
+        try:
+            cfg = load_config(config)
+            client = NagiosClient(cfg, verbose=verbose)
+
+            OutputFormatter.format_verbose(
+                f"Forcing check for {hostname}/{service}", verbose
+            )
+
+            success = client.force_service_check(hostname, service)
+
+            if success:
+                click.echo(f"Force check submitted for {hostname}/{service}")
+            else:
+                click.echo(f"Failed to submit force check for {hostname}/{service}")
+
+        except Exception as e:
+            handle_error(e, verbose)
+
+    @main_group.command("check-host")
+    @click.argument("hostname")
+    @common_options
+    def check_host_cmd(
+        hostname: str,
+        config: str,
+        verbose: int,
+    ) -> None:
+        """Force immediate host check."""
+        try:
+            cfg = load_config(config)
+            client = NagiosClient(cfg, verbose=verbose)
+
+            OutputFormatter.format_verbose(f"Forcing check for host {hostname}", verbose)
+
+            success = client.force_host_check(hostname)
+
+            if success:
+                click.echo(f"Force check submitted for host {hostname}")
+            else:
+                click.echo(f"Failed to submit force check for host {hostname}")
+
+        except Exception as e:
+            handle_error(e, verbose)

nachos-0.1.9/nagioscli/cli/commands/hosts.py

@@ -0,0 +1,57 @@
+"""Hosts command for CLI."""
+
+import json
+from typing import Any
+
+import click
+
+from nagioscli.core.client import NagiosClient
+from nagioscli.core.config import load_config
+
+from ..decorators import common_options, output_options
+from ..handlers import OutputFormatter, handle_error
+
+
+def register_hosts_commands(main_group: Any) -> None:
+    """Register hosts commands with the main CLI group."""
+
+    @main_group.command("hosts")
+    @common_options
+    @output_options
+    def hosts_cmd(
+        config: str,
+        verbose: int,
+        output_json: bool,
+        quiet: bool,
+    ) -> None:
+        """List all monitored hosts."""
+        try:
+            cfg = load_config(config)
+            client = NagiosClient(cfg, verbose=verbose)
+
+            OutputFormatter.format_verbose(f"Querying hosts from {cfg.url}", verbose)
+
+            hosts = client.get_all_hosts()
+
+            if output_json:
+                output = [
+                    {
+                        "host": h.name,
+                        "status": h.status,
+                        "status_text": OutputFormatter.format_host_status(h.status),
+                    }
+                    for h in hosts
+                ]
+                click.echo(json.dumps(output, indent=2))
+            elif quiet:
+                for h in hosts:
+                    click.echo(h.name)
+            else:
+                for h in hosts:
+                    status_text = OutputFormatter.format_host_status(h.status)
+                    click.echo(f"{status_text:12} {h.name}")
+
+                click.echo(f"\nTotal: {len(hosts)} host(s)")
+
+        except Exception as e:
+            handle_error(e, verbose)