Sign in Sign up
rubygems

ukiryu

Ukiryu is a platform-adaptive command execution framework that transforms CLI tools into declarative APIs. It provides the "OpenAPI" for command-line interfaces, enabling cross-platform tool integration with type safety and structured results. Key features: * Declarative YAML profiles define tool behavior, eliminating hardcoded command strings * Platform-adaptive execution across macOS, Linux, and Windows * Shell-aware command formatting for bash, zsh, fish, PowerShell, and cmd * Type-safe parameter validation with automatic coercion * Version routing support with semantic version matching (via Versionian) * Interface contracts allow multiple tools to implement the same abstract API * Structured Result objects with success/failure information instead of parsing stdout * Comprehensive error handling under Ukiryu::Errors namespace The Ukiryu ecosystem consists of: * ukiryu gem - The runtime framework * ukiryu/register - Collection of YAML tool profiles * ukiryu/schemas - JSON Schema for validation Use Ukiryu to integrate command-line tools like ImageMagick, FFmpeg, Inkscape, Ghostscript, and more into your Ruby applications with consistent, predictable interfaces.

Activity

Latest release
4mo ago
Total releases
12
Cadence
~2 days
Last 12 months
12

Reach

Stars

Details

License
BSD-2-Clause
First release
Jan 21, 2026
Releases
Version Released
0.3.0 minor
0.2.4 patch
0.2.3 patch
0.2.0 minor
0.2.2 patch
0.2.1 patch
0.1.7 patch
0.1.6 patch
0.1.4 patch
0.1.3 patch
0.1.1 patch
0.1.0 initial