- name
- scripting-utils
- description
- Universal scripting utilities supporting 8+ languages (Bash, PowerShell, Python, Perl/Raku, JavaScript, Tcl), IRC bot frameworks (pbot, Limnoria), system management (systemd, Ubuntu/CentOS), and WebSearch integration. Provides syntax validation, code generation, best-practice linting, and cross-platform compatibility checks. Use when (1) Writing or validating scripts in any supported language, (2) Needing IRC bot command syntax, (3) Managing systemd services across Ubuntu/CentOS, (4) Validating JSON/API responses from web searches, (5) Converting between shell dialects, or (6) Batch-processing script validation.
Scripting Utils
Universal scripting utilities with WebSearch integration for 8+ languages and IRC bot frameworks.
Supported Languages
| Language | Command | Validation | Linting | WebSearch Docs |
|---|---|---|---|---|
| Bash | bash | ✅ shellcheck | ✅ | ✅ |
| sh (POSIX) | sh | ✅ shellcheck | ✅ | ✅ |
| Python | python3 | ✅ pylint/mypy | ✅ | ✅ |
| Perl 5 | perl | ✅ perlcritic | ✅ | ✅ |
| Raku | raku | ✅ | ✅ | ✅ |
| PowerShell | pwsh | ✅ PSScriptAnalyzer | ✅ | ✅ |
| JavaScript | node | ✅ eslint | ✅ | ✅ |
| Tcl | tclsh | ✅ | ✅ | ✅ |
IRC Bot Frameworks
| Framework | Language | Docs Source | Status |
|---|---|---|---|
| pbot | Perl 5 | https://github.com/pragma-/pbot | ✅ |
| Limnoria | Python | https://docs.limnoria.net/ | ✅ |
| Eggdrop | Tcl | https://docs.eggheads.org/ | ✅ |
System Management
| System | Ubuntu | CentOS 8 | Command Matrix |
|---|---|---|---|
| systemd | ✅ | ✅ | ✅ |
| packages (apt/yum) | ✅ | ✅ | ✅ |
| services | ✅ | ✅ | ✅ |
| networking | ✅ | ✅ | ✅ |
WebSearch Integration
All modules support automatic documentation lookup:
from scripting_utils import LanguageValidator
validator = LanguageValidator("powershell")
# Auto-fetches syntax from Microsoft docs if needed
result = validator.validate("$var = Get-Process")Modules
| Module | Purpose |
|---|---|
language_validator.py | Multi-language syntax validation |
irc_bot_syntax.py | pbot, Limnoria, Eggdrop command syntax |
system_manager.py | systemd, Ubuntu/CentOS abstraction |
json_websearch.py | JSON-Utils + WebSearch combination |
script_converter.py | Cross-language script conversion |
batch_validator.py | Batch validation of script directories |
Quick Start
Validate a script:
python scripts/language_validator.py script.ps1 --lang powershell
python scripts/language_validator.py script.pl --lang perlGet IRC bot command syntax:
python scripts/irc_bot_syntax.py --bot pbot --command "keyword add"
python scripts/irc_bot_syntax.py --bot limnoria --command "config channel"System command (Ubuntu vs CentOS):
python scripts/system_manager.py --action install --package nginx --os ubuntu
python scripts/system_manager.py --action install --package nginx --os centosJSON from WebSearch + Validate:
from json_websearch import validate_search_result
from scripting_utils import WebSearchJSON
# Search API docs, validate response
result = WebSearchJSON.search_and_validate(
query="github api repos endpoint",
schema="github_api_schema.json"
)Integration with json-utils
The json_websearch.py module extends json-utils with WebSearch capabilities:
- Fetch API schemas from documentation
- Validate real API responses
- Batch-validate multiple endpoints
- Auto-repair common API response errors
See: ../json-utils/ for core JSON functionality.