rubycanusellm 0.4.1 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4fa122c59f084a74df8fe6cc1b7b0cf26982d5d7dd29a1dbf37937f821024e08
-  data.tar.gz: 3d01defe930449e9b6cd4adc974c6d051b3af6171287673e1cdd4b679b4648a0
+  metadata.gz: 8366062327382434c0f86c1cb30a0a2265b1d26e7e512b294884aeac93e09468
+  data.tar.gz: 510d3d9d0051a4cdcb63ecdf7e0d1f4e536e27701a64504cd57fb555868aba1d
 SHA512:
-  metadata.gz: 968934bfc95e1d8b5b1e8400ef9a784aa391db310984849ab4a5208c80c8378792afc26463ff4efb5b7f08772fbe72cf71266a2383cd41f1bb2c44078e6da7a8
-  data.tar.gz: 69800687f81c9753267db171bd9a64e74097126f16fa9ffaade1704536976fca53f0c151e4ab187ba2daf9febe45d5614ff9ff8a700c3265593b983db1595494
+  metadata.gz: 711b8791cc6a9aa49362aaeb1a1da4d03071ec0ab14709e2b3ab20ec418752ce48232cace46103337b58f3daab643efd03a4f08259f994c848bf8c41efb8f3a1
+  data.tar.gz: 6c3adfcaa2032802fdfbb8f861dea1d89e56d177be3fbf2f761c47457af573c7a7581cd5727ce736b31738f33649e1ea8b247c18bbc8bf1b7364824966aeaeb8

data/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## [0.5.0] - 2026-04-03
+
+### Added
+
+- `RubyCanUseLLM::Prompt` — lightweight prompt template system with ERB and YAML file support
+- Inline prompts via `Prompt.new(system:, user:, assistant:)` + `render(**variables)`
+- File-based prompts via `Prompt.load("path/to/prompt.yml", **variables)`
+- Full ERB support: loops, conditionals, any Ruby expression
+- Clear error messages for missing variables and invalid roles
+
 ## [0.4.1] - 2026-04-03
 
 ### Added

data/README.md

@@ -197,12 +197,53 @@ rescue RubyCanUseLLM::ProviderError => e
 end
 ```
 
+### Prompt Templates
+
+Keep prompts out of your Ruby code. Define them in YAML files with ERB for dynamic content:
+
+```yaml
+# prompts/commodity_analysis.yml
+system: |
+  You are an expert in <%= domain %> classification.
+user: |
+  Analyze this item: <%= description %>
+  <% if references.any? %>
+  Similar references:
+  <% references.each do |ref| %>
+  - <%= ref %>
+  <% end %>
+  <% end %>
+```
+
+```ruby
+messages = RubyCanUseLLM::Prompt.load("prompts/commodity_analysis.yml",
+  domain: "electronics",
+  description: "capacitor 10uF",
+  references: ["ceramic", "electrolytic"]
+)
+RubyCanUseLLM.chat(messages)
+```
+
+For inline prompts:
+
+```ruby
+prompt = RubyCanUseLLM::Prompt.new(
+  system: "You are a <%= role %> assistant.",
+  user: "Help me with: <%= task %>"
+)
+messages = prompt.render(role: "coding", task: "fix this bug")
+RubyCanUseLLM.chat(messages)
+```
+
+ERB is supported in both cases — loops, conditionals, any Ruby expression.
+
 ## Generators
 
 | Command | Description |
 |---------|-------------|
 | `rubycanusellm generate:config` | Configuration file with provider setup |
 | `rubycanusellm generate:completion` | Completion service object |
+| `rubycanusellm generate:embedding` | Embedding service object |
 
 ## Roadmap
 
@@ -219,6 +260,7 @@ end
 - [x] Mistral provider (chat + embeddings)
 - [x] Ollama provider (chat + embeddings, local)
 - [x] `generate:embedding` command
+- [x] Prompt templates (ERB + YAML file-based)
 - [ ] Tool calling
 
 ## Development

data/lib/rubycanusellm/prompt.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require "erb"
+require "yaml"
+
+module RubyCanUseLLM
+  class Prompt
+    VALID_ROLES = %w[system user assistant].freeze
+
+    def initialize(**roles)
+      invalid = roles.keys.map(&:to_s) - VALID_ROLES
+      unless invalid.empty?
+        raise Error, "Invalid role(s): #{invalid.join(", ")}. Valid roles: #{VALID_ROLES.join(", ")}"
+      end
+      if !roles.key?(:user) && !roles.key?("user")
+        raise Error, "Prompt requires at least a :user role"
+      end
+
+      @roles = roles.transform_keys(&:to_sym)
+    end
+
+    def self.load(path, **variables)
+      raise Error, "Prompt file not found: #{path}" unless File.exist?(path)
+
+      data = YAML.safe_load(File.read(path))
+      unless data.is_a?(Hash)
+        raise Error, "Prompt file must be a YAML hash with role keys (system, user, assistant)"
+      end
+
+      roles = data.transform_keys(&:to_sym).slice(*VALID_ROLES.map(&:to_sym))
+      new(**roles).render(**variables)
+    end
+
+    def render(**variables)
+      binding_obj = build_binding(variables)
+      @roles.filter_map do |role, template|
+        next if template.nil? || template.strip.empty?
+        content = ERB.new(template, trim_mode: "-").result(binding_obj)
+        { role: role, content: content.strip }
+      end
+    rescue NameError => e
+      raise Error, "Missing variable in prompt template: #{e.message}"
+    end
+
+    private
+
+    def build_binding(variables)
+      ctx = Object.new
+      variables.each do |key, value|
+        ctx.define_singleton_method(key) { value }
+      end
+      ctx.instance_eval { binding }
+    end
+  end
+end

data/lib/rubycanusellm/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Rubycanusellm
-  VERSION = "0.4.1"
+  VERSION = "0.5.0"
 end

data/lib/rubycanusellm.rb

@@ -12,6 +12,7 @@ require_relative "rubycanusellm/providers/voyage"
 require_relative "rubycanusellm/providers/mistral"
 require_relative "rubycanusellm/providers/ollama"
 require_relative "rubycanusellm/embedding_response"
+require_relative "rubycanusellm/prompt"
 
 module RubyCanUseLLM
   PROVIDERS = {

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rubycanusellm
 version: !ruby/object:Gem::Version
-  version: 0.4.1
+  version: 0.5.0
 platform: ruby
 authors:
 - Juan Manuel Guzman Nava
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-04-03 00:00:00.000000000 Z
+date: 2026-04-04 00:00:00.000000000 Z
 dependencies: []
 description: One interface, every LLM. Rubycanusellm provides a unified client for
   OpenAI, Anthropic, and more, plus generators that scaffold the boilerplate so you
@@ -33,6 +33,7 @@ files:
 - lib/rubycanusellm/configuration.rb
 - lib/rubycanusellm/embedding_response.rb
 - lib/rubycanusellm/errors.rb
+- lib/rubycanusellm/prompt.rb
 - lib/rubycanusellm/providers/anthropic.rb
 - lib/rubycanusellm/providers/base.rb
 - lib/rubycanusellm/providers/mistral.rb