Skip to content

v0.2.0 - Shell & Python Validation Modules

Choose a tag to compare

@jwesleye jwesleye released this 15 Oct 14:31
· 57 commits to main since this release

🎉 Shell & Python Validation Modules Release

This release adds comprehensive validation and analysis capabilities for shell scripts and Python code, bringing the total function count to 66 functions across 6 modules.

🆕 New Modules

Shell Validation & Security Module (13 functions)

  • Validators: Syntax validation, dependency checking, shellcheck integration
  • Security: Comprehensive security analysis, injection risk detection
  • Formatters: Argument escaping, string quoting, shebang normalization
  • Parsers: Script parsing, function/variable extraction
  • Analyzers: Unquoted variable detection, dangerous command identification
  • Enhanced Features: Optional detect-secrets integration for comprehensive secret scanning

Python Validation & Analysis Module (15 functions)

  • Validators: Syntax validation, type hint checking, import order validation, Google ADK compliance
  • Extractors: Function signature parsing, docstring extraction, type annotation extraction, dependency analysis
  • Formatters: Docstring formatting (Google/NumPy/Sphinx styles), import sorting, type hint normalization
  • Analyzers: Circular import detection, unused import identification, anti-pattern detection, coverage gap analysis

📊 Stats

  • Total Functions: 66 (14 analysis + 9 git + 8 profiling + 7 quality + 13 shell + 15 python)
  • Tests: 451 passing in 3.78s (271 new tests added)
  • Code Coverage: 86% overall
    • Shell module: 87-95% per file
    • Python module: 85-96% per file
  • Code Quality: 100% ruff and mypy --strict compliance

📚 Documentation

  • Updated ROADMAP with comprehensive Git Enhancement Module (v0.4.0, 60+ functions planned)
  • Expanded SQLite module planning (v0.3.5, 16 functions)
  • Updated TODO.md with completion status
  • Comprehensive CHANGELOG updates

🔧 Technical Details

  • All functions follow Google ADK compliance (JSON-serializable, no defaults)
  • Zero breaking changes to existing modules
  • Optional dependencies properly handled (detect-secrets)
  • Full test coverage with edge cases

📦 Installation

pip install coding-open-agent-tools==0.2.0

🚀 Usage Example

import coding_open_agent_tools as coat

# Shell validation
validation = coat.shell.validate_shell_syntax(script_content, "bash")
issues = coat.shell.analyze_shell_security(script_content)

# Python validation
syntax = coat.python.validate_python_syntax(code)
hints = coat.python.validate_type_hints(code)
sig = coat.python.parse_function_signature(code, "my_function")

🔗 Links

📋 Full Changelog

See CHANGELOG.md for detailed changes.


What's Next: v0.3.5 will add SQLite database operations (16 functions), followed by v0.4.0 with comprehensive git enhancements (60+ functions).