runway-ruby 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: f57e9cd74e026d83aad28ba433502d42acc3fbcb4b155101756962bbbcfaca28
+  data.tar.gz: 366ab1709fcc7f56f2f3d9c3e268e9d329c5516d20c276b247a07a53f144c1ff
+SHA512:
+  metadata.gz: dda508c8d93f8e03090121c0e9cc3144677017083fbc58a4747a50463235acc6f05bd6092ecfd7820ed9b19a979a0722cbcb5b87e4ad004fdd63da52727b1398
+  data.tar.gz: 8f86994048cdddd58cecbc29e1821f18eaaa43fa62a6aa23b5fb7013ac854e0dbe41587032c381dbca2131491eba624530fe23429e6fc8a3de8dc4733f8f0aa0

data/.tool-versions

@@ -0,0 +1 @@
+ruby 3.3.5

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Oriol Gual
+
+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.

data/OPENAPI_VALIDATION.md

@@ -0,0 +1,100 @@
+# OpenAPI Contract Validation
+
+This document describes how to validate the RunwayML Ruby SDK against the OpenAPI specification.
+
+## Quick Start
+
+### Check Spec Compliance
+
+```bash
+bundle exec rake spec:coverage
+```
+
+Shows which endpoints are defined in the spec and which SDK methods implement them.
+
+### Run Contract Tests
+
+```bash
+bundle exec rake spec:validate
+```
+
+Validates that SDK requests and responses conform to the OpenAPI spec.
+
+## Tools
+
+### OpenAPI Spec Loader
+
+Fetches and caches the official OpenAPI spec from GitHub.
+
+```ruby
+# Load the spec
+spec = RunwayML::OpenAPISpecLoader.load_spec
+
+# Force reload
+spec = RunwayML::OpenAPISpecLoader.load_spec(force_reload: true)
+
+# Get endpoint schemas
+schema = RunwayML::OpenAPISpecLoader.get_request_schema("POST", "/v1/text_to_video")
+schema = RunwayML::OpenAPISpecLoader.get_response_schema("POST", "/v1/text_to_video")
+```
+
+### Contract Validator
+
+Validates requests and responses against OpenAPI schemas.
+
+```ruby
+validator = RunwayML::ContractValidator.new
+
+result = validator.validate_request("POST", "/v1/text_to_video", {
+  "promptText" => "A beautiful sunset",
+  "ratio" => "1280:720",
+  "duration" => 8,
+  "model" => "veo3.1"
+})
+
+puts result[:valid] ? "Valid" : "Invalid: #{result[:errors].join(', ')}"
+```
+
+### Spec Coverage Analyzer
+
+Analyzes SDK completeness.
+
+```ruby
+# Print human-readable report
+RunwayML::SpecCoverageAnalyzer.print_coverage_report
+```
+
+## Critical Endpoints Monitored
+
+| Endpoint                       | SDK Class            | Method   |
+| ------------------------------ | -------------------- | -------- |
+| POST /v1/text_to_video         | TextToVideo          | create   |
+| POST /v1/image_to_video        | ImageToVideo         | create   |
+| POST /v1/text_to_speech        | TextToSpeech         | create   |
+| POST /v1/speech_to_speech      | SpeechToSpeech       | create   |
+| POST /v1/sound_effect          | SoundEffect          | create   |
+| POST /v1/voice_isolation       | VoiceIsolation       | create   |
+| POST /v1/voice_dubbing         | VoiceDubbing         | create   |
+| POST /v1/character_performance | CharacterPerformance | create   |
+| POST /v1/video_to_video        | VideoToVideo         | create   |
+| POST /v1/text_to_image         | TextToImage          | create   |
+| GET /v1/tasks/{id}             | Task                 | retrieve |
+| DELETE /v1/tasks/{id}          | Task                 | delete   |
+| GET /v1/organization           | Organization         | retrieve |
+| POST /v1/uploads               | Uploads              | create   |
+
+## Automatic Drift Detection
+
+Three GitHub Actions workflows automatically monitor spec compliance:
+
+- **spec-compliance.yml** - Daily check that SDK remains 100% compliant
+- **spec-validation.yml** - Validates contracts on every PR
+- **spec-update-alert.yml** - Weekly alert when upstream spec changes
+
+See `.github/workflows/` for details.
+
+## References
+
+- [RunwayML API Docs](https://docs.dev.runwayml.com)
+- [OpenAPI Specification](https://spec.openapis.org/oas/v3.1.0)
+- [RunwayML OpenAPI Spec](https://github.com/runwayml/openapi)